FlowerBed

Description

A garden plot in which flowers (or other plants) are grown. Usually you will find flower beds in parks, gardens, pedestrian areas or at big highway interchanges.

Data Model

A JSON Schema corresponding to this data model can be found {{add link to JSON Schema}}

  • id : Unique identifier.

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

  • 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.
  • taxon : Used to indicate the biological taxon to which the trees, or plants in the flower bed belong.

    • Attribute type: Property. List of Text
    • Optional
  • category : Category of this flower bed.
    • Attribute type: Property. List of Text
    • Allowed values: (hedge, lawnArea, portable, urbanTreeSpot) or any extended value needed by the application.
    • Optional
  • width. Width of this flower bed.

  • height. Height of this flower bed.

  • depth. Depth of this flower bed.

  • shape. Shape of this flower bed.

    • Attribute type: Property. Text
    • Allowed values: One Of (rectangular, square, elliptic, polygonal, circular) or any other required by an application.
    • Optional
  • location : Location of the flower bed represented by a GeoJSON geometry.

  • address : Civic address of this flower bed.

  • dateLastWatering : Timestamp which corresponds to the last watering of the flower bed.

    • Attribute type: Property. DateTime
    • Optional
  • nextWateringDeadline : Deadline for next watering operation.

    • Attribute type: Property. DateTime
    • Optional
  • refGarden : Flower bed's garden (if it belongs to any).
    • Attribute type: Relationship. Reference to an entity of type Garden
    • Optional

There are two options for representing measurements observed:

  • A/ Through a linked entity of type GreenspaceRecord (attribute named refRecord).
  • B/ Through a group of measurement properties already defined by GreenspaceRecord.

Below is the description of the attribute to be used for option A/.

  • refRecord : List of records which contain measurements related to this flower bed.
    • Attribute type: Relationship. List of references to entities of type GreenspaceRecord
    • Optional

Note: JSON Schemas are intended to capture the data type and associated constraints of the different Attributes, regardless their final representation format in NGSI(v2, LD).

Examples

Normalized Example

Normalized NGSI response

{
    "id": "FlowerBed-345",
    "type": "FlowerBed",
    "category": {
        "value": ["urbanTreeSpot"]
    },
    "soilMoistureVwc": {
        "value": 0.85
    },
    "dateLastWatering": {
        "type": "DateTime",
        "value": "2017-03-31T08:00"
    },
    "soilTemperature": {
        "value": 17
    },
    "address": {
        "type": "PostalAddress",
        "value": {
            "addressCountry": "Spain",
            "streetAddress": "Paseo Zorrilla, 122",
            "adressLocality": "Valladolid"
        }
    }
}

key-value pairs Example

Sample uses simplified representation for data consumers ?options=keyValues

{
    "id": "FlowerBed-345",
    "type": "FlowerBed",
    "category": ["urbanTreeSpot"],
    "dateLastWatering": "2017-03-31T08:00",
    "address": {
        "streetAddress": "Paseo Zorrilla, 122",
        "adressLocality": "Valladolid",
        "addressCountry": "Spain"
    },
    "soilTemperature": 17,
    "soilMoistureVwc": 0.85
}

LD Example

Sample uses the NGSI-LD representation

{
    "id": "urn:ngsi-ld:FlowerBed:FlowerBed-345",
    "type": "FlowerBed",
    "category": {
        "type": "Property",
        "value": ["urbanTreeSpot"]
    },
    "soilMoistureVwc": {
        "type": "Property",
        "value": 0.85
    },
    "dateLastWatering": {
        "type": "Property",
        "value": {
            "@type": "DateTime",
            "@value": "2017-03-31T08:00:00Z"
        }
    },
    "soilTemperature": {
        "type": "Property",
        "value": 17
    },
    "address": {
        "type": "Property",
        "value": {
            "addressCountry": "Spain",
            "streetAddress": "Paseo Zorrilla, 122",
            "adressLocality": "Valladolid",
            "type": "PostalAddress"
        }
    },
    "location": {
        "type": "GeoProperty",
        "value": {
            "type": "Point",
            "coordinates": [-4.743187, 41.627999]
        }
    },
    "@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

Open Issues