Skip to content

spec_ES.md

Latest commit

 

History

History
732 lines (674 loc) · 25 KB

spec_ES.md

File metadata and controls

732 lines (674 loc) · 25 KB

Smart Data Models

Entidad: OSMTelecom

Licencia Abierta

documento generado automáticamente

Descripción global: Infraestructura de telecomunicaciones de OpenStreetMap etiquetada con telecom=*. Este modelo de datos es una obra derivada basada en el Wiki de OpenStreetMap, bajo licencia CC BY-SA 2.0 de los colaboradores de OpenStreetMap.

version: 0.0.1

Lista de propiedades

[*] Si no hay un tipo en un atributo es porque podría tener varios tipos o diferentes formatos/patrones

  • address[object]: La dirección postal . Model: https://schema.org/address
  • alternateName[string]: Un nombre alternativo para este elemento
  • areaServed[string]: El área geográfica donde se presta un servicio o se ofrece un artículo . Model: https://schema.org/Text
  • dataProvider[string]: Una secuencia de caracteres que identifica al proveedor de la entidad de datos armonizada
  • dateCreated[date-time]: Marca de tiempo de creación de la entidad. Esto generalmente será asignado por la plataforma de almacenamiento
  • dateModified[date-time]: Marca de tiempo de la última modificación de la entidad. Esto normalmente será asignado por la plataforma de almacenamiento
  • description[string]: Una descripción de este elemento
  • id[*]: Identificador único de la entidad
  • location[*]: Referencia Geojson al elemento. Puede ser Point, LineString, Polygon, MultiPoint, MultiLineString o MultiPolygon
  • name[string]: El nombre de este elemento
  • operator[string]: El nombre de la organización que opera la infraestructura de telecomunicaciones.
  • osmId[number]: El identificador entero del elemento original de OpenStreetMap . Model: https://wiki.openstreetmap.org/wiki/Elements
  • osmLastModified[date-time]: Marca de tiempo de la última modificación del elemento OSM . Model: https://wiki.openstreetmap.org/wiki/Elements
  • osmType[string]: El tipo del elemento original de OpenStreetMap.
  • owner[array]: Una lista que contiene una secuencia de caracteres codificada en JSON que hace referencia a los identificadores únicos del/de los propietario(s)
  • ref[string]: Referencia externa para este elemento específico . Model: https://wiki.openstreetmap.org/wiki/Key:ref
  • seeAlso[*]: Lista de URIs que apuntan a recursos adicionales.
  • source[string]: Una secuencia de caracteres que proporciona la fuente original de los datos de la entidad como una URL. Se recomienda que sea el nombre de dominio completamente calificado del proveedor de la fuente, o la URL del objeto fuente
  • telecomType[string]: La etiqueta de telecom de OSM que clasifica la característica de telecomunicaciones . Model: https://wiki.openstreetmap.org/wiki/Key:telecom
  • type[string]: Tipo de entidad NGSI. Debe ser OSMTelecom

Propiedades obligatorias

  • id
  • location
  • osmId
  • osmType
  • telecomType
  • type

Descripción de propiedades del Modelo de Datos

Ordenado alfabéticamente (clic para detalles)

