Google Maps

You can use Google Maps instead of the default OpenStreetMap in Blue. An organization owner must add a Google Maps API key in the organization settings.

This setting applies to the organization map, the workspace map view, the Location custom field, and location fields on public forms.

On public forms, location fields use Google tiles and Google Places autocomplete when Google Maps is enabled. Otherwise, they use OpenStreetMap.

Configure Google Cloud

Enable these APIs in Google Cloud Console:

• Maps Tiles API: Renders map tiles.
• Places API: Searches for places and returns their coordinates.
• Geocoding API: Returns the coordinates of a place.

Create a Google Cloud account and a Google Cloud project. Then follow Google’s API key instructions.

Restrict the API key

Restrict the key to authorized domains to prevent unauthorized use. Blue calls Google Maps directly from the visitor’s browser, so use website restrictions for every origin where your organization or public forms are served.

• https://blue.app/* for the main Blue application and Blue-hosted public forms.
• Each white-label domain where your organization or public forms are served, for example https://yourdomain.com/*.

1. Open the Google Cloud Console Credentials page.
2. Find your API key and select Edit.
3. Under Application restrictions, select HTTP referrers (websites).
4. Add these referrers:
   • https://blue.app/*
   • https://yourdomain.com/* (for each white-label domain)
5. Under API restrictions, select Restrict key and allow Maps Tiles API, Places API, and Geocoding API.
6. Select Save.