Documentation

Settings Up Gravity Geolocation

Last modified: January 14, 2025

Introduction

The Gravity Geolocation plugin settings page provides essential options to configure geolocation functionality for Gravity Forms. It enables you to set up API keys, customize location detection methods, and optimize geolocation features for seamless integration with Gravity Forms.

The settings are grouped into categories, allowing you to easily manage licenses, localization, and advanced geolocation options. Explore the configuration options to enhance geolocation functionality in your Gravity Forms, ensuring accurate and reliable geolocation services for your forms.

Gravity Forms geolocation Settings page
Gravity Geolocation Settings page for Gravity Forms.

Gravity Geolocation Settings Options

1. License Key

Enter your Gravity Geolocation license key. This key is required to activate the plugin and receive updates and support. Expired licenses allow the plugin to function but without updates or support. Retrieve or manage your license key from your account page.


2. Google Maps Browser API Key

Enter your Google Maps Browser API key. This key is required for the plugin to interact with Google Maps services in Gravity Forms. If you don’t have one, create one here. For a step-by-step guide, follow this tutorial.


3. Google Maps Country Code

Specify the country code for the default country to be used with Google Maps Geocoding services in Gravity Forms. Refer to this list of country codes.


4. Google Maps Language

Enter the language code for the default language to be used by the Google Maps API in Gravity Forms. This setting determines the language displayed on the map interface and in address autocomplete suggestions. Refer to this page for a complete list of available language codes.


5. High Accuracy Location Mode

Enable this option to allow the auto-locator (via the Locator Button or Page Locator) to potentially retrieve a more accurate location. This may slightly delay location retrieval as it relies on the browser’s HTML5 geolocation.

Note: This option affects only HTML5 geolocation, not IP-based location detection.


6. IP Address Locator

Select an IP address provider to enable IP-based geolocation for the auto-locate feature. This option can be used as a fallback or an alternative to HTML5 geolocation.

Note: Location accuracy depends on the chosen provider, and some may require registration or an API key.

  1. ipinfo.io: Requires registration and a token.
  2. Ipregistry: Requires registration and an API key.
  3. Ipapi.co: No registration needed for the free plan but available with other plans.

7. Google Maps Server API Key

This optional key is only necessary for using server-side geocoding via custom functions. Create one here or refer to this tutorial.


8. Disable Google Maps API

Enable this option to prevent the Gravity Geolocation plugin from loading the Google Maps API. This is useful if another plugin or theme on your site already loads the API, helping to avoid potential conflicts caused by multiple instances of the Google Maps API.

Note: Disabling this feature may cause the plugin to malfunction if the other plugin or theme does not load the Google Maps API correctly or fails to load it on the page with the Gravity Form.

How to Use These Options

Follow these steps to configure the Gravity Geolocation settings for Gravity Forms:

  1. Activate the License: Enter and activate your license key for updates and support.
  2. Set API Keys: Add your required Google Maps Browser API key and optional Server API key.
  3. Configure Localization: Set the default country code and language for geolocation services.
  4. Enable High Accuracy: Turn on high-accuracy mode for precise HTML5 geolocation.
  5. Set IP Locator: Select an IP provider for fallback or alternative geolocation methods.
  6. Optimize API Loading: Disable Google Maps API loading if another plugin handles it.

Visit the Gravity Geolocation Documentation for more guidance on Gravity Forms geolocation features.

menu-circle