full yaml details 
OSMTelecom:    
  description: Telecommunication infrastructure from OpenStreetMap tagged with telecom=*. This data model is a derivative work based on the OpenStreetMap Wiki, licensed under CC BY-SA 2.0 by OpenStreetMap contributors.    
  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    
    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: Relationship    
    location:    
      description: Geojson reference to the item. It can be Point, LineString, Polygon, MultiPoint, MultiLineString or MultiPolygon    
      oneOf:    
        - description: Geojson reference to the item. Point    
          properties:    
            bbox:    
              description: BBox of the  Point    
              items:    
                type: number    
              minItems: 4    
              type: array    
              x-ngsi:    
                type: Property    
            coordinates:    
              description: Coordinates of the Point    
              items:    
                type: number    
              minItems: 2    
              type: array    
              x-ngsi:    
                type: Property    
            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:    
              description: BBox coordinates of the LineString    
              items:    
                type: number    
              minItems: 4    
              type: array    
              x-ngsi:    
                type: Property    
            coordinates:    
              description: Coordinates of the LineString    
              items:    
                items:    
                  type: number    
                minItems: 2    
                type: array    
              minItems: 2    
              type: array    
              x-ngsi:    
                type: Property    
            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:    
              description: BBox coordinates of the Polygon    
              items:    
                type: number    
              minItems: 4    
              type: array    
              x-ngsi:    
                type: Property    
            coordinates:    
              description: Coordinates of the Polygon    
              items:    
                items:    
                  items:    
                    type: number    
                  minItems: 2    
                  type: array    
                minItems: 4    
                type: array    
              type: array    
              x-ngsi:    
                type: Property    
            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:    
              description: BBox coordinates of the LineString    
              items:    
                type: number    
              minItems: 4    
              type: array    
              x-ngsi:    
                type: Property    
            coordinates:    
              description: Coordinates of the MulitPoint    
              items:    
                items:    
                  type: number    
                minItems: 2    
                type: array    
              type: array    
              x-ngsi:    
                type: Property    
            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:    
              description: BBox coordinates of the LineString    
              items:    
                type: number    
              minItems: 4    
              type: array    
              x-ngsi:    
                type: Property    
            coordinates:    
              description: Coordinates of the MultiLineString    
              items:    
                items:    
                  items:    
                    type: number    
                  minItems: 2    
                  type: array    
                minItems: 2    
                type: array    
              type: array    
              x-ngsi:    
                type: Property    
            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:    
              description: Coordinates of the MultiPolygon    
              items:    
                items:    
                  items:    
                    items:    
                      type: number    
                    minItems: 2    
                    type: array    
                  minItems: 4    
                  type: array    
                type: array    
              type: array    
              x-ngsi:    
                type: Property    
            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    
    operator:    
      description: The name of the organization operating the telecommunication infrastructure.    
      type: string    
      x-ngsi:    
        type: Property    
    osmId:    
      description: The original OpenStreetMap element integer identifier    
      type: number    
      x-ngsi:    
        model: https://wiki.openstreetmap.org/wiki/Elements    
        type: Property    
    osmLastModified:    
      description: Timestamp of the last modification of the OSM element    
      format: date-time    
      type: string    
      x-ngsi:    
        model: https://wiki.openstreetmap.org/wiki/Elements    
        type: Property    
    osmType:    
      description: The type of the original OpenStreetMap element.    
      enum:    
        - node    
        - way    
        - relation    
      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: Relationship    
      type: array    
      x-ngsi:    
        type: Property    
    ref:    
      description: External reference for this specific item    
      type: string    
      x-ngsi:    
        model: https://wiki.openstreetmap.org/wiki/Key:ref    
        type: Property    
    seeAlso:    
      description: List of URIs pointing to additional resources.    
      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    
    telecomType:    
      description: The OSM telecom tag classifying the telecommunication feature    
      enum:    
        - antenna    
        - exchange    
        - cabinet    
        - connection_point    
        - distribution_point    
        - manhole    
        - outlet    
        - pedestal    
        - service_device    
      type: string    
      x-ngsi:    
        model: https://wiki.openstreetmap.org/wiki/Key:telecom    
        type: Property    
    type:    
      description: NGSI Entity type. It has to be OSMTelecom    
      enum:    
        - OSMTelecom    
      type: string    
      x-ngsi:    
        type: Property    
  required:    
    - id    
    - type    
    - location    
    - osmId    
    - osmType    
    - telecomType    
  type: object    
  x-derived-from: https://wiki.openstreetmap.org/wiki/Key:telecom    
  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.OpenStreetMap/blob/master/OSMTelecom/LICENSE.md    
  x-model-schema: https://smart-data-models.github.io/dataModel.OpenStreetMap/OSMTelecom/schema.json    
  x-model-tags: OSM OpenStreetMap Telecom    
  x-version: 0.0.1

Ejemplos de cargas útiles

Ejemplo de pares clave-valor de OSMTelecom NGSI-v2

Aquí hay un ejemplo de un OSMTelecom en formato JSON-LD como pares clave-valor. Es compatible con NGSI-v2 al usar options=keyValues y devuelve los datos de contexto de una entidad individual.

show/hide example 
{  
  "id": "urn:ngsi-ld:OSMTelecom:node:99887722",  
  "type": "OSMTelecom",  
  "osmId": 99887722,  
  "osmType": "node",  
  "osmLastModified": "2023-11-20T11:00:00Z",  
  "name": "Telefónica Antenna - Chamartín",  
  "telecomType": "antenna",  
  "operator": "Movistar / Telefónica",  
  "ref": "MAD-ANT-01A",  
  "location": {  
    "type": "Point",  
    "coordinates": [  
      -3.6764,  
      40.4668  
    ]  
  },  
  "source": "https://www.openstreetmap.org",  
  "seeAlso": [  
    "https://www.openstreetmap.org/node/99887722"  
  ]  
}

Ejemplo normalizado de OSMTelecom NGSI-v2

