Setting up Google Maps

To use the Google Maps API to display a map when an address is present for locations, suppliers, etc, you must include a value for GOOGLE_MAPS_API in your .env.

To get a Google Maps API key, you'll need to visit the Google Developers console.

If your set your Google Maps API so you can display maps on locations and suppliers pages in v4.1.7+ and your maps aren't showing up, this usually means you haven't authorized your Google API key to use the Maps APIs. (It's a long, convoluted process that Google makes far more confusing than it should be.)

The easiest way to verify if this is what's happening is to view the map image url in a browser directly. You'll probably see something like The Google Maps API server rejected your request. This API project is not authorized to use this API. Please ensure this API is activated in the Google Developers Console: https://console.developers.google.com/apis/api/static_maps_backend?project=_

In the Google Developers console, go to Library, search for Maps and enable the Maps APIs. (If you want to limit it to just the ones we need, it should be the Maps Embed API or Maps Static API.)

It can take a minute or two after enabling those APIs for google to recognize that it’s authorized now.