Google Maps
Configure Google Maps to display shipment location maps on order tracking pages.
The Google Maps integration displays an interactive map on the order tracking page showing the current or last known location of a shipment. When a customer views their order tracking details, a Google Map renders with a pin at the shipment's coordinates, giving customers a visual indicator of where their package is.
This integration requires a Google Maps JavaScript API key from the Google Cloud Console with the Maps JavaScript API enabled.
Configure Google Maps
- From your Unified Admin, go to Settings > Integrations > Google Maps.
- Enter your API Key in the field provided.
- Click Save.
Settings
| Field | Description |
|---|---|
| API Key | Your Google Maps JavaScript API key. When set, a map panel appears on the order tracking page showing the shipment's location. When empty, the map panel is hidden and only the text-based tracking timeline is shown. |
Getting a Google Maps API Key
- Go to the Google Cloud Console.
- Create or select a project.
- Enable the Maps JavaScript API from the API Library.
- Go to Credentials and create an API key.
- Restrict the key to the Maps JavaScript API and your storefront domain(s) for security.
- Copy the API key and paste it into the Google Maps settings in your Unified Admin.
Associations
Print Store
| Area | Effect |
|---|---|
| Order Tracking | When a Google Maps API key is configured, the order tracking control (OrderTracking.ascx) renders a Google Map below the tracking timeline. The map displays a marker at the shipment's latitude and longitude coordinates. If no API key is configured, the map panel and its script are hidden entirely. |
Related Pages
- Google Places — address autocomplete at checkout using the Google Places API
- Google Address Validation — verify shipping address accuracy before order submission