How To Geocode Members - Sync Members with Google Maps

Link: https://support.brilliantdirectories.com/support/solutions/articles/12000044148

The final and equally important step required for completing the importing process is Geocoding all of the recently imported listings. This way, the listing will become searchable by location using their address information. 


Our location search engine is a Google Maps integration that needs to assign latitude and longitude information based on the location data imported in the CSV file. The Geo-coding tool will perform a search of the member's location data in the Google Maps search engine, based on the information available, the system will assign the most approximate coordinates to the listing. 


Keep in mind that the accuracy of the member's location will depend on the amount of location information available in the import feed. For example, if a listing was only imported with vague location data like state and city, the system will place them in the geographic center of that city or state. On the other hand, if the member has a recognized and specific street address and zip code, the Google Maps search engine will be able to assign a more accurate set of coordinate data. 


Important Note: Google Maps API integration needs to be completed on the site in order Geocode tool to work.



Import File Location Fields


For the geocode to be completed properly we recommend filling in the following fields in the member CSV import file.


See: How To Import Members Via CSV File

 


Recommended Fields

  • address1 (to geocode members to a specific address, otherwise they will be geocoded to the zip_code, city, or state, based on what is available)
  • city
  • zip_code
  • state_code
  • country_code
  • state_name (optional)
  • country_name (optional)


NOTE: It will work with either the state_code and country_code or state_name and country_name. However, if they have all the information, the system will geocode them correctly.

Recommended Minimum Fields

If some of the fields above are not available, these are the minimum required fields:

  • city
  • state_code
  • country_code


These are the minimum fields to geocode members (Google Maps will recognize locations with this information 99% of the time).


It will often also work with just address1 instead of city, or just zip_code instead of city as well.


Find Geocode

If members have red "Find Geocode" text next to the location, these members are missing Latitude and Longitude coordinates.



Start Geocoding 


To begin the Geocoding process use the following tool under the My Members >> Search Members section of the admin:




The "Sync Members With Google Maps" button will open up the Batch Geocoder Tool:



Geocoding Options

There are three types of Geocoding options, each has a different level of specificity in regards to the accuracy of location assignment. 



Essentially, the member's location information will be put through the Google Maps search engine which will perform a search, cross-referencing the location information with their location database. Based on the search, Google Maps will assign the latitude and longitude of the listing based on what Google Maps has on its location database. 



Below is a description of each type of Geolocation option:


  1. Street Address - Longer processing time, but syncs members with their most specific location available. **We recommend this option**

  2. Zip / Postal Code - Faster processing, but only syncs members with their postal code (skips street address).

  3. City - Fastest processing, but only syncs members with their city (skips street address). 


Please note: the Geocoding tool uses the information available in the CSV import file. The better quality and the more specific the location data is, the better results this Geocoding tool will render when assigning the Longitude and Latitude to each listing. 


Depending on the number of members imported, as well as the Geocoding option selected, this process could take up to several minutes to complete. 


Geocode Errors

If the location data on a specific listing is incomplete, misspelled, or "not official location name".  The Geo-coder tool will display these as errors. This means the location information will need to be manually added. 


A list of members with these errors is conveniently displayed on the right side of the Geocoding module as seen below:






The fields are all automatically populated based on the location entered inside the Address Bar:




Results


Now all of the members have Latitude and Longitude coordinates: