Skip to main content
All CollectionsLocal Delivery
Delivery validation: Maximum driving distance
Delivery validation: Maximum driving distance
Jelizaveta avatar
Written by Jelizaveta
Updated over a week ago

With our delivery validation feature, you can check if the customer is eligible for delivery. Depending on the address entered in the widget, a matching delivery location will be selected.

Maximum driving distance method checks the address that your customers entered in the widget. That address will need to be within the driving radius you entered in your location settings for the customer to be able to check out.

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


Requirements


Compare delivery validation methods

If you're not sure if this is the right method for your use case, compare the validation methods we offer.

Google Maps API key

Required

Required

Recommended use

If your delivery zone is set by a straight line radius from your store

If your delivery zone is set by a driving distance from your store

Example distances

10 km

10 km

Eligible addresses

Any address within 10 km straight line distance from your store

Any address within 10 km driving distance from your store

Non-eligible addresses

Any address further than 10 km straight line distance from your store

Any address further than 10 km driving distance from your store


How does maximum driving distance work?

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

  2. You will need to enter your driving distance 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 must select it from the dropdown menu.

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

    • The address will automatically populate in the next step of the checkout, if you have Prepopulate shipping address fields setting enabled in Settings > Local Delivery.

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

    • The distance measured is the actual driving distance from your store to the customer's address.


Enable maximum driving distance validation

  1. Click Settings then Local Delivery.

  2. In the Distance validation section, select Customer within maximum driving distance.

  3. 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.

  4. Click Check your API key.

  5. If the API key shows as valid, click Done.

  6. 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 in the Google Maps API article.

  7. Select whether the driving route should avoid highways, tolls, or ferries.

  8. Select the route options.

    Fastest route will assess traffic conditions and select the fastest route at the time of entering the address.

    Shortest route will always select the shortest possible route.

  9. Tick the Enable address autocompletion setting.

  10. In the Checkout section and make sure the Prepopulate shipping address fields setting is enabled.

  11. Click Save.

Your delivery validation settings are set, now you need to add delivery radius to every location that offers delivery.


Add maximum driving distance to a location

You can change the distance units in Zapiet - Pickup + Delivery > Settings > Standards and formats.

  1. Click Locations.

  2. Click the name of the location you want to edit.

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

  4. In the Distance validation section, enter your Maximum driving distance.

  5. Click Save.

Repeat for all locations that offer local delivery.


Change the wording in the widget

  1. Click Settings, then click Text and Design.

  2. In Text and design section, click Show next to Delivery widget.

  3. Change the wording in every field containing postal code/zip code into address. You can edit:

    • Search field placeholder

    • Instructional text (optional)

    • User has not selected a location, date or time (if required)

  4. Click Save.

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


Limitations

  • 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 driving distance 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?