Skip to content

Commit 7f6f78a

Browse files
geofizzydrinkgeofizzydrink
authored
Update 06-poi-publication-use-case.adoc
1 parent ca304f8 commit 7f6f78a

1 file changed

Lines changed: 156 additions & 55 deletions

File tree

‎22-053/sections/06-poi-publication-use-case.adoc‎

Lines changed: 156 additions & 55 deletions
Original file line numberDiff line numberDiff line change
@@ -1,68 +1,169 @@
11
[[poi_publication_use_case_section]]
2+
23
== POI Publication Use Case
34

4-
=== Use Case Overview
5-
Use case on the publication of domain specific data in a common POI-datamodel on a geoportal.
5+
## Introduction
6+
7+
The Digitaal Vlaanderen (DV) POI Service is a comprehensive initiative designed to standardize and publish location-based information collected by various Flemish government organizations. Different government bodies gather valuable data across diverse domains such as education, sports, tourism, and public health, which are of significant interest to both public and private organizations. These datasets often vary in format, content, and quality, posing challenges for integration and usability. The Digitaal Vlaanderen POI Service addresses these challenges by collecting these disparate datasets, standardizing them into a common POI data model, and ensuring consistency and interoperability.
8+
9+
## Key Statistics of the Digitaal Vlaanderen POI Service (2024)
10+
11+
- Over 10 years of active service.
12+
- 21 datasets from 8 government organizations.
13+
- Data input in 5 different formats (shp, csv, wfs, xml, json).
14+
- Organized into 8 themes, 17 categories, and 154 POI types.
15+
- As of 2024, over 199,000 POIs collected for the Flanders region.
16+
17+
By transforming heterogeneous data into a unified POI data model, Digitaal Vlaanderen not only enhances the accessibility and usability of the information but also facilitates seamless data sharing and integration across different platforms and applications. This standardized approach enables organizations to leverage high-quality, reliable data for various purposes, including urban planning, service delivery, and innovative technological applications such as augmented reality and geospatial analytics, thereby contributing to smarter, more efficient, and more connected communities.
18+
19+
## Standardized POI Data Model for Central Storage
20+
21+
A standardized relational POI data model, such as the one developed by Digitaal Vlaanderen, is essential for ensuring consistency and reliability in representing POI data collected from various government organizations. This model translates diverse datasets into a uniform format, effectively representing locations on maps with basic information such as the name, address, coordinates, and a link to more details. By adhering to this standardized model, Digitaal Vlaanderen can integrate and manage data from multiple sources, maintaining high data quality and facilitating seamless data sharing and usage across different platforms and applications.
622

7-
Institutes collect and create data for their own business processes. This data might be valuable (in part) to make available to a wide audience, particularly on a geoportal. Domain-specific details are not relevant to the intended end user. For example, to the end user it is interesting to know the location of a school and whether it has preschool, but not the official institution number or the name of the schools principal.
23+
## POI Service Product Development
824

9-
Basic information from a wide range of datasets can be mapped to the POI data model by using standard and nonstandard attributes.
25+
### Analysis
26+
- Assess the information in the different datasets for content and use, focusing on relevance to users.
27+
- Ensure accurate completion of the POI model and proper documentation.
1028

29+
### Modeling
30+
- Collaborate with data managers to define the POI data model mapping.
31+
- Determine georeferencing based on address or coordinates.
32+
- Link addresses to central databases to obtain coordinates if necessary.
33+
- Transform the supplied information into the POI product model, performing necessary checks and describing the data through metadata.
1134

12-
TODO
35+
### Public Access
36+
- Select the appropriate channel for the product.
37+
- Establish arrangements for access, use, and reuse.
1338

14-
=== Standard Attributes
39+
### Updating
40+
- Implement a 'production line' approach during product development to process all subsequent versions efficiently.
41+
- Manage maintenance, communication, and support.
1542

16-
* Identifying attributes
17-
** hasFeatureOfInterest
18-
** CreationDate
19-
** TerminationDate
20-
* Descriptive attributes
21-
** Description
22-
** Name
23-
** Alternative name
24-
** Classification (non-standard)
25-
* Contact attributes
43+
## Translating the Digitaal Vlaanderen POI Data Model into a POI JSON Template Following the OGC Conceptual Model
2644

