Public API - OGC services - DRAFT

Bussiness case

Use cases:

Geopunt (TBD): (Eventueel ontdubbelen in punten en multipolygonen)
- Grondwerken vandaag
- Grondwerken vandaag + 1 maand
- Werken vandaag
- Werken vandaag + 1 maand
- Evenementen vandaag
- Evenementen vandaag + 1 maand
- Hinder vandaag
- Hinder vandaag + 1 maand
Brandweer / hulpdiensten
- Hinder, gefilterd op hinder gevolgen
GPS providers
- Hinder, gefilterd op hinder gevolgen
- Innames

GIPOD data wordt publiek ontsloten via OGC services:

WMS: Publiceert kaarten in rasterformaat (jpg,png,…)
WFS: Publiceert kaartdata in vectorformaat (xml, geojson, …)
API Features: Publiceert kaartdata als REST webservice html/json

Architectuur

Opmerkingen:

Innames/hinders worden ontsloten per occurrence/voorkomen.

Tabellen in public API DB

Innameoccurrence

Algemene filter: Enkel innames met status: concreet gepland, in uitvoering, lopende, uitgevoerd/afgelopen (nieuw toegevoegd 23/2/23)

Elke rij is één occurrence van een inname, deze worden in de toekomst berekend tot vb. 2100 (zelfde als in de back-end)

Attribuut	Type (bold = zoekbaar)	Berekening / Filtering	Opmerkingen / voorbeeld
ID	varchar (PK)	gipodId-[occurrence ID]	[GipodID]-YYMMDDHHMM vb: 342-2301171329
gipodId	integer
URI	varchar		`https://gipod.api.[test-/beta-]vlaanderen.be/api/v1/groundworks/10043834`
geometry	Geometry (MultiPolygon)	Unie van inname zones Punten omzetten in polygoon door buffer 0.25m toe te passen ~~Lijnen met buffer 0.25m~~
pointOnSurface	Geometry (Point)		enkel voor WMS
description
reference
type	varchar		Label (Werk / Evenement / grondwerk)
typeId	varchar		`https://gipod.api.[test-/beta-]vlaanderen.be/api/v1/taxonomies/.../60ad4826-893d-4695-b815-a0adb39287e4`
publicDomainOccupancyTypes	text	Puntkomma separated types	Type1; Type2
status	varchar	Enkel innames met status: concreet gepland, in uitvoering, lopende
statusId	varchar		Verwijziging naar taxonomie
start	datetime (UTC)
end	datetime (UTC)
timeSchedule (basis tekstje)	text		Tonen zoals in huidige WMS (wederkerigheid) Extra’s en uitzonderingen, mogelijk in afzonderlijk veld
owner	varchar
ownerId	varchar		`https://gipod.api.[test-/beta-]vlaanderen.be/api/v1/organisations/...`
contactOrganisations	text	Als tekst, 1 regel per contactgegeven: Rol: Organisatie, Naam, E-mail, Telefoon, URL;Rol2: Organisatie, Naam, E-mail, Telefoon, URL;	Te bekijken of dit wel de goeie oplossing is, splitsen in regels vs comma separated, …
mobilityHindrances (❗ aangepast, was consequences)	text	Puntkomma separated per hinder die gevolg is van deze inname	`https://private-api.gipod.vlaanderen.be/api/v1/mobility-hindrances/10043834`;`https://private-api.gipod.vlaanderen.be/api/v1/mobility-hindrances/10043666`
groundworkCategory	varchar	Enkel bij grondwerken, anders null
groundworkCategoryId	varchar		`https://gipod.api.[test-/beta-]vlaanderen.be/api/v1/taxonomies/.../60ad4826-893d-4695-b815-a0adb39287e4`
groundworkSpecification	text	Puntkomma separated specificatie
groundworkPartOfTrenchSynergy	text	Puntkomma separated Ssyn
createdOn	datetime
lastModifiedOn	datetime

HinderZoneoccurrence

