====== Magento 2 Distance Delivery Extension ======

===== Extension context =====

This is a Toweringmedia Magento 2 extension guide in the **Store Operations** category. Use this page for distance-based delivery setup and pricing validation.

  * **Module name**: `Toweringmedia_DistanceDelivery`
  * **Composer package**: `toweringmedia/module-distance-delivery`

===== Quick links =====

  * [[magento2:start|Magento 2 docs home]]
  * [[magento2:extensions:start|Magento 2 extension index]]
  * [[magento2:extensions:toweringmedia-module-store-locator|Magento 2 Store Locator Extension]]
  * [[magento2:extensions:toweringmedia-module-store-pickup|Magento 2 Store Pickup Extension]]

===== Overview =====

Distance Delivery extends Store Locator with distance-based shipping logic for merchant-managed local delivery. It supports Google API routing, fallback distance calculation, and configurable pricing models.

Core capabilities:
  * Delivery rate calculation using distance.
  * Optional Google Maps/Distance Matrix integration with fallback logic.
  * Delivery order workflows and scheduling support.
  * Compatibility with mixed fulfillment (pickup + delivery) operations.

===== Installation =====

<code bash>
cd /path/to/magento
composer require toweringmedia/module-distance-delivery:<VERSION>
php -d memory_limit=-1 bin/magento setup:upgrade
php -d memory_limit=-1 bin/magento setup:di:compile
php bin/magento setup:static-content:deploy -f
php bin/magento cache:flush
</code>

===== Versioning notes =====

  * Pick the version you are licensed for.
  * To see available versions for your credentials:
    * `composer show -a toweringmedia/module-distance-delivery`

===== Configuration =====

Primary admin areas:
  * **Stores > Towering Media > Store Locator > Delivery Orders**
  * **Stores > Configuration > Towering Media > Store Locator** (delivery rules)

Recommended setup order:
  - Ensure Store Locator locations and delivery schedules are configured.
  - Configure delivery rule set (service radius, cutoff, minimums).
  - Configure pricing mode (flat/tier/per-distance).
  - Configure Google API key/settings if using map-based distance calculations.
  - Test checkout delivery quotes for near/far addresses.

===== Validation checklist =====

  * Delivery option appears only for valid serviceable addresses.
  * Delivery cost is calculated according to selected pricing model.
  * API and fallback behavior are acceptable when route service is unavailable.
  * Delivery metadata persists to order/admin views.

===== Troubleshooting =====

  * **No delivery quote**: verify service radius/rules and address validity.
  * **Unexpected delivery cost**: check pricing mode configuration and tier/rate data.
  * **Google API failures**: verify API key scope, enabled APIs, and quota limits.
  * **Schedule issues**: verify location hours and blackout dates in Store Locator.

===== SEO and conversion links =====

  * [[https://toweringmedia.com/toweringmedia-distance-delivery-magento-2-google-powered-logistics|Magento 2 Distance Delivery (Google-powered logistics)]]
  * [[https://toweringmedia.com/magento-2-extensions|Magento 2 Extensions Catalog]]

===== Related Magento 2 docs =====

  * [[magento2:extensions:start|Magento 2 extension index]]
  * [[magento2:start|Magento 2 docs home]]
  * [[magento2:extensions:toweringmedia-module-store-locator|Magento 2 Store Locator Extension]]
  * [[magento2:extensions:toweringmedia-module-store-pickup|Magento 2 Store Pickup Extension]]