Articles on: Rates

Configure Local Delivery Rates based on Radius

Set up radius-based delivery zones. Customers enter their address, and Bird App automatically assigns them to the nearest store location.


Step 1: Get Your Google Maps API Key


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


  1. Go to Google Cloud Console
  2. Create a new project or select an existing one
  3. Enable the Geocoding API for your project
  4. Create an API key in the Credentials section
  5. Set up billing for your Google Cloud project (required for API usage)


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


Step 2: Enable Multi-Location Schedule


  1. Go to Bird App Settings
  2. Select "I have different schedule for different store locations"


Shows the Bird App Settings page with the multi-location schedule option highlighted


Step 3: Configure Radius-Based Validation


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


Displays the radius-based validation section with the radio button highlighted to show users exactly where to click


  1. Enter your Google Maps API Key in the designated field
  2. Click Validate & Save


The app validates your API key when you click "Validate & Save". If you see an error, check that your key is valid and has Places and Geocode permissions.


Shows the completed radius-based validation configuration with the API key field filled


Step 4: Set Up Store Locations and Delivery Zones


Create multiple locations to serve different delivery areas:


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


Demonstrates the Configure Locations page with multiple store locations set up for different delivery zones


Step 5: Configure Radius for Each Location


Set delivery radius for each store location:


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


Location

Radius

Main Store Location

5km

Downtown Zone

10km

Extended Zone

15km


Shows the location settings page with the local delivery radius configuration, specifically highlighting the 5km radius setting for the Main store location


Step 6: Configure Rates for Each Location


  1. Go to Bird App > Rates
  2. Select "I have different rates for different store locations or delivery zones" under Delivery section
  3. Set up rates for each location:


Location

Delivery Rate

Main Store Location

$10

Downtown Zone

$20

Extended Zone

$30


Each location uses the rate conditions you set for that particular location, and these rates apply to all addresses within that location's radius. The app automatically assigns customers to the nearest location within radius and applies that location's rate.


Displays the Bird Rates page with local delivery rates configured differently for each location, showing the tiered pricing structure


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


Shows the customer-facing delivery widget with Google Maps address autofill functionality and dropdown suggestions for address selection


Important behavior:

  • Bird App 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


Customer selecting delivery date and time from the assigned location's schedule with successful location validation


Step 7: Update Input Field Labels and Validation Messages


Update the labels and validation messages for radius-based delivery zones:


  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 from "Enter postal code to check if you are eligible for local delivery" to "Enter your address to check if you are eligible for local delivery"
  • Pin codes label: Change from "Enter your postal code" 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)


Note: These label changes ensure customers understand they should enter their full address rather than just a postal code when radius-based validation is enabled.


Step 8: 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


Shows the checkout page with prefilled selected location and radius-based delivery rate displayed correctly for the customer



Updated on: 08/28/2025

Was this article helpful?

Share your feedback

Cancel

Thank you!