A Google Maps API key is required for the following:
Store pickup map
Geographic search
Auto-address suggestions
Driving distance validation
Max distance validation
Google provides a free trial of 90 days, or until $300 USD of credit has been used. After the free trial, they provide $200 USD of free credit per month which is more than enough for most merchants.
Should you exceed their free limit, you will be charged for your usage. View their plans and pricing for more information.
Requirements
You need to have an active Google account.
Create a Google Maps API Key
If you have an existing Google Cloud account with open projects, follow the steps for Existing Google Cloud users.
New Google Cloud users
To create a Google Maps API key and add it to Zapiet - Pickup + Delivery, follow our video tutorial or the written steps.
Visit the Google Maps Platform page and click Get started.
If needed, sign in to your Google Account.
Continue to add business and billing details.
Copy the API key and check Enable all Google Maps API's for this project.
Click Go to Google Maps Platform.
Do not add a restriction. Click Maybe later.
You can now add the API key you've copied to the Zapiet - Pickup + Delivery settings.
Existing Google Cloud users
Visit the Google Maps Platform page and click Get started.
If needed, sign in to your Google Account.
Click the open project name.
Click New project.
Add a project name and Billing account, and click Create. You can also add a location if needed.
Click Select project.
You may have to wait a moment for the project to be created.
Click Keys & Credentials.
Copy the API key and check Enable all Google Maps API's for this project.
You can also enable budget alerts.
Click Go to Google Maps Platform.
Do not add a restriction. Click Maybe later.
You can now add the API key you've copied to the Zapiet - Pickup + Delivery settings.
Add the API key to Zapiet - Pickup + Delivery
The same API key can be used for Store pickup and Local delivery settings.
Add the API key to local delivery settings
Click Settings.
Click Local delivery.
Select your delivery validation method.
Paste the API key and click Check your API Key.
If the API key shows as valid, click Done.
Click Save.
If the API key shows as invalid, check you have copied the full API key correctly, with no blank spaces or missed characters.
If you have copied it correctly, check the troubleshooting steps below.
After correctly saving the API key, check if your delivery validation method has been correctly set by following the article below.
Add the API key to store pickup settings
Click Settings.
Click Store pickup.
Select the location filter setting you need.
Paste the API key and click Check your API key.
If the API key shows as valid, click Done.
Click Save.
If the API key shows as invalid, check you have copied the full API key correctly, with no blank spaces or missed characters.
If you have copied it correctly, check the troubleshooting steps below.
Troubleshooting
You can check the validity of your Google Maps API key through the link below. Copy the link to your browser and replace the API_KEY with your Google Maps API key.
Compare the error messages with the error messages below.
Error message: "This API project is not authorized to use this API."
This could mean that not all of the API's have been enabled, or that the API has been restricted, or both.
To check if the API's have been enabled:
Click APIs and services.
Check the following API's are enabled:
Maps JavaScript API
Places API
Directions API
Geocoding API
Distance Matrix API
If any are not enabled, click Enable.
Repeat until all 5 API's are enabled, then retest the API key.
If it is still showing an error, check if any restrictions have been placed on the API.
Click Keys & Credentials.
Under Actions, click ⋮ and then click Edit API.
Disable any restrictions.
Click Save.
You can now test the API key again.
Error message: "The provided API key is invalid."
The API key added in Zapiet - Pickup + Delivery may be missing some characters, or a blank space may have been added.
Click Keys & Credentials.
Go to API keys and click Show key.
Copy your API key.
Carefully re-enter your API key in Zapiet - Pickup + Delivery and test again.
Error message: "You must enable Billing on the Google Cloud Project at https://console.cloud.google.com/project/_/billing/enable ..."
Go to https://console.cloud.google.com/project/_/billing/enable and select the project with your Google Maps API.
You may need to create a billing account.
Or you may need to update your payment information.
Once this has been added or changed, test the API key again.
If you are struggling to resolve the issue, reach out to us at [email protected].