Additional tuning options

Some locator properties do not directly contribute to increased quality or performance in geocoding but may still be useful for customizing geocoding abilities of locators for your specific use case. If the default settings of a locator do not meet your geocoding needs, some of the additional properties in Geocoding options may help.

Geocoding options

Preferred city name

The default city name value that is returned by the locator is configured differently for each country based on local knowledge. If you want a different city name value to be returned by default, you can use this option to overwrite the default value with one of the values defined below. If that city value does not exist in the data, the default city value for that country will be returned instead.

Note:

Not all addresses have postal city and local city values assigned to them. If the requested preferred city does not exist in the data, a different city value is returned based on default address formats.

Caution:

The Preferred city name property only applies to the new locators included with ArcGIS StreetMap Premium and multirole locators that contain the Postal role, which has the city name attached to the postal code.

As defined for the country

Keep this option selected to return the default city name defined for the country. For example, cities in the United States are returned using the postal city name by default.

Postal city name

Select this option to return the primary postal city name even if it's different from the city name entered in the search. The postal city name is the primary name assigned to the postal code of the address. For example, the 45420 postal code in Ohio has a primary postal city value of Dayton. Addresses in the city of Kettering are assigned this postal code, which means that searches for addresses in Kettering are returned as Dayton addresses. If this option is selected and an organization member searches for 2109 E Dorothy Ln, Kettering, OH, 45420, the match label returned is 2109 E Dorothy Ln, Dayton, Ohio, 45420, even though the address is within the Kettering city limits.

Local city name

Select this option to return the locally known city name even if it's different from the city name entered in the search. The local city name is the name of the city in which the address is located and may be different from the postal city. For example, if this option is selected, a search for 2109 E Dorothy Ln, Dayton, OH, 45420—an address in Kettering, Ohio—returns the match label of 2109 E. Dorothy Ln, Kettering, Ohio, 45420, even though Dayton is included in the search string and the postal code that is entered has a postal city value of Dayton.

Matched city name

Select this option to return the matched city name value when the city name entered in a search matches any of the local city name or postal city name values.

Preferred street name

The default street name value returned by the locator is the value that is matched to in the data. This option allows you to overwrite the default so that the primary street name is always returned instead of the matched street name.

As defined for the country

Keep this option selected to return the default street name. The default street name is the matched street name.

Matched street name

Select this option to return the matched street name value when the street name that is entered in a search matches any of the supported street names assigned to an address.

Primary street name

Select this option to return the primary street name even if it's different from the alternate street name entered in the search. The primary street name is the primary name assigned to a street. For example, if this option is selected, a search for CA-138, Pearblossom, CA returns the match label of Pearblossom Hwy, Pearblossom, California, 93553.