Reverse Geocode

Title  Reverse Geocode

Summary

Geoprocessing tool that creates street or intersection addresses from point locations in a feature class.


Usage


Syntax

Parameter Explanation
in_features

A point feature class or layer from which addresses are returned based on the features' point location.

out_feature_class

The output feature class.

address_type (Optional)

Indicates whether to return addresses for the points as street addresses or intersection addresses if the address locator supports intersection matching.

  • ADDRESS—Returns street addresses or in the format defined by the input address locator. This is the default option.
  • INTERSECTION—Returns intersection addresses. This option is available if the address locator supports matching intersection addresses.
search_distance

The distance used to search for the nearest address or intersection for the point location. Some locators use optimized distance values that do not support overriding the search distance parameter.

feature_type (Optional)

Limits the possible match types returned. Single or multiple values can be selected. If a single value is selected, the search tolerance for the input feature type is 500 meters. If multiple values are included, the default search distances specified in the feature type hierarchy table are applied. See the REST API web help for more details about the featureTypes parameter for reverseGeocode.

This parameter is not supported for all locators.

  • POINT_ADDRESS—A street address based on points that represent house and building locations.
  • STREET_ADDRESS—A street address that differs from PointAddress because the house number is interpolated from a range of numbers. StreetAddress matches include the house number range for the matching street segment, rather than the interpolated house number value.
  • STREET_INTERSECTION—A street address consisting of a street intersection along with city and optional state and postal code information. This is derived from StreetAddress reference data, for example, Redlands Blvd & New York St, Redlands, CA, 92373.
  • LOCALITY—A place-name representing a populated place.
  • POSTAL—Postal code. Reference data is postal code points, for example, 90210 USA.
  • POINT_OF_INTEREST—Points of interest. Reference data consists of administrative division place-names, businesses, landmarks, and geographic features, for example, Starbucks.
location_type (Optional)

This parameter is available for locators that support the locationType parameter. It specifies the preferred output geometry for PointAddress matches. The options for this parameter are a side of street location, which can be used for routing, or the location that represents the rooftop or parcel centroid for the address. If the preferred location does not exist in the data, the default location will be returned instead. For geocode results with Addr_type=PointAddress, the X,Y attribute values describe the coordinates of the address along the street, while the DisplayX and DisplayY values describe the rooftop, or building centroid, coordinates. See the REST API web help for more details about thelocationType parameter for geocodeAddresses..

This parameter is not supported for all locators

  • ADDRESS_LOCATION—Returns geometry for geocode results that could represent an address location such as rooftop, building centroid, or front door.
  • ROUTING_LOCATION—Returns geometry for geocode results that represent a location close to the side of the street, which can be used for vehicle routing. This is the default.

Code Samples

ReverseGeocode example (Python window)

The following Python window script demonstrates how to use the ReverseGeocode function in immediate mode.


# Import system modules
import arcpy
arcpy.env.workspace = "C:/ArcTutor/Geocoding/atlanta.gdb"

# Set local variables:
input_feature_class = "geocode_result"
address_locator = "C:/ArcTutor/Geocoding/Atlanta.loc"
result_feature_class = "customers_with_address"

arcpy.ReverseGeocode_geocoding(input_feature_class, address_locator, 
                               result_feature_class, "ADDRESS", "100 Meters")

                    

Tags

Credits

Use limitations