VTiger Google Address Lookup, as the name suggests, is an accessory to efficiently and accurately enter the address using Google Maps services. As you start typing the address, it will show all possible matches closest to your location.
But the extension does more; It supports custom address fields, meaning that in the configuration panel you will be able to configure any fields to work as ‘address lookup fields’. In addition, address lookup can be limited to specific country and it is compatible with both Detail and Edit Views.
All the configured Google Address lookup fields are displayed in the settings page. Each set of fields is grouped by module.
+ Add Address: Used to create new google address lookup field set
Editing: You can edit the existing set of fields by clicking on the pencil icon
Deleting: You can delete existing set of fields by clicking on the delete icon
Countries: You can select the country to which you operate. This will limit Google Address lookup search results to ONLY countries selected. By default it searches the address closest to you (by your computer location)
Google ApiKey: you need to generate a Google API Key and add here. The procedure is discussed in more details later in this guide
Add/Configure Google Address Fields
As you are editing or creating Google Address lookup fields – you will have following options:
Address Name: Simply name of the Google Address lookup fields. Can be anything
Module: Select the module for which fields will be configured
Street: Select the field that will be used to prefill from Google Address “Street”
City: Select the field that will be used to prefill from Google Address “City”
State: Select the field that will be used to prefill from Google Address “State/Province”
Postal Code: Select the field that will be used to prefill from Google Address “Postal/Zip Code”
Country: Select the field that will be used to prefill from Google Address “Street”
Locality: Select the field that will be used to prefill from Google Address “Locality”. It is usually county or district
Status: A switch to turn on/off field as Google Address lookup. Recommended instead of deleting
Mapping Fields from Google Maps
You can also map fields directly from Google maps for a specific address, if that address has information on those fields. Some examples of those fields are Street, City, Country, Website, Rating, Latitude and Longitude, and lot more.
For that, open the Extension’s Configuration panel. Add New Address or edit an existing one. You can edit a current address by clicking the “three dots” options button and pressing “Edit“. The left column of picklists can be used for mapping the fields.
To map, select the desired information from the left column of the picklists. Then choose the field where it should be mapped from the right side of picklists. Use the fields in same rows for mapping.
Add Google API Key
As the extension uses Google’s API, you will need a Google API Key to make it work.
How to get a Google API Key?
To get a Google API key:
1. Go to this link Link to get Google API key
2. In the step 1 on that page, click “GET A KEY” button
3. It will generate an API key, copy it
4. Then go to the Google Address Lookup’s Configuration (see “Configuration” section of this guide), and click “+Google ApiKey” button at the top right
5. Paste the API key generated on the step 3 and hit “Save”
It will add the API key and the extension is ready to use.