Geocoding

Geocoding is the process of assigning a location, usually in the form of coordinate values, to an address by comparing the descriptive location elements in the address to those present in the reference material. Addresses come in many forms, ranging from the common address format of house number followed by the street name and succeeding information to other location descriptions such as postal zone or census tract. An address includes any type of information that distinguishes a place.

You can perform geocoding-related operations in GeoAnalytics Engine using the Geocode or Reverse Geocode tools which are detailed below.

Geocoding with GeoAnalytics Engine requires the geoanalytics-natives jar. See the Install and set up documentation for more information on how to install this jar to your environment.

Locators

Geocoding requires a locator. A locator contains a snapshot of the reference data that is used in geocoding operations. The results of geocoding can be used to perform spatial and tabular analysis to help you make specific decisions based on your needs.

Locators in GeoAnalytics Engine

A locator is required to run the Geocode and Reverse Geocode tools. You can load a locator in the Geocode or Reverse Geocode tools with either of the following options:

• Specify the file path of the locator (.loc) data in .setLocator(). The .loz file needs to be in the same directory as the .loc file.
• Specify the file path of a mobile map package (.mmpk) in .setLocator(). The locator data stored in the mobile map package is automatically detected and used in geocoding operations.

The locator must be locally accessible to all nodes in your Spark cluster.

For more information, see Locator and network dataset setup.

You can build your own locator if you want to collect and manage your own assets and address data. This is a flexible option to set up geocoding in a way that aligns with your search patterns and needs. You can build your own locator using an application like ArcGIS Pro, to learn more see Introduction to custom locators. You can also license commercially available locator files, for instance, Esri’s ArcGIS StreetMap Premium.

How Geocode works

Geocoding is the process of converting addresses into geographic coordinates that you can use to perform further analysis. The Geocode tool in GeoAnalytics Engine geocodes string values of addresses in a Spark DataFrame. This DataFrame can be created from a table (stored in a data format that is supported by Spark) that contains one or more fields specifying the address you want to geocode. The tool also requires an address locator. This tool matches the stored addresses against the locator and saves the result of each input record in an output DataFrame which contains the result columns and the input columns. The geocode process is distributed across the nodes in your Spark cluster and will be more performant with more cores.

Use cases

The following examples describe how the Geocode tool can be used for various goals:

• As a retail lead, you can geocode consumer addresses in transaction data to identify trends and propose new store locations.
• As an insurance analyst, you can detect fraudulent insurance claims by looking at the spatial relationship of geocoded property addresses and disaster footprints.
• As a property specialist, you can geocode addresses of unclaimed or abandoned houses.

For more information about how to use Geocode, see the tool documentation.

How Reverse Geocode works

Reverse geocoding is the process of converting a location as described by geographic coordinates to a readable address. The Reverse Geocode tool in GeoAnalytics Engine creates addresses from point geometries in a Spark DataFrame and returns them as string values.

The reverse geocode process is distributed across the nodes in your Spark cluster and will be more performant with more cores.

Use cases

• In the delivery tracking field, truck coordinates can be translated into addresses and matched with an expected delivery address to confirm arrival.
• The coordinates of city buses, trains, or other public transportation vehicles can be turned into addresses in order to communicate a vehicle's location quickly to riders, employees, and emergency services.
• In online retail, reverse geocoding the coordinates of a customer's location can allow you to automatically display the local currency and make location-based recommendations.

For more information about how to use Reverse Geocode, see the tool documentation.