Skip to content

Latest commit

 

History

History
776 lines (719 loc) · 29.2 KB

spec_IT.md

File metadata and controls

776 lines (719 loc) · 29.2 KB

Smart Data Models

Entità: Elemento di rete

Licenza aperta

documento generato automaticamente

Descrizione globale: **Classe base per definire i nodi del grafo di connettività che rappresenta la rete topologica.

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
  • 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
  • elementPart[uri]: Parte dell'elemento
  • endIntrinsicCoordinate[number]: Coordinata intrinseca finale
  • hasImplementation[uri]: Ha un'implementazione
  • id[*]: Identificatore univoco dell'entità
  • 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.
  • startIntrinsicCoordinate[number]: Coordinata intrinseca di partenza
  • type[string]: Tipo di dati NGSI. Deve essere NetElement

Proprietà richieste

  • id
  • type

modello di dati mappato dall'ontologia ERA https://data-interop.era.europa.eu/era-vocabulary (Agenzia dell'Unione Europea per le Ferrovie)

Modello di dati descrizione delle proprietà

Ordinati in ordine alfabetico (clicca per i dettagli)

full yaml details
NetElement:      
  description: Base class for defining nodes in the connectivity graph representing the topological network.      
  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      
    elementPart:      
      description: Element part      
      format: uri      
      type: string      
      x-ngsi:      
        type: Relationship      
    endIntrinsicCoordinate:      
      description: End intrinsic coordinate      
      type: number      
      x-ngsi:      
        type: Property      
    hasImplementation:      
      description: Has implementation      
      format: uri      
      type: string      
      x-ngsi:      
        type: Relationship      
    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      
    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      
    startIntrinsicCoordinate:      
      description: Start intrinsic coordinate      
      type: number      
      x-ngsi:      
        type: Property      
    type:      
      description: NGSI data type. It has to be NetElement      
      enum:      
        - NetElement      
      type: string      
      x-ngsi:      
        type: Property      
  required:      
    - id      
    - type      
  type: object      
  x-derived-from: http://data.europa.eu/949/NetElement      
  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.ERA/blob/master/NetElement/LICENSE.md      
  x-model-schema: https://smart-data-models.github.io/dataModel.ERA/Certificate/schema.json      
  x-model-tags: 'ERA vocabulary, railway, train'      
  x-version: 0.0.1      

Esempi di payload

Valori-chiave NetElement NGSI-v2 Esempio

Ecco un esempio di NetElement 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:NetElement:id:CDPU:99275524",  
  "dateCreated": "2004-12-12T04:49:10Z",  
  "dateModified": "1992-12-16T09:32:23Z",  
  "source": "Natural film decade",  
  "name": "Price institution dream somebody although song how. Low describe energy significant light road great both. Add explain likely way smile new. Fast must leg public",  
  "alternateName": "Common wind western ball read along. Statement another type seat store. Hot case pressure identify lead.",  
  "description": "Truth expect in recently face. By spend social benefit ask response.",  
  "dataProvider": "Sing whole pres",  
  "owner": [  
    "urn:ngsi-ld:NetElement:items:OKII:37700408",  
    "urn:ngsi-ld:NetElement:items:MRRB:33006272"  
  ],  
  "seeAlso": [  
    "urn:ngsi-ld:NetElement:items:NKYQ:56695981"  
  ],  
  "location": {  
    "type": "Point",  
    "coordinates": [  
      28.6509805,  
      -162.802435  
    ]  
  },  
  "address": {  
    "streetAddress": "Way party system teacher purpose federal. For top far sell.",  
    "addressLocality": "These everyone no measure free finish decision call. Car somebody across glass war ask part. Quality here himself popular service suffer.",  
    "addressRegion": "Article despite environmental service head relate from. L",  
    "addressCountry": "Agreement cover study off. Choose back laugh who management communit",  
    "postalCode": "Radio short thought whole contain. Effect contain character after seem put debate. Decision true mission front maintain re",  
    "postOfficeBoxNumber": "Generatio",  
    "streetNr": "Fi",  
    "district": "Weight over big former dream character. Network anyone easy campaign seek of realize right. Range level level kind cause. Score miss need wear push walk month region."  
  },  
  "areaServed": "She reduce policy necessary campaign your.",  
  "type": "NetElement",  
  "endIntrinsicCoordinate": 172.2,  
  "startIntrinsicCoordinate": 698.8,  
  "elementPart": "urn:ngsi-ld:NetElement:elementPart:MXDV:95711699",  
  "hasImplementation": "urn:ngsi-ld:NetElement:hasImplementation:GOYF:07477051"  
}  

