In this section · 14 articles

Set up Google Maps

Add a Google Maps API key so the map picker works on forms, then choose the map's type, starting position and behaviour.

Applies to
Core 12.0 and later
Who can do this
Administrator, Platform owner
Permission
feature.core.maps.edit
Where
Configurations › General Settings › Maps Settings
On this page

Before you start

  • In the Google Cloud Console, create an API key with the Maps JavaScript API turned on, and billing set up. To let people find a place by its pincode, also turn on the Geocoding API.
  • Restrict the key to your site's addresses (HTTP referrers) and to those APIs. The key is used in the visitor's browser, so anyone can see it. The restriction is what stops others from using it.

Without a key, the map picker on forms shows a notice and you type the latitude and longitude by hand.

Steps

  1. Open Configurations › General Settings › Maps Settings. The Maps panel opens.
  2. Under Google Maps API, paste your key in Google Maps API Key.
  3. Under Default View, choose a Map Type: Roadmap, Satellite, Hybrid or Terrain.
  4. Set Default Zoom, a whole number from 1 to 21.
  5. Set Default Centre Latitude (−90 to 90) and Default Centre Longitude (−180 to 180). The map opens here when a form has no location yet.
  6. In Region Bias, enter a 2-letter country code, for example IN, to favour results from that country. Leave it blank for no bias.
  7. Under Behaviour, choose whether to turn on:
    • Locate by pincode: typing a pincode on a form moves the map to that area. It uses the Geocoding API.
    • Draggable marker: people can drag the pin to fine-tune the exact spot.
  8. Select Save changes.
The Maps panel in Maps Settings, with the Google Maps API Key field, Default View settings (Roadmap, zoom 13, centre latitude and longitude, region bias IN) and the Behaviour toggles turned on.

Defaults on a new installation

FieldDefault
Map TypeRoadmap
Default Zoom13
Default Centre Latitude20.5937
Default Centre Longitude78.9629
Region BiasIN
Locate by pincodeOn
Draggable markerOn

What happens next

Map pickers across the app, such as a property's location, show a Google map. The saved key isn't shown again on the panel. To keep it, leave the field blank when you save other changes. To replace it, type the new key. To remove it, select Clear.