Geocoding addresses

Geocoding is the process of connecting an address in your database to a location on a map.


How long it takes to geocode an address

When an address is submitted on your website or entered through your control panel, it will be sent immediately for geocoding. When address information is imported, it can take up to 48 hours to complete the geocoding process, depending on the number of addresses in the import. You can see the status of your geocoding in Settings > Database > Geocoding status.


Updating an address based on geocoding

Once an address is geocoded, it is connected to longitude and latitude points so that it can be placed on a map. Additionally, there may be differences between the address you provide and the one which is returned by our geocoding service. When that happens you will be able to choose which address to use. For example:

choosing a geocode address

I entered my work address as 1315 10, Sacramento, CA and the system suggested 1315 10th St, Sacramento, CA 95814.

When I click the "Use this address" button, the work address associated with my profile will be updated to the mappable address. 

If the original address is correct, no action is needed. As long as the address is geocoded, it will display on a map. 


Geocoding status vs. mappable status

Within the Settings section of the control panel, you can review both the geocoding status and the mappable status of your nation. Geocoding status shows how many addresses in the database have been connected to a point on a map. The mappable status shows how many primary addresses are mailable. A profile can have up to seven addresses and each profile is mapped to its primary address

Geocoding status is found at Settings > Database > Geocoding status.

Here you can see the geocoding status of every address in your people database. There will probably be more addresses listed in geocoding status than people in your database.

Geocode_status.png

Addresses: the total number of addresses connected to people in your nation. Each person can have up to seven addresses in his profile. 

XX geocoded: number of addresses that have been connected to a point on a map with geocoding. This means the address can at least be connected to a country.

XX ungeocodable: number of addresses that could not be placed on a map.

XX not geocoded: number of addresses waiting to be processed. When an address is submitted on your website or entered through your control panel, it will be sent immediately for geocoding. When address information is imported, it can take up to 48 hours to complete the geocoding process, depending on the number of addresses in the import. 

Mapping status can be found at Settings > Database > Mapping status.

Here you can see how many people are in your nation and whether or not these profiles are mailable. A person is mapped at her primary address and the information here is based on people who have mailable addresses.

Mapping_status.png

People: total number of people in your nation

Addresses mapped: number of people who can be sent postal mail. Links to a filter of people whose primary address is mailable. 

People who did not provide addresses: people who did not provide a mailable address

Addresses pending mapping results: number of people whose addresses are waiting to be processed through geocoding.

Addresses failed mapping: number of people who cannot be placed on a map. Since this is a count of people, the number is probably lower than the number of ungeocodable addresses in geocoding status. 

The above screenshots are from the same nation - there is a large discrepancy between the number of geocoded addresses and the number of addresses mapped. This is because most of the addresses in this nation were pulled from social media profiles - so they only include a city and state. Those addresses are not mailable and people who only have a social media address are included in the group of people who did not provide addresses. To find people with incomplete addresses, search for addresses that are not mailable. These are addresses that could not be mapped. 


Primary address HOWTO

Six addresses connected to a profile

If you’re unclear on how this feature works, please ask a question. If you would like to see changes to this feature, please submit a suggestion.