BAG API response niet conform specificaties

In het gebruik van de BAG API vallen ons twee dingen op:

  1. BIj het opvragen van een enkele instantie van een verblijfsobject ontbreken de nevenadressen, ook van verblijfsobjecten die volgens de BAG Viewer wel nevenadressen hebben.

  2. BIj het opvragen van een enkele instantie van een openbare ruimte ontbreekt het type.

Zijn dit een bekende bugs?

Beste Roel,

Beide situaties die je beschrijft, zijn niet bij ons bekend als bug.

Om te kunnen controleren of het werkelijk om bugs gaat, heb ik wel iets meer informatie nodig:

  • Welke requests heb je gedaan?
  • Wat krijg je terug?
  • Wat verwacht je terug te krijgen?

Beste Robin,

Onderstaand een beschrijving van beide bevindingen.

Nevenadressen bij verblijfsobject

Als ik in de BAG viewer de gegevens van verblijfsobject met ID 0363010003761571, dan zie ik:

image

Vraag ik het zelfde object op via de BAG API met:

https://bag.basisregistraties.overheid.nl/api/v1/verblijfsobjecten/0363010003761571

Dan ziet de response er als volgt uit:

{
   "identificatiecode": "0363010003761571",
   "status": "VerblijfsobjectInGebruik",
   "oppervlakte": 23820,
   "_links":    {
      "self": {"href": "https://bag.basisregistraties.overheid.nl/api/v1/verblijfsobjecten/0363010003761571?geldigOp=2019-09-11"},
      "hoofdadres": {"href": "https://bag.basisregistraties.overheid.nl/api/v1/nummeraanduidingen/0363200003761447?geldigOp=2019-09-11"},
      "pandrelateringen": [{"href": "https://bag.basisregistraties.overheid.nl/api/v1/panden/0363100012168052?geldigOp=2019-09-11"}],
      "voorkomens": {"href": "https://bag.basisregistraties.overheid.nl/api/v1/verblijfsobjecten/0363010003761571/voorkomens?geldigOp=2019-09-11"}
   },
   "_embedded":    {
      "geometrie":       {
         "coordinates":          [
            4.8937168,
            52.3732927
         ],
         "type": "Point",
         "crs":          {
            "type": "name",
            "properties": {"name": "urn:ogc:def:crs:EPSG::4258"}
         }
      },
      "geldigVoorkomen":       {
         "beginGeldigheid": "2013-10-11T00:00:00.000+02:00",
         "eindGeldigheid": null,
         "inOnderzoek": false,
         "geconstateerd": false,
         "aanduidingInactief": false,
         "aanduidingCorrectie": 0,
         "label": "Voorkomen Verblijfsobject 0363010003761571 van 2013-10-11",
         "_embedded": {"bron":          {
            "documentnummer": "GV00001796_AC00AC",
            "documentdatum": "2013-10-11"
         }}
      }
   }
}

Dus met slechts een hoofdadres en zonder de nevenadressen. Ik heb nog geen verblijfsobject kunnen vinden waarvoor de API daadwerkelijk nevenadressen retourneert.

Type bij openbare ruimte

Als ik in de BAG viewer de gegevens van openbare ruimte met ID 0363300000004410 opvraag, dan zie ik:

Openbare ruimte
ID 0363300000004410
Naam Rokin
Type Weg
Status Naamgeving uitgegeven
Geconstateerd Nee
In onderzoek Nee
Begindatum 10-01-2014
Einddatum
Documentdatum 10-01-2014
Mutatiedatum 10-01-2014
Documentnummer GV00001729_AC00AC
Gerelateerde woonplaats 3594

Vraag ik het zelfde object op via de BAG API met:
https://bag.basisregistraties.overheid.nl/api/v1/openbare-ruimtes/0363300000004410

Dan ziet de response er als volgt uit:

{
   "identificatiecode": "0363300000004410",
   "naam": "Rokin",
   "status": "NaamgevingUitgegeven",
   "_links":    {
      "self": {"href": "https://bag.basisregistraties.overheid.nl/api/v1/openbare-ruimtes/0363300000004410?geldigOp=2019-09-11"},
      "bijbehorendeWoonplaats": {"href": "https://bag.basisregistraties.overheid.nl/api/v1/woonplaatsen/3594?geldigOp=2019-09-11"},
      "voorkomens": {"href": "https://bag.basisregistraties.overheid.nl/api/v1/openbare-ruimtes/0363300000004410/voorkomens?geldigOp=2019-09-11"}
   },
   "_embedded": {"geldigVoorkomen":    {
      "beginGeldigheid": "2014-01-10T00:00:00.000+01:00",
      "eindGeldigheid": null,
      "inOnderzoek": false,
      "geconstateerd": false,
      "aanduidingInactief": false,
      "aanduidingCorrectie": 0,
      "label": "Voorkomen Openbare ruimte 0363300000004410 van 2014-01-10",
      "_embedded": {"bron":       {
         "documentnummer": "GV00001729_AC00AC",
         "documentdatum": "2014-01-10"
      }}
   }}
}

Direct na de identificatiecode zou volgens de specificaties het type moeten volgen. Dit is slechts een voorbeeld. Ik heb nog geen openbare ruimte kunnen vinden waarbij het type wordt geretourneerd.

1 like

Kan, helaas, bevestigen dat je werkelijk twee bugs hebt gevonden.

Aangezien er hard wordt gewerkt aan een v2 van de BAG API vindt er al enige tijd vrij weinig onderhoud meer plaats voor de huidige v1 API. Deze bugs zouden niet moeten voorkomen in de v2 versie van de API. Wanneer deze beschikbaar is kan @NicoleKortoomsBAG je misschien vertellen.

Wel gaan we in het komende kwartaal de v1 API migreren naar een ander framework en database. Ik heb goede hoop dat deze bugs dan alsnog opgelost worden. @jasperroes kan mogelijk meer vertellen over de planning van deze werkzaamheden.

1 like

Op dit moment durf ik nog geen concretere planning voor de werkzaamheden te geven dan het komende kwartaal.

1 like

Beste Roel,

Bedankt voor de terugkoppeling. Dat geeft ons een extra controle die wij op de API’s, die wij op dit moment aan het ontwikkelen zijn, kunnen toepassen.
Het beschikbaar stellen van de eerste nieuwe BAG API’s staat gepland in oktober van dit jaar. De top 3 van bevragingen zullen dan klaar zijn. De overige bevragingen zullen in maart 2020 beschikbaar worden gesteld.
We hebben op dit moment een pilot groep voor de BAG API’s in het leven geroepen om de nieuwe API’s mee te gaan testen. Als je interesse hebt, dan zouden we je graag aan de groep willen toevoegen. Wij zijn namelijk nog op zoek naar actieve API gebruikers.

Met vriendelijke groet,

Nathalie Vos
Kadaster BAG

Hallo Nathalie,

Bedankt voor je aanbod. Wij zijn zeker geinteresserd om deel te nemen in deze pilot groep.

gr. Roel

Wij lopen tegen precies dezelfde bug aan als hierboven beschreven (soms krijgen we wel nevenadressen bij een verblijfsobject en soms niet).

Is het nog steeds mogelijk om mee te doen in de v2 API testgroep? Is via deze test API ook echte productiedata beschikbaar? Zo ja, dan zouden we ook graag alvast aansluiten op de v2 API.

hoi @jippeh,
gezien de ‘leeftijd’ van dit topic sluit ik deze, ook gezien de ontwikkelingen/discussie van o.a. BAG API die in andere topics plaatsvinden, zoals: