Back to Top

What's included in the geocoded results

The geocoded result includes output fields from the locator, plus original input address fields.

After a table of locations is geocoded, the output point layer contains a copy of the address fields from the address table. One purpose of carrying over the address fields is for rematching. The names of this set of address fields are prefixed with IN_, and the original fields from your table are prefixed with USER_ so that they are easy to differentiate. When an address is modified during rematching, the new address is saved in the IN_ fields rather than overwriting the original USER_ fields.

Note:
  • If you specify Location Only, Minimal, or Minimal and User Fields for the Output Fields parameter in any of the geoprocessing tools that geocodes a table (Geocode Addresses, Geocode File, or Geocode Locations From Table), only a subset of these fields are returned.
  • Location Only returns the Shape field plus the original field names from the input address table.
  • Minimal returns following fields that describe the location and how well it matches information in the locator in the geocode results: Shape, Status, Score, Match_type, Match_addr, and Addr_type. The original field names from the input address table are maintained.
  • Minimal and User Fields returns the original field names from the input address table, Minimal fields, plus user defined output fields.
  • If custom output fields were defined in the Create Locator tool when the locator was created, the custom output fields are included in the geocode result by default unless turned off on the Output fields page on the Locator Properties dialog box.

The following additional output fields in the geocoding results are dependent on the locator service or locator used:

Note:

