Geocoding Jobs

Geocoding is the process of mapping a street address or other POI description to a latitude/longitude pair. A Geocoding Job is a Resource in the Console that manages the process of geocoding a file with addresses.

Lifecycle

Currently, a Geocoding Job can only be created indirectly by uploading a file of type Addresses to a new or existing Footfall Property.

A Geocoding Job may consist of many Geocoding Attempts, where each Attempt represents an attempt to geocode a particular file. When an address file is uploaded to a Footfall Property, a new Geocoding Job is created and its first attempt is also created inside it.

Fixing Problems

Geocoding Attempts may finish with a status of ✅ Succeeded, ⚠️ Warning, or❗Failed. When an Attempt finishes, the results of the attempt are split into 3 result files:

• Success - contains the rows that were successfully mapped, with a latitude and longitude column appended
• Missed - contains the original rows that were not successfully mapped
• Failed - contains rows that were otherwise malformed

It often happens that a particular address will not be found, in which case the Attempt will end with a Warning status, and the parent Geocoding Job will still be in the 🔄 In Progress state. In this case, the user should:

• download the Missed file
• tweak the addresses if necessary
• reupload only the locations that are missed

Completion

When a Geocoding Job is created through Footfall Properties, there is an option to automatically mark the Job as Complete

• If true, the Geocoding Job will be marked complete when any child attempt fully Succeeds
• If false, the Geocoding Job must be manually marked complete

🚧

Footfall Waits Until Complete

A Geocoding Job will not be used in a Footfall Property until it is marked complete, either automatically or manually.

Manual Completion

To mark an In Progress job as complete:

• Click the three-button menu
• Click Mark Job as Complete