Skip to content

Latest commit

 

History

History
678 lines (620 loc) · 23.1 KB

File metadata and controls

678 lines (620 loc) · 23.1 KB

Smart Data Models

Entité : NightSkyQuality

[Licence ouverte] (https://github.com/smart-data-models//dataModel.Environment/blob/master/NightSkyQuality/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 : Données relatives à la qualité du ciel observée et à l'état de l'appareil de mesure.

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.

  • address[object]: L'adresse postale . Model: https://schema.org/address
  • alternateName[string]: Un nom alternatif pour ce poste
  • ambientTemperature[number]: Mesure de la température
  • areaServed[string]: La zone géographique où un service ou un article est offert . Model: https://schema.org/Text
  • battery[number]: Tension fournie par la batterie
  • batteryLevel[*]: Niveau de la batterie de l'appareil. Il doit être égal à 1,0 lorsque la batterie est pleine. 0,0 lorsque la batterie est vide. -1 lorsqu'il n'est pas possible de déterminer le niveau de la batterie de manière transitoire . Model: https://schema.org/Number
  • clouds[string]: Indicateur qualitatif de la couverture nuageuse
  • 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
  • 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
  • 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.
  • seeAlso[*]: liste d'uri pointant vers des ressources supplémentaires concernant l'élément
  • sigmaMagnitude[number]: Paramètre sans unité, exprimant l'écart-type correspondant à la mesure de la magnitude du ciel
  • skyMagnitude[number]: Paramètre sans unité : la mesure prise par l'appareil, correspondant à la magnitude apparente du ciel nocturne (c'est-à-dire sa luminosité)
  • skyTemperature[number]: Mesure directe de la température du ciel, telle qu'elle est prise par l'appareil
  • 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.
  • type[string]: Type d'entité NGSI. Il doit s'agir de MosquitoDensity

Propriétés requises

  • id
  • location
  • 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
NightSkyQuality:    
  description: Data regarding the observed sky quality and the status of the measuring device.    
  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    
    ambientTemperature:    
      description: Temperature measurement    
      type: number    
      x-ngsi:    
        type: Property    
        units: degrees Celsius (C)    
    areaServed:    
      description: The geographic area where a service or offered item is provided    
      type: string    
      x-ngsi:    
        model: https://schema.org/Text    
        type: Property    
    battery:    
      description: Voltage provided by the battery    
      type: number    
      x-ngsi:    
        type: Property    
        units: Changes relative to the  millivolts (mV)    
    batteryLevel:    
      description: Device battery level. It must be equal to 1.0 when battery is full. 0.0 when battery is empty. -1 when transiently cannot be determined    
      oneOf:    
        - maximum: 1    
          minimum: 0    
          type: number    
        - maximum: -1    
          minimum: -1    
          type: number    
      x-ngsi:    
        model: https://schema.org/Number    
        type: Property    
    clouds:    
      description: Qualitative indicator of the amount of cloud cover    
      type: string    
      x-ngsi:    
        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    
    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    
    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    
    sigmaMagnitude:    
      description: 'Unitless parameter, expressing the Standard Deviation corresponding to the measurement of sky magnitude'    
      type: number    
      x-ngsi:    
        type: Property    
    skyMagnitude:    
      description: 'Unitless parameter: the measurement taken by the device, corresponding to the apparent magnitude of the night sky (that is, its brightness)'    
      type: number    
      x-ngsi:    
        type: Property    
    skyTemperature:    
      description: 'Direct measurement of the sky temperature, as taken by the device'    
      type: number    
      x-ngsi:    
        type: Property    
        units: degrees Celsius (C)    
    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: NGSI Entity type. It has to be MosquitoDensity    
      enum:    
        - NightSkyQuality    
      type: string    
      x-ngsi:    
        type: Property    
  required:    
    - id    
    - type    
    - location    
  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) 2023 Contributors to Smart Data Models Program'    
  x-license-url: https://github.com/smart-data-models/dataModel.Environment/blob/master/NightSkyQuality/LICENSE.md    
  x-model-schema: https://smart-data-models.github.io/dataModel.NightSkyQuality/NightSkyQuality/schema.json    
  x-model-tags: ""    
  x-version: 0.0.2    

Exemples de charges utiles

