The address locators available with the StreetMap Premium for ArcGIS Asia Pacific HERE 2018 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 levels of geocoding for individual countries.
The following levels of geocoding 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), IDN (Indonesia), IND (India), KHM (Cambodia), MAC (Macau), 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 now available in the Asia Pacific locators when using ArcGIS Server 10.5.1 or later with the appropriate Geocoding Patch. After publishing a country composite locator to ArcGIS Server 10.5.1 or later, 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 ArcGIS Locators provided for geocoding, you must install either ArcGIS Desktop or ArcGIS Server 10.5.1 or later. Esri strongly recommends that you install the the appropriate Geocoding Patch from Patches and Service Packs for StreetMap Premium for ArcGIS on the ArcGIS Enterprise website.
For details on publishing and using these address locators on ArcGIS Server, see the About publishing services in ArcGIS Server Help and Working with address locators and geocoding topics in ArcGIS Desktop Help.
NOTE: Creating geocoding services in ArcGIS Server with some of the larger 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.
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 ArcGIS Desktop Help.
The following address locators are available with the StreetMap Premium for ArcGIS Asia Pacific HERE 2018 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 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
When using a composite locator, this stores the name of the locator the address was matched to. 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.
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 XXX_PointAddress.loc file in a text editor (Notepad++ is recommended), change the following line from
GeometryFromDisplayFields = false
to
GeometryFromDisplayFields = true
and then save the file. However, to take advantage of this option, you must have ArcGIS Desktop or ArcGIS Server 10.5.1 or later installed.
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.