Entità: Sensore

Descrizione globale: Un dispositivo che rileva e risponde a eventi o cambiamenti nell'ambiente fisico, come luce, movimento o variazioni di temperatura. Inoltre, un dispositivo della categoria saref:Sensor che esegue una saref:SensingFunction.

versione: 0.0.1

Elenco delle proprietà

^{_{[*] Se non c'è un tipo in un attributo è perché potrebbe avere diversi tipi o diversi formati/modelli}}.

address[object]: L'indirizzo postale . Model: https://schema.org/address
- addressCountry[string]: Il paese. Ad esempio, la Spagna . Model: https://schema.org/addressCountry
- addressLocality[string]: La località in cui si trova l'indirizzo civico e che si trova nella regione . Model: https://schema.org/addressLocality
- addressRegion[string]: La regione in cui si trova la località, e che si trova nel paese . Model: https://schema.org/addressRegion
- district[string]: Un distretto è un tipo di divisione amministrativa che, in alcuni paesi, è gestita dal governo locale.
- postOfficeBoxNumber[string]: Il numero di casella postale per gli indirizzi di casella postale. Ad esempio, 03578 . Model: https://schema.org/postOfficeBoxNumber
- postalCode[string]: Il codice postale. Ad esempio, 24004 . Model: https://schema.org/https://schema.org/postalCode
- streetAddress[string]: L'indirizzo stradale . Model: https://schema.org/streetAddress
alternateName[string]: Un nome alternativo per questa voce
areaServed[string]: L'area geografica in cui viene fornito il servizio o l'articolo offerto. . Model: https://schema.org/Text
dataProvider[string]: una sequenza di caratteri che identifica il fornitore dell'entità di dati armonizzati
dateCreated[date-time]: Timestamp di creazione dell'entità. Di solito viene assegnato dalla piattaforma di archiviazione
dateModified[date-time]: Timestamp dell'ultima modifica dell'entità. Di solito viene assegnato dalla piattaforma di archiviazione
description[string]: Descrizione dell'articolo
hasManufacturer[string]: Una relazione che identifica il produttore di un'entità (ad esempio, un dispositivo). Si prevede che il valore sia una stringa o una stringa con tag linguistico
hasModel[string]: Una relazione che identifica il modello di un'entità (ad esempio, un dispositivo). Il valore dovrebbe essere una stringa o una stringa con tag lingua
hasSensingRange[number]: Una relazione tra una funzione di rilevamento e una misura che identifica il campo di rilevamento di un sensore
hasSensorType[string]: Una relazione che identifica il tipo di rilevamento di un sensore (ad esempio, temperatura, occupazione, umidità, movimento, fumo, pressione, ecc.)
id[*]: Identificatore univoco dell'entità
isContainedInBuildingSpace[*]: Entità utilizzata per definire gli spazi fisici dell'edificio. Uno spazio dell'edificio contiene dispositivi o oggetti dell'edificio. (Spazio edificio)
isContainedInPhysicalObject[*]: Qualsiasi oggetto che abbia una regione spaziale propria. (Definizione estratta dall'ontologia DUL) (PhysicalObject)
isSubSystemOf[array]: Un riferimento a uno o più sistemi di cui l'oggetto fisico fa parte.
location[*]: Riferimento geojson all'elemento. Può essere un punto, una stringa di linea, un poligono, un multi-punto, una stringa di linea o un poligono multiplo.
name[string]: Il nome di questo elemento
owner[array]: Un elenco contenente una sequenza di caratteri codificata JSON che fa riferimento agli ID univoci dei proprietari.
seeAlso[*]: elenco di uri che puntano a risorse aggiuntive sull'elemento
source[string]: Una sequenza di caratteri che indica la fonte originale dei dati dell'entità come URL. Si consiglia di utilizzare il nome di dominio completamente qualificato del provider di origine o l'URL dell'oggetto di origine.
type[string]: Deve essere uguale a Sensore.

Proprietà richieste

id
type

Modello di dati descrizione delle proprietà

Ordinati in ordine alfabetico (clicca per i dettagli)

full yaml details

Sensor:      
  description: 'A device that detects and responds to events or changes in the physical environment such as light, motion, or temperature changes. Further, a device of category saref:Sensor that performs a saref:SensingFunction.'      
  properties:      
    address:      
      description: The mailing address      
      properties:      
        addressCountry:      
          description: 'The country. For example, Spain'      
          type: string      
          x-ngsi:      
            model: https://schema.org/addressCountry      
            type: Property      
        addressLocality:      
          description: 'The locality in which the street address is, and which is in the region'      
          type: string      
          x-ngsi:      
            model: https://schema.org/addressLocality      
            type: Property      
        addressRegion:      
          description: 'The region in which the locality is, and which is in the country'      
          type: string      
          x-ngsi:      
            model: https://schema.org/addressRegion      
            type: Property      
        district:      
          description: 'A district is a type of administrative division that, in some countries, is managed by the local government'      
          type: string      
          x-ngsi:      
            type: Property      
        postOfficeBoxNumber:      
          description: 'The post office box number for PO box addresses. For example, 03578'      
          type: string      
          x-ngsi:      
            model: https://schema.org/postOfficeBoxNumber      
            type: Property      
        postalCode:      
          description: 'The postal code. For example, 24004'      
          type: string      
          x-ngsi:      
            model: https://schema.org/https://schema.org/postalCode      
            type: Property      
        streetAddress:      
          description: The street address      
          type: string      
          x-ngsi:      
            model: https://schema.org/streetAddress      
            type: Property      
        streetNr:      
          description: Number identifying a specific property on a public street      
          type: string      
          x-ngsi:      
            type: Property      
      type: object      
      x-ngsi:      
        model: https://schema.org/address      
        type: Property      
    alternateName:      
      description: An alternative name for this item      
      type: string      
      x-ngsi:      
        type: Property      
    areaServed:      
      description: The geographic area where a service or offered item is provided      
      type: string      
      x-ngsi:      
        model: https://schema.org/Text      
        type: Property      
    dataProvider:      
      description: A sequence of characters identifying the provider of the harmonised data entity      
      type: string      
      x-ngsi:      
        type: Property      
    dateCreated:      
      description: Entity creation timestamp. This will usually be allocated by the storage platform      
      format: date-time      
      type: string      
      x-ngsi:      
        type: Property      
    dateModified:      
      description: Timestamp of the last modification of the entity. This will usually be allocated by the storage platform      
      format: date-time      
      type: string      
      x-ngsi:      
        type: Property      
    description:      
      description: A description of this item      
      type: string      
      x-ngsi:      
        type: Property      
    hasManufacturer:      
      description: 'A relationship identifying the manufacturer of an entity (e.g., device). The value is expected to be a string or a string with language tag'      
      type: string      
      x-ngsi:      
        type: Property      
    hasModel:      
      description: 'A relationship identifying the model of an entity (e.g., device). The value is expected to be a string or a string with language tag'      
      type: string      
      x-ngsi:      
        type: Property      
    hasSensingRange:      
      description: A relationship between a sensing function and a measurement identifying the range of a sensor detection      
      type: number      
      x-ngsi:      
        type: Property      
    hasSensorType:      
      description: 'A relationship identifying the sensing type of a sensor detection (i.e., Temperature, Occupancy, Humidity, Motion , Smoke, Pressure, etc.) '      
      enum:      
        - CO2Concentration      
        - DirectNormalIrradiation      
        - Energy      
        - Humidity      
        - Light      
        - Motion      
        - Occupancy      
        - OpeningPosition      
        - Power      
        - Pressure      
        - Price      
        - Smoke      
        - Temperature      
      type: string      
      x-ngsi:      
        type: Property      
    id:      
      anyOf:      
        - description: Identifier format of any NGSI entity      
          maxLength: 256      
          minLength: 1      
          pattern: ^[\w\-\.\{\}\$\+\*\[\]`|~^@!,:\\]+$      
          type: string      
          x-ngsi:      
            type: Property      
        - description: Identifier format of any NGSI entity      
          format: uri      
          type: string      
          x-ngsi:      
            type: Property      
      description: Unique identifier of the entity      
      x-ngsi:      
        type: Property      
    isContainedInBuildingSpace:      
      anyOf:      
        - description: Identifier format of any NGSI entity      
          maxLength: 256      
          minLength: 1      
          pattern: ^[\w\-\.\{\}\$\+\*\[\]`|~^@!,:\\]+$      
          type: string      
          x-ngsi:      
            type: Property      
        - description: Identifier format of any NGSI entity      
          format: uri      
          type: string      
          x-ngsi:      
            type: Property      
      description: An entity used to define the physical spaces of the building. A building space contains devices or building objects. (BuildingSpace)      
      x-ngsi:      
        type: Property      
    isContainedInPhysicalObject:      
      anyOf:      
        - description: Identifier format of any NGSI entity      
          maxLength: 256      
          minLength: 1      
          pattern: ^[\w\-\.\{\}\$\+\*\[\]`|~^@!,:\\]+$      
          type: string      
          x-ngsi:      
            type: Property      
        - description: Identifier format of any NGSI entity      
          format: uri      
          type: string      
          x-ngsi:      
            type: Property      
      description: Any Object that has a proper space region.  (Definition extracted from DUL ontology) (PhysicalObject)      
      x-ngsi:      
        type: Property      
    isSubSystemOf:      
      description: A reference to a system(s) that this Physical Object is part of      
      items:      
        anyOf:      
          - description: Identifier format of any NGSI entity      
            maxLength: 256      
            minLength: 1      
            pattern: ^[\w\-\.\{\}\$\+\*\[\]`|~^@!,:\\]+$      
            type: string      
            x-ngsi:      
              type: Property      
          - description: Identifier format of any NGSI entity      
            format: uri      
            type: string      
            x-ngsi:      
              type: Property      
        description: Unique identifier of the entity      
        x-ngsi:      
          type: Property      
      type: array      
      x-ngsi:      
        type: Relationship      
    location:      
      description: 'Geojson reference to the item. It can be Point, LineString, Polygon, MultiPoint, MultiLineString or MultiPolygon'      
      oneOf:      
        - description: Geojson reference to the item. Point      
          properties:      
            bbox:      
              items:      
                type: number      
              minItems: 4      
              type: array      
            coordinates:      
              items:      
                type: number      
              minItems: 2      
              type: array      
            type:      
              enum:      
                - Point      
              type: string      
          required:      
            - type      
            - coordinates      
          title: GeoJSON Point      
          type: object      
          x-ngsi:      
            type: GeoProperty      
        - description: Geojson reference to the item. LineString      
          properties:      
            bbox:      
              items:      
                type: number      
              minItems: 4      
              type: array      
            coordinates:      
              items:      
                items:      
                  type: number      
                minItems: 2      
                type: array      
              minItems: 2      
              type: array      
            type:      
              enum:      
                - LineString      
              type: string      
          required:      
            - type      
            - coordinates      
          title: GeoJSON LineString      
          type: object      
          x-ngsi:      
            type: GeoProperty      
        - description: Geojson reference to the item. Polygon      
          properties:      
            bbox:      
              items:      
                type: number      
              minItems: 4      
              type: array      
            coordinates:      
              items:      
                items:      
                  items:      
                    type: number      
                  minItems: 2      
                  type: array      
                minItems: 4      
                type: array      
              type: array      
            type:      
              enum:      
                - Polygon      
              type: string      
          required:      
            - type      
            - coordinates      
          title: GeoJSON Polygon      
          type: object      
          x-ngsi:      
            type: GeoProperty      
        - description: Geojson reference to the item. MultiPoint      
          properties:      
            bbox:      
              items:      
                type: number      
              minItems: 4      
              type: array      
            coordinates:      
              items:      
                items:      
                  type: number      
                minItems: 2      
                type: array      
              type: array      
            type:      
              enum:      
                - MultiPoint      
              type: string      
          required:      
            - type      
            - coordinates      
          title: GeoJSON MultiPoint      
          type: object      
          x-ngsi:      
            type: GeoProperty      
        - description: Geojson reference to the item. MultiLineString      
          properties:      
            bbox:      
              items:      
                type: number      
              minItems: 4      
              type: array      
            coordinates:      
              items:      
                items:      
                  items:      
                    type: number      
                  minItems: 2      
                  type: array      
                minItems: 2      
                type: array      
              type: array      
            type:      
              enum:      
                - MultiLineString      
              type: string      
          required:      
            - type      
            - coordinates      
          title: GeoJSON MultiLineString      
          type: object      
          x-ngsi:      
            type: GeoProperty      
        - description: Geojson reference to the item. MultiLineString      
          properties:      
            bbox:      
              items:      
                type: number      
              minItems: 4      
              type: array      
            coordinates:      
              items:      
                items:      
                  items:      
                    items:      
                      type: number      
                    minItems: 2      
                    type: array      
                  minItems: 4      
                  type: array      
                type: array      
              type: array      
            type:      
              enum:      
                - MultiPolygon      
              type: string      
          required:      
            - type      
            - coordinates      
          title: GeoJSON MultiPolygon      
          type: object      
          x-ngsi:      
            type: GeoProperty      
      x-ngsi:      
        type: GeoProperty      
    name:      
      description: The name of this item      
      type: string      
      x-ngsi:      
        type: Property      
    owner:      
      description: A List containing a JSON encoded sequence of characters referencing the unique Ids of the owner(s)      
      items:      
        anyOf:      
          - description: Identifier format of any NGSI entity      
            maxLength: 256      
            minLength: 1      
            pattern: ^[\w\-\.\{\}\$\+\*\[\]`|~^@!,:\\]+$      
            type: string      
            x-ngsi:      
              type: Property      
          - description: Identifier format of any NGSI entity      
            format: uri      
            type: string      
            x-ngsi:      
              type: Property      
        description: Unique identifier of the entity      
        x-ngsi:      
          type: Property      
      type: array      
      x-ngsi:      
        type: Property      
    seeAlso:      
      description: list of uri pointing to additional resources about the item      
      oneOf:      
        - items:      
            format: uri      
            type: string      
          minItems: 1      
          type: array      
        - format: uri      
          type: string      
      x-ngsi:      
        type: Property      
    source:      
      description: 'A sequence of characters giving the original source of the entity data as a URL. Recommended to be the fully qualified domain name of the source provider, or the URL to the source object'      
      type: string      
      x-ngsi:      
        type: Property      
    type:      
      description: It must be equal to `Sensor`      
      enum:      
        - Sensor      
      type: string      
      x-ngsi:      
        type: Property      
  required:      
    - id      
    - type      
  type: object      
  x-derived-from: "https://saref.etsi.org/core/v3.1.1/#saref:Sensor"      
  x-disclaimer: 'Redistribution and use in source and binary forms, with or without modification, are permitted  provided that the license conditions are met. Copyleft (c) 2022 Contributors to Smart Data Models Program'      
  x-license-url: https://github.com/smart-data-models/dataModel.SAREF/blob/master/Sensor/LICENSE.md      
  x-model-schema: https://smart-data-models.github.com/dataModel.SAREF/Sensor/schema.json      
  x-model-tags: SAREF Sensor      
  x-version: 0.0.1

Esempi di payload

Sensore NGSI-v2 valori-chiave Esempio

Ecco un esempio di sensore in formato JSON-LD come valori-chiave. Questo è compatibile con NGSI-v2 quando si usa options=keyValues e restituisce i dati di contesto di una singola entità.

show/hide example

{  
  "id": "urn:ngsi-ld:Sensor:5e1bbf3c-f8a9-4a5f-b7b5-74456fa911d5",  
  "type": "Sensor",  
  "hasSensingRange": 0.014230070583521992,  
  "hasSensorType": "Smoke",  
  "hasManufacturer": "Sensor Company Inc.",  
  "hasModel": "Sensor 0.1.2",  
  "isContainedInBuildingSpace": "urn:ngsi-ld:BuildingSpace:1f5569e9-37c0-4211-bf58-a4c7b6db8169",  
  "isContainedInPhysicalObject": "urn:ngsi-ld:PhysicalObject:bdc0656f-f29c-4dfc-9b8d-f68a5209b6b6",  
  "isSubSystemOf": [  
    "urn:ngsi-ld:System:b6f77f2f-94f9-4ef0-bd73-58e008b0dd8e",  
    "urn:ngsi-ld:System:143d66f0-6d53-48c5-8ec4-4677754caf42",  
    "urn:ngsi-ld:System:47d20506-0d3a-4027-97e7-3442a9ee93e0"  
  ],  
  "dateCreated": "2023-01-26T03:07:27Z",  
  "dateModified": "2023-01-26T00:23:18Z",  
  "source": "Import",  
  "name": "Sensor",  
  "alternateName": "Sensor type 2",  
  "description": "Sensor of limited Sensor types",  
  "dataProvider": "IFC file"  
}

Sensore NGSI-v2 normalizzato Esempio

Ecco un esempio di sensore in formato JSON-LD normalizzato. Questo è compatibile con NGSI-v2 quando non si usano le opzioni e restituisce i dati di contesto di una singola entità.

show/hide example

{  
  "id": "urn:ngsi-ld:Sensor:5164ac7d-f33a-4a9d-92c0-d85738dce5dc",  
  "type": "Sensor",  
  "hasSensingRange": {  
    "type": "Number",  
    "value": 0.6379919853662889  
  },  
  "hasSensorType": {  
    "type": "Text",  
    "value": "Motion"  
  },  
  "hasManufacturer": {  
    "type": "Text",  
    "value": "Sensor Company Inc."  
  },  
  "hasModel": {  
    "type": "Text",  
    "value": "Sensor 0.1.2"  
  },  
  "isContainedInBuildingSpace": {  
    "type": "Text",  
    "value": "urn:ngsi-ld:BuildingSpace:dde4fa8f-da14-4e32-9061-53b1934b80dd"  
  },  
  "isContainedInPhysicalObject": {  
    "type": "Text",  
    "value": "urn:ngsi-ld:PhysicalObject:c1a7b6e1-9a70-4e7f-aecd-3a694da2ac1a"  
  },  
  "isSubSystemOf": {  
    "type": "StructuredValue",  
    "value": [  
      "urn:ngsi-ld:System:e55fb57f-3106-4f04-9121-ecc2eae1056f",  
      "urn:ngsi-ld:System:f32c549f-7d88-48e9-804f-a4f758868bc0",  
      "urn:ngsi-ld:System:0a12aeeb-5637-42dd-ad57-4b5e34dc929a"  
    ]  
  },  
  "dateCreated": {  
    "type": "DateTime",  
    "value": "2023-01-25T20:29:30.4737975+01:00"  
  },  
  "dateModified": {  
    "type": "DateTime",  
    "value": "2023-01-25T22:25:21.6300054+01:00"  
  },  
  "source": {  
    "type": "Text",  
    "value": "Import"  
  },  
  "name": {  
    "type": "Text",  
    "value": "Sensor"  
  },  
  "alternateName": {  
    "type": "Text",  
    "value": "Sensor type 2"  
  },  
  "description": {  
    "type": "Text",  
    "value": "Sensor of limited Sensor types"  
  },  
  "dataProvider": {  
    "type": "Text",  
    "value": "IFC file"  
  }  
}

Sensore NGSI-LD valori chiave Esempio

Ecco un esempio di sensore in formato JSON-LD come valori-chiave. Questo è compatibile con NGSI-LD quando si usa options=keyValues e restituisce i dati di contesto di una singola entità.

show/hide example

{  
  "id": "urn:ngsi-ld:Sensor:b9cd8f11-8d0f-4fa1-b1d9-627572e9d67a",  
  "type": "Sensor",  
  "hasSensingRange": 0.19880952263281826,  
  "hasSensorType": "Occupancy",  
  "hasManufacturer": "Sensor Company Inc.",  
  "hasModel": "Sensor 0.1.2",  
  "isContainedInBuildingSpace": "urn:ngsi-ld:BuildingSpace:0eead0dd-78fa-4072-b9ec-5fe95d2cb755",  
  "isContainedInPhysicalObject": "urn:ngsi-ld:PhysicalObject:a7575198-623d-48b3-afd6-6d1a65972cc4",  
  "isSubSystemOf": [  
    "urn:ngsi-ld:System:0ad39b84-1b82-4fec-ae7d-3139d0402025",  
    "urn:ngsi-ld:System:261f46f5-546f-4c07-a553-a423e8e80e31",  
    "urn:ngsi-ld:System:2c77915b-4b1f-49af-9f05-12611c0fec4b"  
  ],  
  "dateCreated": "2023-01-25T18:39:06Z",  
  "dateModified": "2023-01-26T12:07:34Z",  
  "source": "Import",  
  "name": "Sensor",  
  "alternateName": "Sensor type 2",  
  "description": "Sensor of limited Sensor types",  
  "dataProvider": "IFC file",  
  "@context": [  
    "https://raw.githubusercontent.com/smart-data-models/dataModel.SAREF/master/context.jsonld",  
    "https://uri.etsi.org/ngsi-ld/v1/ngsi-ld-core-context.jsonld"  
  ]  
}

Sensore NGSI-LD normalizzato Esempio

Ecco un esempio di sensore in formato JSON-LD normalizzato. Questo è compatibile con NGSI-LD quando non si utilizzano opzioni e restituisce i dati di contesto di una singola entità.

show/hide example

{  
  "id": "urn:ngsi-ld:Sensor:51d66982-bef7-4ccb-a9cd-80a338348d78",  
  "type": "Sensor",  
  "hasSensingRange": {  
    "type": "Property",  
    "unitCode": "NA",  
    "observedAt": "2023-01-26T00:40:11Z",  
    "value": 0.7330213275090168  
  },  
  "hasSensorType": {  
    "type": "Property",  
    "value": "Occupancy"  
  },  
  "hasManufacturer": {  
    "type": "Property",  
    "value": "Sensor Company Inc."  
  },  
  "hasModel": {  
    "type": "Property",  
    "value": "Sensor 0.1.2"  
  },  
  "isContainedInBuildingSpace": {  
    "type": "Relationship",  
    "object": "urn:ngsi-ld:BuildingSpace:9f857ae8-7285-445c-b78c-4b021935d531"  
  },  
  "isContainedInPhysicalObject": {  
    "type": "Relationship",  
    "object": "urn:ngsi-ld:PhysicalObject:1c143596-fb89-40b1-b575-2583c693644e"  
  },  
  "isSubSystemOf": [  
    {  
      "type": "Relationship",  
      "object": "urn:ngsi-ld:System:aedbd727-63dd-4ca0-893c-515b3fde97dc"  
    },  
    {  
      "type": "Relationship",  
      "object": "urn:ngsi-ld:System:7142065b-7971-4cc6-9e24-32ab9126bb5d"  
    },  
    {  
      "type": "Relationship",  
      "object": "urn:ngsi-ld:System:64eb8dc8-bf25-4773-bfc2-59464c0b018c"  
    }  
  ],  
  "dateCreated": {  
    "type": "Property",  
    "value": "2023-01-26T07:13:43Z"  
  },  
  "dateModified": {  
    "type": "Property",  
    "value": "2023-01-26T13:51:53Z"  
  },  
  "source": {  
    "type": "Property",  
    "value": "Import"  
  },  
  "name": {  
    "type": "Property",  
    "value": "Sensor"  
  },  
  "alternateName": {  
    "type": "Property",  
    "value": "Sensor type 2"  
  },  
  "description": {  
    "type": "Property",  
    "value": "Sensor of limited Sensor types"  
  },  
  "dataProvider": {  
    "type": "Property",  
    "value": "IFC file"  
  },  
  "@context": [  
    "https://raw.githubusercontent.com/smart-data-models/dataModel.SAREF/master/context.jsonld",  
    "https://uri.etsi.org/ngsi-ld/v1/ngsi-ld-core-context.jsonld"  
  ]  
}

Vedere FAQ 10 per ottenere una risposta su come gestire le unità di grandezza.

Smart Data Models +++ Contribution Manual +++ About

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

spec_IT.md

spec_IT.md

Entità: Sensore

Elenco delle proprietà

Modello di dati descrizione delle proprietà

Esempi di payload

Sensore NGSI-v2 valori-chiave Esempio

Sensore NGSI-v2 normalizzato Esempio

Sensore NGSI-LD valori chiave Esempio

Sensore NGSI-LD normalizzato Esempio

Files

spec_IT.md

Latest commit

History

spec_IT.md

File metadata and controls

Entità: Sensore

Elenco delle proprietà

Modello di dati descrizione delle proprietà

Esempi di payload

Sensore NGSI-v2 valori-chiave Esempio

Sensore NGSI-v2 normalizzato Esempio

Sensore NGSI-LD valori chiave Esempio

Sensore NGSI-LD normalizzato Esempio