If you are geocoding with a service that was created from a locator type that is deprecated in ArcGIS Pro, you will see output fields that differ from what is documented below.

  • Loc_name—The name of the locator used to return a match result. This field is available only if the locator used for matching the table is a composite locator.
    Note:

    The Loc_name field is used internally by ArcGIS software and is not intended for use by client applications.

  • Status—A code indicating whether the address was matched. This attribute has values as follows:
    • M—Matched. The address is matched.
    • U—Unmatched. The address is not matched.
    • T—Tied. The address has more than one candidate with the same best match score but at different locations.
  • Score—The match score of the candidate to which the address was matched. The score can be in a range of 0 to 100, in which 100 indicates the candidate is a perfect match.
  • Match_type—A code showing how an address was matched. You can group the results based on this attribute to show how the addresses were matched or use the grouping to select records for rematching.
    • A—Automatically matched or rematched.
    • M—Manually matched or unmatched. If the geocoded feature class is rematched, the field may have the code M when you manually match or unmatch.
    • PP—Pick by Point. The address was matched to the click point chosen by the user during the rematch process.
  • Match_addr—The address where the matched location actually resides based on the information of the matched candidate. For example, an input address of 123 Main St. N is matched to a candidate with the suffix direction NW, and all other components matched correctly. The Match_addr field contains 123 Main St. NW as the actual address that was matched.
  • LongLabel—A longer version of the Match_addr containing more administrative information.
  • ShortLabel—A shortened version of the Match_addr.
  • Addr_type—The geocoded address type. This attribute indicates the match level to which the address matched. You can study the accuracy of the matched addresses and pattern of the matches based on the values. Supported match levels vary in different countries. Possible values include the following:
    • Subaddress—A street address based on points that represent house and building subaddress locations. Typically, this is the most spatially accurate match level. The subaddress elements of unit type and unit identifier help to distinguish one subaddress within or between structures from another when several occur within the same feature or PointAddress location. Reference data contains address points or polygons with associated house numbers, street names, and subaddress elements, along with administrative divisions and optional postal code, for example, 3836 Emerald Ave., Suite C, La Verne, CA 91750. It's usually a precise location of the address.
    • PointAddress—A street address based on points that represent house and building locations. Reference data contains address points with associated house numbers and street names, along with administrative divisions and optional postal code. The X and Y and geometry output values for a PointAddress match represent the street entry location for the address; this is the location used for routing operations. The DisplayX and DisplayY values represent the rooftop or actual location of the address, for example, 380 New York St., Redlands, CA 92373.
    • Parcel—A plot of land that is considered real property and may include one or more homes or other structures. A parcel typically has an address and parcel identification number assigned to it, such as 17 011100120063.
    • StreetAddress—A street address that differs from PointAddress because the house number is interpolated from a range of numbers. Reference data contains street centerlines with house number ranges, along with administrative divisions and optional postal code information, for example, 647 Haight St., San Francisco, CA 94117.
    • StreetInt—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.
    • StreetAddressExt—An estimated street address match that is returned when parameter matchOutOfRange=true and the input house number exceeds the house number range for the matched street segment.
    • POI—Points of interest. Reference data consists of administrative division, place-names, businesses, landmarks, and geographic features, for example, Starbucks.
    • DistanceMarker—A street address that represents the linear distance along a street, typically in kilometers or miles, from a designated origin location, for example, Carr 682 KM 4, Barceloneta, 00617.
    • StreetMidBlock—The estimated midpoint of a range of house numbers along a street segment that correspond to a city block, for example, 100 Block of Grant Ave, Millville, New Jersey. The location returned for a StreetMidBlock match is more precise than that of a StreetName match, but less precise than a StreetAddress match. This is currently only functional for the United States.
    • StreetName—Similar to a street address but without the house number. Reference data contains street centerlines with associated street names (no numbered address ranges), along with administrative divisions and optional postal code, for example, W Olive Ave., Redlands, CA 92373.
    • PostalExt—A postal code with an additional extension, such as the United States Postal Service ZIP+4. Reference data is postal code points with extensions, for example, 90210-3841.
    • Postal—Postal code. Reference data is postal code points, for example, 90210 USA.
    • PostalLoc—A combination of postal code and city name. Reference data is typically a union of postal boundaries and administrative (locality) boundaries, for example, 7132 Frauenkirchen.
    • Locality—A place-name representing a populated place. The Type output field provides more detailed information about the type of populated place. Possible Type values for Locality matches include Block, Sector, Neighborhood, District, City, MetroArea, County, State or Province, Territory, Country, and Zone, for example, Bogotá, COL.
    • Feature—A geocoding result returned by a locator created with the Create Feature Locator tool. Examples of potential geocoding results can be unique features such as points of interest, tax parcels, census tracts, water meters, short place-names, cell towers, or alphanumeric strings used to identify locations, such as N1N115 represented in a feature class.
    • LatLong—An x,y coordinate pair. The LatLong addr_type is returned when an x,y coordinate pair, such as 117.155579,32.703761, is the search input.
    • XY—XY—The match based on the assumption that the first coordinate of the input is longitude and the second is latitude.
    • YX—YX—Returned as Addr_type for the candidate, which assumes that latitude is the first number in the input, followed by longitude.
    • MGRS—A Military Grid Reference System (MGRS) location, such as 46VFM5319397841.
    • USNG—A United States National Grid (USNG) location, such as 15TXN29753883. This Addr_type value is only returned when the USNG Coordinate System category is enabled in the Categories to support section of the Locator Properties dialog box or when the category parameter is set to USNG in a findAddressCandidates or geocodeAddresses request.
  • Type—The feature type for results returned by a search. The Type field only includes a value for candidates with Addr_type = POI or Locality, as an example, for Starbucks, Type = Coffee Shop.
  • PlaceName—The formal name of a geocode match candidate, for example, Paris or Starbucks.
  • Place_addr—The full street address of a place, including street, city, and region, for example, 275 Columbus Ave., New York, New York.
  • Phone—The primary phone number of a place. For other searches, such as address, intersection, and postal code, the field is empty, for example, Knott's Berry Farm, Phone = (714)220-5200.
  • URL—The URL of the primary website for a place. For other searches, such as address, intersection, and postal code, the field is empty, for example, the University of Georgia, URL = http://www.uga.edu/.
  • Rank—A numerical text value or floating-point value in a number field, depending on the locator that indicates the importance of a result relative to other results with the same name. For example, there are cities in France and Texas named Paris. Paris, France, has a greater population than Paris, Texas, so it has a higher rank. The smaller numbers represent higher-ranked features. Rank is used to sort results for ambiguous queries such as Lincoln, in which no additional information (state) is available. Rank values are based on population or feature type.
  • AddBldg—The name of a building, for example, Empire State Building.
  • AddNum—The alphanumeric value that represents the portion of an address typically known as a house number or building number, for example, in the address 380 New York Street, AddNum = 380. This value is returned for PointAddress and StreetAddress matches only.
  • AddNumFrom—A value representing the beginning number of a street address range. It is relative to direction of feature digitization and is not always the smallest number in the range. This value is provided for StreetAddress match results.
  • AddNumTo—A value representing the ending number of a street address range. It is relative to direction of feature digitization and is not always the largest number in the range. This value is provided for StreetAddress match results.
  • AddRange—The full address number range for the street segment that an address lies on, in the format AddNumFrom-AddNumTo. An example is the AddRange value for the street address 123 Main St. may be 101-199.
  • Side—The side of the street where an address resides relative to the direction of feature digitization. This value is not relative to the direction of travel along the street. This attribute can have one of the following values:
    • L—The address is matched to the left side of the street.
    • R—The address is matched to the right side of the street.
    • No value—The address is not matched, or the locator could not determine the side of the street.
  • StPreDir—An address element defining the direction of a street, which occurs before the primary street name, for example, North in North Main Street.
  • StPreType—An address element defining the leading type of a street, for example, the Spanish term Avenida in Avenida Central or the French term Rue in Rue Lapin.
  • StName—An address element defining the primary name of a street, for example, Main in North Main Street.
  • StType—An address element defining the trailing type of a street, for example, Street in Main Street.
  • StDir—An address element defining the direction of a street, which occurs after the primary street name, for example, North in Main Street North.
  • BldgName—The name or number of a building subunit, for example, A in Building A.
  • BldgType—The classification of a building subunit. Examples are building, hangar, and tower.
  • LevelType—The classification of a floor subunit. Examples are floor, level, department, and wing.
  • LevelName—The name or number of a floor subunit, for example, 3 in Level 3.
  • UnitType—The classification of a unit subunit. Examples are unit, apartment, flat, office, and suite.
  • UnitName—The name or number of a unit subunit, for example, 2B in Apartment 2B.
  • SubAddr—The full subunit value for a candidate with Addr_type = Subaddress, which includes <subunit type> + <subunit name>. For instance, if the subaddress candidate is an apartment unit, Subaddr = UnitType + UnitName. An example is Apt 2B. Reference data consists of point features with associated house number, street name, and subaddress elements, along with administrative divisions and optional postal code; for example, 3836 Emerald Ave., Suite C, La Verne, CA 91750.
  • StAddr—The street address of a place without a zone, such as city or state, for example, 275 Columbus Ave.
  • Block—The name of the block-level administrative division for a candidate. Block is the smallest administrative area for a country. It can be described as a subdivision of sector or neighborhood or a named city block. It is not commonly used.
  • Sector—The name of the sector-level administrative division for a candidate. Sector is a subdivision of neighborhood, district, or a collection of blocks. It is not commonly used.
  • Nbrhd—The name of the neighborhood-level administrative division for a candidate. Nbrhd is a subsection of a city or district. Little Italy is the name of a neighborhood in the city of San Diego, California.
  • District—The name of the district-level administrative division for a candidate, for example, a subdivision of city. Wilhelmsburg is a district in the city of Hamburg in Germany.
  • City—The name of the city-level administrative division for a candidate. City is a subdivision of a subregion or region, for example, Atlanta is a city within Fulton County in the state of Georgia.
  • MetroArea—The name of the metropolitan area-level administrative division for a candidate. An example is an urban area consisting of a large city and the smaller cities surrounding it. This can potentially intersect multiple subregions or regions. An example is the Kolkata Metropolitan Area in India.
  • Subregion—The name of the subregion-level administrative division for a candidate. Subregion is a subdivision of a region, such as a county within a state. For example, San Diego County is a subregion of the state of California.
  • Region—The name of the region-level administrative division for a candidate. This can be a subdivision of a country or territory. It is typically the largest administrative area for a country, such as state or province, if the Territory administrative division is not used.
  • RegionAbbr—Abbreviated region name. The RegionAbbr value for California is CA, which is a state in the United States of America.
  • Territory—The name of the territory-level administrative division for a candidate. An example is a subdivision of a country. It is not commonly used. The Sudeste macroregion of Brazil, which encompasses the states of Espírito Santo, Minas Gerais, Rio de Janeiro, and São Paulo, is an example.
  • Postal—An alphanumeric address element defining the primary postal code, for example, V7M 2B4 for a Canadian postal code and 92374 for a USA postal code.
  • PostalExt—An alphanumeric address element defining the postal code extension, for example, 8110 in USA postal code 92373-8110.
  • Country—A three-character code for a country, for example, United States of America = USA. A list of supported countries is available in Geocode data coverage for theArcGIS World Geocoding Service.
  • CountryCode—A three-character code for country; for example, Canada = CAN. A list of supported countries is available in Geocode data coverage for the ArcGIS World Geocoding Service. This field is the same as the Country output field, but is only returned by reverse geocoding.
  • CntryName—The full country name for an address candidate; for example, "日本" (Japan). The name may be in the same language as the input address, or in the language specified by the langCode parameter for the request. If the full country name is not available in the specified language, the primary language of the country that the address candidate is within is used. A list of supported languages is available in Geocode data coverage for the World Geocoding Service.
  • LangCode—A three-character language code, representing the language of the address, for example, ENG = English. See a list of codes.
  • Distance—The physical distance, in meters, from a candidate to a specified location. The Distance output value is calculated for each candidate when the Location input parameter is passed in a request using the findAddressCandidates REST operation. If the Location parameter is not passed in a request, the value of Distance is zero.
  • X—The primary x-coordinate of the matched address in the spatial reference of the locator. The x-coordinate is returned in spatial reference WGS84 (WKID 4326) by the ArcGIS World Geocoding Service.
  • Y—The primary y-coordinate of the matched address in the spatial reference of the locator. The y-coordinate is returned in spatial reference WGS84 (WKID 4326) by the ArcGIS World Geocoding Service.
  • DisplayX—The display x-coordinate of an address returned in the spatial reference of the locator. The display x-coordinate is returned in spatial reference WGS84 (WKID 4326) by the ArcGIS World Geocoding Service. For matches to PointAddress or Subddress as indicated in the Addr_type field and PointAddress role-based locators, this value represents the x-coordinate value of the building rooftop or parcel centroid for the address. It differs from the primary x-value, which represents the x-coordinate of the side of street location or the street entry for an address. However, there are exceptions, as some data sources used by the ArcGIS World Geocoding Service only provide the rooftop location of PointAddress and Subaddress features. In other cases, only the street-side location is available for some PointAddress and Subaddress features. For such cases, the X and DisplayX values are equivalent. For all other Addr_type matches and locators, this value is equal to the x-value.
  • DisplayY—The display y-coordinate of an address returned in the spatial reference of the locator. The display y-coordinate is returned in spatial reference WGS84 (WKID 4326) by the ArcGIS World Geocoding Service. For matches to PointAddress or Subddress as indicated in the Addr_type field and PointAddress role-based locators, this value represents the y-coordinate value of the building rooftop or parcel centroid for the address. It differs from the y-value, which is derived from a location along the street or the street entry for an address. However, there are exceptions, as some data sources used by the ArcGIS World Geocoding Service only provide the rooftop location of PointAddress and Subaddress features. In other cases, only the street-side location is available for some PointAddress and Subaddress features. For such cases, the Y and DisplayY values are equivalent. For all other Addr_type matches and locators, this value is equal to the y-value.
  • Xmin—The minimum x-coordinate for the display extent of a feature returned by the locator. The Xmin, Xmax, Ymin, and Ymax values can be combined to set the map extent for displaying a geocode result. The extent coordinates use the spatial reference of the locator but in spatial reference WGS84 (WKID 4326) by the ArcGIS World Geocoding Service.
  • Xmax—The maximum x-coordinate for the display extent of a feature returned by the locator. The Xmin, Xmax, Ymin, and Ymax values can be combined to set the map extent for displaying a geocode result. The extent coordinates use the spatial reference of the locator but in spatial reference WGS84 (WKID 4326) by the ArcGIS World Geocoding Service.
  • Ymin—The minimum y-coordinate for the display extent of a feature returned by the locator. The Xmin, Xmax, Ymin, and Ymax values can be combined to set the map extent for displaying a geocode result. The extent coordinates use the spatial reference of the locator but in spatial reference WGS84 (WKID 4326) by the ArcGIS World Geocoding Service.
  • Ymax—The maximum y-coordinate for the display extent of a feature returned by the locator. The Xmin, Xmax, Ymin, and Ymax values can be combined to set the map extent for displaying a geocode result. The extent coordinates use the spatial reference of the locator but in spatial reference WGS84 (WKID 4326) by the ArcGIS World Geocoding Service.
  • ExInfo—A collection of strings from the input that could not be matched to any part of an address and were used to score or penalize the result.

Feedback on this topic?