documento generado automáticamente
Descripción global: Servicio de datos adaptado de la especificación DCAT-AP 2.1.1, pero ampliado con propiedades adicionales y compatible con la norma NGSI.
versión: 0.0.2
[*] Si no hay un tipo en un atributo es porque puede tener varios tipos o diferentes formatos/patrones.
accessRights[string]
: Esta propiedad PUEDE incluir información relativa al acceso o restricciones basadas en políticas de privacidad, seguridad u otras. . Model: http://purl.org/dc/terms/RightsStatementaddress[object]
: La dirección postal . Model: https://schema.org/addressaddressCountry[string]
: El país. Por ejemplo, España . Model: https://schema.org/addressCountryaddressLocality[string]
: La localidad en la que se encuentra la dirección postal, y que está en la región . Model: https://schema.org/addressLocalityaddressRegion[string]
: La región en la que se encuentra la localidad, y que está en el país . Model: https://schema.org/addressRegiondistrict[string]
: Un distrito es un tipo de división administrativa que, en algunos países, gestiona el gobierno localpostOfficeBoxNumber[string]
: El número del apartado de correos para las direcciones de apartados postales. Por ejemplo, 03578 . Model: https://schema.org/postOfficeBoxNumberpostalCode[string]
: El código postal. Por ejemplo, 24004 . Model: https://schema.org/https://schema.org/postalCodestreetAddress[string]
: La dirección . Model: https://schema.org/streetAddress
areaServed[string]
: La zona geográfica en la que se presta un servicio o se ofrece un artículo . Model: https://schema.org/Textdescription[array]
: Esta propiedad contiene una descripción en texto libre del Servicio de Datos. Esta propiedad puede repetirse para versiones de la descripción en lenguajes paralelos . Model: http://www.w3.org/2000/01/rdf-schema#LiteralendPointDescription[array]
: Esta propiedad contiene una descripción de los servicios disponibles a través de los puntos finales, incluidas sus operaciones, parámetros, etc. La propiedad proporciona detalles específicos de las instancias reales de los extremos, mientras que dct:conformsTo se utiliza para indicar la norma o especificación general que aplican los extremos. . Model: http://www.w3.org/2000/01/rdf-schema#ResourceendPointURL[array]
: La ubicación raíz o punto final primario del servicio (un IRI) . Model: http://www.w3.org/2000/01/rdf-schema#Resourceid[*]
: Identificador único de la entidadlicense[string]
: Esta propiedad contiene la licencia bajo la cual se ofrece el servicio de datos. . Model: http://purl.org/dc/terms/LicenseDocumentlocation[*]
: Referencia Geojson al elemento. Puede ser Point, LineString, Polygon, MultiPoint, MultiLineString o MultiPolygon.servesDataset[array]
: Esta propiedad se refiere a una colección de datos que este servicio de datos puede distribuir . Model: http://www.w3.org/ns/dcat#Datasettitle[array]
: Esta propiedad contiene un nombre dado al Servicio de Datos. Esta propiedad puede repetirse para versiones del nombre en idiomas paralelos . Model: http://www.w3.org/2000/01/rdf-schema#Literaltype[string]
: Tipo de entidad NGSI. Tiene que ser DataService
Propiedades requeridas
endPointURL
id
title
type
Adaptado de DCAT-AP versión 2.1.1. Se ha cambiado el nombre de algunas propiedades para evitar conflictos con otras propiedades existentes. Además, se han añadido otras propiedades para mantener la compatibilidad con el estándar NGSI y otros modelos de datos.
Ordenados alfabéticamente (pulse para más detalles)
full yaml details
DataService:
description: 'Data Service adapted from DCAT-AP 2.1.1 specification, but extended with additional properties and compatible with NGSI standard'
properties:
accessRights:
description: 'This property MAY include information regarding access or restrictions based on privacy, security, or other policies'
type: string
x-ngsi:
model: http://purl.org/dc/terms/RightsStatement
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
description:
description: This property contains a free-text account of the Data Service. This property can be repeated for parallel language versions of the description
items:
description: Every description in a language
type: string
x-ngsi:
type: Property
type: array
x-ngsi:
model: "http://www.w3.org/2000/01/rdf-schema#Literal"
type: Property
endPointDescription:
description: 'This property contains a description of the services available via the end-points, including their operations, parameters etc. The property gives specific details of the actual endpoint instances, while dct:conformsTo is used to indicate the general standard or specification that the endpoints implement'
items:
description: Every service available at an end-point
type: string
x-ngsi:
type: Property
type: array
x-ngsi:
model: "http://www.w3.org/2000/01/rdf-schema#Resource"
type: Property
endPointURL:
description: The root location or primary endpoint of the service (an IRI)
items:
description: Every root location
format: uri
minItems: 1
type: string
x-ngsi:
type: Property
type: array
x-ngsi:
model: "http://www.w3.org/2000/01/rdf-schema#Resource"
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
license:
description: This property contains the licence under which the Data service is made available
type: string
x-ngsi:
model: http://purl.org/dc/terms/LicenseDocument
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
servesDataset:
description: This property refers to a collection of data that this data service can distribute
items:
description: Every dataset distributed
type: string
x-ngsi:
type: Property
type: array
x-ngsi:
model: "http://www.w3.org/ns/dcat#Dataset"
type: Property
title:
description: This property contains a name given to the Data Service. This property can be repeated for parallel language versions of the name
items:
description: The title in one language
type: string
x-ngsi:
type: Property
type: array
x-ngsi:
model: "http://www.w3.org/2000/01/rdf-schema#Literal"
type: Property
type:
description: NGSI Entity type. It has to be DataService
enum:
- DataService
type: string
x-ngsi:
type: Property
required:
- endPointURL
- id
- title
- 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.DCAT-AP/blob/master/DataService/LICENSE.md
x-model-schema: https://smart-data-models.github.io/dataModel.DCAT-AP/DataService/schema.json
x-model-tags: ""
x-version: 0.0.2
Se han añadido algunas propiedades para permitir un uso más amplio. A saber, contactPoint, assetProvider y configuración.
He aquí un ejemplo de un DataService en formato JSON-LD como key-values. Esto es compatible con NGSI-v2 cuando se utiliza options=keyValues
y devuelve los datos de contexto de una entidad individual.
show/hide example
{
"id": "urn:ngsi-ld:DataService:id:JBDJ:56257192",
"type": "DataService",
"accessRights": "No restrictions to access the data but APi requests limit, 5000 requests per hour",
"address": {
"addressCountry": "Luxembourg",
"addressLocality": "Luxembourg",
"addressRegion": "Luxembourg",
"postOfficeBoxNumber": "",
"postalCode": "2985",
"streetAddress": "2, rue Mercier"
},
"areaServed": "European union and beyond",
"description": [
"Digital resources for accessing to the end points of the EU open data portal for solar system.",
"Recursos digitales para el acceso a los puntos de interaccion del portal europeo de datos abiertos del sistema solar."
],
"endPointDescription": [
"SPARQL end point without authentication",
"API compliant with CKAN specification"
],
"endPointURL": [
"urn:ngsi-ld:DataServiceDCAT-AP:items:AFGI:79071729",
"urn:ngsi-ld:DataServiceDCAT-AP:items:JAZP:97999812"
],
"license": "EUPL.",
"location": {
"coordinates": [
72.564509,
11.125289
],
"type": "Point"
},
"servesDataset": [
"EU geographic map",
"EU physical map"
],
"title": [
"Data service of the european open data portal",
"Data service del portal europeo de datos abiertos"
]
}
He aquí un ejemplo de un DataService en formato JSON-LD normalizado. Esto es compatible con NGSI-v2 cuando no se utilizan opciones y devuelve los datos de contexto de una entidad individual.
show/hide example
{
"id": "urn:ngsi-ld:DataService:id:JBDJ:56257192",
"type": "DataService",
"description": {
"type": "StructuredValue",
"value": [
"Data service for the solar system open data portal."
]
},
"location": {
"type": "geo:json",
"value": {
"type": "Point",
"coordinates": [
72.564509,
11.125289
]
}
},
"address": {
"type": "StructuredValue",
"value": {
"streetAddress": "2, rue Mercier",
"addressLocality": "Luxembourg",
"addressRegion": "Luxembourg",
"addressCountry": "Luxembourg",
"postalCode": "2985",
"postOfficeBoxNumber": ""
}
},
"areaServed": {
"type": "Text",
"value": "European union and beyond"
},
"endPointURL": {
"type": "StructuredValue",
"value": [
"urn:ngsi-ld:DataServiceDCAT-AP:items:AFGI:79071729",
"urn:ngsi-ld:DataServiceDCAT-AP:items:JAZP:97999812"
]
},
"title": {
"type": "StructuredValue",
"value": [
"Data service of the european open data portal",
"Data service del portal europeo de datos abiertos"
]
},
"endPointDescription": {
"type": "StructuredValue",
"value": [
"SPARQL end point without authentication",
"API compliant with CKAN specification"
]
},
"servesDataset": {
"type": "StructuredValue",
"value": [
"EU geographic map",
"EU physical map"
]
},
"accessRights": {
"type": "Text",
"value": "No restrictions to access the data but APi requests limit, 5000 requests per hour"
},
"license": {
"type": "Text",
"value": "EUPL."
}
}
He aquí un ejemplo de un DataService en formato JSON-LD como key-values. Esto es compatible con NGSI-LD cuando se utiliza options=keyValues
y devuelve los datos de contexto de una entidad individual.
show/hide example
{
"id": "urn:ngsi-ld:DataService:id:JBDJ:56257192",
"type": "DataService",
"accessRights": "No restrictions to access the data but APi requests limit, 5000 requests per hour",
"address": {
"addressCountry": "Luxembourg",
"addressLocality": "Luxembourg",
"addressRegion": "Luxembourg",
"postOfficeBoxNumber": "",
"postalCode": "2985",
"streetAddress": "2, rue Mercier"
},
"areaServed": "European union and beyond",
"description": [
"Digital resources for accessing to the end points of the EU open data portal for solar system.",
"Recursos digitales para el acceso a los puntos de interaccion del portal europeo de datos abiertos del sistema solar."
],
"modified": "2021-10-06T16:31:26Z",
"endPointDescription": [
"SPARQL end point without authentication",
"API compliant with CKAN specification"
],
"endPointURL": [
"urn:ngsi-ld:DataServiceDCAT-AP:items:AFGI:79071729",
"urn:ngsi-ld:DataServiceDCAT-AP:items:JAZP:97999812"
],
"license": "EUPL.",
"location": {
"coordinates": [
72.564509,
11.125289
],
"type": "Point"
},
"servesDataset": [
"EU geographic map",
"EU physical map"
],
"title": [
"Data service of the european open data portal",
"Data service del portal europeo de datos abiertos"
],
"@context": [
"https://raw.githubusercontent.com/smart-data-models/dataModel.DCAT-AP/master/context.jsonld"
]
}
He aquí un ejemplo de un DataService en formato JSON-LD normalizado. Esto es compatible con NGSI-LD cuando no se utilizan opciones y devuelve los datos de contexto de una entidad individual.
show/hide example
{
"id": "urn:ngsi-ld:DataService:id:JBDJ:56257192",
"type": "DataService",
"accessRights": {
"type": "Property",
"value": "No restrictions to access the data but APi requests limit, 5000 requests per hour"
},
"address": {
"type": "Property",
"value": {
"streetAddress": "2, rue Mercier",
"addressLocality": "Luxembourg",
"addressRegion": "Luxembourg",
"addressCountry": "Luxembourg",
"postalCode": "2985",
"postOfficeBoxNumber": ""
}
},
"areaServed": {
"type": "Property",
"value": "European union and beyond"
},
"modified": {
"type": "Property",
"value": {
"@type": "DateTime",
"@value": "2021-10-06T16:31:26Z"
}
},
"description": {
"type": "Property",
"value": "Data service for the solar system open data portal."
},
"endPointDescription": {
"type": "Property",
"value": [
"SPARQL end point without authentication",
"API compliant with CKAN specification"
]
},
"endPointURL": {
"type": "Property",
"value": [
"urn:ngsi-ld:DataServiceDCAT-AP:items:AFGI:79071729",
"urn:ngsi-ld:DataServiceDCAT-AP:items:JAZP:97999812"
]
},
"license": {
"type": "Property",
"value": "EUPL."
},
"location": {
"type": "GeoProperty",
"value": {
"type": "Point",
"coordinates": [
72.564509,
11.125289
]
}
},
"servesDataset": {
"type": "Property",
"value": [
"EU geographic map",
"EU physical map"
]
},
"title": {
"type": "Property",
"value": [
"Data service of the european open data portal",
"Data service del portal europeo de datos abiertos"
]
},
"@context": [
"https://raw.githubusercontent.com/smart-data-models/dataModel.DCAT-AP/master/context.jsonld"
]
}
Consulte FAQ 10 para obtener una respuesta sobre cómo tratar las unidades de magnitud.