Skip to content

spec_FR.md

Latest commit

 

History

History
554 lines (497 loc) · 18.9 KB

spec_FR.md

File metadata and controls

554 lines (497 loc) · 18.9 KB
Raw

Smart Data Models

Entité : Agent

[Licence ouverte] (https://github.com/smart-data-models//dataModel.DCAT-AP/blob/master/Agent/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 : Schéma d'agent conforme à la spécification DCAT-AP 2.1.1

version : 1.0.1

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.

  • Type[string]: Cette propriété fait référence à un type d'agent qui met à disposition le catalogue ou l'ensemble de données. . Model: http://www.w3.org/2004/02/skos/core#Concept
  • address[object]: L'adresse postale . Model: https://schema.org/address
  • areaServed[string]: La zone géographique où un service ou un article est offert . 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[array]: Cette propriété contient le nom de l'agent. Cette propriété peut être répétée pour différentes versions du nom (par exemple, le nom dans différentes langues). . Model: dct:description
  • type[string]: Type d'entité NGSI. Il doit s'agir d'un agent

Propriétés requises

  • id
  • name
  • type

Adapté de [DCAT-AP version 2.1.1] (https://codeload.github.com/SEMICeu/DCAT-AP/zip/refs/tags/v2.1.1). L'attribut type original de DCAT 2.1.1 a été renommé en Type pour permettre son utilisation avec NGSI-LD.

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 
Agent:      
  description: Agent Schema meeting DCAT-AP 2.1.1 specification      
  properties:      
    Type:      
      description: This property refers to a type of the agent that makes the Catalogue or Dataset available      
      type: string      
      x-ngsi:      
        model: "http://www.w3.org/2004/02/skos/core#Concept"      
        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      
    areaServed:      
      description: The geographic area where a service or offered item is provided      
      type: string      
      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: This property contains a name of the agent.  This property can be repeated for different  versions of the name (e.g. the name in  different languages)      
      items:      
        description: Every name in different languages      
        minItems: 1      
        type: string      
        x-ngsi:      
          type: Property      
      type: array      
      x-ngsi:      
        model: dct:description      
        type: Property      
    type:      
      description: NGSI Entity type. It has to be Agent      
      enum:      
        - Agent      
      type: string      
      x-ngsi:      
        type: Property      
  required:      
    - id      
    - type      
    - name      
  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.DCAT-AP/blob/master/Agent/LICENSE.md      
  x-model-schema: https://smart-data-models.github.io/dataModel.DCAT-AP/Agent/schema.json      
  x-model-tags: ""      
  x-version: 1.0.1

Exemples de charges utiles

Agent NGSI-v2 key-values Exemple

Voici un exemple d'agent au format JSON-LD en tant que 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": "urn:ngsi-ld:id:ZLHO:07918336",  
  "type": "Agent",  
  "name": [  
    "Agent 10",  
    "Agente 10"  
  ],  
  "location": {  
    "type": "Point",  
    "coordinates": [  
      12.934074,  
      -149.532943  
    ]  
  },  
  "address": {  
    "streetAddress": "2 Rue Mercier",  
    "addressLocality": "Luxembourg",  
    "addressRegion": "Luxembourg",  
    "addressCountry": "Luxembourg",  
    "postalCode": "2985 ",  
    "postOfficeBoxNumber": "",  
    "areaServed": "European Union"  
  },  
  "Type": "EU Publications office"  
}

Agent NGSI-v2 normalisé Exemple

Voici un exemple d'agent 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": "urn:ngsi-ld:id:ZLHO:07918336",  
  "type": "Agent",  
  "location": {  
    "type": "geo:json",  
    "value": {  
      "type": "Point",  
      "coordinates": [  
        12.934074,  
        -149.532943  
      ]  
    }  
  },  
  "address": {  
    "type": "StructuredValue",  
    "value": {  
      "streetAddress": "2 Rue Mercier",  
      "addressLocality": "Luxembourg",  
      "addressRegion": "Luxembourg",  
      "addressCountry": "Luxembourg",  
      "postalCode": "2985 ",  
      "postOfficeBoxNumber": "",  
      "areaServed": "European Union"  
    }  
  },  
  "name": {  
    "type": "StructuredValue",  
    "value": [  
      "Agent 10",  
      "Agente 10"  
    ]  
  },  
  "Type": {  
    "type": "Text",  
    "value": "EU Publications office"  
  }  
}

Valeurs clés de l'agent NGSI-LD Exemple

Voici un exemple d'agent 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": "urn:ngsi-ld:id:ZLHO:07918336",  
  "type": "Agent",  
  "address": {  
    "streetAddress": "2 Rue Mercier",  
    "addressLocality": "Luxembourg",  
    "addressRegion": "Luxembourg",  
    "addressCountry": "Luxembourg",  
    "postalCode": "2985 ",  
    "postOfficeBoxNumber": "",  
    "areaServed": "European Union"  
  },  
  "name": [  
    "Agent 10",  
    "Agente 10"  
  ],  
  "Type": "EU Publications office",  
  "description": "organization the Agent 10 belongs to.",  
  "location": {  
    "type": "Point",  
    "coordinates": [  
      12.934074,  
      -149.532943  
    ]  
  },  
  "@context": [  
    "https://raw.githubusercontent.com/smart-data-models/dataModel.DCAT-AP/master/context.jsonld"  
  ]  
}

Agent NGSI-LD normalisé Exemple

Voici un exemple d'un agent au format JSON-LD 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": "urn:ngsi-ld:id:ZLHO:07918336",  
    "type": "Agent",  
    "address": {  
        "type": "Property",  
        "value": {  
            "streetAddress": "2 Rue Mercier",  
            "addressLocality": "Luxembourg",  
            "addressRegion": "Luxembourg",  
            "addressCountry": "Luxembourg",  
            "postalCode": "2985 ",  
            "postOfficeBoxNumber": "",  
            "areaServed": "European Union"  
        }  
    },  
    "name": {  
        "type": "Property",  
        "value": [  
            "Agent 10",  
            "Agente 10"  
        ]  
    },  
    "Type": {  
        "type": "Property",  
        "value": "EU Publications office"  
    },  
    "location": {  
        "type": "GeoProperty",  
        "value": {  
            "type": "Point",  
            "coordinates": [  
                12.934074,  
                -149.532943  
            ]  
        }  
    },  
    "@context": [  
        "https://raw.githubusercontent.com/smart-data-models/dataModel.DCAT-AP/master/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