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.
https://www.mapquestapi.com/geocoding/v1/reverse
Response Formats | JSON, XML, CSV |
---|---|
Authentication | Yes (Requires Key) |
Rate Limited | Yes |
The API Key, which is needed to make requests to MapQuest services.
The latitude,longitude of the point to reverse geocode.
location=40.039401,-76.307078
This parameter tells the service whether it should return a URL to a static map thumbnail image for a location being geocoded.
thumbMaps=false
Specifies the format of the response. Must be one of the following, if supplied:
outFormat=xml
Specifies the delimiter used in the csv response
delimiter=|
Returns the nearest cross streets (intersection) to the given points.
includeNearestIntersection=true
Returns speed limit and toll road data, if available.
includeRoadMetadata=true
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.
callback=reverseGeocodeResult
The provided location properties passed in the geocode request.
Returns the latitude/longitude for routing and is the nearest point on a road for the entrance.
Street address.
Neighborhood name.
City name.
County name.
State name.
Country name.
Postal code.
Type of location.
Returns speed limit and toll road data, when available.
Returns nearest intersection (street pair) to a given point.
Is location a drag point? This option only applies when
making a dragroute
call.
A lat/lng pair that can be helpful when showing this address as a Point of Interest.
The precision of the geocoded location.
Refer to the Geocode Quality reference page for more information.
The five character quality code for the precision of the geocoded location.
Refer to the Geocode Quality reference page for more information.
String that identifies the closest road to the address for routing purposes.
Specifies the side of street.
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
GET
https://www.mapquestapi.com/geocoding/v1/reverse?key=KEY&location=30.333472,-81.470448&includeRoadMetadata=true&includeNearestIntersection=true
{
"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,|¢er=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"