# Locatieserver

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

## Issues

Gebruik het [Geoforum (Locatieserver categorie)](https://geoforum.nl/c/applicaties-en-diensten/locatieserver) 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/`](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](https://github.com/PDOK/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/`](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.