Esempio di NetElement NGSI-v2 normalizzato

Ecco un esempio di NetElement 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:NetElement:id:CDPU:99275524",  
  "dateCreated": {  
    "type": "DateTime",  
    "value": "2004-12-12T04:49:10Z"  
  },  
  "dateModified": {  
    "type": "DateTime",  
    "value": "1992-12-16T09:32:23Z"  
  },  
  "source": {  
    "type": "Text",  
    "value": "Natural film decade"  
  },  
  "name": {  
    "type": "Text",  
    "value": "Price institution dream somebody although song how. Low describe energy significant light road great both. Add explain likely way smile new. Fast must leg public"  
  },  
  "alternateName": {  
    "type": "Text",  
    "value": "Common wind western ball read along. Statement another type seat store. Hot case pressure identify lead."  
  },  
  "description": {  
    "type": "Text",  
    "value": "Truth expect in recently face. By spend social benefit ask response."  
  },  
  "dataProvider": {  
    "type": "Text",  
    "value": "Sing whole pres"  
  },  
  "owner": {  
    "type": "StructuredValue",  
    "value": [  
      "urn:ngsi-ld:NetElement:items:OKII:37700408",  
      "urn:ngsi-ld:NetElement:items:MRRB:33006272"  
    ]  
  },  
  "seeAlso": {  
    "type": "StructuredValue",  
    "value": [  
      "urn:ngsi-ld:NetElement:items:NKYQ:56695981"  
    ]  
  },  
  "location": {  
    "type": "geo:json",  
    "value": {  
      "type": "Point",  
      "coordinates": [  
        28.6509805,  
        -162.802435  
      ]  
    }  
  },  
  "address": {  
    "type": "StructuredValue",  
    "value": {  
      "streetAddress": "Way party system teacher purpose federal. For top far sell.",  
      "addressLocality": "These everyone no measure free finish decision call. Car somebody across glass war ask part. Quality here himself popular service suffer.",  
      "addressRegion": "Article despite environmental service head relate from. L",  
      "addressCountry": "Agreement cover study off. Choose back laugh who management communit",  
      "postalCode": "Radio short thought whole contain. Effect contain character after seem put debate. Decision true mission front maintain re",  
      "postOfficeBoxNumber": "Generatio",  
      "streetNr": "Fi",  
      "district": "Weight over big former dream character. Network anyone easy campaign seek of realize right. Range level level kind cause. Score miss need wear push walk month region."  
    }  
  },  
  "areaServed": {  
    "type": "Text",  
    "value": "She reduce policy necessary campaign your."  
  },  
  "type": "NetElement",  
  "endIntrinsicCoordinate": {  
    "type": "Number",  
    "value": 172.2  
  },  
  "startIntrinsicCoordinate": {  
    "type": "Number",  
    "value": 698.8  
  },  
  "elementPart": {  
    "type": "Text",  
    "value": "urn:ngsi-ld:NetElement:elementPart:MXDV:95711699"  
  },  
  "hasImplementation": {  
    "type": "Text",  
    "value": "urn:ngsi-ld:NetElement:hasImplementation:GOYF:07477051"  
  }  
}  

Valori chiave dell'elemento netto NGSI-LD Esempio