27-
[source.JSON]
28-
----
45+
Translating the Digitaal Vlaanderen POI data model into a POI JSON template involves aligning the data structure with the OGC (Open Geospatial Consortium) Conceptual Model as outlined in the OGC POI Standard. This process ensures that the data is interoperable, consistent, and adheres to international standards. The OGC Conceptual Model provides a comprehensive framework that defines the attributes, relationships, and semantics necessary for accurately representing POIs. By following this model, the POI JSON template incorporates standardized elements such as geometric data, feature identification, contact information, metadata, rights, and payload attributes.
46+
47+
The template should be designed to serve as both an input and output format. As an input format, it ensures that data collected from various sources adheres to a common structure, facilitating seamless integration and processing. As an output format, it ensures that the published data is consistent and usable across different applications and platforms. This dual functionality not only facilitates seamless data integration and exchange between different systems and applications but also enhances the quality and reliability of the data. The result is a robust, flexible, and scalable template that supports various use cases, including smart city applications, augmented reality, and geospatial analytics, thereby maximizing the utility and impact of the published POI data.
48+
49+
## Benefits for Data Publishers and Developers
50+
51+
- **Consistency and Interoperability**: Ensures consistency across datasets, facilitating easier integration and use of diverse data sources.
52+
- **Efficiency and Reduced Costs**: Streamlines processes by adhering to common standards, reducing the need for custom solutions.
53+
- **Enhanced Data Quality**: Enforces uniform formats and definitions, leading to more accurate and reliable data.
54+
- **Simplified Data Sharing**: Facilitates collaboration and information exchange between organizations.
55+
- **Broader Reach and Impact**: Easier dissemination and access to data, increasing its utility and impact.
56+
- **Support for Advanced Technologies**: Enables the development of smart city applications, AR, and IoT technologies.
57+
58+
## Example JSON Schema Used by Digitaal Vlaanderen
59+
60+
```json
2961
{
30-
"properties" : {
31-
"POI" : {
32-
"contactInfo" : {
33-
"role" : "owner" (??),
34-
"party" : {
35-
"contactInfo" : {
36-
"address" : {
37-
"city" : "Ghent",
38-
"country" : "Belgium",
39-
"postalCode": "9040",
40-
"deliveryPoint" : "Victor Braeckmanlaan 180",
41-
"electronicMailAddress" : "rozebroeken@lago.be"
42-
},
43-
"phone" : {
44-
"number" : "+32 9 335 28 88"
45-
}
46-
},
47-
"name": "Sports Centre Lago"
48-
}
49-
}
50-
}
51-
}
62+
"type": "Feature",
63+
"geometry": {
64+
"type": "Point",
65+
"coordinates": [51.19391876816891, 5.1644166129636519]
66+
},
67+
"featureID": "c3bf1a5e-df00-4c93-89de-6b0e44e97806",
68+
"name": {
69+
"name": "AGC Glass Europe Mol"
70+
},
71+
"contactInfo": [{
72+
"role": "owner",
73+
"party": {
74+
"contactInfo": {
75+
"OnlineResource": "https://omgeving.vlaanderen.be/gpbv-installaties"
76+
},
77+
"name": "Afdeling Gebiedsontwikkeling, Omgevingsplanning en -projecten (GOP)"
78+
}
79+
}],
80+
"hasMetadata": {
81+
"href": "https://www.vlaanderen.be/datavindplaats/catalogus/gpbv-installaties-in-vlaanderen-in-het-kader-van-de-richtlijn-industriele-emissies-rie-via-poi-service",
82+
"rel": "about"
83+
},
84+
"rights": [{
85+
"otherConstraints": "Modellicentie_Gratis_Hergebruik"
86+
}],
87+
"hasPayload": {
88+
"usesSchema": [{
89+
"href": "https://genpoijson.org/schema/publicationpoi.json",
90+
"rel": "describedby"
91+
}],
92+
"onlineResources": [{
93+
"description": "Meer info over de installatie, waaronder de vergunningsbesluiten",
94+
"linkage": "https://gpbv.omgeving.vlaanderen.be/gpbv-register-beheer/installatiefiche/BE.VL.000000002.INSTALLATION"
95+
}],
96+
"locationInfo": [{
97+
"address": {
98+
"country": "Belgium",
99+
"deliveryPoint": "Voortstraat 27, 2400 Mol",
100+
"electronicMailAddress": "NA"
101+
},
102+
"phone": {
103+
"number": "NA"
104+
}
105+
}],
106+
"alternateName": {
107+
"name": "BE.VL.000000002.INSTALLATION"
108+
},
109+
"note": "Toeristische regio: Kust",
110+
"categories": [{
111+
"categoryType": "Type",
112+
"value": "MineraleIndustrie"
113+
}, {
114+
"categoryType": "Category",
115+
"value": "GPBVInstallatiesIndustrie"
116+
}, {
117+
"categoryType": "Theme",
118+
"value": "NatuurEnMilieu"
119+
}]
120+
}
52121
}
122+
```
123+
## POI Attributes Used
124+
125+
### Standard POI Attributes
126+
- **type**: "Feature"
127+
- **geometry**:
128+
- **type**: "Point"
129+
- **coordinates**: [51.19391876816891, 5.1644166129636519]
130+
- **featureID**: "c3bf1a5e-df00-4c93-89de-6b0e44e97806"
131+
- **name**:
132+
- **name**: "AGC Glass Europe Mol"
133+
- **contactInfo**:
134+
- **role**: "owner"
135+
- **party**:
136+
- **contactInfo**:
137+
- **OnlineResource**: "https://omgeving.vlaanderen.be/gpbv-installaties"
138+
- **name**: "Afdeling Gebiedsontwikkeling, Omgevingsplanning en -projecten (GOP)"
139+
- **hasMetadata**:
140+
- **href**: "https://www.vlaanderen.be/datavindplaats/catalogus/gpbv-installaties-in-vlaanderen-in-het-kader-van-de-richtlijn-industriele-emissies-rie-via-poi-service"
141+
- **rel**: "about"
142+
- **rights**:
143+
- **otherConstraints**: "Modellicentie_Gratis_Hergebruik"
53144

