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 to PointOfInterest.

  • dateModified : Last update timestamp of this entity.

    • Attribute type: DateTime
    • Read-Only. Automatically generated.
  • dateCreated : Entity's creation timestamp.

    • Attribute type: DateTime
    • Read-Only. Automatically generated.
  • source : A sequence of characters giving the source of the entity data.
    • Attribute type: Text or URL
    • Optional
  • name : Name of this point of interest.
  • alternateName : Alternative name for this point of interest.

  • description : Description of this point of interest.

  • location : Location of the point of interest represented by a GeoJSON geometry, usually a Point.

  • address : Civic address of this point of interest.
  • category : Category of this point of interest.
    • Attribute type: List of Text
    • Allowed values: Those defined by the Factual taxonomy. For instance the value 113 corresponds to beaches, and the value 311 corresponds to museums.
    • Mandatory
  • contactPoint : Contact point of this point of interest.
  • 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 1 (Normalized Format)

{
    "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"
    }
}

Examples of use 2 (?options=keyValues simplified representation for data consumers)

{
    "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.

Open Issues