The North American Address Locator (TA_Address_NA) 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. See Using free geocoding tools on the task server for the URL to use the service in ArcGIS Desktop or ArcGIS Server and to learn more about using tasks in your ArcGIS application, or see Using the World Geocoding subscription if you're using the service for external commercial use or for more than 1,000 batch geocodes in a year.
The locator is based on Tele Atlas 2008 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.
The locator is not intended to support batch geocode requests. You may use this free service to test limited batch geocode requests of up to 1,000 addresses per year. The locator will batch geocode up to 10 addresses per request.
If you would like to batch geocode large numbers of addresses, you may subscribe to World Geocoding for ArcGIS Desktop and ArcGIS Server users for this purpose. This subscription will provide you access to an additional North American Address Locator (TA_BatchAddress_NA) specifically intended for batch geocoding. TA_BatchAddress_NA will support batch geocoding several thousand addresses in a single job with up to 100 addresses per request.
Technical Notes:
- Batch Geocoding: To improve reliability when using the North American Address Locator (TA_BatchAddress_NA) batch geocoding service described above, please batch geocode files of less than 25,000 addresses per job. If you have more addresses than this, and you have subscribed to batch geocode larger volumes (e.g., 100,000 batch geocodes), then you should divide the total number of addresses to be geocoded into multiple files of 25,000 addresses each before submitting them to be geocoded.
-
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)
- US_RoofTop: Used for finding latitude and longitude of a U.S. building
-
Candidate sorting: Candidate results are sorted using multiple fields in the following sequence:
- 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.
- Match Score (Score): Beginning with full match of 100 and proceeding down to the minimum match score for each Loc_name.
- 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.
- 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.