A point converted to the closest address using the geocoding service.
What is reverse geocoding?
Reverse geocoding is the process of converting a point to an address or place. For example, you can convert -79.3871 longitude and 43.6426 latitude to "CN Tower, 301 Front St W, Toronto, Ontario, M5V, CAN".
You can use reverse geocoding to:
- Get the nearest address to your current location.
- Show an address or place name when you tap on a map.
- Find the address for a geographic location.
How reverse geocoding works
You can find an address for a location by making an HTTPS request to the geocoding service reverse
operation or by using client APIs. Specify the location and optionally, additional parameters to enhance the search.
To refine the search, you can specify a feature type to return a specific type of address such as only POIs or addresses. You can also specify whether to return a street address or rooftop location.
The geocoding service uses the location and all parameters to return a single address that is the closest match. This address contains a number of attributes such as the place name, full address, city, region, and location.
If there are no streets near the input location, then large areal features such as parks, universities, zoos, or airports may be returned.
URL request
https://geocode-api.arcgis.com/arcgis/rest/services/World/GeocodeServer/reverseGeocode?location={point}&f=json&token=<ACCESS_TOKEN>
Required parameters
Name | Description | Examples |
---|---|---|
f | The format of the data returned. | f=json f=pjson |
token | An API key or OAuth 2.0 access token. | token= |
Key parameters
Name | Description | Example |
---|---|---|
location | The location to search. | location=-79.3871,43.6426 location={x |
Additional parameters: Refine the search and enhance the return values by using parameters such as feature
, location
, and return
. Use lang
to return results in a specific language.
Code examples
Find an address near a location
This example finds the closest address to a point location when you click on the map.
-
Reference the geocoding service.
-
Set the location to a point.
-
Set the API key.
The response is a street address or a place with an address nearest to the point location. To get the full address use Long
and Place
to get the name if a POI is returned. Most APIs provide a LocatorTask to access the service.
Find the closest address to a point location
APIs
const geocodingServiceUrl = "https://geocode-api.arcgis.com/arcgis/rest/services/World/GeocodeServer" ;
const params = {
location: pt
};
locator.locationToAddress(geocodingServiceUrl, params).then(
(response) => {
if (response) {
showPopup(response);
}
},
(err) => {
showPopup("No address found.", pt);
}
);
REST API
curl https://geocode-api.arcgis.com/arcgis/rest/services/World/GeocodeServer/reverseGeocode \
-d 'f=pjson' \
-d 'location=-79.3871,43.6426' \
-d 'token=<ACCESS_TOKEN>'
Tutorials
Reverse geocode
Get an address, business, or place from coordinates with the geocoding service.
Display your location
Find and track your device location on a map.