Beach

This repository is now archived and subsequent works will be carried out the in Smart data models repositories. The latest version of this Data Model can be found at https://github.com/smart-data-models/dataModel.PointOfInterest**

Description

This entity contains a harmonised geographic description of a beach. It is used in applications that use spatial data and is applicable to Tourism, Environment, and Smart City vertical segments and related IoT applications. Special thanks to TURESPAÑA who provided some examples which inspired the development of this data model.

Data Model

A JSON Schema corresponding to this data model can be found here. This entity type has been designed as an extension of https://schema.org/Beach so that any property specified by schema.org and which domain is https://schema.org/Beach can be used by applications.

• id : Unique identifier.

• type : Entity type. It must be equal to Beach.

• 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.
  • Attribute type: Property. Text or URL
  • Optional
• name : Name of this beach.
  • Normative References: https://schema.org/name
  • Mandatory

• alternateName : Alternative name for this beach.

  • Attribute type: Property. Text
  • Normative References: https://schema.org/alternateName
  • Optional

• description : Description of this beach.

  • Attribute type: Property. Text
  • Normative References: https://uri.etsi.org/ngsi-ld/description equivalent to description
  • Optional

• location : Location of this beach represented by a GeoJSON geometry, usually a Point or a Polygon.

  • Attribute type: Property. geo:json.
  • Normative References: https://tools.ietf.org/html/rfc7946
  • Mandatory if address is not defined.

• address : Address of this beach.

  • Normative References: https://schema.org/address
  • Mandatory if location is not present.

• width : Width of this beach.

  • Normative References: https://schema.org/width
  • Default unit: meter
  • Optional

• length : Length of this beach.

  • Normative References: https://schema.org/length
  • Default unit: meter
  • Optional

• beachType : Type of beach according to different criteria.

  • Attribute type: Property. List of Text
  • Allowed Values: (whiteSand, urban, isolated, calmWaters, blueFlag, Q-Quality, strongWaves, windy, blackSand) or any other value needed by an application.
  • Optional

• occupationRate : Typical occupation rate of this beach.

  • Attribute type: Property. Text
  • Allowed Values: (low, medium, high)
  • Optional

• facilities : Describes different facilities offered by this beach.

  • Attribute type: Property. List of Text
  • Allowed values: (promenade, showers, cleaningServices, lifeGuard, sunshadeRental, sunLoungerRental, waterCraftRental, toilets, touristOffice, litterBins, telephone, surfPracticeArea, accessforDisabled) or any other value needed by an application.
  • Optional

• accessType : Describes how to get to this beach.

  • Attribute type: Property. List of Text
  • Allowed values: (privateVehicle, boat, onFoot, publicTransport)
  • Optional

• refSeeAlso : Reference to one or more related entities.

  • Attribute type: Relationship. List of References
  • Optional

Examples

Normalized Example

Normalized NGSI response

{
    "id": "Beach-A-Concha-123456",
    "type": "Beach",
    "description": {
        "value": "La Playa de A Concha se presenta ....."
    },
    "width": {
        "value": 51
    },
    "accessType": {
        "value": ["privateVehicle", "onFoot", "publicTransport"]
    },
    "location": {
        "type": "geo:json",
        "value": {
            "type": "Point",
            "coordinates": [-8.768460000000001, 42.60214472222222]
        }
    },
    "facilities": {
        "value": ["promenade", "showers", "cleaningServices", "lifeGuard"]
    },
    "length": {
        "value": 450
    },
    "source": {
        "value": "http://www.tourspain.es"
    },
    "address": {
        "type": "PostalAddress",
        "value": {
            "addressCountry": "ES",
            "addressLocality": "Vilagarc\u00eda de Arousa"
        }
    },
    "beachType": {
        "value": ["whiteSand", "urban", "calmWaters"]
    },
    "occupationRate": {
        "value": "high"
    },
    "name": {
        "value": "Playa de a Concha"
    }
}

key-value pairs Example

Sample uses simplified representation for data consumers ?options=keyValues

{
    "id": "Beach-A-Concha-123456",
    "type": "Beach",
    "name": "Playa de a Concha",
    "description": "La Playa de A Concha se presenta .....",
    "address": {
        "addressCountry": "ES",
        "addressLocality": "Vilagarcía de Arousa"
    },
    "beachType": ["whiteSand", "urban", "calmWaters"],
    "occupationRate": "high",
    "facilities": ["promenade", "showers", "cleaningServices", "lifeGuard"],
    "accessType": ["privateVehicle", "onFoot", "publicTransport"],
    "location": {
        "type": "Point",
        "coordinates": [-8.768460000000001, 42.60214472222222]
    },
    "width": 51,
    "length": 450,
    "source": "http://www.tourspain.es"
}

LD Example

Sample uses the NGSI-LD representation

{
    "id": "urn:ngsi-ld:Beach:Beach-A-Concha-123456",
    "type": "Beach",
    "description": {
        "type": "Property",
        "value": "La Playa de A Concha se presenta ....."
    },
    "width": {
        "type": "Property",
        "value": 51
    },
    "accessType": {
        "type": "Property",
        "value": ["privateVehicle", "onFoot", "publicTransport"]
    },
    "location": {
        "type": "GeoProperty",
        "value": {
            "type": "Point",
            "coordinates": [-8.768460000000001, 42.60214472222222]
        }
    },
    "facilities": {
        "type": "Property",
        "value": ["promenade", "showers", "cleaningServices", "lifeGuard"]
    },
    "length": {
        "type": "Property",
        "value": 450
    },
    "source": {
        "type": "Property",
        "value": "http://www.tourspain.es"
    },
    "address": {
        "type": "Property",
        "value": {
            "addressCountry": "ES",
            "addressLocality": "Vilagarc\u00eda de Arousa",
            "type": "PostalAddress"
        }
    },
    "beachType": {
        "type": "Property",
        "value": ["whiteSand", "urban", "calmWaters"]
    },
    "occupationRate": {
        "type": "Property",
        "value": "high"
    },
    "name": {
        "type": "Property",
        "value": "Playa de a Concha"
    },
    "@context": [
        "https://schema.lab.fiware.org/ld/context",
        "https://uri.etsi.org/ngsi-ld/v1/ngsi-ld-core-context.jsonld"
    ]
}

Use it with a real service

Coming soon

Open Issues