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 Status 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

Toggle JSON Response

{
  "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"
  } ]
}