Beach

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.
  • alternateName : Alternative name for this beach.

  • description : Description of this beach.

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

  • address : Address of this beach.

  • width : Width of this beach.

  • length : Length of this beach.

  • 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://uri.etsi.org/ngsi-ld/v1/ngsi-ld-core-context.jsonld",
        "https://schema.lab.fiware.org/ld/context"
    ]
}

Use it with a real service

Coming soon

Open Issues