FRAMES | NO FRAMES Description | Parameters | Examples | Response
Reverse Geocode (Operation)

This is an archive of a previous version of the ArcGIS REST API. The current version can be found at http://resources.arcgis.com/en/help/arcgis-rest-api/

URL http://<geocodeservice-url>/reverseGeocode
Parent Resource Geocode Service

Description

The reverseGeocode operation is performed on a geocode service resource. The result of this operation is a reverse geocoded address resource. This resource provides information about all the address fields pertaining to the reverse geocoded address as well as its exact location.

You can provide arguments to the reverseGeocode operation as query parameters defined in the parameters table below.

Parameters

Parameter Details
f Description: The response format. The default response format is html.

Values: html | json | kmz
location Description: The point at which to search for the closest address. The structure of the point is the same as the structure of the json point object returned by the ArcGIS REST API. In addition to the JSON structure, you can specify the location with a simpler comma-separated syntax.

Syntax:
  • JSON structure: location={point}
  • Simple syntax: location=<x>,<y>
Examples:
  • location={x: -122.4, y: 37.7}
  • location=-122.4,37.7
If not specified in the JSON object or if you are using the simple comma-separated syntax, the location is assumed to be in the same spatial reference as that of the geocode service.
distance Description: The distance in meters from the given location within which a matching address should be searched. If this parameter is not provided or an invalid value is provided, a default value of 0 meters is used.

Example: distance=100
outSR Description: The well-known ID of the spatial reference or a spatial reference json object for the returned address candidates. For a list of valid WKID values, see Projected coordinate Systems and Geographic coordinate Systems.
This parameter was added at 10.

Example Usage

Example 1: Reverse geocode based on a point:

http://sampleserver1.arcgisonline.com/ArcGIS/rest/services/Locators/ESRI_Geocode_USA/GeocodeServer/reverseGeocode?location=-117.195681386,34.057517097&distance=0

JSON Response Syntax

{
"address" : {
"<fieldName1>" : "<fieldValue1>",
"<fieldName2>" : "<fieldValue2>"
},
"location" : {
<point> }
}

JSON Response Example

{
"address" : {
"Street" : "771 TUNNEL AVE",
"Zone" : "94005"
},
"location" : { "x" : -122.400260954336, "y" : 37.7000445053795 }
}