54-
----
55-
56-
* Location attributes
57-
* Metadata attributes
58-
** hasMetadata
59-
** Rights
60-
*** Reference (voor url)
61-
*** useLimitation ("gebruik en toegansbeperking")
62-
*** otherConstrains (voor omschrijving)
63-
64-
=== Nonstandard Attributes
65-
* Descriptive attributes
66-
** Classification (non-standard)
67-
* Referential attributes:
68-
** Links (non-standard)
145+
### Payload Attributes
146+
- **hasPayload**:
147+
- **usesSchema**:
148+
- **href**: "https://genpoijson.org/schema/publicationpoi.json"
149+
- **rel**: "describedby"
150+
- **onlineResources**:
151+
- **description**: "Meer info over de installatie, waaronder de vergunningsbesluiten"
152+
- **linkage**: "https://gpbv.omgeving.vlaanderen.be/gpbv-register-beheer/installatiefiche/BE.VL.000000002.INSTALLATION"
153+
- **locationInfo**:
154+
- **address**:
155+
- **country**: "Belgium"
156+
- **deliveryPoint**: "Voortstraat 27, 2400 Mol"
157+
- **electronicMailAddress**: "NA"
158+
- **phone**:
159+
- **number**: "NA"
160+
- **alternateName**:
161+
- **name**: "BE.VL.000000002.INSTALLATION"
162+
- **note**: "Toeristische regio: Kust"
163+
- **categories**:
164+
- **categoryType**: "Type"
165+
- **value**: "MineraleIndustrie"
166+
- **categoryType**: "Category"
167+
- **value**: "GPBVInstallatiesIndustrie"
168+
- **categoryType**: "Theme"
169+
- **value**: "NatuurEnMilieu"

0 commit comments

Comments
 (0)