_1@2x.png)
About GravityView Maps geocoding
"Geocoding" is the process of converting an address to geographic coordinates (latitude and longitude). Geocoding can be done manually or automatically, but it always requires an address field present on the form.
⚠️ Important: Unrestricted API Key Required
For geocoding to work, you’ll need to set an Unrestricted Google Maps API Key in your WordPress admin.
- Sign up for a Google Maps API key. Make sure it has no Website restrictions. IP Address restrictions that use your server's IP are allowed.
- Go to: GravityKit → Settings → GravityView Maps
- There you’ll see the option to enter an Unrestricted Google Maps API Key. This key is used only for geocoding and will not be exposed to visitors.
Jump to the section:
Manual Geocoding
Entries that were not automatically geocoded after the form submission can be manually geocoded later by viewing the entry details in the Entries page of the Gravity Forms menu and clicking on the "Geocode This Address" button right below the address field of the form. This action will send the address field data to Google via an API request, and latitude and longitude will be returned.
Automatic Geocoding
Entries can be automatically geocoded when one of these two settings is used:
1) By enabling the geolocation autocomplete option in the address field of your form.
The Maps extension has a built-in functionality to autocomplete address fields using Google's Places API. When this option is used, geolocation coordinates (latitude and longitude) are automatically included in the submission as entry meta (non-visible information) that GravityView can use to put a precise pin for that address on a map.
This feature can be found and activated under the general section of an address field's settings panel on the sidebar of the form editor.
2) By activating the automatic geocoding option in your View Settings.
Support For Other Geolocation Add-Ons
The Maps extension also supports the geolocation data provided by a similar autocomplete functionality from Gravity Wiz's Address Autocomplete and Gravity Forms' Geolocation Add-On.
If the View detects that your form is using multiple geolocation sources, a new option will appear under the Maps tab so you can select which Geocoding Source will be used.
Once you select one of these add-ons as the default geocoding source, you must save your View. After the View editor page reloads, you'll see this new message on top suggesting you migrate the geocoding data to the new source used.
