Configuring a geocoding provider

Configure a geocoding provider if you want to use geocoding when you add new items to the map in the Operations view. For example, you can use geocoding to determine a location for a specified address. You can also use reverse geocoding to determine a street address for a location that you specify in coordinates. Currently, Esri is the only supported geocoding provider.

About this task

To configure a geocoding provider, you must configure the following system properties:
GeocodingAccountUser
The user name that is associated with geocoding requests. If your geocoding provider is Esri, set the user name to your client ID.
GeocodingAccountPassword
The base 64 encoded version of the password to use with the user name that you specified in GeocodingAccountUser. If your geocoding provider is Esri, enter the base 64 encoded version of your client secret.
GeocodingProvider
The name of the geocoding provider to use. If you do not specify a value, the corresponding address fields are not displayed in the Add New Item window.
GeocodingProviderBaseURL
The geocoding provider service address.
GeocodingFieldDefaults
A list of default values that autopopulate the corresponding address fields if you display the Add New Item window on the List tab. For example, enter values that you might reuse many times to create data items that are in your area: '{"city":"Dublin","region":"","postalCode":"Dublin 16","country":"Ireland"}'
If you provide values for both GeocodingAccountUser and GeocodingAccountPassword, the geocoding request uses those values. If the values that you provide are invalid, the geocoding request fails. If you do not provide values, the solution attempts to connect without them.

Procedure

  1. In the navigation menu, click Administration > System Administration > System Properties.
  2. Configure the GeocodingProvider system property with the value ESRI.
  3. Configure the GeocodingProviderBaseURL system property with a value similar to the following URL: 
    http://YOUR ESRI GEOCODING SERVER HOSTNAME/arcgis/rest/services/World/GeocodeServer
  4. Optional: Configure the GeocodingFieldDefaults system property with relevant values. Format the values as shown in the following example: '{"city":"Minneapolis","region":"","postalCode":"55401","country":"USA"}'.

What to do next

Import the SSL certificate for your geocoding server into the Liberty default keystore.