➡️ reverseGeocode-spec
GET https://{{geocode-service}}.arcgis.com/arcgis/rest/services/World/GeocodeServer/reverseGeocode
The reverseGeocode operation determines the address at a particular x/y location. You pass the coordinates of a point location to the ArcGIS World Geocoding Service, and the service returns the address or place that is closest to the location.
📄 API reference: reverseGeocode operation.
📄 Errors: geocoding error codes.
📄 Language codes: langCode.
📙 Related guides: Reverse geocoding.
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
token | string | (Required on Platform) You need a valid access token. To learn more, read the collection's documentation. | |
f | string | (Required) Format of the response: json, pjson, html, ... | |
location | string | (Required) The point from which to search for the closest address. The point can be represented as a simple, comma-separated syntax (long, lat) or as a JSON point object. | |
outSR | string | The spatial reference of the x/y coordinates returned by a geocode request. This is useful for applications using a map with a spatial reference different than that of the geocode service. | |
langCode | string | Sets the language in which reverse-geocoded addresses are returned. Addresses in many countries are available in more than one language; in these cases the langCode parameter can be used to specify which language should be used for addresses returned by the reverseGeocode operation. This is useful for ensuring that addresses are returned in the expected language. For example, a web application could be designed to get the browser language and pass it as the langCode parameter value in a reverseGeocode request. | |
forStorage | string | Specifies whether the results of the operation will be persisted. The default value is false, which indicates the results of the operation can't be stored, but they can be temporarily displayed on a map, for instance. If you store the results, in a database, for example, you need to set this parameter to true. | |
featureType | string | Limits the possible match types returned by the reverseGeocode operation. Valid values are listed in the feature type hierarchy table. Single or multiple values can be included in the request. If a single value is included then the search tolerance for the input feature type is 500 meters. If multiple values are included then the default search distances specified in the feature type hierarchy table are applied. | |
returnIntersection | string | (Deprecated). This parameter is only included for backwards compatibility. The new featureTypes parameter should be used instead of returnIntersection. Specifically, if you want to return the nearest street intersection to the input location, pass featureTypes=StreetInt in the reverseGeocode request. | |
locationType | string | Specifies if the output geometry of PointAddress and Subaddress matches should be the rooftop point or street entrance location. Valid values are rooftop and street. The default value is rooftop. | |
preferredLabelValues | string | Allows simple configuration of output fields returned in a response from the ArcGIS World Geocoding Service by specifying which address component values should be included in output fields. Supports a single value as input. If the parameter is blank or excluded from a request then default address label formats will be used. |