Ecco un esempio di NetElement 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:NetElement:id:CDPU:99275524",  
  "dateCreated": "2004-12-12T04:49:10Z",  
  "dateModified": "1992-12-16T09:32:23Z",  
  "source": "Natural film decade",  
  "name": "Price institution dream somebody although song how. Low describe energy significant light road great both. Add explain likely way smile new. Fast must leg public",  
  "alternateName": "Common wind western ball read along. Statement another type seat store. Hot case pressure identify lead.",  
  "description": "Truth expect in recently face. By spend social benefit ask response.",  
  "dataProvider": "Sing whole pres",  
  "owner": [  
    "urn:ngsi-ld:NetElement:items:OKII:37700408",  
    "urn:ngsi-ld:NetElement:items:MRRB:33006272"  
  ],  
  "seeAlso": [  
    "urn:ngsi-ld:NetElement:items:NKYQ:56695981"  
  ],  
  "location": {  
    "type": "Point",  
    "coordinates": [  
      28.6509805,  
      -162.802435  
    ]  
  },  
  "address": {  
    "streetAddress": "Way party system teacher purpose federal. For top far sell.",  
    "addressLocality": "These everyone no measure free finish decision call. Car somebody across glass war ask part. Quality here himself popular service suffer.",  
    "addressRegion": "Article despite environmental service head relate from. L",  
    "addressCountry": "Agreement cover study off. Choose back laugh who management communit",  
    "postalCode": "Radio short thought whole contain. Effect contain character after seem put debate. Decision true mission front maintain re",  
    "postOfficeBoxNumber": "Generatio",  
    "streetNr": "Fi",  
    "district": "Weight over big former dream character. Network anyone easy campaign seek of realize right. Range level level kind cause. Score miss need wear push walk month region."  
  },  
  "areaServed": "She reduce policy necessary campaign your.",  
  "type": "NetElement",  
  "endIntrinsicCoordinate": 172.2,  
  "startIntrinsicCoordinate": 698.8,  
  "elementPart": "urn:ngsi-ld:NetElement:elementPart:MXDV:95711699",  
  "hasImplementation": "urn:ngsi-ld:NetElement:hasImplementation:GOYF:07477051",  
  "@context": [  
    "https://raw.githubusercontent.com/smart-data-models/dataModel.ERA/master/context.jsonld"  
  ]  
}  

Elemento netto NGSI-LD normalizzato Esempio

Ecco un esempio di NetElement 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:NetElement:id:NVEI:78144573",  
  "dateCreated": {  
    "type": "Property",  
    "value": {  
      "@type": "DateTime",  
      "@value": "2011-10-25T09:04:55Z"  
    }  
  },  
  "dateModified": {  
    "type": "Property",  
    "value": {  
      "@type": "DateTime",  
      "@value": "1972-02-02T07:09:51Z"  
    }  
  },  
  "source": {  
    "type": "Property",  
    "value": "Increase administration contain main. Top every your. Approach raise cup kid region under pay."  
  },  
  "name": {  
    "type": "Property",  
    "value": "Indicate group son local suddenly loss."  
  },  
  "alternateName": {  
    "type": "Property",  
    "value": "Pul"  
  },  
  "description": {  
    "type": "Property",  
    "value": "Of shoulder push total throw security. Worker body season soon just skin room."  
  },  
  "dataProvider": {  
    "type": "Property",  
    "value": "Ok value system send worker. Worry mouth exist economy red. Home voice out offer think make while effort."  
  },  
  "owner": {  
    "type": "Property",  
    "value": [  
      "urn:ngsi-ld:NetElement:items:HDKF:77009578",  
      "urn:ngsi-ld:NetElement:items:IZMH:45951686"  
    ]  
  },  
  "seeAlso": {  
    "type": "Property",  
    "value": [  
      "urn:ngsi-ld:NetElement:items:TRQK:78299265"  
    ]  
  },  
  "location": {  
    "type": "Property",  
    "value": {  
      "type": "Point",  
      "coordinates": [  
        -82.8184375,  
        29.596471  
      ]  
    }  
  },  
  "address": {  
    "type": "Property",  
    "value": {  
      "streetAddress": "Dinner pay business attorney. Bring picture easy knowledge financial.",  
      "addressLocality": "Stock available country onto single have after. Tonight want detail audience best partner better thus.",  
      "addressRegion": "Individual sign most outside position ",  
      "addressCountry": "Treat same head court beyond discuss bad security.",  
      "postalCode": "Western mention large tro",  
      "postOfficeBoxNumber": "Go hold behavior. Police mind sometimes political impact seat. Everyone allow forward weight.",  
      "streetNr": "Step rate start. Term clearly character.",  
      "district": "Over my citizen alone know standard single garden. Daughter sure once whose or."  
    }  
  },  
  "areaServed": {  
    "type": "Property",  
    "value": "Wall dream hold team whatever continue field draw. Result poor educati"  
  },  
  "type": "NetElement",  
  "endIntrinsicCoordinate": {  
    "type": "Property",  
    "value": 437.0  
  },  
  "startIntrinsicCoordinate": {  
    "type": "Property",  
    "value": 884.3  
  },  
  "elementPart": {  
    "type": "Relationship",  
    "object": "urn:ngsi-ld:NetElement:elementPart:QPYN:94443064"  
  },  
  "hasImplementation": {  
    "type": "Relationship",  
    "object": "urn:ngsi-ld:NetElement:hasImplementation:LVLV:02180509"  
  },  
  "@context": [  
    "https://raw.githubusercontent.com/smart-data-models/dataModel.ERA/master/context.jsonld"  
  ]  
}  

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


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