De PDOK Locatieserver is op 2 februari jl. gemigreerd naar het nieuwe 3G platform van PDOK. Als gevolg van deze migratie zijn de API's beschikbaar via nieuwe URL’s:
PDOK constateert dat er helaas nog veel bevragingen worden gedaan op de oude URL’s van de locatieserver. We vragen afnemers van de Locatieserver dan ook om zo snel mogelijk over te stappen op de nieuwe URL’s zoals hierboven beschreven.
Uit productie
De oude URL’s te beginnen met https://geodata.nationaalgeoregister.nl (verschillende versies) komen op 2 augustus 2023 definitief te vervallen. Switch daarom vandaag nog naar de nieuwe URL’s!
Voor meer informatie over de migratie van de Locatieserver zie het eerdere nieuwsbericht.
Een overzicht van de veranderingen (change log) zou gewaardeerd worden de volgende keer. Nu heb ik door reacties van anderen heen moeten zoeken om erachter te komen welke veranderingen er zijn bij deze nieuwe versie. Tot nu toe ben ik dit tegengekomen:
‘q’ parameter is nu verplicht (behalve bij /free endpoint)
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.”
Het is bij de nieuwe locatieserver niet toegestaan om query parameters op te geven die niet in de OpenAPI specificatie staan.
De twee extra velden zijn 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.
Een andere wijzging voor de change log is dat het algoritme om de score te berekenen is aangepast. Hierdoor hebben de documenten over het algemeen een lagere score.