The geocoding service can find addresses, businesses, and places around the world. Address text can be converted to location candidates and a location can be converted into an address. The service provides suggested address candidates for partial address and place-name text. Many addresses can also be geocoded at one time with batch geocoding.
Key features
To get started using the service, you can do the following:
- Geocode addresses and find places around the world.
- Filter place search by category type.
- Return candidates in different languages and locales.
- Return candidates in a different spatial reference.
- Refine search by location, extent, city, and country code.
- Return specific data fields for each candidate.
- Limit the number of candidates returned.
- Return the rooftop or street location for PointAddress candidates.
- Specify the type of city name or street name to be included in output fields.
Access the services
To access the geocoding service you need the following:
- An ArcGIS Location Platform account or ArcGIS Online account.
- An access token (API key or OAuth 2.0) with the appropriate privilege.
Example
This example shows how to find the location of an address:
GET geocode-api.arcgis.com/arcgis/rest/services/World/GeocodeServer/findAddressCandidates?f=pjson&singleLine=1600 Pennsylvania Ave NW, DC&outFields=*&token=<ACCESS_TOKEN> HTTP/1.1
To see a live example, go to the Mapping APIs and location services guide.