GetLocation

GET

Get Location

Returns geographic coordinates in the form of latitude and longitude angles. After receiving the subscriber's latitude and longitude position, the API helps to reverse geocoding to get your user's address.

 

To reverse geo-coordinates, every request must pass in the access_token value in the header. For more information on how to generate your access_token, please refer to this section.

 

 

Request

Method URL
GET https://blinke-stage.apigee.net/io/location

 

 

Request Headers

Name Description Mandatory
Authorization Bearer access_token Yes
Content-Type application/json Yes

 

 

Query Parameter

Name Description
latlng*
string
The lat lng value in lat,lng format.

 

 

Response

Result of the successful request contains geocoding information. Please refer to Google Maps API for more details.

 

 

Response (Example)

HTTP Code Response
200
{
   "results" : [
      {
         "address_components" : [
            {
               "long_name" : "1600",
               "short_name" : "1600",
               "types" : [ "street_number" ]
            },
            {
               "long_name" : "Amphitheatre Pkwy",
               "short_name" : "Amphitheatre Pkwy",
               "types" : [ "route" ]
            },
            {
               "long_name" : "Mountain View",
               "short_name" : "Mountain View",
               "types" : [ "locality", "political" ]
            },
            {
               "long_name" : "Santa Clara County",
               "short_name" : "Santa Clara County",
               "types" : [ "administrative_area_level_2", "political" ]
            },
            {
               "long_name" : "California",
               "short_name" : "CA",
               "types" : [ "administrative_area_level_1", "political" ]
            },
            {
               "long_name" : "United States",
               "short_name" : "US",
               "types" : [ "country", "political" ]
            },
            {
               "long_name" : "94043",
               "short_name" : "94043",
               "types" : [ "postal_code" ]
            }
         ],
         "formatted_address" : "1600 Amphitheatre Parkway, Mountain View, CA 94043, USA",
         "geometry" : {
            "location" : {
               "lat" : 37.4224764,
               "lng" : -122.0842499
            },
            "location_type" : "ROOFTOP",
            "viewport" : {
               "northeast" : {
                  "lat" : 37.4238253802915,
                  "lng" : -122.0829009197085
               },
               "southwest" : {
                  "lat" : 37.4211274197085,
                  "lng" : -122.0855988802915
               }
            }
         },
         "place_id" : "ChIJ2eUgeAK6j4ARbn5u_wAGqWA",
         "types" : [ "street_address" ]
      }
   ],
   "status" : "OK"
}
401
{
    "fault": {
        "faultstring": "Invalid Access Token",
        "detail": {
            "errorcode": "keymanagement.service.invalid_access_token"
        }
    }
}

Resource URL

https://blinke-stage.apigee.net /io/location

Query Parameters


Name Values Description
latlng
(required)

The lat lng value in lat,lng format.


Header Parameters


Name Values Description
Content-Type
(required)

JSON

Authorization
(required)

Bearer access_token

Request Body

HTTP Basic

OAuth 2.0

API Key

Reset

Make a request and see the response.

Make a request and see the response.

Make a request and see the response.

Resource Summary

Security

Working...