Delivery validation: Maximum driving distance

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

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

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

• How does maximum driving distance work?
• Enabling maximum driving distance method
• Adding maximum driving distance to the location
• Changing the wording in the widget
• Limitations
• Troubleshoot

How does maximum driving distance work?

1. Enabling 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 select it from the dropdown menu.    
   • If the address is in your driving distance, they will be able to proceed.    
   • The address will automatically populate in the next step of the checkout.
     
   • If the address is not in your driving distance, they will get an error and not be able to proceed further.   

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

Enabling maximum driving distance method

1. Open the Apps section in your Shopify admin and click Store Pickup + Delivery.
   
2. Within Store 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 max driving distance.  
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 driving distance to the location

1. Within Store Pickup + Delivery, click the Locations tab.  
2. Click the name of the location, e.g. Store 1.  
3. Under the Local delivery section, click Edit settings.  
4. Under the Distance validation field, enter your maximum driving distance.  
5. Click Save.          
   
   

Changing the wording in the widget

1. Within the Store 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 max driving distance 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 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.