Google Maps Integration

The Google Maps integration allows you to use the Google Address Element to search addresses, removing the need to manually add an address. For information on Google Map API Key pricing please refer to the Maps Platform Pricing Page.

To use the Google Maps integration you will need to provide a Google Maps API Key. Below are step by step instructions on how to create a Google Maps API Key and configure the integration within your account.

Set Up the Integration

1. Navigate to the Google Cloud APIs and Services menu

2. Click Enable APIs and Services

3. Search for and select the Maps JavaScript API, Maps Static API, and Places API

4. Click Enable

5. Navigate to the Google Cloud Console Credentials menu

6. Click the Create Credentials button and select API Key from the drop-down

7. This will create the key in your list of API Keys, click on the key to begin editing it

8. Give the key a Name

9. We recommend adding some Key restrictions to ensure that your key can only be used in the forms and apps you designate. To add a restriction click the Websites option.

   Note:

   For more on restricting your API key check out the help provided by Google on how to restrict your API key to specific websites.

10. Click Add under the Website restrictions section

11. Enter the Website URL of your app and click Done

    Note:

    If you are embedding your form on another website ensure you add the domain of your website to the available URLs. You will also want to add the URL of any apps that you will be using the integration with. Add an asterisk at the end of the URL, for example: https://support-administration.app.transform.civicplus.com/* to include any variations.

12. Click Restrict key under the API restrictions section

13. For the API restrictions you will want to restrict the Key to only the required APIs. These include Maps JavaScript API, Maps Static API, and Places API.

14. Now that your Key is configured, click Save

15. Copy your API Key

16. Open your Process Automation and Digital Services account. Navigate to the Workspace menu and click Settings.

17. Select Integrations

18. Select Setup Integration on the Google Maps Integration card

19. Enter the Label for your Key and paste the API Key copied from Step 15

    Note:

    You can add multiple Keys if needed. Click the Add Key button to add another key. You will be unable to view the API Keys after saving the integration.

20. Click Save

Add the API Key to Apps & Forms

1. Navigate to the Apps menu and select Manage on the app

2. Navigate to the Developer Tools tab

3. Toggle on Use custom Google Maps API Key and select the key from the dropdown

4. Click Save

5. Now that your app is configured, you can select the Google Address element in the Integration Elements section of the form builder

   Note:

   The integration will not show up in the Form Preview at this time.