Waste Container

Description

A waste container.

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 WasteContainer.

  • location : Container's location represented by a GeoJSON Point.

  • address: Civic address where the container is located.

  • fillingLevel : Filling level of the container (percentage, expressed in parts per one). When the container is full it must be equal to 1.0. When the container is empty it must be equal to 0.0. If it is not possible to determine the current filling level it must be equal to null.

    • Attribute type: Number
    • Attribute metadata:
      • timestamp: Timestamp when the last update of the attribute happened.
      • TimeInstant : Timestamp saved by FIWARE's IoT Agents. Note: This attribute has not been harmonized to keep backwards compatibility with current FIWARE reference implementations.
        • Type: DateTime. There can be production environmments where the attribute type is equal to the ISO8601 string. If so, it must be considered as a synonym of DateTime.
    • Allowed values: Interval [0,1].
    • Optional
  • fullnessThreshold : The level at which the container will generate a warning (percentage, expressed in parts per one). If the filling level passes this threshold, action should be taken to clean the container.

    • Attribute type: Number
    • Attribute metadata:
      • timestamp: Timestamp when the last update of the attribute happened.
      • TimeInstant : Timestamp saved by FIWARE's IoT Agents. Note: This attribute has not been harmonized to keep backwards compatibility with current FIWARE reference implementations.
        • Type: DateTime. There can be production environmments where the attribute type is equal to the ISO8601 string. If so, it must be considered as a synonym of DateTime.
    • Allowed values: Interval [0,1].
    • Optional
  • cargoWeight : Weight of the container load.

    • Attribute type: Number
    • Attribute metadata:
      • timestamp: Timestamp when the last update of the attribute happened.
      • TimeInstant : Timestamp saved by FIWARE's IoT Agents. Note: This attribute has not been harmonized to keep backwards compatibility with current FIWARE reference implementations.
        • Type: DateTime. There can be production environmments where the attribute type is equal to the ISO8601 string. If so, it must be considered as a synonym of DateTime.
    • Default Unit: Kilograms.
    • See also: https://schema.org/weight
    • Optional
  • temperature : Temperature inside the container.

    • Attribute type: Number
    • Attribute metadata:
      • timestamp: Timestamp when the last update of the attribute happened.
      • TimeInstant : Timestamp saved by FIWARE's IoT Agents. Note: This attribute has not been harmonized to keep backwards compatibility with current FIWARE reference implementations.
        • Type: DateTime. There can be production environmments where the attribute type is equal to the ISO8601 string. If so, it must be considered as a synonym of DateTime.
    • Default unit: Celsius Degrees.
    • Optional
  • methaneConcentration : Methane (CH4) concentration inside the container.

    • Attribute type: Number
    • Attribute metadata:
      • timestamp: Timestamp when the last update of the attribute happened.
      • TimeInstant : Timestamp saved by FIWARE's IoT Agents. Note: This attribute has not been harmonized to keep backwards compatibility with current FIWARE reference implementations.
        • Type: DateTime. There can be production environmments where the attribute type is equal to the ISO8601 string. If so, it must be considered as a synonym of DateTime.
    • Default unit: Micrograms per cubic meter.
    • Optional
  • storedWasteOrigin : Origin of the waste stored.

    • Attribute type: Text
    • Allowed values: one Of (household, municipal, industrial, construction, hostelry, agriculture, other)
      • Or any other value which does not fit within the former.
    • Optional
  • storedWasteKind : Kind/s of waste stored by the container.

    • Attribute type: List of Text
    • Allowed values: (organic, inorganic, glass, oil, plastic, metal, paper, batteries, electronics, hazardous, other)
      • Or any other value which does not fit within the former.
    • Optional
  • storedWasteCode : As per the regulation, waste codes which precisely identifies waste origin and kind.

    • Attribute type: List of Text
    • Allowed values: Depend on the target regulation. For Europe, check Europe's List of Waste.
    • Optional
  • refWasteContainerModel : Container's model.

  • serialNumber : Serial number of the container.

  • regulation : Regulation under which the container is operating.

    • Attribute type: List of Text
    • Optional
  • responsible : Responsible for the container, i.e. entity in charge of actuating (emptying, collecting etc.).

    • Attribute type: Text
    • Optional
  • owner : Container's owner.

    • Attribute type: Text
    • Optional
  • dateServiceStarted : Date at which the container started giving service.

    • Attribute Type: Date
    • Optional
  • dateLastEmptying : Timestamp which represents when the container was emptied last time.

  • nextActuationDeadline : Deadline for next actuation to be performed (emptying, picking up, etc.).

  • actuationHours : Hours suitable for performing actuations over the container.

  • dateLastCleaning : When the container was cleaned last time.

  • nextCleaningDeadline : Deadline for next cleaning.

  • refWasteContainerIsle : Isle where the container is placed.

  • isleId : Identifier (or name) of the isle where the container is placed. This attribute should be used when entities of type WasteContainerIsle are not being modelled specifically. Otherwise, refWasteContainerIsle should be used.

    • Attribute Type: Text
    • Optional
  • category : Container's category.

    • Attribute type: List of Text
    • Allowed Values:
      • All values allowed for the category property of WasteContainerModel.
      • fixed. Container is fixed to a wall, support or handle.
      • underground. Container is placed underground.
      • ground. Container is placed at ground level.
      • portable. Container can be moved around a certain extent.
      • Any other value which captures an aspect not covered by those referred above.
  • status : Container's status from the point of view of safety.

    • Attribute type: Text
    • Allowed Values:
      • ok. Container is where it must be and stands properly.
      • lidOpen. Container's lid has been opened and not closed after a certain amount of time.
      • dropped. Container has been dropped for some reason.
      • moved. Container has been moved from its regular position and has not come back.
      • vandalized. Container has been damaged or destroyed due to vandalism.
      • burning. Container is burning and an immediate action has to be taken.
    • Attribute metadata:
      • timestamp: Timestamp when the last update of the attribute happened.
      • TimeInstant : Timestamp saved by FIWARE's IoT Agents. Note: This attribute has not been harmonized to keep backwards compatibility with current FIWARE reference implementations.
        • Type: DateTime. There can be production environmments where the attribute type is equal to the ISO8601 string. If so, it must be considered as a synonym of DateTime.
    • Optional
  • color : Container's color

  • image : A URL containing a photo of the container.

  • description : Description about the container.

  • annotations : A field reserved for annotations (incidences, remarks, etc.).

    • Attribute type: List of Text
    • Optional
  • areaServed : Higher level area to which the container belongs to. It can be used to group containers per responsible, district, neighbourhood, etc.

  • dateModified : Last update timestamp of this entity

    • Attribute type: DateTime
    • Read-Only. Automatically generated.
  • TimeInstant : Timestamp saved by FIWARE's IoT Agent as per dynamic IoT data arrival. Note: This attribute has not been harmonized to keep backwards compatibility with current FIWARE reference implementations.

    • Attribute type: DateTime. There can be production environmments where the attribute type is equal to the ISO8601 string. If so, it must be considered as a synonym of DateTime.
    • Optional
  • refDevice : Reference to the device(s) used to monitor this container.

    • Attribute type: List of Reference to entity(ies) of type Device
    • Optional

Note: JSON Schemas only capture the NGSI simplified representation, this means that to test the JSON schema examples with a FIWARE NGSI version 2 API implementation, you need to use the keyValues mode (options=keyValues).

Examples of use

{
   "id": "wastecontainer:Fleming:12a",
   "type": "WasteContainer",
   "refWasteContainerModel": "wastecontainermodel:c1",
   "refWasteContainerIsle":  "wastecontainerisle:Fleming:12",
   "serialNumber": "ab56kjl",
   "location": {
     "type": "Point",
     "coordinates": [  -3.164485591715449, 40.62785133667262 ]
   },
   "fillingLevel" : 0.4,
   "dateLastEmptying": "2016-06-21T15:05:59.408Z",
   "nextActuationDeadline": "2016-06-28T15:05:59.408Z",
   "status": "ok",
   "category": ["underground"],
   "refDevice": ["device-Fleming:12a:1"]
}

Test it with real services

Open issues