Open topic with navigation

North American Address Locator

Service Name: TA_Address_NA

Description: The North American Address Locator enables you to geocode street addresses in North America. The locator is a composite geocoder that supports multiple levels of geocoding. The following levels of geocoding are supported in the USA: street address point, street address, ZIP Code, ZIP+4, and city/state. The following levels of geocoding are supported in Canada: street address, street name, postal code, and city/province.

The locator is based on Tele Atlas 2009 reference data for North America and is limited to the coverage for the United States and Canada.

The locator can be used to geocode and reverse geocode single addresses or batch geocode multiple addresses.

The data used in the service is in Geographic Coordinate System (GCS) WGS84.

Attribution: Copyright:© 2010 ESRI, TANA

Directory Size: 6.69 GB

Number of Files: 34

Technical Notes:

• Locators: The North American Address Locator is a composite locator that references nine locators. Each attribute listed below is in one or more of these locators as defined for the attribute below. For example, if you use the ZIP attribute, it will only be returned for the US_Zip4 or US_Zipcode locators. A valid result will not be returned in the response unless the specific locator for an attribute was used in the request. The nine locators are:
• US_RoofTop: Used for finding latitude and longitude of a U.S. building
• US_Streets: Used for finding street addresses in the U.S. (e.g., 380 New York Street, Redlands, California)
• US_ZIP4: Used for finding a U.S. ZIP+4 Code (e.g., 92373-8100)
• US_Zipcode: Used for finding a U.S. ZIP Code (e.g., 92373)
  
• US_CityState: Used for finding a U.S.city/state (e.g., Redlands, CA)
  
• CAN_Streets: Used for finding street addresses in Canada (e.g., 12 Concorde Place, Toronto, Ontario)
  
• CAN_StreetName: Used for finding a street name in Canada (Concorde Place, Toronto, Ontario)
• CAN_Postcode: Used for finding a postal code in Canada (M3C 3R8)
• CAN_CityProv: Used for finding a city/province in Canada (e.g., Calgary, Alberta)
• Candidate sorting: Candidate results are sorted using multiple fields in the following sequence:
  1. Locator Name (Loc_name): Sorted in order of individual locators in the composite locator with the most accurate locator first and the least accurate last. For U.S.: a) US_RoofTop, b) US_Streets, c) US_ZIP4, d) US_Zipcode, and e) US_CityState. For Canada: a) CAN_Streets, b) CAN_StreetName, c) CAN_Postcode, and d) CAN_CityProv.
  2. Match Score (Score): Beginning with full match of 100 and proceeding down to the minimum match score for each Loc_name.
• Shape: Geometry of the output
• Score: A value assigned to all potential candidates of an address match. The match score is based on how well the location found in the reference data matches with the address being searched.
• Side: The side of the street to which the candidate has been matched: Left (L) or Right (R).
• X: Longitude of candidate point.
• Y: Latitude of candidate point.
• LeftHNX: Prefix of house number for candidate address on left side of street. This includes any characters that precede the street number as well as any information to the left of a hyphen in the street number (e.g., for A100 Main Street or 200-100 Main Street, 'A' and '200' would be identified as LeftHNX).
• LeftFrom: Start of address range on left side of candidate street segment
• LeftTo: End of address range on left side of candidate street segment
• LeftHNS: Suffix of house number for candidate address on left side of street. This includes any characters that follow the street number as well as any information to the right of a hyphen in the street number (e.g., for 100B Main Street or 100-300 Main Street, 'B' and '300' would be identified as LeftHNS).
• RightHNX: Prefix of house number for candidate address on right side of street. This includes any characters that precede the street number as well as any information to the left of a hyphen in the street number (e.g., for A100 Main Street or 200-100 Main Street, 'A' and '200' would be identified as RightHNX).
• RightFrom: Start of address range on right side of candidate street segment
• RightTo: End of address range on right side of candidate street segment
• RightHNS: Suffix of house number for candidate address on right side of street. This includes any characters that follow the street number as well as any information to the right of a hyphen in the street number (e.g., for 100B Main Street or 100-300 Main Street, 'B' and '300' would be identified as RightHNS).
• PreDir: Prefix of N(orth), E(ast), S(outh) or W(est) that precedes the street name (e.g., for 123 N Main Street, 'N' is the PreDir).
  
• PreType: Includes tag words like Freeway, Fwy, Highway, Interstate,I, etc., which may precede a number in the StreetName field (e.g., for Interstate 10, the PreType field would contain 'Interstate' and the StreetName field would contain '10'). PreType may also include words like 'New' or 'Old' as in New Main Street or Old County Road.
• StreetName: The name of the candidate street
• StreetType: The type of street, such as, Avenue, Street, Boulevard, etc. 
• SufDir: Suffix of NE, NW, SE, or SW, which follows the street name (e.g., for 123 Main Street NE, 'NE' is the SufDir).
• LeftCity: The city to the left of the candidate street segment or address point. This field is used only for US_Streets or US_RoofTop. LeftCity will only be different from RightCity if the point falls directly on a city boundary.
• RightCity: The city to the right of the candidate street segment or address point. This field is used only for US_Streets or US_RoofTop. RightCity will only be different from LeftCity if the point falls directly on a city boundary.
• LeftState: The state to the left of the candidate street segment or address point. This field is used only for US_Streets or US_RoofTop. LeftState will only be different from RightState if the point falls directly on a state boundary.
• RightState: The state to the right of the candidate street segment or address point. This field is used only for US_Streets or US_RoofTop. RightState will only be different from LeftState if the point falls directly on a state boundary.
• LeftZIP: The ZIP Code to the left of the candidate street segment or address point. This field is used only for US_Streets or US_RoofTop. LeftZIP will only be different from RightZIP if the point falls directly on a ZIP Code boundary.
• RightZip: The ZIP Code to the right of the candidate street segment or address point. This field is used only for US_Streets or US_RoofTop. RightZIP will only be different from LeftZIP if the point falls directly on a ZIP Code boundary.
• Match_addr: The corresponding address in the reference data for the candidate point
  
• ZIP: ZIP Code for the candidate. This field is used only for US_Zip4 or US_Zipcode.
• ZIP4: ZIP4 of the candidate point. This field is used only for US_Zip4.
• Zip4_Type: The type of centroid identified by the US_Zip4 locator. Type 1 indicates a Zip+4 centroid (more accurate); Type 2 indicates a Zip+2 centroid (less accurate).
• City: Name of the candidate city. This field is used only for US_CityState or CAN_CityProv.
• State: Name of the candidate state. This field is used only for US_CityState.
• LeftProvince: The province to the left of the candidate street segment. This field is used only for CAN_Streets or CAN_StreetName. LeftProvince will only be different from RightProvince if the point falls directly on a province boundary.
• RightProvince: The province to the right of the candidate street segment. This field is used only for CAN_Streets or CAN_StreetName. RightProvince will only be different from LeftProvince if the point falls directly on a province boundary.
• LeftPostal: The postal code to the left of the candidate street segment. This field is used only for CAN_Streets or CAN_StreetName. LeftPostal will only be different from RightPostal if the point falls directly on a postal code boundary.
• RightPostal: The postal code to the right of the candidate street segment. This field is used only for CAN_Streets or CAN_StreetName. RightPostal will only be different from LeftPostal if the point falls directly on a postal code boundary.
• FSA: The Forward Sortation Area (first three characters of Canadian postal codes) of the candidate point. This field is used only for CAN_Postcode.
• Province: The province of the candidate point. This field is used only for CAN_CityProv.