Geocoding Services

Geocoding services ("geocoders") convert between addresses and spatial data. Converting an address to spatial data enables the address to be shown on the map. This is called "forward geocoding". Converting from spatial data (a geographic location) to an address is called "reverse geocoding".

In order for a site's viewers to do operations that involve geocoding, you must configure at least one geocoding service in the site. Essentials supports unsecured and secured ArcGIS geocoding services, and the Bing Maps geocoding service.

About Configuration Settings for Geocoding Services

After you have added a geocoding service to a site, you might need to configure additional settings. This depends on what type of viewer you are using and which geocoding-dependent features you configure.

Additional geocoding service settings (other settings are omitted)

The settings are summarized in the table below. In the table, the geocoding service settings are identified by number. The numbers relate to the screen capture above.

To use the table, first look in the Feature column to find the feature that you want to configure. Now read across the row for that feature to find out which settings to configure. In addition to configuring the geocoding settings, you must configure the feature itself. Follow the link given in the Feature column to configure the feature.

The table uses the following values:

For information about what the individual settings do, see Configuration Settings for ArcGIS Geocoding Services and Configuration Settings for the Bing Maps Geocoding Service .

Geocoding Service Settings to Configure Geocoding Features

Feature

Global Search (text search)

See Search.

Yes

Yes

No effect

Optional

No effect

No effect

Batch Geocoding

See Configure a Batch Geocoder.

No effect

No effect

No effect

Optional

No effect

No effect

ArcGIS Geocoding Services

If you are using the HTML5 Viewer with a proxy page, you must register the geocoding service with the proxy. The enables the proxy to forward requests to the geocoding service. For instructions, see Set Up a Proxy Page.

Add an ArcGIS Geocoding Service

To add an ArcGIS geocoding service to a site:

  1. In Manager, edit the site that you want to configure, and then click GIS Services from the side panel.

  2. On the Geocoding tab, click Add Geocoding Service.

    The Geocoding Service Wizard opens.

  3. With ArcGIS Geocoding Service selected, click Next.

  4. Type a Display Name for the geocoding service.

    Choose a display name that end users understand.

  5. Click Next.

  6. Type in the URL of the ArcGIS REST services endpoint. By default, this is:

    http://[server.domain.com]/ArcGIS/rest/services

    where [server.domain.com] is the fully qualified host where the service is located.

    Essentials supports the ArcGIS Online World Geocoding Service. The URL is:

    http://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer

  7. Click Next.

    Manager discovers the geocoding services at the specified URL.

  8. Click Finish.

    The wizard closes and the Edit Geocoding Service page for the new geocoding service opens.

  9. Click Save Site.

Configuration Settings for ArcGIS Geocoding Services

ArcGIS geocoding services have the following settings:

See also...

About Configuration Settings for Geocoding Services

Configure an ArcGIS Geocoding Service

When you add an ArcGIS geocoding service to a site, the wizard prompts you to configure the Display Name and Service URL settings. Instructions for changing the Display Name and URL are given below.

Depending on which features you configure that use the geocoding service, you might need to configure additional settings after the wizard has completed. For information about which settings to configure, see About Configuration Settings for Geocoding Services.

Additional settings for ArcGIS geocoding services

To configure an ArcGIS geocoding service:

  1. In Manager, edit the site that you want to configure, and then click GIS Services from the side panel.

  2. On the Geocoding tab, click the Edit icon beside the geocoding service that you want to edit.

  3. In the Display Name box, change the geocoding service's name if you want.

    Choose a display name that end users understand.

  4. In the Service URL box, change the geocoding service's URL if you want. Use a fully qualified URL.

    If you use a proxy page, update the geocoding service's URL in the proxy.config file.

    Manager will connect to the URL. If the geocoding service's Address Fields are different than the Address Fields at the previous URL, Manager highlights the fields that do not exist at the current URL. You can remove the highlighted fields by clicking the Remove icon beside each field.

    Fields that are not present at the updated URL are highlighted

  5. If you want to make this geocoder the default for batch geocoding, select Default Batch Geocoder. This setting only applies to one geocoder at any time.

  6. If you want to make this geocoder the default for reverse geocoding, select Default Reverse Geocoder. Reverse geocoding is the process of determining the address of a given map point. This setting only applies to one geocoder at any time.

  7. Select an Authentication Method to access the geocoder.

  8. If you want to use this geocoding service in Global Search, select the Include in Global Search checkbox and then select the attribute to search on from the Global Search Key drop-down list.

  9. Fill in the desired search parameters in the table.

    For detailed information about the settings on the Edit Geocoding Service page, see About Configuration Settings for Geocoding Services.

  10. Click Apply Changes.

The Bing Maps Geocoding Service

If you are using the HTML5 Viewer with a proxy page, you must register the geocoding service with the proxy. The enables the proxy to forward requests to the geocoding service. For instructions, see Set Up a Proxy Page.

Add a Bing Maps Geocoding Service

To add a Bing Maps geocoding service to a site:

  1. In Manager, edit the site that you want to configure, and then click GIS Services from the side panel.

  2. On the Geocoding tab, click Add Geocoding Service.

    The Geocoding Service Wizard opens.

  3. Select Bing Geocoding Service, and then Next.

  4. Type a Display Name for the geocoding service.

    Choose a display name that end users understand.

  5. Click Next.

  6. Enter your Bing Maps key in the Bing Maps Key text field.

    To obtain a key or to learn more about Bing Maps, see Getting a Bing Maps Key in the Microsoft documentation.

  7. Click Finish.

    Manager validates the Bing Maps Key. If it returns as invalid, re-enter the key. The geocoding service is not be added to the site if the key is not valid.

    When the key validates, the wizard closes and the Edit Geocoding Service page opens.

Configuration Settings for the Bing Maps Geocoding Service

The Bing Maps geocoding service has the following settings:

See also...

About Configuration Settings for Geocoding Services

Configure a Bing Maps Geocoding Service

When you add a Bing Maps geocoding service to a site, the wizard prompts you to configure a display name and specify the Bing Maps Key.

You can also set a culture to attach to geocoding requests. The Bing Maps geocoding service uses the culture to translate and prioritize the results it returns. For information, refer to the Microsoft documentation on the Culture Parameter.

Instructions on configuring the display name, service URL, key, and culture are given below.

Depending on which features you configure that use the geocoding service, you might need to configure additional settings.

Additional settings for the Bing Maps geocoding service

The HTML5 Viewer only uses geocoding services for Global Search. To enable Global Search, add a geocoding service to your site. No additional configuration is required.

To configure the Bing Maps geocoding service:

  1. In Manager, edit the site that you want to configure, and then click GIS Services from the side panel.

  2. On the Geocoding tab, click the Edit icon beside the geocoding service that you want to configure.

  3. In the Display Name box, change the geocoding service's name if you want.

    Choose a display name that end users understand.

  4. In the Service URL box, type or paste the URL for the Bing Maps geocoding service that you are using.

    You only need to configure the URL if you are hosting the Bing Maps geocoding service, or you want to enforce the use of SSL with the public Bing Maps service.

  5. If you want to use this geocoding service in Global Search, select the Include in Global Search checkbox.

    and then select the attribute to search on from the Global Search Key drop-down list.

  6. In the Bing Maps Key box, change the key if you want.

    Manager will verify the key when you apply the changes.

  7. Enter a culture code if you want.

    For information, refer to the Microsoft documentation on Supported Culture Codes.

  8. Browse for an Icon URI to configure a custom icon for the geocoding service if you want.

    The HTML5 Viewer does not use the remaining settings.

  9. Click Apply Changes.

Remove a Geocoding Service

If you use a proxy page, you may want to remove the geocoding service from the proxy.config file after you have removed it form the site.

To remove a geocoding service:

  1. In Manager, edit the site that you want to configure, and then click GIS Services from the side panel.

  2. On the Geocoding tab, click the Remove icon next to the geocoding service that you want to delete.

    You are prompted to confirm the deletion.

  3. Click OK.

Troubleshooting Geocoders

Limit the Geographic Area

Some geocoding services may not be able to find addresses unless you specify the geographic area to geocode within. If you find that features that do forward geocoding do not return the results you expect, try configuring the Value setting for one or more parameters.

The Configuring Value settings for a geocoding service's parameters affects all the configured features that use this service to do forward geocoding—the values are sent to the geocoding service as part of the geocoding request.

To specify the geographic area for forward geocoding:

  1. In Manager, edit the site that you want to configure, and then click GIS Services from the side panel.

  2. On the Geocoding tab, click the Edit icon next to the geocoding service that you want to configure.

  3. Enter values for one or more of the parameters in the parameter's Value text field.

    For example, in the screen capture below, the City and State are specified.

    Specify the area to geocode within

  4. Click Apply Changes.

Use the Geocoding Service's Fully Qualified URL

Make sure you have configured the geocoding service's fully qualified URL. To check, edit the geocoding service's Service URL text field. Note that the Service URL box is blank for public Bing Maps geocoding services. In this case, Essentials provides the URL.

Register the Geocoding Service with an HTML5 Viewer Proxy Page

If you are using the HTML5 Viewer with a proxy page, you must register the geocoding service with the proxy. The enables the proxy to forward requests to the geocoding service. For instructions, see Set Up a Proxy Page.