Local Delivery: Radius Distance Validation

Configure local delivery based on a radial distance (kilometers/miles) from your store location. This effectively draws a circle around your store usage Google Maps, allowing any address inside that circle to be eligible for delivery.

Table of Contents

• When to Use Radius Validation
• Prerequisites
• Configuration Steps
• • 1. Configure Radius-Based Validation
  • 2. Set Up Store Locations
  • 3. Configure Radius for Each Location
• How Radius-Based Validation Works
• • Important behavior
• Update Input Field Labels and Validation Messages
• Test Your Configuration
• Common Questions
• • Is this driving distance?
  • Why do I see a error or why do the locations don't show up in frontend?
• Related Articles

When to Use Radius Validation

• Regions without Postal Codes: Countries or cities (e.g., UAE, Hong Kong) where street addresses are used but zip codes are not granular or used at all.
• Simple Distance Rules: "We deliver to anyone within 5km."
• Avoids Complex Lists: No need to maintain a list of 500 postal codes.

Prerequisites

You need a Google Maps API key to enable address-based location assignment:

1. Get API Key: Go to Google Cloud Console.
2. Enable APIs: Enable the Geocoding API, Maps JavaScript API, and Places API for your project.
3. Billing: Set up billing for your Google Cloud project (required for API usage).
4. Create Key: Create an API key in the Credentials section.

For detailed setup instructions, follow Google's official documentation.

Configuration Steps

1. Configure Radius-Based Validation

1. Navigate to Bird Settings > Delivery.
2. Scroll to "Radius-based validation (Google Maps)".
3. Click the radio button to enable radius-based validation.

4. Enter your Google Maps API Key.
5. Click Validate & Save.

2. Set Up Store Locations

1. Go to Bird App Settings > Configure Locations.
2. Create or duplicate locations for different delivery zones (e.g., "Main Store", "Downtown Zone").

3. Configure Radius for Each Location

1. Select a location and enable Local Delivery.
2. Click "Edit Settings" in the Local Delivery section.
3. Scroll to "Local delivery radius".
4. Set the radius for each location:

How Radius-Based Validation Works

1. Customer types their address in delivery widget
2. Google Maps provides address suggestions as they type
3. Customer selects their address from dropdown
4. Bird App calculates distance to each store location
5. App assigns customer to nearest location within radius
6. App applies that location's rates and delivery schedules

Important behavior

• Bird selects location with smallest radius if multiple locations overlap.
• Each location's delivery rate applies to all addresses within that location's radius.
• Customers select delivery date and time from that location's schedule.

Update Input Field Labels and Validation Messages

Update the labels and validation messages for radius-based delivery zones to ensure customers enter a full address:

1. Navigate to Bird App Settings > Text and Languages
2. Click Edit on the language you want to modify
3. Update the following elements:

• Pin codes header: Change to "Enter your address to check if you are eligible for local delivery"
• Pin codes label: Change to "Enter your address"
• Pin codes success: Update to reflect address validation instead of postal code (optional)
• Pin codes error: Update error message to reflect address validation instead of postal code (optional)

Test Your Configuration

Verify radius-based delivery works correctly:

1. Test with addresses at various distances from store locations
2. Verify Google Maps address autofill functionality
3. Confirm correct location assignment
4. Check proper rate application
5. Test addresses that are outside all delivery radii
6. Verify updated labels and validation messages display correctly

Common Questions

Is this driving distance?

No. Radius validation uses straight-line distance, not actual road distance. If you need validation based on actual driving distance, see Local Delivery: Driving Distance Validation.

Why do I see a error or why do the locations don't show up in frontend?

Ensure your API Key is valid and has "Geocoding API" enabled in the Google Cloud Console.

Related Articles

• Local Delivery: Driving Distance Validation
• Local Delivery: Postal Code Validation
• How to Set Up Radius-Based Delivery Zones
• How to Set Up Driving Distance-Based Delivery Zones
• I am getting an error Order can't be shipped to the Address or Order not available for address
• Can I set specific delivery days for a particular postal code?

Updated on: 04/13/2026