Custom Preferences

Custom preferences supported by the Geocode Service are for use against any country dataset. Other custom fields that apply to certain countries are located in Custom Preferences and Fields.

To create a custom preference for a POST request, follow this code snippet.

"preferences" : {
            "customPreferences" : {
            "<YOUR_CUSTOM_PREFERENCE>" : "true"
            }


Parameter	Type	Description
POST: "clientLocale"	String	Specify the locale value. For example, specify "th" for the Thai language. Java API Example where xx = language value: setClientLocale(Locale.forLanguageTag("xx"))
POST: FALLBACK_TO_WORLD	String	When is installed, the geocoder specifies whether to use to determine a geocode when any of the following conditions exist: A country geocoder is not installed A country geocoder is installed without a geocoding dataset A street match with the country geocoder cannot be made may return either a postal or geographic geocode depending on the level of support in the dataset. Optional. true Use Geocoder for matching when a country geocoder is not installed, a country geocoder is installed without a geocoding dataset, or a street match with the country geocoder cannot be made. false Do not use Geocoder. Default. The customPreferences object is specified in the preferences object. see example at the top of this table.
POST: RETURN_PARSED_INPUT	String	The Parsed Input address displays the formatted input street address and each input address element in a separate field. This feature can help you understand how the input address was parsed by the geocoder and identify specific input elements that could not be geocoded. For example, a returned PARSED_INPUT_ADDRESS_NUMBER could contain an invalid house number in your input address. Optional. true Return parsed input address element in GeocodeServiceResponse object. false Do not return parsed input address element in GeocodeServiceResponse object. Default. The customPreferences object is specified in the preferences object. see example at the top of this table.
POST: SEARCH_WORLD_PLACES	String	This option specifies to only use the World Geocoder for geocoding. Regardless of any other configured data, if you have the World Geocoder configured and the fallbacks are set to true, you can use the custom preference "SEARCH_WORLD_PLACES" to geocode against just the World data. Optional. true Use only the World Geocoder for geocoding. This option ignores all other configured data. false Do not use only the World Geocoder for geocoding. Use other configured data. Default. The customPreferences object is specified in the preferences object. see example at the top of this table.
POST: USE_ADDRESS_POINT_INTERPOLATION	Boolean	Address point interpolation is a patented process that results in a more accurate interpolated point. It improves upon regular street segment interpolation by using point data in the interpolation process, as opposed to using street segments alone.
POST: KEY_CUSTOM_DICTIONARY_USAGE	String	possible values: PREFER_CUSTOM_DICTIONARIES, PREFER_STANDARD_DICTIONARIES, USE_CUSTOM_DICTIONARIES_ONLY, USE_STANDARD_DICTIONARIES_ONLY
POST: PREFER_POBOX_OVER_STREET	Boolean	For countries that support PO Box addresses, this preference allows you to prefer the PO Box match over the Street match.