Je hebt je zones keurig ingetekend op de kaart: bezorggebieden, servicezones of verkoopgebieden per postcode. Nu wil je die zones ook gebruiken in je eigen systeem — automatisch, zonder dat iemand handmatig hoeft te zoeken. Daar is de PCMapper API voor.
Wat doet de API?
De PCMapper API stelt je in staat om bij een gegeven postcode op te vragen welke zone (of zones) daarvoor gelden in een specifieke kaart. De response is een eenvoudig JSON-object met de zonenaam en eventuele extra veldwaarden die je zelf hebt gedefinieerd.
Een typisch gebruik: een klant vult zijn postcode in op je website, en je systeem vraagt direct op of die postcode binnen je bezorggebied valt — en zo ja, welke bezorgdag of welk tarief daarvoor geldt.
Praktijkvoorbeelden
- Webshop checkout — toon bij het invullen van de postcode direct of bezorging beschikbaar is, en zo ja, de bezorgkosten of levertijd voor die zone.
- CRM lead-routing — wijs nieuwe leads automatisch toe aan de juiste vertegenwoordiger op basis van de postcode van het bedrijf.
- Planningsoftware — koppel een serviceaanvraag automatisch aan het juiste team of depot via de postcode van het adres.
- Klantportaal — laat klanten zien welke monteur of accountmanager hun account beheert, op basis van hun woonadres.
Hoe stel je de API in?
In het PCMapper-dashboard maak je een API-sleutel aan voor een specifieke kaart. Die sleutel gebruik je als authenticatie in je API-aanroepen. De kaart-ID en zone-configuratie blijven beheerd in PCMapper — je hoeft niets te deployen of te beheren in je eigen infrastructuur.
Velden: meer dan alleen een zonenaam
Per zone kun je in PCMapper aanvullende velden definiëren, zoals een tariefcode, een verantwoordelijke, of een levertijdvenster. Die velden worden meegegeven in de API-response, zodat je downstream systemen direct alle informatie hebben die ze nodig hebben — zonder extra lookups.
Beveiliging en beschikbaarheid
API-sleutels zijn per kaart uniek en kunnen op elk moment worden ingetrokken of opnieuw gegenereerd. De API draait op Firebase Cloud Functions in de regio europe-west1, dicht bij de meeste Nederlandse en Europese gebruikers. Dat houdt de latency laag — typisch onder de 100ms voor een eenvoudige zone-lookup.
Klaar om te integreren?
De API is beschikbaar voor alle betaalde PCMapper-kaarten. Maak een account aan, teken je zones in, genereer een API-sleutel en je bent klaar. Heb je hulp nodig bij de integratie? Neem contact op via het dashboard — we helpen je graag op weg. Bekijk de demo en maak een kaart →