Geocoding API

The reverse geocoding service allows a latitude and longitude to be converted to a location.

Note: For Reverse Geocode native language support to work, the client should pass a header parameter accept-language which takes ISO-2 country codes as its value with the request.

Resource URL

Resource Information

Request Parameters

• key required

  The API Key, which is needed to make requests to MapQuest services.

• location required

  The latitude,longitude of the point to reverse geocode.

  Example: latitude,longitude

  location=40.039401,-76.307078

• thumbMaps optional, defaults to true

  This parameter tells the service whether it should return a URL to a static map thumbnail image for a location being geocoded.

  • true: The response will include a URL to a static map image of the geocoded location.
  • false : The response will not include a static map image URL.

  Example: Disable Static Map Response

  thumbMaps=false

• outFormat optional, defaults to json

  Specifies the format of the response. Must be one of the following, if supplied:

  • json
  • xml
  • csv (character delimited)

  Example: XML response

  outFormat=xml

• delimiter optional, defaults to none, only in effect if outFormat=csv

  Specifies the delimiter used in the csv response

  • ,
  • |
  • :
  • ;

  Example: Pipe Delimiter

  delimiter=|

• includeNearestIntersection optional, defaults to false

  Returns the nearest cross streets (intersection) to the given points.

  • true: nearest intersection is returned.
  • false: nearest intersection is not returned.

  Example: Return Nearest Intersection

  includeNearestIntersection=true

• includeRoadMetadata optional, defaults to false

  Returns speed limit and toll road data, if available.

  • true: speed limit or toll road data is returned.
  • false: speed limit or toll road data is not returned.

  Example: Road Metadata

  includeRoadMetadata=true

• callback optional

  A JavaScript function name. The JSON-formatted response will be wrapped in a call to the supplied callback function name to provide JSONP functionality. This functionality might be needed to do cross-site scripting. See the Wikipedia.org entry for JSON for more details.

  Example: Callback

  callback=reverseGeocodeResult

Response Object

• providedLocation

  The provided location properties passed in the geocode request.

• latLng

  Returns the latitude/longitude for routing and is the nearest point on a road for the entrance.

• street

  Street address.

• adminArea6

  Neighborhood name.

• adminArea5

  City name.

• adminArea4

  County name.

• adminArea3

  State name.

• adminArea1

  Country name.

• postalCode

  Postal code.

• type

  Type of location.

  • 's' = stop (default)
  • 'v' = via

• roadMetadata

  Returns speed limit and toll road data, when available.

• nearestIntersection

  Returns nearest intersection (street pair) to a given point.

• dragPoint

  Is location a drag point? This option only applies when making a dragroute call.

  • true = location is a drag point
  • false = location is not a drag point (default)

• displayLatLng

  A lat/lng pair that can be helpful when showing this address as a Point of Interest.

• geocodeQuality

  The precision of the geocoded location.

  Refer to the Geocode Quality reference page for more information.

• geocodeQualityCode

  The five character quality code for the precision of the geocoded location.

  Refer to the Geocode Quality reference page for more information.

• linkId

  String that identifies the closest road to the address for routing purposes.

• sideOfStreet

  Specifies the side of street.

  • 'L' = left
  • 'R' = right
  • 'M' = mixed
  • 'N' = none (default)

• info

  This field contains information about the response.

  The statuscode subfield is an integer return value. Refer to the status codes page for more details about our status codes and error messages.

  The messages subfield is an array of error messages that describe the status

Try It Now

Example Request

Example Response

• JSON
• XML
• CSV

{
  "info": {
    "statuscode": 0,
    "copyright": {
      "text": "© 2023 MapQuest, Inc.",
      "imageUrl": "https://api.mqcdn.com/res/mqlogo.gif",
      "imageAltText": "© 2023 MapQuest, Inc."
    },
    "messages": []
  },
  "options": {
    "maxResults": 1,
    "thumbMaps": true,
    "ignoreLatLngInput": false
  },
  "results": [
    {
      "providedLocation": {
        "latLng": {
          "lat": 30.333472,
          "lng": -81.470448
        }
      },
      "locations": [
        {
          "street": "12714 Ashley Melisse Blvd",
          "adminArea6": "",
          "adminArea6Type": "Neighborhood",
          "adminArea5": "Jacksonville",
          "adminArea5Type": "City",
          "adminArea4": "Duval",
          "adminArea4Type": "County",
          "adminArea3": "FL",
          "adminArea3Type": "State",
          "adminArea1": "US",
          "adminArea1Type": "Country",
          "postalCode": "32225",
          "geocodeQualityCode": "L1AAA",
          "geocodeQuality": "ADDRESS",
          "dragPoint": false,
          "sideOfStreet": "R",
          "linkId": "0",
          "unknownInput": "",
          "type": "s",
          "latLng": {
            "lat": 30.33472,
            "lng": -81.470448
          },
          "displayLatLng": {
            "lat": 30.333472,
            "lng": -81.470448
          },
          "mapUrl": "https://www.mapquestapi.com/staticmap/v4/getmap?key=KEY&type=map&size=225,160&pois=purple-1,30.3334721,-81.4704483,0,0,|&center=30.3334721,-81.4704483&zoom=15&rand=-553163060",
          "nearestIntersection": {
            "streetDisplayName": "Posey Cir",
            "distanceMeters": "851755.1608527573",
            "latLng": {
              "longitude": -87.523761,
              "latitude": 35.013434
            },
            "label": "Danley Rd & Posey Cir"
          },
          "roadMetadata": {
            "speedLimitUnits": "mph",
            "tollRoad": null,
            "speedLimit": 40
          }
        }
      ]
    }
  ]
}

"Country","State","County","City","PostalCode","Street","Lat","Lng","DragPoint","LinkId","Type","GeocodeQualityCode","GeocodeQuality","SideOfStreet","DisplayLat","DisplayLng"
"US","FL","Duval","Jacksonville","32225","12714 Ashley Melisse Blvd","30.333472","-81.470448","false","0","s","L1AAA","ADDRESS","R","30.333472","-81.470448"