Why can’t I save my API key?

MAPPY: Dealer and Locator uses Google Maps as the map provider for your store locator. We'll use a key you provide from Google to power the map and parts of the search.

Google Maps functionality is divided into several "services" that each enable separate features. MAPPY: Dealer and Locator relies on five of them to work properly:

• Maps JavaScript API: Used to display the map imagery

• Geocoding API: Used to help match searches to specific places

• Geolocation API: Used to get the geographical position of a user

• Places API: Used to show address suggestions when searching

• Distance Matrix API: Used to calculate distances and time between destinations

If your Google Maps key is missing one of these services, you may not save your API Key.

Please follow these steps to check that your key is set up correctly.

Enabling the five Google Maps services

1. Open the Maps JavaScript API service page on the Google dashboard. If needed, sign into the Google account you used to create your key.

2. Ensure that the correct project is selected. The project name shown should match the project that you created when initially setting up your Google Maps key.

3. If you see a button Enable, click to turn on the service. If the button says Manage, the service is already enabled, and you can move to the next step.

4. Open all the service pages below and complete steps 2 & 3 again for that service (if an Enable button is shown, click it to turn on the service).

   • The Geocoding API service page

   • The Geolocation API service page

   • The Places API service page

   • The Distance Matrix API service page

5. Once you've visited all five service pages and have confirmed that they're all enabled, your locator should be able to display properly.

Checking for key restrictions

If the steps above didn’t resolve the issue, another possibility is that your key has been restricted to only work with certain services.

These steps will ensure the necessary services are permitted for your key:

1. Open the Credential page.

2. Find your key in the list and click on the name:

3. Check for any restrictions under API Restrictions. You want to ensure that either Don't restrict key is selected or, if Restrict key is selected, ensure that all 5 services (Maps Javascript API, Geocoding API, Geolocation API, Distance Matrix API, Places API) are included in the permitted APIs:

Don't restrict key

Restrict key

If the steps above didn't solve your issue, feel free to contact us at [e-mail].