Document toolboxDocument toolbox

Public API - OGC services - DRAFT

Owned by oliver.may
Last updated: 12 Dec, 2024
3 min read

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

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

text

 

 

Reference

text

 

 

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, uitgevoerd/afgelopen

 

StatusId

varchar

 

Verwijziging naar taxonomie

Start

datetime (UTC)

 

 

End

datetime (UTC)

 

 

TimeSchedule

text

(basis tekstje)

Tonen zoals in huidige WMS (wederkerigheid)

Extra’s en uitzonderingen, mogelijk in afzonderlijk veld

Owner

varchar

 

 

OownerId

varchar

 

https://gipod.api.[test-/beta-]vlaanderen.be/api/v1/organisations/...

ContactOrganisations

text

Als tekst, gescheiden door puntkomma:

Rol: Organisatie, Naam, E-mail, Telefoon, URL;Rol2: Organisatie, Naam, E-mail, Telefoon, URL;

 

MobilityHindrances ( aangepast, was consequences)

text

Puntkomma separated per hinder die gevolg is van deze inname

https://gipod.api.[test-/beta-]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

 

Dit is de datum van publicatie naar geoservices, niet de datum van aanmaak innam in GIPOD

LastModifiedOn

datetime

 

 

HinderZoneoccurrence

Attribuut

Type (bold = index)

Berekening / Filtering

Opmerkingen / voorbeeld

Attribuut

Type (bold = index)

Berekening / Filtering

Opmerkingen / voorbeeld

ID

varchar (PK)

GUID zone-[occurrence ID]

 

Uri

varchar

 

https://gipod.api.[test-/beta-]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://gipod.api.[test-/beta-]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://gipod.api.[test-/beta-]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, gescheiden door puntkomma, als tekst:

Rol: Organisatie, Naam, E-mail, Telefoon, URL

 

HindranceStart

datetime

 

 

HindranceEnd

datetime

 

 

HindranceStatus

varchar

 

Label

HindranceStatusId

varchar

 

Taxonomie

HindranceCreatedOn

datetime

 

 

HindranceLastModified

datetime

 

 

SevereHindrance

 

 

 

HinderZoneConsequence

Attribuut

Type (bold = index)

Berekening / Filtering

Opmerkingen / voorbeeld

Attribuut

Type (bold = index)

Berekening / Filtering

Opmerkingen / voorbeeld

ID

varchar (PK)

GUID zone-consequenceId-[occurrence ID]

 

Uri

varchar

 

https://gipod.api.[test-/beta-]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://gipod.api.[test-/beta-]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)

 

HindranceGipodId

integer

 

Vanaf hier allemaal attributen van hinder

HindranceURI

 

 

https://gipod.api.[test-/beta-]vlaanderen.be/api/v1/mobility-hindrances/10043834

HindranceStart

datetime

 

 

HindranceEnd

datetime

 

 

HindranceStatus

varchar

 

Label

HindranceStatusId

varchar

 

https://gipod.api.[test-/beta-]vlaanderen.be/api/v1/taxonomies/.../60ad4826-893d-4695-b815-a0adb39287e4

HindranceCreatedOn

datetime

 

 

HindranceLastModified

datetime

 

 

HindranceDescription

varchar

 

 

HindranceOwner

varchar

 

 

HindranceOwnerId

varchar

 

 

HeightLimitation

int

 

 

WidthLimitation

int

 

 

SevereHindrance

boolean

 

 

Datalagen WFS / API Features

  • Inname occurrence multipolygoon

  • Mobiliteitshinder occurrence multipolygoon

  • Mobiliteitshindergevolg occurrence multipolygoon

 

Datalagen WMS

  • GIPOD vandaag

    • Inname vandaag

      • Grondwerken vandaag

      • Werken vandaag

      • Evenementen vandaag

      • Grondwerken vandaag icoon

      • Werken vandaag icoon

      • Evenementen vandaag icoon

    • Mobiliteitshinder vandaag

      • Mobiliteitshinder vandaag

      • Mobiliteitshinder vandaag icoon

  • GIPOD komende maand

    • Inname vandaag +30 dagen

      • Grondwerken vandaag +30d

      • Werken vandaag +30d

      • Evenementen vandaag +30d

      • Grondwerken vandaag +30d icoon

      • Werken vandaag +30d icoon

      • Evenementen vandaag +30d icoon

    • Mobiliteitshinder vandaag +30 dagen

      • Mobiliteitshinder vandaag +30d

      • Mobiliteitshinder vandaag +30d icoon