全局描述:为智能数据模型倡议从原始无摩擦数据转换而来的数据资源
版本: 0.0.3
[*] 如果属性中没有类型,是因为它可能有多个类型或不同的格式/模式。
address[object]
: 邮寄地址 . Model: https://schema.org/addressaddressCountry[string]
: 国家。例如,西班牙 . Model: https://schema.org/addressCountryaddressLocality[string]
: 街道地址所在的地点,以及该地点所在的区域 . Model: https://schema.org/addressLocalityaddressRegion[string]
: 地点所在的地区,以及该地区位于哪个国家 . Model: https://schema.org/addressRegiondistrict[string]
: 地区是一种行政区划,在一些国家由地方政府管理postOfficeBoxNumber[string]
: 用于邮政信箱地址的邮政信箱号码。例如:03578 . Model: https://schema.org/postOfficeBoxNumberpostalCode[string]
: 邮政编码。例如:24004 . Model: https://schema.org/https://schema.org/postalCodestreetAddress[string]
: 街道地址 . Model: https://schema.org/streetAddress
areaServed[string]
: 提供服务或提供物品的地理区域 . Model: https://schema.org/Textbytes[number]
: 字节。该资源的大小(字节data[array]
: 数据。该资源的内联数据description[string]
: 描述。文本描述。鼓励使用 Markdownencoding[string]
: 编码。该资源的文件编码format[string]
: 格式。csv"、"xls"、"json "是常见格式的示例。该资源的文件格式hash[string]
: 哈希值。该资源的 MD5 哈希值。使用 {algorithm}:{hash} 格式指明其他散列算法homepage[string]
: 主页。与该数据包相关的网络主页id[*]
: 实体的唯一标识符licenses[array]
: 许可证。本属性不具有法律约束力,也不保证软件包已根据本条款获得许可。发布资源所依据的许可证location[*]
: 项目的 Geojson 引用。它可以是点、线条字符串、多边形、多点、多线条字符串或多多边形mediatype[string]
: 媒体类型。该资源的媒体类型。可以是 IANA 列出的任何有效媒体类型。name[string]
: 名称。理想情况下,这是一个可在 url 中使用且人类可读的名称。名称 "应 "保持不变,也就是说,当父描述符更新时,名称 "不应 "改变。标识符字符串。允许使用小写字母"."、"_"、"-"和"/"。path[array]
: 路径。路径 "中每个引用数据源的终止引用值 "必须 "与资源描述数据的本地终止引用表示相称。例如,在 Tabular 数据资源中,这意味着 "路径 "的解除引用值 "必须 "是一个数组。对该资源数据的引用,可以是字符串形式的路径,也可以是字符串形式的路径数组。 有效 URIsprofile[string]
: 简介。每个包和资源描述符都有一个配置文件。如果没有声明配置文件,默认的配置文件对包来说是 "data-package",对资源来说是 "data-resource"。该描述符的配置文件schema[object]
: 模式。该资源的模式sources[array]
: 来源:..本资源的原始资料来源title[string]
: 标题人类可读的标题type[string]
: NGSI 实体类型。必须是 DataResourceFrictionlessData
所需属性
id
name
type
该数据模型来自原始的无摩擦数据,可在 https://frictionlessdata.io/ 上找到。其中有几处改动1)根据 NGSI-LD 标准的要求,id 和类型已成为必填项 2)json 模式的结构已调整为智能数据模型的官方格式。参见贡献手册 https://bit.ly/contribution_manual。为了使其兼容,数据属性和源属性被定义为对象数组。此外,还包括类型。
按字母顺序排列(点击查看详情)
full yaml details
DataResourceFrictionlessData:
description: Data Resource.Converted for Smart Data Models initiative from original frictionless data
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
areaServed:
description: The geographic area where a service or offered item is provided
type: string
x-ngsi:
model: https://schema.org/Text
type: Property
bytes:
description: Bytes. The size of this resource in bytes
type: number
x-ngsi:
type: Property
data:
description: Data. Inline data for this resource
items:
type: object
type: array
x-ngsi:
type: Property
description:
description: Description. A text description. Markdown is encouraged
type: string
x-ngsi:
type: Property
encoding:
description: Encoding. The file encoding of this resource
type: string
x-ngsi:
type: Property
format:
description: 'Format. ''csv'', ''xls'', ''json'' are examples of common formats. The file format of this resource'
type: string
x-ngsi:
type: Property
hash:
description: 'Hash. The MD5 hash of this resource. Indicate other hashing algorithms with the {algorithm}:{hash} format'
pattern: ^([^:]+:[a-fA-F0-9]+|[a-fA-F0-9]{32}|)$
type: string
x-ngsi:
type: Property
homepage:
description: Home Page. The home on the web that is related to this data package
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
licenses:
description: Licenses. This property is not legally binding and does not guarantee that the package is licensed under the terms defined herein. The license(s) under which the resource is published
items:
properties:
name:
type: string
path:
type: string
title:
type: string
type: object
minItems: 1
type: array
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
mediatype:
description: 'Media Type. The media type of this resource. Can be any valid media type listed with [IANA](https://www.iana.org/assignments/media-types/media-types.xhtml)'
type: string
x-ngsi:
type: Property
name:
description: 'Name. This is ideally a url-usable and human-readable name. Name ''SHOULD'' be invariant, meaning it ''SHOULD NOT'' change when its parent descriptor is updated. An identifier string. Lower case characters with ''.'', ''_'', ''-'' and ''/'' are allowed'
type: string
x-ngsi:
type: Property
path:
description: 'Path. The dereferenced value of each referenced data source in ''path'' ''MUST'' be commensurate with a native, dereferenced representation of the data the resource describes. For example, in a *Tabular* Data Resource, this means that the dereferenced value of ''path'' ''MUST'' be an array. A reference to the data for this resource, as either a path as a string, or an array of paths as strings. of valid URIs'
items:
type: string
minItems: 1
type: array
x-ngsi:
type: Property
profile:
description: 'Profile. Every Package and Resource descriptor has a profile. The default profile, if none is declared, is ''data-package'' for Package and ''data-resource'' for Resource. The profile of this descriptor'
type: string
x-ngsi:
type: Property
schema:
description: Schema. A schema for this resource
type: object
x-ngsi:
type: Property
sources:
description: Sources. . The raw sources for this resource
items:
properties:
email:
format: idn-email
type: string
path:
type: string
title:
type: string
type: object
type: array
x-ngsi:
type: Property
title:
description: Title. A human-readable title
type: string
x-ngsi:
type: Property
type:
description: NGSI Entity type. It has to be DataResourceFrictionlessData
enum:
- DataResourceFrictionlessData
type: string
x-ngsi:
type: Property
required:
- name
- id
- 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.FrictionlessData/blob/master/DataResourceFrictionlessData/LICENSE.md
x-model-schema: ""
x-model-tags: SDG
x-version: 0.0.3
下面是一个以 JSON-LD 格式作为键值的 DataResourceFrictionlessData 示例。当使用 options=keyValues
时,它与 NGSI-v2 兼容,并返回单个实体的上下文数据。
show/hide example
{
"id": "urn:ngsi-ld:dataresource:AECS:1234",
"type": "DataResourceFrictionlessData",
"bytes": 2082,
"data": [
{},
{}
],
"description": "My favourite data about the solar system.",
"encoding": "utf-8",
"format": "csv",
"hash": "SHA256:5262f12512590031bbcc9a430452bfd75c2791ad6771320bb4b5728bfb78c4d0",
"homepage": "https://smartdatamodels.org",
"licenses": [
{
"name": "CC-BY",
"title": "creative commons attribution",
"path": "https://creativecommons.org/licenses/by/4.0/deed.en"
},
{
"name": "odc-pddl-1.0",
"path": "http://opendatacommons.org/licenses/pddl/",
"title": "Open Data Commons Public Domain Dedication and License v1.0"
}
],
"mediatype": "text/csv",
"name": "solar-system",
"path": [
"http://example.com/solar-system.csv"
],
"profile": "tabular-data-package",
"schema": {},
"sources": [
{
"title": "Venus",
"path": "https://smartdatamodels.org/venus",
"email": "[email protected]"
},
{
"title": "Jupiter",
"path": "https://smartdatamodels.org/jupiter",
"email": "[email protected]"
}
],
"title": "The Solar System"
}
下面是一个规范化 JSON-LD 格式的 DataResourceFrictionlessData 示例。当不使用选项时,它与 NGSI-v2 兼容,并返回单个实体的上下文数据。
show/hide example
{
"id": "urn:ngsi-ld:dataresource:AECS:1234",
"type": "DataResourceFrictionlessData",
"bytes": {
"type": "Number",
"value": 2082
},
"data": {
"type": "StructuredValue",
"value": [
{},
{}
]
},
"description": {
"type": "Text",
"value": "My favourite data about the solar system."
},
"encoding": {
"type": "Text",
"value": "utf-8"
},
"format": {
"type": "Text",
"value": "csv"
},
"hash": {
"type": "Text",
"value": "SHA256:5262f12512590031bbcc9a430452bfd75c2791ad6771320bb4b5728bfb78c4d0"
},
"homepage": {
"type": "Text",
"value": "https://smartdatamodels.org"
},
"licenses": {
"type": "StructuredValue",
"value": [
{
"name": "CC-BY",
"title": "creative commons attribution",
"path": "https://creativecommons.org/licenses/by/4.0/deed.en"
},
{
"name": "odc-pddl-1.0",
"path": "http://opendatacommons.org/licenses/pddl/",
"title": "Open Data Commons Public Domain Dedication and License v1.0"
}
]
},
"mediatype": {
"type": "Text",
"value": "text/csv"
},
"name": {
"type": "Text",
"value": "solar-system"
},
"path": {
"type": "StructuredValue",
"value": [
"http://example.com/solar-system.csv"
]
},
"profile": {
"type": "Text",
"value": "tabular-data-package"
},
"schema": {
"type": "StructuredValue",
"value": {}
},
"sources": {
"type": "StructuredValue",
"value": [
{
"title": "Venus",
"path": "https://smartdatamodels.org/venus",
"email": "[email protected]"
},
{
"title": "Jupiter",
"path": "https://smartdatamodels.org/jupiter",
"email": "[email protected]"
}
]
},
"title": {
"type": "Text",
"value": "The Solar System"
}
}
下面是一个以 JSON-LD 格式作为键值的 DataResourceFrictionlessData 示例。当使用 options=keyValues
时,它与 NGSI-LD 兼容,并返回单个实体的上下文数据。
show/hide example
{
"id": "urn:ngsi-ld:dataresource:AECS:1234",
"type": "DataResourceFrictionlessData",
"bytes": 2082,
"data": [
{},
{}
],
"description": "My favourite data about the solar system.",
"encoding": "utf-8",
"format": "csv",
"hash": "SHA256:5262f12512590031bbcc9a430452bfd75c2791ad6771320bb4b5728bfb78c4d0",
"homepage": "https://smartdatamodels.org",
"licenses": [
{
"name": "CC-BY",
"title": "creative commons attribution",
"path": "https://creativecommons.org/licenses/by/4.0/deed.en"
},
{
"name": "odc-pddl-1.0",
"path": "http://opendatacommons.org/licenses/pddl/",
"title": "Open Data Commons Public Domain Dedication and License v1.0"
}
],
"mediatype": "text/csv",
"name": "solar-system",
"path": [
"http://example.com/solar-system.csv"
],
"profile": "tabular-data-package",
"schema": {},
"sources": [
{
"title": "Venus",
"path": "https://smartdatamodels.org/venus",
"email": "[email protected]"
},
{
"title": "Jupiter",
"path": "https://smartdatamodels.org/jupiter",
"email": "[email protected]"
}
],
"title": "The Solar System",
"@context": [
"https://smartdatamodels.org/context.jsonld",
"https://raw.githubusercontent.com/smart-data-models/dataModel.FrictionlessData/master/context.jsonld"
]
}
下面是一个规范化 JSON-LD 格式的 DataResourceFrictionlessData 示例。当不使用选项时,它与 NGSI-LD 兼容,并返回单个实体的上下文数据。
show/hide example
{
"id": "urn:ngsi-ld:dataresource:AECS:1234",
"type": "DataResourceFrictionlessData",
"bytes": {
"type": "Property",
"value": 2082
},
"data": {
"type": "Property",
"value": [
{},
{}
]
},
"description": {
"type": "Property",
"value": "My favourite data about the solar system."
},
"encoding": {
"type": "Property",
"value": "utf-8"
},
"format": {
"type": "Property",
"value": "csv"
},
"hash": {
"type": "Property",
"value": "SHA256:5262f12512590031bbcc9a430452bfd75c2791ad6771320bb4b5728bfb78c4d0"
},
"homepage": {
"type": "Property",
"value": "https://smartdatamodels.org"
},
"licenses": {
"type": "Property",
"value": [
{
"name": "CC-BY",
"title": "creative commons attribution",
"path": "https://creativecommons.org/licenses/by/4.0/deed.en"
},
{
"name": "odc-pddl-1.0",
"path": "http://opendatacommons.org/licenses/pddl/",
"title": "Open Data Commons Public Domain Dedication and License v1.0"
}
]
},
"mediatype": {
"type": "Property",
"value": "text/csv"
},
"name": {
"type": "Property",
"value": "solar-system"
},
"path": {
"type": "Property",
"value": [
"http://example.com/solar-system.csv"
]
},
"profile": {
"type": "Property",
"value": "tabular-data-package"
},
"schema": {
"type": "Property",
"value": {}
},
"sources": {
"type": "Property",
"value": [
{
"title": "Venus",
"path": "https://smartdatamodels.org/venus",
"email": "[email protected]"
},
{
"title": "Jupiter",
"path": "https://smartdatamodels.org/jupiter",
"email": "[email protected]"
}
]
},
"title": {
"type": "Property",
"value": "The Solar System"
},
"@context": [
"https://smartdatamodels.org/context.jsonld",
"https://raw.githubusercontent.com/smart-data-models/dataModel.FrictionlessData/master/context.jsonld"
]
}
请参阅 FAQ 10,获取如何处理幅度单位的答案。