Locatieserver

Deze repository bevat gebruikersdocumentatie en aanvullende informatie voor gebruikers van de PDOK Locatieserver.

Issues

Gebruik het Geoforum (Locatieserver categorie) voor het melden van issues.

Documentatie

De Locatieserver API implementeert de Open API Specificatie (OAS) en heeft daarmee een HTML pagina die de functionaliteit van de API documenteert:

• https://api.pdok.nl/bzk/locatieserver/search/v3_1/ui/

Aanvullende documentatie met meer details is te vinden in de Wiki van dit repository:

• Locatieserver Wiki

Releases

3.1

Release notes 3.0 -> 3.1:

1. ‘q’ parameter is nu verplicht (behalve bij /free endpoint)
2. CORS pre-flight is veranderd: "dit werkt alleen wanneer de request volgens de http specificaties gedaan wordt, dus met een Origin en Access-Control-Allow-Methods header."
3. Het is bij de nieuwe locatieserver niet toegestaan om query parameters op te geven die niet in de OpenAPI specificatie staan.
4. Er zijn nu Open API docs beschikbaar https://api.pdok.nl/bzk/locatieserver/search/v3_1/ui/
5. Twee extra velden, te weten numFoundExact in de response envelope en het veld shards in de documenten. De laatste wordt alleen getoond als je deze in de fl= parameter opneemt.
6. Het algoritme om de score te berekenen is aangepast. Hierdoor hebben de documenten over het algemeen een lagere score.