Google Maps

Configure Google Maps for all map and location views in your Blue organization.


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

This setting applies to the organization map, the Map view, the Location 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:

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. Google Maps requests come directly from the visitor’s browser. Add website restrictions for every application and public-form origin used by your deployment.

  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 each application and public-form origin as an authorized referrer. See Domain examples.
  5. Under API restrictions, select Restrict key and allow Maps Tiles API, Places API, and Geocoding API.
  6. Select Save.

Enable Google Maps

  1. Open the organization’s Settings > General.
  2. Turn on Google Maps.
  3. Enter the key in API Key.
  4. Check API Status. All three required APIs must validate before you can save a non-empty key.
  5. Select Save.

The configuration applies to the organization. If validation fails, check the enabled Google APIs and authorized website origins, then retry.

Domain examples

  • Blue-hosted application and forms: https://blue.app/*.
  • A white-label application and its forms: https://yourdomain.com/*.
  • A dedicated deployment: its actual application and form origins.

Use only the origins that apply to your organization.

External service account

Google Maps requires your organization’s Google Cloud account and API key. Google bills API use separately. See Third-party services for billing responsibilities.