delivery-system

Calculate delivery distance and fees by geocoding the delivery address via Nominatim, computing the Haversine distance from the store, and applying that distance to predefined pricing tiers. The system calculates the exact geographical distance and matches it to the correct fee bracket.

Haversine distance calculation works by computing the great-circle distance between the store's coordinates and the geocoded delivery address. This spherical trigonometry formula provides accurate straight-line distance, which is then mapped to tiered delivery fees and ETA estimates.

Yes, you can use Nominatim for address geocoding restricted to Benin. The system queries OpenStreetMap Nominatim with appropriate User-Agent headers and debounced requests to convert Benin addresses into coordinates for distance computation.

Yes, delivery fee estimation includes server-side validation. The system validates the computed fees against the calculated distances and store coordinates server-side, ensuring the final fee charged matches the verified geographical distance.

When geocoding fails during delivery fee computation, the system employs graceful fallbacks. These fallback mechanisms prevent the delivery pricing process from crashing when the Nominatim address lookup cannot resolve the provided delivery address.

Estimate delivery ETA by applying the computed Haversine distance to predefined service levels. The system uses the calculated geographical distance to determine the estimated time of arrival for the delivery.