NightSkyQuality Valeurs clés NGSI-v2 Exemple

Voici un exemple de NightSkyQuality 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 contextuelles d'une entité individuelle.

show/hide example
{  
  "id": "DTI-036",  
  "type": "NightSkyQuality",  
  "ambientTemperature": 10.17,  
  "battery": 3691,  
  "clouds": "Despejado",  
  "dateCreated": "2023-03-15T14:00:00.000Z",  
  "dateModified": "2023-03-15T14:10:00.000Z",  
  "location": {  
    "type": "Point",  
    "coordinates": [  
      -103.9904,  
      39.7564  
    ]  
  },  
  "sigmaMagnitude": 0.003,  
  "skyMagnitude": 19.4,  
  "skyTemperature": -6.23  
}  

NightSkyQuality NGSI-v2 normalisé Exemple

Voici un exemple de NightSkyQuality au format JSON-LD tel que 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": "DTI-036",  
  "type": "NightSkyQuality",  
  "ambientTemperature": {  
    "type": "Number",  
    "value": 10.17  
  },  
  "battery": {  
    "type": "Number",  
    "value": 3691  
  },  
  "clouds": {  
    "type": "Text",  
    "value": "Despejado"  
  },  
  "dateCreated": {  
    "type": "DateTime",  
    "value": "2023-03-15T14:00:00.000Z"  
  },  
  "dateModified": {  
    "type": "DateTime",  
    "value": "2023-03-15T14:10:00.000Z"  
  },  
  "location": {  
    "type": "geo:json",  
    "value": {  
      "type": "Point",  
      "coordinates": [  
        -103.9904,  
        39.7564  
      ]  
    }  
  },  
  "sigmaMagnitude": {  
    "type": "Number",  
    "value": 0.003  
  },  
  "skyMagnitude": {  
    "type": "Number",  
    "value": 19.4  
  },  
  "skyTemperature": {  
    "type": "Number",  
    "value": -6.23  
  }  
}  

Valeurs clés NightSkyQuality NGSI-LD Exemple

Voici un exemple de NightSkyQuality au format JSON-LD sous forme de valeurs-clés. Ceci 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": "DTI-036",  
  "type": "NightSkyQuality",  
  "ambientTemperature": 10.17,  
  "battery": 3691,  
  "clouds": "Despejado",  
  "dateCreated": "2023-03-15T14:00:00.000Z",  
  "dateModified": "2023-03-15T14:10:00.000Z",  
  "location": {  
    "type": "Point",  
    "coordinates": [  
      -103.9904,  
      39.7564  
    ]  
  },  
  "sigmaMagnitude": 0.003,  
  "skyMagnitude": 19.4,  
  "skyTemperature": -6.23,  
  "@context": [  
    "https://smart-data-models.github.io/dataModel.Environment/NightSkyQuality/schema.json"  
  ]  
}  

NightSkyQuality NGSI-LD normalisé Exemple

Voici un exemple de NightSkyQuality au format JSON-LD tel que 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": "DTI-036",  
  "type": "NightSkyQuality",  
  "ambientTemperature": {  
    "type": "Property",  
    "value": 10.17  
  },  
  "battery": {  
    "type": "Property",  
    "value": 3691  
  },  
  "clouds": {  
    "type": "Property",  
    "value": "Despejado"  
  },  
  "dateCreated": {  
    "type": "Property",  
    "value": {  
      "@type": "date-time",  
      "@value": "2023-03-15T14:00:00.000Z"  
    }  
  },  
  "dateModified": {  
    "type": "DateTime",  
    "value": {  
      "@type": "date-time",  
      "@value": "2023-03-15T14:10:00.000Z"  
    }  
  },  
  "location": {  
    "type": "GeoProperty",  
    "value": {  
      "type": "Point",  
      "coordinates": [  
        -103.9904,  
        39.7564  
      ]  
    }  
  },  
  "sigmaMagnitude": {  
    "type": "Property",  
    "value": 0.003  
  },  
  "skyMagnitude": {  
    "type": "Property",  
    "value": 19.4  
  },  
  "skyTemperature": {  
    "type": "Property",  
    "value": -6.23  
  },  
  "@context": [  
    "https://smart-data-models.github.io/dataModel.Environment/NightSkyQuality/schema.json"  
  ]  
}  

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