Verbeteringen PDOK Locatieserver(releasenotes)

N.a.v. gebruikerservaringen zijn er enkele verbeteringen doorgevoerd. Zo is o.a. de sortering van adressen verbeterd. Hieronder worden de verbeteringen nader toegelicht. De wijzigingen zijn ook doorgevoerd in het API document (http://pdokforum.geonovum.nl/t/documentatie-en-voorbeelden-locatieserver/262/2) en in de zoekvoorbeelden (Home · PDOK/locatieserver Wiki · GitHub).

  1. De sortering van gegevens bij de suggest-service is verbeterd. Er is afscheid genomen van de harde sortering op objecttype (gemeente, woonplaats, weg, postcode, adres). Verder wordt er nu beter rekening gehouden met exacte matches. Bijv. wanneer er op “Hei 1” wordt gezocht, verschijnen de adressen Hei 1 in Baarlo en Kessel bovenaan, voor bijv. de 1-Februariweg in Heijningen. Ook zijn de postcode-centroïden minder prominent gemaakt, omdat er veel meer gerichte zoekacties op adressen zijn dan op postcodes.

  2. Het veld centroide_ll wordt niet meer als een array getoond in de JSON-output, maar als een tekststring (een WKT-string van de centroïde). Dit geldt zowel voor de JSON-output als de XML-output. In de JSON-output zijn de vierkante haken verdwenen en in de XML-output is het arr-element met een genest str-element vervangen door een str-element.

  3. De velden geometrie_ll en geometrie_rd worden standaard niet meer getoond in de output van lookup- en free-requests. De reden hiervoor is dat bij met name gemeenten en woonplaatsen deze waarden zeer lang zijn, omdat ze de geometrie van het betreffende object omvatten. Ze kunnen worden opgevraagd door in de lookup- en free een fl-parameter met daarin alle gewenste velden (bijv. fl=id,geometrie_rd,…) mee te geven. Met een sterretje kunnen alle velden in de index worden opgevraagd en met fl=*,score kan ook nog de score worden opgevraagd. Dit laatste is alleen zinvol bij het free-endpoint.

  4. De coördinaten van alle geometrieën worden afgerond op meters / één honderdduizendste graad (ca. 1,1 m), aangezien deze geometrieën gegeneraliseerd worden. Deze geometrieën zijn bedoeld voor eenvoudige weergave in een viewer en zeker geen vervanging voor WFS. Vraag voor de volledige geometrie de betreffende objecten op in de BAG WFS.) Het generaliseren gebeurde voorheen ook al, maar de nauwkeurigheid van de resulterende geometrie kwam niet tot uitdrukking in de weergave van de coördinaten. Het veld geometrie_ll is nu ca. 50% korter en het veld geometrie_rd ca. 35%. De coördinaten van de centroïden worden afgerond op millimeters / één honderdmiljoenste graad (ca. 1,1 mm).

  5. In diverse endpoints zijn request parameters die eerst een vastgestelde waarde hadden verplaatst naar default-waarden. Hierdoor kunnen ze bij een request worden overschreven. Dit zijn:

  • Suggest: df, qf, bq, sort.
  • Lookup: fl (zie boven).
  • Free: fl (zie boven).
  • De sort-parameter bij suggest was verantwoordelijk voor de oude sortering, die o.b.v. het type was (zie het eerste punt). De oude sortering bij de suggest en free endpoints kan worden gerealiseerd door de volgende parameter mee te geven in het request: sort=typesortering asc, score desc, sortering asc, weergavenaam asc
  • Voor meer informatie over de parameters die Locatieserver gebruikt, zie Common Query Parameters | Apache Solr Reference Guide 6.6 bij Common Query Parameters, The DisMax Query Parser en The Extended DisMax Query Parser.