De Geodoc Presenteren V1 API die door de viewer wordt gebruikt is specifiek voor de viewer bedoeld en nog niet publiek beschikbaar gesteld.
De API van Informatiehuis Ruimte waar je vervolgens naar kijkt, is een REST API die alleen de ruimtelijke plannen ontsluit. Dat is dus alles wat op ruimtelijkeplannen.nl te vinden is, en nu wordt vervangen door de omgevingsdocumenten uit de Omgevingswet.
Er zijn meer APIs om informatie over omgevingdocumenten op te vragen, maar om je daarin te adviseren is het handig als je eerst iets meer vertelt over wat je probeert te bereiken.
De ruimtelijkeplannen-API (IHR) bevat alleen de plannen die via IMRO door bevoegd gezag aangeleverd zijn. Voor de omgevingsdocumenten (via STOP-TPOD; Ozon) kun je van de omgevingsdocument-presenteren-API gebruik maken (Omgevingsdocument presenteren - Ontwikkelaarsportaal).
Ter beeldvorming; in de viewer in het loket komen beide bovenstaande APIās tezamen aangevuld met APIās voor de vectortiles van de verschillende informatiebronnen (IMRO en STOP-TPOD). Geodoc is tooling die hier tussen zit voornamelijk voor optimalisatie tbv de viewer (oa metadata IHR & Ozon tbv viewer). De Geodoc-API is echter nog niet publiek vrijgegeven omdat deze stapsgewijs verder wordt ontwikkeld. Om deze reden maakt de viewer ook gebruik van een wisselende combi van geodoc, ruimtelijkeplannen (IHR) e/o OD-presenteren (Ozon).
De wijze van uitvragen van de omgevingsdocument-presenteren-API is overigens wel anders dan de ruimtelijkeplannen-API, met name omdat de nieuwe informatiemodellen en het werkveld heel anders is dan in het verleden onder de Wet ruimtelijke ordening. Hopelijk heb ik je hierbij enige achtergrondinfo meegegeven en kun je hiermee het juiste pad bewandelen.
Bedankt voor jullie reacties. Hier was ik al een beetje bang voor. De _zoek mogelijkheden van de api OD-presenteren kent geen geo ingang op een specifieke XY locatie, waar ik wel op zoek naar ben. Wel de optie om via een tweetraps raket, eerst Locaties op te vragen en dan de omgevingsdocument behorend bij de locatiesā¦, maar dat levert te veel bijvangst en kost te veel tijd.
Hallo Jelmer,
Ik reageer even op jouw vraag aan Robin mbt toekomstplannen Geodoc-API. Om jouw vraag te beantwoorden wil ik graag wat meer achtergrondinfo meegeven.
Momenteel zijn wij druk bezig om de dataleveringen aan VRK; Viewer regels op de kaart - DSO-viewer in het Omgevingsloket, te optimaliseren voor viewergebruik. Hiervoor gebruiken we de zogenaamde ākaartmotorā ook bekend als geodoc.
VRK heeft koppelingen met diverse APIās voor data en vectortiles van omgevingsdocumenten (Ozon, nieuwe wetgeving > Omgevingswet) en data en vectortiles van ruimtelijke plannen (IHR, oude wetgeving > Wet ruimtelijke ordening inclusief overgangsrecht). Deze informatiestromen komen tezamen in VRK. Om de performance te optimaliseren is er een kaartmotor die een subset van data verzameld van zowel Ozon als IHR en deze gezamenlijk door routeert naar VRK. VRK maakt hierbij gebruik van zowel kaartmotor, Ozon als IHR. Alle gegevens die in de kaartmotor zitten zijn ook aanwezig in Ozon e/o IHR. De kaartmotor is nog volop in ontwikkeling en zal stapsgewijs steeds meer ondersteuning gaan bieden aan VRK.
Tot slot, om terug te komen op jouw vraag wat de planning cq toekomstplannen zijn; op dit moment is de kaartmotor dus nog volop in ontwikkeling en wordt stapsgewijs onderzocht waar deze uitgebreid kan worden gevolgd door eventuele realisatie daarvan. Een einddatum hiervan is nog niet bekend.
Wat wij herkennen vanuit eigen ervaring en vragen vanuit het werkveld is hoe informatie vanuit oude en nieuwe wetgeving in samenhang bekeken en gebruikt kan worden en juist hierin kan de kaartmotor een rol vervullen.
Onze teams die hiermee bezig zijn zijn onderdeel van de operationele deel van de projectorganisatie van DSO-LV. In samenspraak met de tactische beheerorganisatie en vertegenwoordigers van de diverse koepels en gebruikers wordt bepaald wat er binnen het DSO-LV wordt ontwikkeld en op welke wijze dit aan het werkveld beschikbaar wordt gesteld. Om deze reden kunnen wij ook geen uitspraak doen of en zo ja wanneer de kaartmotor gereed is en breder beschikbaar gesteld gaat worden. Persoonlijk verwacht ik wel dat dit plaats gaat vinden maar ik kan helaas geen garanties of termijnen geven.
Indien je hierover meer wilt weten dan is mijn advies om contact met IPLO (Contact | Informatiepunt Leefomgeving) op te nemen om dit bijvoorbeeld als wens kenbaar te maken.
Dank je wel Merijn voor je uitgebreide uitleg. Dus als ik het goed begrijp doet deze kaartmotor niets nieuws, het is een combinatie van verschillende andere open APIās?
Er is ondertussen een opvolger van de hierboven genoemde āGeodoc Presenteren V1 APIā die wel publiek beschikbaar is (linkje).
Daarnaast is het even opletten als je een API voor Omgevingsdocumenten zoekt, de V7 variant van de Presenteren API wordt binnenkort uit gezet. Gebruik daar dus de V8 variant van (linkje)
Dank Robin, de handleiding moet wel worden bijgewerkt. Als je een POST request doet op deze API is het antwoord:
{
"type": "https://service.omgevingswet.overheid.nl/fout/id/concept/unprocessable_entity",
"title": "Niet-ondersteunde CRS",
"status": 422,
"detail": "De default Content-Crs 'http://www.opengis.net/def/crs/OGC/1.3/CRS84' wordt niet ondersteund door deze API",
"instance": "urn:uuid:0579dc9ee859def9756243a9e725fd08"
}
Om dat te voorkomen dien je een extra Header opnemen:
Die API is gebouwd volgens de NL API Design rules. Als je daarvan de Geo module pakt, en dan specifiek de sectie over CRS Negotiation, kan je lezen dat APIs WGS84 als standaard CRS moeten gebruiken als er geen Content-CRS header wordt meegegeven. Het stomme hiervan is, dat ik geen enkele API binnen het DSO ken die werkelijk iets met WGS84 kan. Dus je krijgt altijd een HTTP 422 als je niet de optionele Content-CRS header mee geeft.
Gebruikersvriendelijk ā¦ nee, absoluut niet. Maar dit is helaas wat de NL API Strategie voorschrijft.
Als wij vervolgens geometrie willen ophalen (op geometrieopvragen API) met āgeometrieIdentificatiesā dan lukt dat voor een omgevingsplan, bijvoorbeeld:
De Geometrie Opvragen V1 API bevat alleen de geometrieƫn die in gebruik zijn in omgevingsdocumenten die zijn gepubliceerd onder de Omgevingswet. Ruimtelijke plannen vallen daar buiten.
Geometrieƫn van plannen en planobjecten zijn in de ruimtelijke plannen API op vrijwel ieder endpoint op te vragen met de expand query parameter met de waarde geometrie.
