Skip to content

Latest commit

 

History

History
877 lines (821 loc) · 31.8 KB

File metadata and controls

877 lines (821 loc) · 31.8 KB

Smart Data Models

Entité : StreetlightFeeder

[Licence ouverte] (https://github.com/smart-data-models//dataModel.Streetlighting/blob/master/StreetlightFeeder/LICENSE.md)

[document généré automatiquement] (https://docs.google.com/presentation/d/e/2PACX-1vTs-Ng5dIAwkg91oTTUdt8ua7woBXhPnwavZ0FxgR8BsAI_Ek3C5q97Nd94HS8KhP-r_quD4H0fgyt3/pub?start=false&loop=false&delayms=3000#slide=id.gb715ace035_0_60)

Description globale : Panneau de commande d'un lampadaire Modèle de données.

version : 0.0.2

Liste des propriétés

[*] S'il n'y a pas de type dans un attribut, c'est parce qu'il peut avoir plusieurs types ou différents formats/modèles.

  • activePower[array]: Puissance active consommée par phase. Triangle ordonné comprenant la puissance active de trois phases dans l'ordre suivant : [R Y B] . Model: https://schema.org/Text
  • address[object]: L'adresse postale . Model: https://schema.org/address
  • alternateName[string]: Un nom alternatif pour ce poste
  • areaServed[string]: La zone géographique où un service ou un article est offert . Model: https://schema.org/Text
  • dataProvider[string]: Une séquence de caractères identifiant le fournisseur de l'entité de données harmonisées
  • dateCreated[date-time]: Horodatage de la création de l'entité. Celle-ci est généralement attribuée par la plate-forme de stockage
  • dateModified[date-time]: Date de la dernière modification de l'entité. Cette date est généralement attribuée par la plate-forme de stockage
  • description[string]: Une description de l'article
  • deviceInfo[object]: Informations sur le dispositif associé aux observations . Model: https://schema.org/Text
    • deviceBatteryStatus[string]: Indique l'état de charge de la batterie de l'appareil concerné (connecté, déconnecté). . Model: https://schema.org/Text
    • deviceId[string]: ID du dispositif du capteur physique/de la station de mesure correspondant à cette observation . Model: https://schema.org/Text
    • deviceModel[object]: Décrit les informations relatives à l'appareil, au capteur ou au système considéré. . Model: https://schema.org/Text
    • deviceName[string]: Nom de l'appareil ou nom de la station de l'appareil ou de la station correspondant à cette observation . Model: https://schema.org/Text
    • deviceSimNumber[string]: Indique le numéro de simulation de l'appareil dans le véhicule de gestion des déchets. . Model: https://schema.org/Text
    • measurand[string]: Propriété(s) détectée(s), observée(s), mesurée(s) par le dispositif . Model: https://schema.org/Text
  • id[*]: Identifiant unique de l'entité
  • location[*]: Référence Geojson à l'élément. Il peut s'agir d'un point, d'une chaîne de ligne, d'un polygone, d'un point multiple, d'une chaîne de ligne multiple ou d'un polygone multiple.
  • name[string]: Le nom de cet élément
  • numStreetlight[number]: Décrit le nombre total de lampadaires connectés au panneau d'alimentation correspondant à cette observation. . Model: https://schema.org/Number
  • observationDateTime[date-time]: Dernière heure d'observation signalée . Model: https://schema.org/Text
  • owner[array]: Une liste contenant une séquence de caractères encodés JSON référençant les identifiants uniques du ou des propriétaires.
  • phaseCurrent[array]: Courant par phase. Triangle ordonné comprenant la puissance active de trois phases dans l'ordre suivant : [R Y B] . Model: https://schema.org/Text
  • phaseVoltage[array]: Tension par phase. Triangle ordonné comprenant la puissance active de trois phases dans l'ordre suivant : [R Y B] . Model: https://schema.org/Text
  • powerState[string]: Indique l'état actuel du panneau d'alimentation de l'éclairage public. . Model: https://schema.org/Text
  • reactivePower[array]: Puissance réactive consommée par phase. Triangle ordonné comprenant la puissance active de trois phases dans l'ordre suivant : [R Y B] . Model: https://schema.org/Text
  • seeAlso[*]: liste d'uri pointant vers des ressources supplémentaires concernant l'élément
  • source[string]: Séquence de caractères indiquant la source originale des données de l'entité sous forme d'URL. Il est recommandé d'utiliser le nom de domaine complet du fournisseur de la source ou l'URL de l'objet source.
  • totalActivePower[number]: Puissance active totale consommée par toutes les phases . Model: https://schema.org/Number
  • totalReactivePower[number]: Puissance réactive totale pour toutes les phases . Model: https://schema.org/Number
  • type[string]: Type d'entité NGSI. Il doit s'agir de StreetlightFeeder

Propriétés requises

  • id
  • type

Modèle de données description des propriétés

Classés par ordre alphabétique (cliquez pour plus de détails)

full yaml details
StreetlightFeeder:      
  description: A streetlight control panel Data Model.      
  properties:      
    activePower:      
      description: 'Active power consumed per phase. Ordered triple comprising of active power from three phases in the following order: [R Y B]'      
      items:      
        minItems: 3      
        type: number      
      type: array      
      x-ngsi:      
        model: https://schema.org/Text      
        type: Property      
    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      
    deviceInfo:      
      description: Information about the device associated with the observations      
      properties:      
        deviceBatteryStatus:      
          description: 'Gives the Battery charging status of the reporting device(Connected, Disconnected)'      
          type: string      
          x-ngsi:      
            model: https://schema.org/Text      
            type: Property      
        deviceId:      
          description: Device ID of the physical sensor/ measurement station corresponding to this observation      
          type: string      
          x-ngsi:      
            model: https://schema.org/Text      
            type: Property      
        deviceModel:      
          description: 'Describes the information of the device, sensor or system in consideration'      
          properties:      
            brandName:      
              description: 'Name of the brand associated with an entity, e.g., sensor, device etc'      
              type: string      
              x-ngsi:      
                model: https://schema.org/Text      
                type: Property      
            manufacturerName:      
              description: 'Name of the manufacturer associated with an entity, e.g., sensor, device etc'      
              type: string      
              x-ngsi:      
                model: https://schema.org/Text      
                type: Property      
            modelName:      
              description: 'Name of a specific model associated with an entity, e.g., sensor, device etc'      
              type: string      
              x-ngsi:      
                model: https://schema.org/Text      
                type: Property      
            modelURL:      
              description: 'URL providing further information of a specific model associated with an entity, e.g., sensor, device etc'      
              type: string      
              x-ngsi:      
                model: https://schema.org/Text      
                type: Property      
          type: object      
          x-ngsi:      
            model: https://schema.org/Text      
            type: Property      
        deviceName:      
          description: Device Name or Station name of the sensor device/station corresponding to this observation      
          type: string      
          x-ngsi:      
            model: https://schema.org/Text      
            type: Property      
        deviceSimNumber:      
          description: Gives the sim number of the device in the waste management vehicle      
          type: string      
          x-ngsi:      
            model: https://schema.org/Text      
            type: Property      
        measurand:      
          description: Property/properties sensed/observed/measured by the device      
          type: string      
          x-ngsi:      
            model: https://schema.org/Text      
            type: Property      
        rfId:      
          description: Gives the ID of the RFID reader      
          type: string      
          x-ngsi:      
            model: https://schema.org/Text      
            type: Property      
      type: object      
      x-ngsi:      
        model: https://schema.org/Text      
        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      
    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      
    numStreetlight:      
      description: Describes the total number of streetlights connected to the feeder panel corresponding to this observation      
      type: number      
      x-ngsi:      
        model: https://schema.org/Number      
        type: Property      
    observationDateTime:      
      description: Last reported time of observation      
      format: date-time      
      type: string      
      x-ngsi:      
        model: https://schema.org/Text      
        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      
    phaseCurrent:      
      description: 'Current per phase. Ordered triple comprising of active power from three phases in the following order: [R Y B]'      
      items:      
        minItems: 3      
        type: number      
      type: array      
      x-ngsi:      
        model: https://schema.org/Text      
        type: Property      
    phaseVoltage:      
      description: 'Voltage per phase. Ordered triple comprising of active power from three phases in the following order: [R Y B]'      
      items:      
        minItems: 3      
        type: number      
      type: array      
      x-ngsi:      
        model: https://schema.org/Text      
        type: Property      
    powerState:      
      description: Indicates the current status of the streetlight feeder panel      
      type: string      
      x-ngsi:      
        model: https://schema.org/Text      
        type: Property      
    reactivePower:      
      description: 'Reactive power consumed per phase. Ordered triple comprising of active power from three phases in the following order: [R Y B]'      
      items:      
        minItems: 3      
        type: number      
      type: array      
      x-ngsi:      
        model: https://schema.org/Text      
        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      
    totalActivePower:      
      description: Total active power consumed by all phases      
      type: number      
      x-ngsi:      
        model: https://schema.org/Number      
        type: Property      
    totalReactivePower:      
      description: Total reactive power for all phases      
      type: number      
      x-ngsi:      
        model: https://schema.org/Number      
        type: Property      
    type:      
      description: NGSI entity type. It has to be StreetlightFeeder      
      enum:      
        - StreetlightFeeder      
      type: string      
      x-ngsi:      
        type: Property      
  required:      
    - id      
    - type      
  type: object      
  x-derived-from: ""      
  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.Streetlighting/blob/master/StreetlightFeeder/LICENSE.md      
  x-model-schema: https://smart-data-models.github.io/dataModel.Streetlighting/StreetLightFeeder/schema.json      
  x-model-tags: IUDX      
  x-version: 0.0.2      

Exemples de charges utiles

StreetlightFeeder NGSI-v2 key-values Exemple

Voici un exemple d'un StreetlightFeeder au format JSON-LD sous forme de valeurs-clés. Ceci est compatible avec NGSI-v2 lorsque l'on utilise options=keyValues et renvoie les données de contexte d'une entité individuelle.

show/hide example
{  
  "id": "https://smart-data-models.github.io/dataModel.Streetlighting/StreetLightFeeder/schema.json",  
  "type": "StreetlightFeeder",  
  "totalActivePower": 30,  
  "phaseCurrent": [  
    25,  
    28,  
    30  
  ],  
  "reactivePower": [  
    25,  
    28,  
    30  
  ],  
  "numStreetlight": 45,  
  "phaseVoltage": [  
    240,  
    120,  
    50  
  ],  
  "totalReactivePower": 200,  
  "activePower": [  
    120,  
    200,  
    150  
  ],  
  "powerState": "ON",  
  "observationDateTime": "2021-03-11T15:51:02+05:30",  
  "deviceInfo": {  
    "rfId": "5634684",  
    "deviceBatteryStatus": "Connected",  
    "deviceName": "SL1",  
    "deviceId": "43",  
    "measurand": "6",  
    "deviceSimNumber": "6755375727",  
    "deviceModel": {  
      "brandName": "abc",  
      "manufacturerName": "xyz",  
      "modelName": "SL1",  
      "modelURL": "www.abcstreetlight.com"  
    }  
  }  
}  

StreetlightFeeder NGSI-v2 normalisé Exemple

Voici un exemple de StreetlightFeeder au format JSON-LD tel qu'il a été normalisé. Ce format est compatible avec NGSI-v2 lorsqu'il n'utilise pas d'options et renvoie les données contextuelles d'une entité individuelle.

show/hide example
{  
  "id": "https://smart-data-models.github.io/dataModel.Streetlighting/StreetLightFeeder/schema.json",  
  "type": "StreetlightFeeder",  
  "totalActivePower": {  
    "type": "Number",  
    "value": 30  
  },  
  "phaseCurrent": {  
    "type": "StructuredValue",  
    "value": [  
      25,  
      28,  
      30  
    ]  
  },  
  "reactivePower": {  
    "type": "StructuredValue",  
    "value": [  
      25,  
      28,  
      30  
    ]  
  },  
  "numStreetlight": {  
    "type": "Number",  
    "value": 45  
  },  
  "phaseVoltage": {  
    "type": "StructuredValue",  
    "value": [  
      240,  
      120,  
      50  
    ]  
  },  
  "totalReactivePower": {  
    "type": "Number",  
    "value": 200  
  },  
  "activePower": {  
    "type": "StructuredValue",  
    "value": [  
      120,  
      200,  
      150  
    ]  
  },  
  "powerState": {  
    "type": "Text",  
    "value": "ON"  
  },  
  "observationDateTime": {  
    "type": "DateTime",  
    "value": "2021-03-11T15:51:02+05:30"  
  },  
  "deviceInfo": {  
    "type": "StructuredValue",  
    "value": {  
      "rfId": "5634684",  
      "deviceBatteryStatus": "Connected",  
      "deviceName": "SL1",  
      "deviceId": "43",  
      "measurand": "6",  
      "deviceSimNumber": "6755375727",  
      "deviceModel": {  
        "brandName": "abc",  
        "manufacturerName": "xyz",  
        "modelName": "SL1",  
        "modelURL": "www.abcstreetlight.com"  
      }  
    }  
  }  
}  

StreetlightFeeder Valeurs clés NGSI-LD Exemple

Voici un exemple de StreetlightFeeder au format JSON-LD sous forme de valeurs-clés. Ce format est compatible avec NGSI-LD lorsque l'on utilise options=keyValues et renvoie les données contextuelles d'une entité individuelle.

show/hide example
{  
  "id": "https://smart-data-models.github.io/dataModel.Streetlighting/StreetLightFeeder/schema.json",  
  "type": "StreetlightFeeder",  
  "activePower": [  
    120,  
    200,  
    150  
  ],  
  "deviceInfo": {  
    "rfId": "5634684",  
    "deviceBatteryStatus": "Connected",  
    "deviceName": "SL1",  
    "deviceId": "43",  
    "measurand": "6",  
    "deviceSimNumber": "6755375727",  
    "deviceModel": {  
      "brandName": "abc",  
      "manufacturerName": "xyz",  
      "modelName": "SL1",  
      "modelURL": "www.abcstreetlight.com"  
    }  
  },  
  "numStreetlight": 45,  
  "observationDateTime": "2021-03-11T15:51:02+05:30",  
  "phaseCurrent": [  
    25,  
    28,  
    30  
  ],  
  "phaseVoltage": [  
    240,  
    120,  
    50  
  ],  
  "powerState": "ON",  
  "reactivePower": [  
    25,  
    28,  
    30  
  ],  
  "totalActivePower": 30,  
  "totalReactivePower": 200,  
  "@context": [  
    "https://smart-data-models.github.io/dataModel.Streetlighting/context.jsonld"  
  ]  
}  

StreetlightFeeder NGSI-LD normalisé Exemple

Voici un exemple de StreetlightFeeder au format JSON-LD tel qu'il a été normalisé. Ce format est compatible avec NGSI-LD lorsqu'il n'utilise pas d'options et renvoie les données contextuelles d'une entité individuelle.

show/hide example
{  
  "id": "https://smart-data-models.github.io/dataModel.Streetlighting/StreetLightFeeder/schema.json",  
  "type": "StreetlightFeeder",  
  "activePower": {  
    "type": "Property",  
    "value": [  
      120,  
      200,  
      150  
    ]  
  },  
  "deviceInfo": {  
    "type": "Property",  
    "value": {  
      "rfId": "5634684",  
      "deviceBatteryStatus": "Connected",  
      "deviceName": "SL1",  
      "deviceId": "43",  
      "measurand": "6",  
      "deviceSimNumber": "6755375727",  
      "deviceModel": {  
        "brandName": "abc",  
        "manufacturerName": "xyz",  
        "modelName": "SL1",  
        "modelURL": "www.abcstreetlight.com"  
      }  
    }  
  },  
  "numStreetlight": {  
    "type": "Property",  
    "value": 45  
  },  
  "observationDateTime": {  
    "type": "Property",  
    "value": {  
      "@type": "DateTime",  
      "@value": "2021-03-11T15:51:02+05:30"  
    }  
  },  
  "phaseCurrent": {  
    "type": "Property",  
    "value": [  
      25,  
      28,  
      30  
    ]  
  },  
  "phaseVoltage": {  
    "type": "Property",  
    "value": [  
      240,  
      120,  
      50  
    ]  
  },  
  "powerState": {  
    "type": "Property",  
    "value": "ON"  
  },  
  "reactivePower": {  
    "type": "Property",  
    "value": [  
      25,  
      28,  
      30  
    ]  
  },  
  "totalActivePower": {  
    "type": "Property",  
    "value": 30  
  },  
  "totalReactivePower": {  
    "type": "Property",  
    "value": 200  
  },  
  "@context": [  
    "https://smart-data-models.github.io/dataModel.Streetlighting/context.jsonld"  
  ]  
}  

Voir [FAQ 10] (https://smartdatamodels.org/index.php/faqs/) pour obtenir une réponse à la question de savoir comment traiter les unités de magnitude.


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