Skip to content

Commit

Permalink
Merge pull request #413 from VNG-Realisatie/develop-1.2
Browse files Browse the repository at this point in the history
Develop 1.2
  • Loading branch information
JohanBoer authored Jul 6, 2021
2 parents a7a665e + f6846b0 commit 14d211a
Show file tree
Hide file tree
Showing 6 changed files with 830 additions and 736 deletions.
5 changes: 3 additions & 2 deletions docs/goals-canvas.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ title: Goals Canvas

| PRIO | | WHATS | HOWS | INPUT | OUTPUT | GOALS | STORIES |
|------|-|-------|------|-------|--------|--------|---------|
| 1 | | Zoeken uniek adres om adres, pand, verblijfsobject, standplaats, ligplaats, nummeraanduiding, openbare ruimte en woonplaats te vinden | fuzzy zoeken van een adres (search as you type, exact match) | free query op postcode, woonplaats, openbare ruimtenaam, huisnummer-letter-toevoeging, contour, coordinaat | verzameling adressen (adresstrings) | collectie adresstrings tonen zodat er 1 door client kan worden geselecteerd | [4](https://github.com/VNG-Realisatie/Haal-Centraal-BAG-bevragen/issues/4){:target="_blank"} |
| 1 | | Zoeken uniek adres om adres, pand, verblijfsobject, standplaats, ligplaats, nummeraanduiding, openbare ruimte en woonplaats te vinden | fuzzy zoeken van een adres (search as you type, exact match) | free query op postcode, woonplaats, openbare ruimtenaam, huisnummer-letter-toevoeging | verzameling adressen (adresstrings) | collectie adresstrings tonen zodat er 1 door client kan worden geselecteerd | [4](https://github.com/VNG-Realisatie/Haal-Centraal-BAG-bevragen/issues/4){:target="_blank"} |
| 2 | | eigenschappen en relaties van een adres vinden, inclusief "in onderzoek" | selecteer een unieke adres uit een collectie adresstrings die matchen met invoer OF gebruik een nummeraanduidingIdentificatie (bijv. uit BRK of BRP). | adresstring + expand parameter(optioneel) OF nummeraanduidingIdentificatie + expandparameter (optioneel) | adres: verkorte openbare ruimtenaam, huisnr, huisl, huisnr.toevoeging, postcode, woonplaats (+embedded openbare ruimte, nummeraanduiding, woonplaats), geconstateerd, optionele boolean nevenadres en "in onderzoek" + relaties van het adres met de resources adresseerbaarObject en pand. | raadplegen 1. eigenschappen van adres met bijbehorende identificatie/links naar nummeraanduiding, openbare ruimte en woonplaats + 2. identificatie/links van gerelateerd verblijfsobject, standplaats, ligplaats en pand(en), om deze evt. te kunnen raadplegen. | [32](https://github.com/VNG-Realisatie/Haal-Centraal-BAG-bevragen/issues/32){:target="_blank"}, [15](https://github.com/VNG-Realisatie/Haal-Centraal-BAG-bevragen/issues/15){:target="_blank"}, [16](https://github.com/VNG-Realisatie/Haal-Centraal-BAG-bevragen/issues/16){:target="_blank"}, [17](https://github.com/VNG-Realisatie/Haal-Centraal-BAG-bevragen/issues/17){:target="_blank"}, [18](https://github.com/VNG-Realisatie/Haal-Centraal-BAG-bevragen/issues/18){:target="_blank"} |
| 3 | | eigenschappen (minimaal gebruiksdoel, geometrie, oppervlakte, brondocument, gecontateerd en in onderzoek) en relaties van adresseerbaar object vinden | raadpleeg adresseerbaar object en relaties, of zoeken obv een ID. Bijvoorbeeld uit een andere (basis)registratie | invoeren adresseerbaarObjectIdentificatie + expandparameter (optioneel) Queryparameters: nummeraanduidingIdentificatie en pandIdentificatie | adresseerbaarObject met eigenschappen en relaties met adres (embedded) en Pand (embedded). | eigenschappen en relaties adresseerbaarObject raadplegen | [11](https://github.com/VNG-Realisatie/Haal-Centraal-BAG-bevragen/issues/11){:target="_blank"}, [8](https://github.com/VNG-Realisatie/Haal-Centraal-BAG-bevragen/issues/8){:target="_blank"}, [7](https://github.com/VNG-Realisatie/Haal-Centraal-BAG-bevragen/issues/7){:target="_blank"}, [6](https://github.com/VNG-Realisatie/Haal-Centraal-BAG-bevragen/issues/6){:target="_blank"}, [13](https://github.com/VNG-Realisatie/Haal-Centraal-BAG-bevragen/issues/13){:target="_blank"}, [9](https://github.com/VNG-Realisatie/Haal-Centraal-BAG-bevragen/issues/9){:target="_blank"}, [5](https://github.com/VNG-Realisatie/Haal-Centraal-BAG-bevragen/issues/5){:target="_blank"}, [2](https://github.com/VNG-Realisatie/Haal-Centraal-BAG-bevragen/issues/2){:target="_blank"}, [13](https://github.com/VNG-Realisatie/Haal-Centraal-BAG-bevragen/issues/13){:target="_blank"} |
| 4 | | eigenschappen (minimaal geometrie, oorspronkelijk bouwjaar, brondocument, gecontateerd en in onderzoek) en relaties van een pand vinden | raadpleeg pand en relaties, bijvoorbeeld via de kaart, of via zoeken op een ID. Bijvoorbeeld uit een andere (basis)registratie | invoeren pandIdentificatie + de expand parameter (optioneel). Queryparameters: nummeraanduidingIdentificatie en adresseerbaarObjectIdntificatie | eigenschappen van het pand en relaties met verblijfsobjecten (embedded) en adressen (embedded) | eigenschappen en relaties Pand raadplegen | [1](https://github.com/VNG-Realisatie/Haal-Centraal-BAG-bevragen/issues/1){:target="_blank"}, [2](https://github.com/VNG-Realisatie/Haal-Centraal-BAG-bevragen/issues/2){:target="_blank"}, [3](https://github.com/VNG-Realisatie/Haal-Centraal-BAG-bevragen/issues/3){:target="_blank"}, [10](https://github.com/VNG-Realisatie/Haal-Centraal-BAG-bevragen/issues/10){:target="_blank"}, [13](https://github.com/VNG-Realisatie/Haal-Centraal-BAG-bevragen/issues/13){:target="_blank"}, [14](https://github.com/VNG-Realisatie/Haal-Centraal-BAG-bevragen/issues/14){:target="_blank"}, [4](https://github.com/VNG-Realisatie/Haal-Centraal-BAG-bevragen/issues/4){:target="_blank"} |
Expand All @@ -16,4 +16,5 @@ title: Goals Canvas
| laag | SPECIAL!!!! | actuele verdeling van alle gebruiksfuncties van verblijfsobjecten in BAG binnen een bepaald gebied | Zoek verblijfsobjecten standplaatsen en ligplaatsen in een gebied | invoeren contour | verdeling van actuele gebruiksdoelen in percentages (samen 100%) | actuele uitnutting gebruiksdoelen en beschikbare vrije ruimte binnen bestemmingsplan bepalen | [7](https://github.com/VNG-Realisatie/Haal-Centraal-BAG-bevragen/issues/7){:target="_blank"} |
| 1 | | Panden zoeken | Zoek panden op contour in combinatie met bouwjaar binnen periode (voor of na bouwjaar) | contour in combinatie met bouwperiode | panden | panden vinden van voor of na een bepaald bouwjaar of binnen een periode tbv energietransitie | [306](https://github.com/VNG-Realisatie/Haal-Centraal-BAG-bevragen/issues/306){:target="_blank"} |
| 2 | | Panden zoeken | Zoek panden op contour in combinatie met status en geconstateerd | contour in combinatie met status en geconstateerd | panden | panden vinden in een bepaald gebied met gecontateerd tbv handhaving stedelijke ontwikkelingen en belastingzaken | [331](https://github.com/VNG-Realisatie/Haal-Centraal-BAG-bevragen/issues/331){:target="_blank"}, [333](https://github.com/VNG-Realisatie/Haal-Centraal-BAG-bevragen/issues/333){:target="_blank"} |
| 3 | | Adresseerbaar object zoeken | zoeken ADO op contour in combinatie met oppervlakterange, status, gebruiksdoel, type en geconstateerd | contour in combinatie met oppervlakterange, status, gebruiksdoel, type en gecontateerd | Adresseerbaar objecten | ADO's vinden in een bepaald gebied met gecontateerd tbv handhaving stedelijke ontwikkelingen en belastingzaken | [19](https://github.com/VNG-Realisatie/Haal-Centraal-BAG-bevragen/issues/19){:target="_blank"}, [331](https://github.com/VNG-Realisatie/Haal-Centraal-BAG-bevragen/issues/331){:target="_blank"}, [332](https://github.com/VNG-Realisatie/Haal-Centraal-BAG-bevragen/issues/332){:target="_blank"}, [334](https://github.com/VNG-Realisatie/Haal-Centraal-BAG-bevragen/issues/334){:target="_blank"} |
| 3 | | Adresseerbaar object zoeken | zoeken ADO op woonplaats in combinatie met oppervlakterange, status, gebruiksdoel, type en geconstateerd | woonplaats in combinatie met oppervlakterange, status, gebruiksdoel, type en geconstateerd | Adresseerbaar objecten | overzicht ADO's met gecontateerd tbv belastingzaken | [334](https://github.com/VNG-Realisatie/Haal-Centraal-BAG-bevragen/issues/334){:target="_blank"} |
| 3 | | Adresseerbaar object zoeken | zoeken ADO op contour in combinatie met oppervlakterange, status, gebruiksdoel, type en geconstateerd | contour in combinatie met oppervlakterange, status, gebruiksdoel, type en geconstateerd | Adresseerbaar objecten | ADO's en gerelateerde panden vinden in een bepaald gebied met gecontateerd tbv handhaving stedelijke ontwikkelingen en belastingzaken | [19](https://github.com/VNG-Realisatie/Haal-Centraal-BAG-bevragen/issues/19){:target="_blank"}, [331](https://github.com/VNG-Realisatie/Haal-Centraal-BAG-bevragen/issues/331){:target="_blank"}, [332](https://github.com/VNG-Realisatie/Haal-Centraal-BAG-bevragen/issues/332){:target="_blank"}, [334](https://github.com/VNG-Realisatie/Haal-Centraal-BAG-bevragen/issues/334){:target="_blank"} |
34 changes: 28 additions & 6 deletions docs/releasenotes.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,28 @@ title: Releasenotes

# Release notes BAG Huidige bevragingen API

## Versie 1.2.0 (22-06-2021)
In deze release zijn enkele bugs in productie opgelost. Tevens zijn er enkele wijzigingen aan de API-specificaties en de feature-files aangebracht.
Er worden nu adresregels geleverd met daarin het samengestelde adres.
De Header Content-Crs is voorzien van een default waarde.
Op /adressen worden de resultaten gesorteerd geretourneerd.

### Opgeloste issues

| Link Github | Beschrijving |
| --- | --- |
| [234](https://github.com/VNG-Realisatie/Haal-Centraal-BAG-bevragen/issues/234) | gebruik relatieve urls voor interne links |
| [293](https://github.com/VNG-Realisatie/Haal-Centraal-BAG-bevragen/issues/293) | Expand gerelateerde resource als relatie in onderzoek is |
| [294](https://github.com/VNG-Realisatie/Haal-Centraal-BAG-bevragen/issues/294) | Als gebruiker (nader te bepalen) wil ik de inhoud van de mogelijkOnjuist gegevensgroep kunnen filteren |
| [309](https://github.com/VNG-Realisatie/Haal-Centraal-BAG-bevragen/issues/309) | wijzigen description zoekparameter zoekresultaat get/adressen/zoek e.a. |
| [338](https://github.com/VNG-Realisatie/Haal-Centraal-BAG-bevragen/issues/338) | Underscores verwijderen uit componentnamen en enumeratienamen. |
| [343](https://github.com/VNG-Realisatie/Haal-Centraal-BAG-bevragen/issues/343) | Gebruiker mag niet worden verplicht om Accept-Crs te definieren |\
| [360](https://github.com/VNG-Realisatie/Haal-Centraal-BAG-bevragen/issues/360) | Als gebruiker wil ik het samengesteld adres krijgen |
| [363](https://github.com/VNG-Realisatie/Haal-Centraal-BAG-bevragen/issues/363) | als developer van de BRK API wil ik de korteNaam kunnen leveren bij het adres van een kadastraal object |
| [364](https://github.com/VNG-Realisatie/Haal-Centraal-BAG-bevragen/issues/364) | toevoegen controle op minimale en maximale lengte invoer zoek |
| [371](https://github.com/VNG-Realisatie/Haal-Centraal-BAG-bevragen/issues/371) | Is Content-Crs noodzakelijk bij bevraging van panden endpoint |


## Versie 1.1.1 (03-03-2021)
In deze release zijn enkele bugs in productie opgelost. Er zijn geen wijzigingen gedaan aan de API specificaties.

Expand All @@ -21,7 +43,7 @@ In deze release zijn enkele bugs in productie opgelost. Er zijn geen wijzigingen

### Opgeloste issues
De volgende issues zijn in deze release opgelost.

| Link Github | Beschrijving |
| --- | --- |
| [305](https://github.com/VNG-Realisatie/Haal-Centraal-BAG-bevragen/issues/305) | Juiste foutmelding bij niet-toegestane combinatie van queryparameters |
Expand All @@ -34,11 +56,11 @@ In deze release zijn enkele bugs in productie opgelost. Er zijn geen wijzigingen
De volgende issues staan nog open, oplossing volgt in een latere versie:

| Link Github | Beschrijving |
| --- | --- |
| - | Opvragen nummeraanduiding die niet gekoppeld is aan een verblijfsobject|
| [234](https://github.com/VNG-Realisatie/Haal-Centraal-BAG-bevragen/issues/234) | Interne URL’s in de response worden relatief (zijn nu allemaal absolute links) |
| [265](https://github.com/VNG-Realisatie/Haal-Centraal-BAG-bevragen/issues/265) | Via fields-parameter opvragen van link zonder "\_links" toe te voegen |
| [293](https://github.com/VNG-Realisatie/Haal-Centraal-BAG-bevragen/issues/293) | Communiceren dat een relatie mogelijk onjuist is bij het met fields vragen om _links of met expand vragen om de gerelateerde resource |
| --- | --- | --- |






## Versie 1.0.0 (12-08-2020)
Expand Down
162 changes: 162 additions & 0 deletions features/adresregels.feature
Original file line number Diff line number Diff line change
@@ -0,0 +1,162 @@
# language: nl

Functionaliteit: Als gebruiker wil ik samengestelde adresregels
zodat ik het samengestelde adres direct en correct kan gebruiken.

Het adres wordt samengesteld conform NEN 5825:2002. Dit betreft alleen het adresdeel van de adressering, het naamdeel van de adressering komt uit een andere bron (zoals BRP, HR of BRK).

De adresregels worden samengesteld op basis van de volgende regels
- Property adresregel1 wordt samengesteld uit korteNaam + huisnummer + huisletter + huisnummertoevoeging
- Property adresregel2 wordt samengesteld uit postcode + woonplaats
- Tussen kortenaam en huisnummer wordt een spatie opgenomen
- Tussen het huisnummer en de huisnummertoevoeging (wat in de NEN een samenstelling is van huisletter en huisnummertoevoeging, niet gecheiden van elkaar) moet een koppelteken ("-") worden geplaatst indien de huisnummertoevoeging met een cijfer begint, een spatie in alle andere gevallen
- Tussen postcode numeriek deel en postcode alfabetisch deel moet een spatie worden geplaatst
- Tussen postcode alfabetisch deel en woonplaatsnaam moeten twee spaties worden geplaatst
- De woonplaatsnaam wordt in hoofdletters geschreven

Scenario: er is geen huisnummertoevoeging en geen huisletter
Gegeven adres met nummeraanduidingidentificatie "0957200000021241" heeft de volgende gegevens:
"""
{
"straat": "Annelien Kappeyne van de Coppellostraat",
"huisnummer": 8,
"postcode": "6049HD",
"woonplaats": "Herten",
"korteNaam": "A K vd Coppellostr"
}
"""
Als het adres wordt gevraagd met /adressen/0957200000021241
Dan bevat het antwoord:
"""
{
"adresregel1": "A K vd Coppellostr 8",
"adresregel2": "6049 HD HERTEN"
}
"""

Scenario: er is een huisletter en er is geen huinummertoevoeging
Gegeven adres met nummeraanduidingidentificatie "0344200000004821" heeft de volgende gegevens:
"""
{
"straat": "Blauwkapelseweg",
"huisnummer": 1,
"huisletter": "A",
"postcode": "3572KA",
"woonplaats": "Utrecht",
"korteNaam": "Blauwkapelseweg"
}
"""
Als het adres wordt gevraagd met /adressen/0344200000004821
Dan bevat het antwoord:
"""
{
"adresregel1": "Blauwkapelseweg 1 A",
"adresregel2": "3572 KA UTRECHT"
}
"""

Scenario: er is een huisnummertoevoeging die begint met een letter en er is geen huisletter
Gegeven adres met nummeraanduidingidentificatie "0417200000000354" heeft de volgende gegevens:
"""
{
"straat": "Burgemeester van Nispen van Sevenaerstraat",
"huisnummer": 1,
"huisnummertoevoeging": "BEN",
"postcode": "1251KD",
"woonplaats": "Laren",
"korteNaam": "Burg v N v Sevenaerstr"
}
"""
Als het adres wordt gevraagd met /adressen/0417200000000354
Dan bevat het antwoord:
"""
{
"adresregel1": "Burg v N v Sevenaerstr 1 BEN",
"adresregel2": "1251 KD LAREN"
}
"""

Scenario: er is een huisnummertoevoeging die begint met een cijfer en er is geen huisletter
Gegeven adres met nummeraanduidingidentificatie "0289200000017214" heeft de volgende gegevens:
"""
{
"straat": "Bornsesteeg",
"huisnummer": 1,
"huisnummertoevoeging": "5A3",
"postcode": "6708GA",
"woonplaats": "Wageningen",
"korteNaam": "Bornsesteeg"
}
"""
Als het adres wordt gevraagd met /adressen/0014200022188962
Dan bevat het antwoord:
"""
{
"adresregel1": "Bornsesteeg 1-5A3",
"adresregel2": "6708 GA WAGENINGEN"
}
"""

Scenario: er is een huisletter en een huisnummertoevoeging die begint met een letter
Gegeven adres met nummeraanduidingidentificatie "0118200000264072" heeft de volgende gegevens:
"""
{
"straat": "Defensieweg",
"huisnummer": 16,
"huisletter": "D",
"huisnummertoevoeging": "K",
"postcode": "7933TL",
"woonplaats": "Pesse",
"korteNaam": "Defensieweg"
}
"""
Als het adres wordt gevraagd met /adressen/0118200000264072
Dan bevat het antwoord:
"""
{
"adresregel1": "Defensieweg 16 DK",
"adresregel2": "7933 TL PESSE"
}
"""

Scenario: er is een huisletter en een huisnummertoevoeging die begint met een cijfer
Gegeven adres met nummeraanduidingidentificatie "0484200002040489" heeft de volgende gegevens:
"""
{
"straat": "Belgiëlaan",
"huisnummer": 1,
"huisletter": "A",
"huisnummertoevoeging": "3",
"postcode": "2391PH",
"woonplaats": "Hazerswoude-Dorp",
"korteNaam": "Belgiëlaan"
}
"""
Als het adres wordt gevraagd met /adressen/0484200002040489
Dan bevat het antwoord:
"""
{
"adresregel1": "Belgiëlaan 1 A3",
"adresregel2": "2391 PH HAZERSWOUDE-DORP"
}
"""

Scenario: er is geen postcode
Gegeven adres met nummeraanduidingidentificatie "0518200001661726" heeft de volgende gegevens:
"""
{
"straat": "Zorgvlietstraat",
"huisnummer": 4,
"huisletter": "T",
"woonplaats": "'s-Gravenhage",
"korteNaam": "Zorgvlietstraat"
}
"""
Als het adres wordt gevraagd met /adressen/0518200001661726
Dan bevat het antwoord:
"""
{
"adresregel1": "Zorgvlietstraat 4 T",
"adresregel2": "'S-GRAVENHAGE"
}
"""
Loading

0 comments on commit 14d211a

Please sign in to comment.