Tips for improving geocoding performance

You can tune geocoding performance by adjusting the number of CPUs used for geocoding, the number of candidates returned, and the number of suggestion candidates returned by your locator. The sections below will go into more detail on how to tune your locator to fit your performance needs.

Performance tab

Number of threads

It is recommended that you determine the number of cores that you can devote to a geocoding job available on the machine you will be using for geocoding. Geocoding can use all of the cores on your machine to complete a geocoding job more quickly. By default, this value is set to a smaller value that will work on any machine, regardless of the number of cores available, but it can be configured to use more cores if you know you have them available. It can be set to Auto to detect the cores and optimize the number used for your machine, or you can choose to devote a specified number of cores to geocoding if you know you need to leave some other resources available for other applications.


If you plan to share your locator to ArcGIS Enterprise, it is recommended that you set Number of threads to 4.

Maximum number of candidates

If you find that geocoding is taking a long time and you are also getting high-quality matches, ensure that the Maximum candidates property is not set too high. Assuming you are getting good results, performance can be improved by generating fewer results and focusing on the top few.

Default number of suggest candidates

Use this setting to increase or decrease the number of suggestions that are shown by default in ArcGIS clients. You can overwrite the value for locators that are published to ArcGIS Enterprise if you pass a different value for the maxSuggestions ArcGIS REST API parameter, but you are limited to the value set for Maximum number of suggest candidates.

Maximum number of suggest candidates

You can limit the number of suggestions that can be requested by a client when publishing a locator to ArcGIS Enterprise by setting this property to a smaller or larger value. Users can use the maxSuggestions ArcGIS REST API parameter to request more or fewer suggestions from the server, but this setting will limit the number that a user can request. Setting the value to a smaller number can help improve the amount of system resources that are used by the server and also the improve the performance that the suggestions are returned.

Improve batch geocoding performance

Use the following best practices to improve batch geocoding performance in a desktop environment:

  • Stay up to date with the latest version of ArcGIS Pro.
  • Use locators created with the Create Locator tool.
  • In most cases, it is recommended that you create a multirole locator over a composite locator. See Combine multiple data layers into a single locator for details about multirole locators.
  • Set the number of threads that the locator will use on the machine where the geocoding job will run.
    • Set Number of threads to Auto, which is one less than the number of cores on the machine.
  • Store the locator and the table to be geocoded on an SSD drive or the fastest drive on the system.

Related topics