belgif / openapi-location

OpenAPI data types for locations
Apache License 2.0
0 stars 1 forks source link

Schemas voor BeSt address #3

Open smals-vea opened 4 years ago

smals-vea commented 4 years ago

Voor de BeSt Address, zullen we een reusable schema voorstellen? zoals bvb: Address

pvdbosch commented 4 years ago

Some relevant documentation:

MarcBruyland commented 4 years ago

max. lengte van velden in BEST-data van eind maart 2020:

(base) C:\Users\marc.bruyland\OneDrive - GCloud Belgium\Documents\PRJ_BEST\Data>python BEST_Tools_MaxLength.py

Street nl 42 ['Albert en Marie-Louise Servais-Kinetstraat'] fr 54 ['Rue Marie-Christine Pironnet (Rue de la Waide Lonneux)'] de 31 ['Lager-Camp Elsenborn,Zosterbach']

Municipality nl 22 ['Sint-Lambrechts-Woluwe'] fr 26 ['Ottignies-Louvain-la-Neuve'] de 21 ['Scherpenheuvel-Zichem']

PostalInfo nl 210 ["Berg (Limb.)/Diets-Heur/Haren (Tongeren)/Henis/Kolmont (Tongeren)/Koninksem/Lauw/Mal/Neerrepen/Nerem/Overrepen (Kolmont)/Piringen (Haren)/Riksingen/Rutten/'s Herenelderen/Sluizen/Tongeren/Vreren/Widooie (Haren)"] fr 50 ['Schaerbeek + Bruxelles (Pont Van Praet, Teichmann)'] de 0 []

Address hs 11 ['2.........0'] bx 35 ['0004-blok A,inkom links-1ste rechts', '0004-blok B,inkom links-1ste rechts', '0002-1ste rechts(kant hoogboomstwg)']

pvdbosch commented 4 years ago

scope if this issue is the Belgian address (BeSt). A more generic address that includes foreign address would be more liberal in structure.

@MarcBruyland will look up existing schemas used for REST services

pvdbosch commented 4 years ago

relevant BOSA doc on BeSt services: https://dtservices.bosa.be/sites/default/files/content/best_services_userguide_v1.4.pdf

This page links to services with WSDL and XSDs.

At the bottom there are some "REST" services but looking further at the linked SoapUI projects, they aren't really proper REST APIs (XML instead of JSON, no URI parameters, not following the REST guide at all, ...); just SOAP services without the SOAP envelope.