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
. -
dateModified
: Last update timestamp of this entity.- Attribute type: DateTime
- Optional
-
dateCreated
: Entity's creation timestamp.- Attribute type: DateTime
- Optional
-
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](https://schema.org/description]
- Optional
-
location
: Location of the point of interest represented by a GeoJSON geometry, usually aPoint
.- Attribute type:
geo:json
. - Normative References: https://tools.ietf.org/html/rfc7946
- Mandatory if
address
is not defined.
- Attribute type:
-
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: List of text Text
- Allowed values: Those defined by the Factual taxonomy.
For instance the value
113
corresponds to beaches, and the value311
corresponds to museums. - Mandatory
-
refSeeAlso
: Reference to one or more related entities that may provide extra, specific information about this point of interest.- Attribute type: List of References
- Optional
Examples of use
{
"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"]
}
Use it with a real service
The instance described here has been set up by the FIWARE Community.
Get POIs around Fira Montjuic (2 Kms around)
curl -S --header 'fiware-service:poi' --header 'fiware-servicepath:/Spain' --header 'x-auth-token:dd3a796995294dc5b6d7bf2cdb36e15f' “http://130.206.118.244:1027/v2/entities?type=PointOfInterest&attrs=location,name&orderBy=geo:distance&georel=near;maxDistance:2000&geometry=point&coords=41.3730751,2.1482742&options=keyValues”