Geocoding API
What is Geocoding?
The Geocoding process matches addresses with geographic coordinates. Three major functions are supported by the Geocoding API: address (forward geocode), reverse, and batch. Requests can be submitted as Key-Value pairs, JSON, and XML.
Get StartedWhat it can do for you
Find a location near you
Display points of interest, addresses and location on a map within a location-based application — you have a retail location and you want your customers to be able to find it.
Address Verification
Help your delivery drivers find and verify an address, or make a business decision based upon the quality code of that address.
Mark your territory
Utilize geocoding to clearly delineate sales and delivery territories with ease.
You can map if you want to
Store geocode results and display them on a map from any provider, or choose to not display them on a map at all.
Key Features
Forward Geocoding
Find a lat/lng pair for a given address.
Reverse Geocoding
Find an address for a given lat/lng pair.
Batch Forward/Reverse Geocoding
Geocode up to 100 locations with a single batch call.
Extended Rights Geocoding (ERG)
Store and access your geocode results for future use.
Detailed Quality Codes
Know the accuracy of a geocode result on a granular level.
Thumbnail Ambiguity Maps
Ambiguity results can return a static map URL with a thumbnail image.
Reflected User-Provided Values
Add your own data to the location object with your request and receive it in the response.
Viewport Biasing
Specify specific bounding box coordinates.
Delimited File Output
Specify outFormat, and the API will return a delimited text file including a header row.
How it Looks
{
"info": {
"statuscode": 0,
"copyright": {
"text": "© 2017 MapQuest, Inc.",
"imageUrl": "http://api.mqcdn.com/res/mqlogo.gif",
"imageAltText": "© 2017 MapQuest, Inc."
},
"messages": []
},
"options": {
"maxResults": -1,
"thumbMaps": true,
"ignoreLatLngInput": false
},
"results": [
{
"providedLocation": {
"location": "Washington,DC"
},
"locations": [
{
"street": "",
"adminArea6": "",
"adminArea6Type": "Neighborhood",
"adminArea5": "Washington",
"adminArea5Type": "City",
"adminArea4": "District of Columbia",
"adminArea4Type": "County",
"adminArea3": "DC",
"adminArea3Type": "State",
"adminArea1": "US",
"adminArea1Type": "Country",
"postalCode": "",
"geocodeQualityCode": "A5XAX",
"geocodeQuality": "CITY",
"dragPoint": false,
"sideOfStreet": "N",
"linkId": "282772166",
"unknownInput": "",
"type": "s",
"latLng": {
"lat": 38.892062,
"lng": -77.019912
},
"displayLatLng": {
"lat": 38.892062,
"lng": -77.019912
}
}
]
}
]
}