Reverse Geocode
Request
The Reverse Geocode API is used to obtain an address from a latitude and longitude.
GET https://apis.location.studio/geo/v2/reversegeocode/json
Required Parameters
api_key |
String |
Your Location Studio API Key |
coordinate |
String |
The latitude and longitude for the reverse geocode address lookup. The latitude must be in the range of -90.0 to 90.0 and longitude must be in the range of -180.0 to 180.0 otherwise HTTP Error Code 400 for Bad Request will result. |
Response
Description
When Reverse Geocode returns results, it places entries within a location
array unless there aren’t any results in which case HTTP status 204 is returned. Please see the listing of Error Codes for additional details. The response includes at most a single location
element if an error does not occur.
-
location contains the following information:
-
city city name of the returned address.
-
coordinate contains the latitude and longitude value.
-
country The country name in long form. For example, "United States".
-
country_code The ISO 3166-1 three character country code. For example, "USA".
-
formatted_address The returned address formatted as a single line of text.For example, "25381 Alicia Pky, Laguna Hills, CA 92653, USA".
-
house_number The house number in the street. For example, "25381" in "25381 Alicia Pky".
-
postal The postal code.
-
state state name of the returned address.
-
street street name of the returned address.
-
type type of the returned address. The following values are supported:
-
airport
-
street
-
intersection
-
-
JSON
{
"locations" : [ {
"city" : "Laguna Hills",
"coordinate" : {
"latitude" : 33.5937,
"longitude" : -117.6978
},
"country_code" : "US",
"country" : "United States",
"formatted_address" : "Alicia Pkwy, Laguna Hills, CA 92653, United States",
"postal" : "92653",
"state" : "CA",
"street" : "Alicia Pkwy",
"type" : "street"
} ]
}