delivery-system

Compute delivery distances and fees for Pixel-Mart orders using Nominatim and the Haversine formula.

2|1|Updated Feb 22, 2026

Search Tags:#delivery #haversine #fees #distance #geocoding #nominatim

Ready to run

npx skills add https://github.com/aboudou-cto-bloko/pixelmart --skill delivery-system

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: delivery-system
Source: https://github.com/aboudou-cto-bloko/pixelmart/tree/main/.claude/skills/delivery-system
Command: npx skills add https://github.com/aboudou-cto-bloko/pixelmart --skill delivery-system

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Pixel-Mart requires accurate distance-based delivery pricing and reliable ETA estimations to optimize logistics and improve customer satisfaction.

Core Features & Use Cases - Address autocomplete and geocoding via OpenStreetMap/Nominatim (Benin restricted). - Haversine distance calculation between store and delivery address. - Tiered delivery fees with client-side estimate and server-side validation. - ETA estimation based on distance and predefined service levels. - Use Case: A shopper in Cotonou requests delivery; system computes distance, fee, and ETA.

Quick Start Provide a sample delivery address "Cotonou Central, Benin" to generate distance, fee, and ETA.

Frequently Asked Questions about delivery-system

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I calculate delivery distance and fees using an address?▼

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.

How does Haversine distance calculation work for delivery pricing?▼

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.

Can I use Nominatim for address geocoding restricted to Benin?▼

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.

Does the delivery fee estimation include server-side validation?▼

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.

What happens when geocoding fails during delivery fee computation?▼

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.

How do I estimate delivery ETA based on distance?▼

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.