Aquí hay un ejemplo de un OSMTelecom en formato JSON-LD como normalizado. Es compatible con NGSI-v2 cuando no se usan opciones y devuelve los datos de contexto de una entidad individual.

show/hide example 
{  
  "id": "urn:ngsi-ld:OSMTelecom:node:99887722",  
  "type": "OSMTelecom",  
  "osmId": {  
    "type": "Integer",  
    "value": 99887722  
  },  
  "osmType": {  
    "type": "Text",  
    "value": "node"  
  },  
  "osmLastModified": {  
    "type": "DateTime",  
    "value": "2023-11-20T11:00:00Z"  
  },  
  "name": {  
    "type": "Text",  
    "value": "Telefónica Antenna - Chamartín"  
  },  
  "telecomType": {  
    "type": "Text",  
    "value": "antenna"  
  },  
  "operator": {  
    "type": "Text",  
    "value": "Movistar / Telefónica"  
  },  
  "ref": {  
    "type": "Text",  
    "value": "MAD-ANT-01A"  
  },  
  "location": {  
    "type": "geo:json",  
    "value": {  
      "type": "Point",  
      "coordinates": [  
        -3.6764,  
        40.4668  
      ]  
    }  
  },  
  "source": {  
    "type": "URL",  
    "value": "https://www.openstreetmap.org"  
  },  
  "seeAlso": {  
    "type": "StructuredValue",  
    "value": [  
      "https://www.openstreetmap.org/node/99887722"  
    ]  
  }  
}

Ejemplo de pares clave-valor de OSMTelecom NGSI-LD

Aquí hay un ejemplo de un OSMTelecom en formato JSON-LD como pares clave-valor. Es compatible con NGSI-LD al usar options=keyValues y devuelve los datos de contexto de una entidad individual.

show/hide example 
{  
  "id": "urn:ngsi-ld:OSMTelecom:node:99887722",  
  "type": "OSMTelecom",  
  "osmId": 99887722,  
  "osmType": "node",  
  "osmLastModified": "2023-11-20T11:00:00Z",  
  "name": "Telefónica Antenna - Chamartín",  
  "telecomType": "antenna",  
  "operator": "Movistar / Telefónica",  
  "ref": "MAD-ANT-01A",  
  "location": {  
    "type": "Point",  
    "coordinates": [  
      -3.6764,  
      40.4668  
    ]  
  },  
  "source": "https://www.openstreetmap.org",  
  "seeAlso": [  
    "https://www.openstreetmap.org/node/99887722"  
  ],  
  "@context": [  
    "https://raw.githubusercontent.com/smart-data-models/dataModel.OpenStreetMap/refs/heads/master/context.jsonld"  
  ]  
}

Ejemplo normalizado de OSMTelecom NGSI-LD

Aquí hay un ejemplo de un OSMTelecom en formato JSON-LD como normalizado. Es compatible con NGSI-LD cuando no se usan opciones y devuelve los datos de contexto de una entidad individual.

show/hide example 
{  
  "id": "urn:ngsi-ld:OSMTelecom:node:99887722",  
  "type": "OSMTelecom",  
  "osmId": {  
    "type": "Property",  
    "value": 99887722  
  },  
  "osmType": {  
    "type": "Property",  
    "value": "node"  
  },  
  "osmLastModified": {  
    "type": "Property",  
    "value": "2023-11-20T11:00:00Z"  
  },  
  "name": {  
    "type": "Property",  
    "value": "Telefónica Antenna - Chamartín"  
  },  
  "telecomType": {  
    "type": "Property",  
    "value": "antenna"  
  },  
  "operator": {  
    "type": "Property",  
    "value": "Movistar / Telefónica"  
  },  
  "ref": {  
    "type": "Property",  
    "value": "MAD-ANT-01A"  
  },  
  "location": {  
    "type": "GeoProperty",  
    "value": {  
      "type": "Point",  
      "coordinates": [  
        -3.6764,  
        40.4668  
      ]  
    }  
  },  
  "source": {  
    "type": "Property",  
    "value": "https://www.openstreetmap.org"  
  },  
  "seeAlso": {  
    "type": "Property",  
    "value": [  
      "https://www.openstreetmap.org/node/99887722"  
    ]  
  },  
  "@context": [  
    "https://raw.githubusercontent.com/smart-data-models/dataModel.OpenStreetMap/refs/heads/master/context.jsonld"  
  ]  
}

Consulte Preguntas Frecuentes 10 para obtener una respuesta sobre cómo tratar las unidades de magnitud

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