Delivery validation: Maximum radius
Chloé Beattie avatar
Written by Chloé Beattie
Updated over a week ago

With our delivery validation feature, you can validate if the customer is eligible for delivery.

Maximum radius method checks the address that your customers entered in the widget. That address will need to be within the radius you entered in your location settings.

Note

In order to use this feature, you will need a Google Maps API key. Please follow our Google Maps API key article to create one.

To learn more about other delivery validation methods, take a look at our Delivery validation article.


How does maximum radius work?

  1. Enabling the maximum radius method will add a field to the Local delivery section of our widget.

  2. You will need to enter your radius in the location settings.

  3. Your customers will need to enter their address to check if delivery is available.

    • They will start typing their address and select it from the dropdown menu.

    • If the address is within your radius, they will be able to proceed.

    • The address will automatically populate in the next step of the checkout.

    • If the address is not within your radius, they will get an error and not be able to proceed further.

Distance measured is the “as the crow flies” distance (straight line) from your store to the customer's address.


Enabling maximum radius method

  1. Open the Apps section in your Shopify admin and click Zapiet - Pickup + Delivery.

2. Within Zapiet - Pickup + Delivery, click the Settings tab.

3. Click Local delivery.

4. Scroll down to the Distance validation section and locate the Validation field.

5. Select Customer within maximum radius.

6. Enter your Google Maps API Key. If you do not have one, please follow the steps in our Creating a Google Maps API Key article.

7. Check the box Enable address autocompletion.

8. Scroll to the Checkout section and make sure the Prepopulate shipping address fields setting is enabled.

9. Click Save.


Adding maximum radius to the location

  1. Within Zapiet - Pickup + Delivery, click the Locations tab.

  2. Click the name of the location, e.g. Almonds and Cream.

  3. Under the Local delivery section, click Edit settings.

  4. Under the Distance validation field, enter your maximum radius.

  5. Click Save.


Changing the wording in the widget

  1. Within the Zapiet - Pickup + Delivery app, click the Settings tab.

  2. Click Text and design.

  3. Find the Local delivery settings.

  4. Change the wording in every field containing postal code/zip code into address.

  5. Click Save.

This is how your widget would look when you change the wording.


Limitations

  • Delivery validator is not compatible when using radius validation method. We are working on adding support for address autocompletion.

  • You can use address autocompletion if your store delivers to only one country—we don't support autocompletion for multiple countries.


Troubleshooting

  1. Check if you've selected the correct validation method.

  2. Check if you've added the correct max radius within a location.

  3. Check Google Maps API article to make sure:

    • You have enabled all the APIs (Maps, Geocoding, Places, Directions, Distance Matrix)

    • Enabled billing

    • Removed the restrictions on your Google Maps API key.

Did this answer your question?