Intuitive Shipping uses Google Directions and Geocoding APIs when calculating distance-based shipping rates or when applying distance conditions. If you want to create a Local delivery shipping method, which calculates rates by measuring distance between your shipping origin location and the customer’s address, or if you want use a Delivery distance condition in a Scenario to restrict when a shipping method can be activated, you will need to create a Google API account for both Directions and Geocoding APIs, then connect your Google API account to Intuitive Shipping.
Create A Billing Account
Google requires you to have a billing account linked to your API project, even if you don’t anticipate being billed for usage.
1) Sign in to the Google Maps Platform with your Google credentials – the same credentials you use to sign in to Gmail or Google My Business.
2) Click the Get started button.
3) Complete the Account Information step.
4) Complete the Payment Information Verification step.
5) Enter the project name, such as ‘Intuitive Shipping’, to name the project that will hold your API credentials.
6) Click the Create button.
7) When the pop-up box appears, click the copy icon to copy your confidential API key to your computer’s clipboard, then save it somewhere private but accessible, like a secure note in your password manager. After copying your API key, uncheck the box beside ‘Enable all Google Maps APIs for this project’. You will only need ‘Directions’ and ‘Geocoding’ APIs.
If you don’t copy your API key at this point, or if you misplace it, don’t worry! You can retrieve it later when you complete the steps to Copy Your API Key To Intuitive Shipping later in this guide.
8) Click the Go to Google Maps Platform button.
Enable Directions and Geocoding APIs
Intuitive Shipping requires both Directions and Geocoding APIs to be enabled. Our system first attempts to calculate distance using Directions by measuring your store’s address to the customer’s address. If that fails, our system will fall back to the Geocoding API, which uses geocoordinates, to complete the calculation.
1) Click APIs on the sidebar menu.
2) Under Enable APIs, click Directions API.
3) Click the Enable button.
4) Click Geocoding API.
5) Click the Enable button.
How It Works
Each time Intuitive Shipping is used to check a distance condition or to calculate a distance-based shipping rate for local delivery shipping methods, it sends an API request to Google with your Directions API. If the required information is not returned, it sends another API request to Google with your Geocoding API.
That means, Intuitive Shipping will make at least one (1) and sometimes two (2) Google API requests per distance check.
Distance API will be sufficient typically about 75% of the time.
Both Directions and Geocoding APIs cost $5.00 per 1000 API requests per month. Meanwhile, Google provides a free credit of $200.00 of total API requests per month on a recurring basis. That means, you can use Intuitive Shipping to calculate up to at least 20,000, but typically up to 30,000 – 40,000 distance-based calculations before you are at risk of exceeding your monthly credit and being charged for API calls.
- $200.00 in credit gets you 40,000 total API requests per month, based on $5.00 per 1000 requests
- Typically 75% (30,000) require only Distance API = $150.00
- Remaining 25% (10,000) may require both Distance and Geocoding = $50.00
- Worst case, 20,000 distance-based calculations per month resulting in 2 API calls each
Once you exceed 40,000 total API calls, you will begin accruing charges for each 1000 calls, and Google will invoice you at the end of the billing period.
Connect You Google API Account To Intuitive Shipping
Once your API Key has been generated and you have enabled both Directions and Geocoding API, you must copy your Key into Intuitive Shipping.
If you have your confidential API key stored in a safe location, retrieve it, then skip ahead to Step 4. Otherwise, continue to Step 1.
1) From the Google Maps Platform, click Credentials on the sidebar menu
2) Under API Keys, click Show Key. This will generate a pop-up box.
3) Click the copy icon to copy your confidential API key to your computer’s clipboard.
4) Go to your Shopify admin page, then click Apps on the Shopify sidebar menu.
5) Search Intuitive Shipping, then select it from the list.
6) Click Settings on the sidebar menu, then select Carrier accounts from the drop-down list.
7) Click Add carrier account.
8) Click the downward arrow beside Integrated services.
9) Select Google API from the list provided.
10) Click the Configure account button.
11) Enter a title, such as ‘Google API’ or ‘Google Distance’.
12) Paste your Google API Key into the app.
Save Your Settings
1) Click the Save button to save your Google API Account.
After saving your Google API account, it will be listed on the Carrier accounts page along with any other carriers you have connected to Intuitive Shipping.
And, when you create a new Local delivery shipping method, Google API will be listed as a selectable option in the Carrier accounts section.
Learn how to connect another carrier account.