There are now two different sets of locators included in StreetMap Premium. The classic locators are the ones that have been included with StreetMap Premium over the last few years. The new locators are a new style of locators similar to the ones used for the ArcGIS Online World Geocoding Service. However, since StreetMap Premium utilizes primarily HERE data for the source of address data, and the ArcGIS Online World Geocoding Service utilizes HERE data plus other vendors or public sources of information, some countries' geocoding results may vary.
The classic address locators available with the StreetMap Premium for ArcGIS Asia Pacific 2019 Release 1 enhanced street dataset enable you to geocode and reverse geocode addresses in Asia Pacific. Individual address locators that are specific to Asia Pacific countries are available, as well as composite locators that support multiple geocoding match types for individual countries.
The following geocoding match types are supported in Asia Pacific, although some countries do not include all six standardized levels: PointAddress, StreetAddress, StreetName, PostalLocality, Postal, and AdminPlaces. These standardized levels are combined into a global composite locator for each country.
Individual and composite locators are available for the following 14 countries: AUS (Australia), BRN (Brunei Darussalam), GUM (Guam), HKG (Hong Kong-China), IDN (Indonesia), IND (India), KHM (Cambodia), MAC (Macau-China), MYS (Malaysia), NZL (New Zealand), PHL (Philippines), SGP (Singapore), THA (Thailand), and VNM (Vietnam). In addition to a global composite locator, some countries have a local composite when the local input mapping fields were able to be determined.
For more detail on the geocoding levels for each country, see the StreetMap Premium product coverage page.
Input mapping fields for addresses are standardized across the global composite locators and include the fields: Address, Postal, Neighborhood, City, Subregion, and Region; although some countries do not utilize all four administrative place fields as input:
These input mapping fields are localized for some countries in a local composite. For a list of these fields by country, see the localized input mapping fields.
Suggestions functionality is available in the Asia Pacific locators. After publishing a country composite locator to ArcGIS Server, you can consume the suggestions REST API in your own applications. If you are using individual locators, suggestions are enabled only in the StreetAddress, Postal, and AdminPlaces locators.
NOTE: To use the classic ArcGIS Locators provided for geocoding, you must install either ArcGIS Desktop or ArcGIS Server 10.6.1 or later or ArcGIS Pro 2.3.3 or later. Esri strongly recommends that you install the appropriate Patches from Patches and Service Packs for StreetMap Premium for ArcGIS on the ArcGIS Enterprise website.
For details on publishing and using these classic address locators, see the About publishing services in ArcGIS Server help, Working with address locators and geocoding topics in ArcMap help, and Geocode with StreetMap Premium classic locators in ArcGIS Pro in ArcGIS Pro help. If you wish to restrict use of a geocoding service to certain users within your organization, create a group in your Enterprise Portal. Then, publish a geocoding service and share the service only with that group. Remember to invite the designated users to the group.
NOTE: Creating geocoding services in ArcGIS Server with some of the larger classic StreetMap Premium locators can consume a significant amount of RAM on the ArcGIS Server machine. For example, on top of the RAM required to run ArcGIS Server (approximately 2 GB), you will need roughly an additional 2.8 GB of RAM per instance (SOC) to publish a geocoding service using the AUS composite locator. In addition, with all other things being equal, the use of a solid state drive (SSD) instead of a hard disk drive (HDD) will improve batch geocoding performance.
When you use ArcCatalog or ArcMap for geocoding, you can browse for any of these address locators. For details, see About managing address locators in ArcMap help.
The following classic address locators are available with the StreetMap Premium for ArcGIS Asia Pacific 2019 Release 1. For the values of XXX, see the countries list above:
Locator File Name | Locator Name | Description |
---|---|---|
XXX_PointAddress | Country Address Points Locator | Used for finding address locations in a country. Latitude/longitude coordinates are accurate to the address level. |
XXX_BuildingName | Country Building Name Locator | Used for finding building names in a country. Latitude/longitude coordinates are accurate to the building location level. Available in IND only. |
XXX_StreetAddress | Country Street Address Locator | Used for finding street addresses in a country (e.g., 414 Kent Street, Sydney, Australia). Latitude/longitude coordinates are accurate to the street level. |
XXX_StreetName | Country Street Name Locator | Used for finding street names in a country (e.g., Victoria Street, Wellington, New Zealand). Latitude/longitude coordinates represent the midpoint of the street segment. |
XXX_PostalLocality |
Country Postal Code by Locality Locator | Used for finding postal codes within a locality (e.g., 6000, Perth). Latitude/longitude coordinates represent the approximate centroid of the postal code area within the city. |
XXX_Postal | Country Postal Locator | Used for finding postal codes in a country (e.g., 111). Latitude/longitude coordinates represent the approximate centroid of the postal code. |
XXX_Zone | Country Zone Locator | Used for finding zones in a country written in Chinese or English (e.g., 尖沙咀東, Tsim Sha Tsui East). Latitude/longitude coordinates represent the centroid of the zone. Available in Hong Kong-China only. |
XXX_AdminPlaces | Country Administrative Places Centroid Locator | Used for finding administrative places in a country (e.g., Chennai, India). Latitude/longitude coordinates represent the centroid of the administrative place. |
XXX | Country Global Composite Locator | This composite locator for a country references one or more of the following individual locators in the following priority: PointAddress, StreetAddress, StreetName, PostalLocality, Postal, or AdminPlaces. Input mapping fields for addresses are standardized for all countries. |
XXX_LocalComposite | Country Local Composite Locator | This composite locator for a country references one or more of the following individual locators in the following priority: PointAddress, StreetAddress, StreetName, PostalLocality, Postal, or AdminPlaces. Input mapping fields for addresses are localized for the country. See the localized input mapping fields. |
The following File Output Field Definitions may be helpful:
Loc_name
For composite locators, this field lists the individual locator that geocoded each address. The standard locator names are: PointAddress, StreetAddress, StreetName, PostalLocality, Postal, and AdminPlaces. Additional possible locator names include: BuildingName (IND) and Zone (HKG).
Addr_type
The match type for an address. Possible values include:
Match_addr
The full matched address formatted in the local country address schema. This is the correct address format based on address standards for a country.
Status
Score
The score is a value assigned to all potential candidates of an address match. The match score is based on how well the locations found in the reference data matches with the address data being searched. A score can range from 0–100, 100 being a perfect match.
Side
For Point Address and Street Address locators, this field indicates which side of the street (L or R) the matched address falls on.
DisplayX / DisplayY
For the Point Address locator, these fields store the decimal degree coordinates for the parcel centroid associated with each address, as the geocoded point feature is located on the street segment near the main entrance to the property. For all other locators, the DISPLAYX and DISPLAYY output field values are the same as the X and Y output field values, respectively.
NOTE: Asia Pacific PointAddress locators provide the ability to change the default location of a matched address from the entry point on the street to the parcel centroid. To make this change, open the locator Properties in either ArcCatalog or ArcGIS Pro, and in the Geocoding options change 'Derive output geometry from display fields' to Yes. You can also make this change by opening the XXX_PointAddress.loc file in a text editor (Notepad++ is recommended), and changing the following line from
GeometryFromDisplayFields = false
to
GeometryFromDisplayFields = true
and saving the file. However, to take advantage of this option, you must have ArcGIS Desktop or ArcGIS Server 10.6.1 or later or ArcGIS Pro 2.3.3 or later installed with the appropriate Patches from Patches and Service Packs for StreetMap Premium for ArcGIS on the ArcGIS Enterprise website.
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 Find or findAddressCandidates methods. If the Location parameter is not passed in a request, then the value of Distance is zero.
For a more complete list of possible locator output fields, see the ArcGIS REST API: World Geocoding Service documentation. For information on how output fields are handled for the two participating streets in street intersection matches (Addr_type = StreetInt), see Output fields for StreetInt candidates, under the Responses from the service section in the Service Output topic.