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 Started

What 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
          },
          "mapUrl": "http://www.mapquestapi.com/staticmap/v4/getmap?key=KEY&type=map&size=225,160&pois=purple-1,38.892062,-77.019912,0,0,|&center=38.892062,-77.019912&zoom=12&rand=306744981"
        }
      ]
    }
  ]
}

Try it before you buy it. See our APIs in action and get a better understanding of what they can do for you.

Try It Out

Access everything you need to know about each of our APIs and SDKs. From response codes to release notes, it’s all here.

Documentation

Connect and collaborate with a community of developers who are all on the same topic.

Forum

One subscription for all your geospatial needs