Reverse Geocode


The Reverse Geocode API is used to obtain an address from a latitude and longitude.


Required Parameters



Your Location Studio API Key



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.



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


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