Attribuut	Type (bold = index)	Berekening / Filtering	Opmerkingen / voorbeeld
ID	varchar (PK)	GUID zone-[occurrence ID]
URI	varchar		`https://private-api.gipod.vlaanderen.be/api/v1/mobility-hindrances/10043834/zones/0cd0ae5e-94b8-475d-aceb-5a6f50df0f95`
zoneId	varchar	GUID zone	`0cd0ae5e-94b8-475d-aceb-5a6f50df0f95`
geometry	Geometry (MultiPolygon)	MobilityHindranceZone
pointOnSurface	Geometry (Point)	enkel voor WMS
zoneType	varchar		Label
zoneTypeId	varchar		`https://private-api.gipod.vlaanderen.be/api/v1/taxonomies/.../60ad4826-893d-4695-b815-a0adb39287e4`
consequences	text	Puntkomma separated per consequence
hindranceGipodId	integer		Vanaf hier allemaal attributen van hinder
hindranceURI			`https://private-api.gipod.vlaanderen.be/api/v1/mobility-hindrances/10043834`
hindranceConsequenceOf	text	Puntkomma separated per concequenceOf
hindranceDescription	text
hindranceOwner	varchar		Label
hindranceOwnerId	varchar		Link naar organisatie
hindranceContactorganisations		Enkel publieke contactgegevens Als tekst, 1 regel per contactgegeven: Rol: Organisatie, Naam, E-mail, Telefoon, URL	oliver.may verder te bekijken (zie ook inname)
hindranceStart	datetime
hindranceEnd	datetime
hindranceStatus	varchar		Label
hindranceStatusId	varchar		Taxonomie
hindranceCreatedOn	datetime
hindranceLastModified	datetime

HinderZoneConsequence

Attribuut	Type (bold = index)	Berekening / Filtering	Opmerkingen / voorbeeld
ID	varchar (PK)	GUID zone-consequenceId-[occurrence ID]
URI	varchar		`https://private-api.gipod.vlaanderen.be/api/v1/mobility-hindrances/10043834/zones/0cd0ae5e-94b8-475d-aceb-5a6f50df0f95`
zoneId	varchar		`0cd0ae5e-94b8-475d-aceb-5a6f50df0f95`
geometry	Geometry (MultiPolygon)	MobilityHindranceZone
pointOnSurface	Geometry (Point)
zoneType	varchar		Label
zoneTypeId	varchar		`https://private-api.gipod.vlaanderen.be/api/v1/taxonomies/.../60ad4826-893d-4695-b815-a0adb39287e4`
consequence	varchar	Leaf uit consequence taxonomie boom	Label
consequenceTreeLevel0	varchar	Niveau 0 in de consequence taxonomie boom	vb. “Gemotoriseerd verkeer”
consequenceTreeLevel1	varchar	Niveau 1 in de consequence taxonomie boom (of null)	vb. “Hoogtebeperking”
consequenceTreeLevel2	varchar	Niveau 2 in de consequence taxonomie boom (of null)	vb. “Max x m hoogte”
consequenceTreeLevel3	varchar	Niveau 3 in de consequence taxonomie boom (of null)	vb. “Hoogtebeperking: max 2,5 m”
consequenceId	varchar	Id Leaf uit consequence taxonomie boom
consequenceTreeLevel0Id	varchar	Id Niveau 0 in de consequence taxonomie boom
consequenceTreeLevel1Id	varchar	Id Niveau 1 in de consequence taxonomie boom (of null)
consequenceTreeLevel2Id	varchar	Id Niveau 2 in de consequence taxonomie boom (of null)
consequenceTreeLevel3Id	varchar	Id Niveau 3 in de consequence taxonomie boom (of null)
hindranceStatus	varchar		Label
hindranceStatusId	varchar		`https://private-api.gipod.vlaanderen.be/api/v1/taxonomies/.../60ad4826-893d-4695-b815-a0adb39287e4`
hindranceCreatedOn	datetime
hindranceLastModified	datetime
hindranceGipodId	integer		Vanaf hier allemaal attributen van hinder
hindranceURI			`https://private-api.gipod.vlaanderen.be/api/v1/mobility-hindrances/10043834`

Datalagen WFS / API Features

Inname
- Inname occurrence point on surface
- Inname occurrence multipolygoon
Mobiliteitshinder
- Mobiliteitshinder occurrence point on surface
- Mobiliteitshinder occurrence multipolygoon
Mobiliteitshindergevolg
- Mobiliteitshindergevolg occurrence point on surface
- Mobiliteitshindergevolg occurrence multipolygoon