Officiële adresbasis eerst
PDOK en BAG leveren de officiële adres- en gebouwcontext; OSM-gebaseerde bronnen worden alleen als resolutiecontext gebruikt.
Adresvalidatie met BAG-context
Valideer een bedrijfsadres tegen de officiële BAG-context.
Bedrijfsbron gebruikt PDOK en BAG als officiële adresbasis. Alleen wanneer dat expliciet is toegestaan kan een geocodeprovider helpen bij resolutie; zo'n resultaat blijft herkenbaar als fallback en geldt niet als onafhankelijk registerbewijs.
Bron per voorstel Review bij twijfel Origineel blijft bewaard
Waar dit bij helpt
Maak een databesluit controleerbaar vóór je het toepast.
Herkomst in iedere response
Provider, bronfamilie, evidence-status, bronomgeving, ophaaltijd en verplichte attributie blijven bij het resultaat.
Geen stille fallback
Een Nominatim-fallback werkt alleen wanneer die server-side is ingeschakeld en wordt zichtbaar als resolution_only gemarkeerd.
Werkbare route
Van eerste signaal tot veilig resultaat.
- 01
Stuur een Nederlands adres
Gebruik straat, huisnummer, postcode en plaats of een volledige vrije adresquery zonder API-key in de browser.
- 02
Resolveer via PDOK
De geodata-orchestrator bevraagt eerst de officiële PDOK-locatievoorziening en bewaart de bronstatus.
- 03
Beoordeel BAG-context
Controleer identificatie, coördinaten en beschikbare gebouwcontext voordat je een bronrecord wijzigt.
- 04
Markeer een eventuele fallback
Is officiële resolutie niet beschikbaar, dan kan een geconfigureerde fallback een locatievoorstel geven dat niet als BAG-feit wordt gepubliceerd.
Synthetisch voorbeeld · geen klantdata
Het adresrequest is klein; de bronstatus blijft volledig.
Dit synthetische request toont alleen de invoervorm. Coördinaten, identifiers en providerstatus komen uitsluitend uit de live workspace-API.
Voorbeeldstraat en Voorbeeldstad zijn fictief. De pagina toont geen vooraf ingevulde BAG-id, coördinaten of validatiestatus.
Request · synthetische invoer
POST /v1/geodata/geocode
Content-Type: application/json
{
"query": "Voorbeeldstraat 10, 1234 AB Voorbeeldstad",
"allow_fallback": false
}Responsecontract · geen ingevuld resultaat
type GeoContextResponse<T> = {
data: T;
provenance: {
provider: string;
source_family: "bag" | "osm" | "pdok";
evidence_status:
| "authoritative"
| "resolution_only"
| "context_only";
source_url: string;
retrieved_at: string;
cached: boolean;
attribution: string[];
};
};Wat adresvalidatie wel vaststelt
De flow helpt een opgegeven locatie koppelen aan officiële adrescontext en maakt zichtbaar welke provider de resolutie leverde.
- BAG- of PDOK-herkomst
- Coördinaten met bronstatus
- Attributie in de response
Wat niet automatisch een bedrijfsfeit wordt
Een gevonden locatie bewijst niet zelfstandig welke rechtspersoon daar gevestigd is. Bedrijfsidentiteit en adrescontext blijven afzonderlijke bewijsstappen.
- Geen bedrijfsbevestiging uit OSM alleen
- Geen stille vervanging van bronadres
- Geen publieke Nominatim-autocomplete of bulkverwerking
Veelgestelde vragen
Eerst weten wat er precies gebeurt.
Welke bron gebruikt Bedrijfsbron voor Nederlandse adressen?
PDOK en BAG zijn de officiële basis voor adres- en gebouwcontext. Een OSM-gebaseerde provider kan uitsluitend als herkenbaar gemarkeerde resolutiecontext worden gebruikt.
Wordt Nominatim standaard gebruikt?
Nee. De fallback moet expliciet server-side zijn geconfigureerd en per request zijn toegestaan. De publieke instance is niet bedoeld voor autocomplete of bulkgebruik.
Staat een providerkey in de browser?
Nee. De browser roept de workspace-API aan; providercredentials blijven uitsluitend in de serveromgeving.
Begin met echte input
Bespreek je dataset Toets Bedrijfsbron eerst op een afgebakende dataset.
Beschrijf je bronbestand, gewenste velden en beslisregels. Dan kan de pilot worden ingericht zonder directe writeback naar je ERP of CRM.