Point of interest
Description
This entity contains a harmonised geographic description of a Point of Interest. This entity is used in applications that use spatial data and is applicable to Automotive, Environment, Industry and Smart City vertical segments and related IoT applications. This data model has been created in cooperation with the GSMA and the members of the IoT Big Data Project.
Data Model
A JSON Schema corresponding to this data model can be found here
-
id
: Unique identifier. -
type
: Entity type. It must be equal toPointOfInterest
. -
dataProvider
: Specifies the URL to information about the provider of this information- Attribute type: Property. URL
- Optional
-
dateModified
: Last update timestamp of this entity.- Attribute type: Property. DateTime
- Read-Only. Automatically generated.
-
dateCreated
: Entity's creation timestamp.- Attribute type: Property. DateTime
- Read-Only. Automatically generated.
-
source
: A sequence of characters giving the source of the entity data. -
name
: Name of this point of interest.- Normative References: https://schema.org/name
- Mandatory
-
alternateName
: Alternative name for this point of interest.- Normative References: https://schema.org/alternateName
- Optional
-
description
: Description of this point of interest.- Normative References: https://schema.org/description
- Optional
-
location
: Location of the point of interest represented by a GeoJSON geometry, usually aPoint
.- Attribute type: Property.
geo:json
. - Normative References: https://tools.ietf.org/html/rfc7946
- Mandatory if
address
is not defined.
- Attribute type: Property.
-
address
: Civic address of this point of interest.- Normative References: https://schema.org/address
- Mandatory if
location
is not present.
-
category
: Category of this point of interest.- Attribute type: Property. List of Text
- Allowed values: Those defined by the
Factual taxonomy
together with the extended categories described by the present
specification (see below). For instance the value
113
corresponds to beaches, and the value311
corresponds to museums. - Mandatory
-
contactPoint
: Contact point of this point of interest.- Normative references: https://schema.org/contactPoint
- Optional
-
refSeeAlso
: Reference to one or more related entities that may provide extra, specific information about this point of interest.- Attribute type: Property. List of References
- Optional
Extended POI Categories
Category | Description |
---|---|
1478 |
Public drinking fountain |
1479 |
Public toilet |
1480 |
Registry office |
Examples
Normalized Example
Normalized NGSI response
{
"id": "PointOfInterest-A-Concha-123456",
"type": "PointOfInterest",
"category": {
"value": ["113"]
},
"description": {
"value": "La Playa de A Concha se presenta como una continuaci\u00f3n de la Playa de Compostela, una de las m\u00e1s frecuentadas de Vilagarc\u00eda."
},
"refSeeAlso": {
"type": "Relationship",
"value": ["Beach-A-Concha-123456"]
},
"source": {
"value": "http://www.tourspain.es"
},
"location": {
"type": "geo:json",
"value": {
"type": "Point",
"coordinates": [-8.768460000000001, 42.60214472222222]
}
},
"address": {
"type": "PostalAddress",
"value": {
"addressCountry": "ES",
"addressLocality": "Vilagarc\u00eda de Arousa"
}
},
"name": {
"value": "Playa de a Concha"
}
}
key-value pairs Example
Sample uses simplified representation for data consumers ?options=keyValues
{
"id": "PointOfInterest-A-Concha-123456",
"type": "PointOfInterest",
"name": "Playa de a Concha",
"description": "La Playa de A Concha se presenta como una continuación de la Playa de Compostela, una de las más frecuentadas de Vilagarcía.",
"address": {
"addressCountry": "ES",
"addressLocality": "Vilagarcía de Arousa"
},
"category": ["113"],
"location": {
"type": "Point",
"coordinates": [-8.768460000000001, 42.60214472222222]
},
"source": "http://www.tourspain.es",
"refSeeAlso": ["Beach-A-Concha-123456"]
}
LD Example
Sample uses the NGSI-LD representation
{
"id": "urn:ngsi-ld:PointOfInterest:PointOfInterest-A-Concha-123456",
"type": "PointOfInterest",
"category": {
"type": "Property",
"value": ["113"]
},
"description": {
"type": "Property",
"value": "La Playa de A Concha se presenta como una continuaci\u00f3n de la Playa de Compostela, una de las m\u00e1s frecuentadas de Vilagarc\u00eda."
},
"refSeeAlso": {
"type": "Relationship",
"object": ["urn:ngsi-ld:SeeAlso:Beach-A-Concha-123456"]
},
"source": {
"type": "Property",
"value": "http://www.tourspain.es"
},
"location": {
"type": "GeoProperty",
"value": {
"type": "Point",
"coordinates": [-8.768460000000001, 42.60214472222222]
}
},
"address": {
"type": "Property",
"value": {
"addressCountry": "ES",
"addressLocality": "Vilagarc\u00eda de Arousa",
"type": "PostalAddress"
}
},
"name": {
"type": "Property",
"value": "Playa de a Concha"
},
"@context": [
"https://uri.etsi.org/ngsi-ld/v1/ngsi-ld-core-context.jsonld",
"https://schema.lab.fiware.org/ld/context"
]
}
Use it with a real service
The instance described here has been set up by the FIWARE Community.