Skip to content

Commit c8c5603

Browse files
albertoabellagarciaalbertoabellagarcia
committed
Update ZH
1 parent 16bbeb6 commit c8c5603

1 file changed

Lines changed: 120 additions & 69 deletions

File tree

‎OSMRailway/doc/spec_ZH.md‎

Lines changed: 120 additions & 69 deletions
Original file line numberDiff line numberDiff line change
@@ -1,40 +1,81 @@
1-
<!-- 10-Header -->
2-
[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org)
3-
实体: OSMRailway
4-
==================<!-- /10-Header -->
5-
<!-- 15-License -->
6-
[Open License](https://github.com/smart-data-models//dataModel.OpenStreetMap/blob/master/OSMRailway/LICENSE.md)
7-
[document generated automatically](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)
8-
<!-- /15-License -->
9-
<!-- 20-Description -->
10-
全局描述: **来自OpenStreetMap的铁路轨道或基础设施元素，带有railway键标签。涵盖所有类型的铁路基础设施，从主线重轨到有轨电车、地铁和缆索铁路。**
11-
版本: 0.0.1
12-
<!-- /20-Description -->
13-
<!-- 30-PropertiesList -->
1+
<!-- 10-Header -->
2+
[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org)
3+
实体：OSMRailway
4+
==================<!-- /10-Header -->
5+
<!-- 15-License -->
6+
[Open License](https://github.com/smart-data-models//dataModel.OpenStreetMap/blob/master/OSMRailway/LICENSE.md)
7+
[document generated automatically](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)
8+
<!-- /15-License -->
9+
<!-- 20-Description -->
1410

15-
## 属性列表
11+
全局描述：**来自 OpenStreetMap 且使用 railway 键标记的铁路轨道或基础设施元素。涵盖各类轨道基础设施，从干线重轨到有轨电车、地铁和缆车。**
12+
version: 0.0.1
13+
<!-- /20-Description -->
14+
<!-- 30-PropertiesList -->
1615

17-
<sup><sub>[*] 如果属性中没有类型，那是因为它可能有多种类型或不同的格式/模式</sub></sup>
18-
- `address[object]`: 邮寄地址。模型: [https://schema.org/address](https://schema.org/address) - `addressCountry[string]`: 国家。例如，西班牙。模型: [https://schema.org/addressCountry](https://schema.org/addressCountry)
19-
- `addressLocality[string]`: 街道地址所在的地区，且该地区位于某个区域内。模型: [https://schema.org/addressLocality](https://schema.org/addressLocality)
20-
- `addressRegion[string]`: 地区所在的区域，且该区域位于某个国家内。模型: [https://schema.org/addressRegion](https://schema.org/addressRegion)
21-
- `district[string]`: 地区是一种行政区划，在某些国家由地方政府管理
22-
- `postOfficeBoxNumber[string]`: 邮政信箱地址的邮政信箱号码。例如，03578。模型: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber)
23-
- `postalCode[string]`: 邮政编码。例如，24004。模型: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode)
24-
- `streetAddress[string]`: 街道地址。模型: [https://schema.org/streetAddress](https://schema.org/streetAddress)
25-
- `streetNr[string]`: 识别公共街道上特定物业的号码
26-
- `alternateName[string]`: 此项目的替代名称 - `areaServed[string]`: 提供服务或商品的地理区域。模型: [https://schema.org/Text](https://schema.org/Text)- `bridge[boolean]`: 指示此铁路段是否经过桥梁。模型: [https://wiki.openstreetmap.org/wiki/Key:bridge](https://wiki.openstreetmap.org/wiki/Key:bridge)- `dataProvider[string]`: 标识统一数据实体提供者的字符序列 - `dateCreated[date-time]`: 实体创建时间戳。这通常由存储平台分配 - `dateModified[date-time]`: 实体最后修改的时间戳。这通常由存储平台分配 - `description[string]`: 此项目的描述 - `electrified[string]`: 铁路电气化方式。模型: [https://wiki.openstreetmap.org/wiki/Key:electrified](https://wiki.openstreetmap.org/wiki/Key:electrified)- `frequency[number]`: 牵引电流的电频率，单位赫兹。模型: [https://wiki.openstreetmap.org/wiki/Key:frequency](https://wiki.openstreetmap.org/wiki/Key:frequency)- `gauge[number]`: 轨距，单位毫米（两轨之间的距离）。模型: [https://wiki.openstreetmap.org/wiki/Key:gauge](https://wiki.openstreetmap.org/wiki/Key:gauge)- `id[*]`: 实体的唯一标识符 - `layer[number]`: 相对于同一位置其他特征的垂直层。模型: [https://wiki.openstreetmap.org/wiki/Key:layer](https://wiki.openstreetmap.org/wiki/Key:layer)- `location[*]`: Geojson 对该项目的引用。可以是 Point、LineString、Polygon、MultiPoint、MultiLineString 或 MultiPolygon - `maxSpeed[number]`: 此轨道允许的最大速度，单位公里/小时。模型: [https://wiki.openstreetmap.org/wiki/Key:maxspeed](https://wiki.openstreetmap.org/wiki/Key:maxspeed)- `name[string]`: 此项目的名称 - `operator[string]`: 铁路运营商或公司的名称。模型: [https://wiki.openstreetmap.org/wiki/Key:operator](https://wiki.openstreetmap.org/wiki/Key:operator)- `osmId[number]`: 原始 OpenStreetMap 元素的整数标识符。模型: [https://wiki.openstreetmap.org/wiki/Elements](https://wiki.openstreetmap.org/wiki/Elements)- `osmLastModified[date-time]`: OSM 元素最后修改的时间戳。 - `osmType[string]`: 原始 OpenStreetMap 元素的类型。模型: [https://wiki.openstreetmap.org/wiki/Elements](https://wiki.openstreetmap.org/wiki/Elements)- `owner[array]`: 包含 JSON 编码字符序列的列表，引用所有者(s)的唯一 ID - `railwayType[string]`: 划分铁路基础设施类型的 OSM 铁路标签值。枚举值：'rail, subway, tram, light_rail, narrow_gauge, monorail, funicular, miniature, preserved, disused, abandoned, construction, proposed'。模型: [https://wiki.openstreetmap.org/wiki/Key:railway](https://wiki.openstreetmap.org/wiki/Key:railway)- `ref[string]`: 官方线路参考编号或代码。模型: [https://wiki.openstreetmap.org/wiki/Key:ref](https://wiki.openstreetmap.org/wiki/Key:ref)- `seeAlso[*]`: 指向此项目附加资源的 URI 列表。 - `service[string]`: 服务轨道的类型，如果不是主运行线的一部分。模型: [https://wiki.openstreetmap.org/wiki/Key:service](https://wiki.openstreetmap.org/wiki/Key:service)- `source[string]`: 以 URL 形式提供实体数据原始来源的字符序列。建议使用源提供者的完全限定域名，或源对象的 URL - `tracks[number]`: 平行轨道的数量。模型: [https://wiki.openstreetmap.org/wiki/Key:tracks](https://wiki.openstreetmap.org/wiki/Key:tracks)- `tunnel[boolean]`: 指示此铁路段是否穿过隧道。模型: [https://wiki.openstreetmap.org/wiki/Key:tunnel](https://wiki.openstreetmap.org/wiki/Key:tunnel)- `type[string]`: NGSI 实体类型。必须是 OSMRailway - `usage[string]`: 铁路线的预期用途。模型: [https://wiki.openstreetmap.org/wiki/Key:usage](https://wiki.openstreetmap.org/wiki/Key:usage)- `voltage[number]`: 牵引所用的电压，单位伏特。模型: [https://wiki.openstreetmap.org/wiki/Key:voltage](https://wiki.openstreetmap.org/wiki/Key:voltage)<!-- /30-PropertiesList -->
27-
<!-- 35-RequiredProperties -->
28-
所需属性
29-
- `id` - `location` - `osmId` - `osmType` - `railwayType` - `type` <!-- /35-RequiredProperties -->
30-
<!-- 40-NotesYaml -->
31-
<!-- /40-NotesYaml -->
32-
<!-- 50-DataModelHeader -->
33-
## 属性数据模型描述
34-
按字母顺序排序（点击查看详情）
35-
<!-- /50-DataModelHeader -->
36-
<!-- 60-ModelYaml -->
37-
<details><summary><strong>完整的 YAML 详情</strong></summary>
16+
## 属性列表
17+
18+
<sup><sub>[*] 如果某个属性未指定类型，则表示其可包含多种类型或不同的格式/模式</sub></sup>
19+
- `address[object]`：邮寄地址。模型：[https://schema.org/address](https://schema.org/address)
20+
- `addressCountry[string]`：国家。例如，西班牙。模型：[https://schema.org/addressCountry](https://schema.org/addressCountry)
21+
- `addressLocality[string]`：街道地址所在的城镇，且该城镇位于该地区内。模型：[https://schema.org/addressLocality](https://schema.org/addressLocality)
22+
- `addressRegion[string]`：城镇所在的地区，且该地区位于该国家内。模型：[https://schema.org/addressRegion](https://schema.org/addressRegion)
23+
- `district[string]`：区县，在某些国家中由地方政府管理的一种行政区划类型
24+
- `postOfficeBoxNumber[string]`：用于邮政信箱地址的邮政信箱号码。例如，03578。模型：[https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber)
25+
- `postalCode[string]`：邮政编码。例如，24004。模型：[https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode)
26+
- `streetAddress[string]`：街道地址。模型：[https://schema.org/streetAddress](https://schema.org/streetAddress)
27+
- `streetNr[string]`：标识公共街道上特定房产的编号
28+
- `alternateName[string]`：此项目的另一个名称
29+
- `areaServed[string]`：提供服务或提供的项目的地理区域。模型：[https://schema.org/Text](https://schema.org/Text)
30+
- `bridge[boolean]`：指示该铁路段是否通过桥梁。模型：[https://wiki.openstreetmap.org/wiki/Key:bridge](https://wiki.openstreetmap.org/wiki/Key:bridge)
31+
- `dataProvider[string]`：标识统一数据实体提供者的一组字符序列
32+
- `dateCreated[date-time]`：实体创建时间戳。通常由存储平台分配
33+
- `dateModified[date-time]`：实体最后一次修改的时间戳。通常由存储平台分配
34+
- `description[string]`：此项目的描述
35+
- `electrified[string]`：铁路的电气化方式。模型：[https://wiki.openstreetmap.org/wiki/Key:electrified](https://wiki.openstreetmap.org/wiki/Key:electrified)
36+
- `frequency[number]`：牵引电流的电气频率，单位为赫兹。模型：[https://wiki.openstreetmap.org/wiki/Key:frequency](https://wiki.openstreetmap.org/wiki/Key:frequency)
37+
- `gauge[number]`：轨距，以毫米为单位（两根钢轨之间的距离）。模型：[https://wiki.openstreetmap.org/wiki/Key:gauge](https://wiki.openstreetmap.org/wiki/Key:gauge)
38+
- `id[*]`：实体的唯一标识符
39+
- `layer[number]`：相对于同一位置的其他要素的垂直图层。模型：[https://wiki.openstreetmap.org/wiki/Key:layer](https://wiki.openstreetmap.org/wiki/Key:layer)
40+
- `location[*]`：指向该项目的 GeoJSON 引用。可以是 Point、LineString、Polygon、MultiPoint、MultiLineString 或 MultiPolygon
41+
- `maxSpeed[number]`：该轨道允许的最高速度，单位为公里/小时。模型：[https://wiki.openstreetmap.org/wiki/Key:maxspeed](https://wiki.openstreetmap.org/wiki/Key:maxspeed)
42+
- `name[string]`：此项目的名称
43+
- `operator[string]`：铁路运营商或公司的名称。模型：[https://wiki.openstreetmap.org/wiki/Key:operator](https://wiki.openstreetmap.org/wiki/Key:operator)
44+
- `osmId[number]`：原始 OpenStreetMap 元素的整数标识符。模型：[https://wiki.openstreetmap.org/wiki/Elements](https://wiki.openstreetmap.org/wiki/Elements)
45+
- `osmLastModified[date-time]`：原始 OSM 元素的最后一次修改时间戳
46+
- `osmType[string]`：原始 OpenStreetMap 元素的类型。模型：[https://wiki.openstreetmap.org/wiki/Elements](https://wiki.openstreetmap.org/wiki/Elements)
47+
- `owner[array]`：包含以 JSON 编码的字符序列的列表，引用所有者的唯一 ID
48+
- `railwayType[string]`：对铁路基础设施类型进行分类的原始 OpenStreetMap 铁路标签值。枚举：‘rail（干线铁路）, subway（地铁）, tram（有轨电车）, light_rail（轻轨）, narrow_gauge（窄轨）, monorail（单轨铁路）, funicular（缆车）, miniature（小型铁路）, preserved（保护性铁路）, disused（废弃铁路）, abandoned（废弃铁路）, construction（在建铁路）, proposed（规划铁路）’。模型：[https://wiki.openstreetmap.org/wiki/Key:railway](https://wiki.openstreetmap.org/wiki/Key:railway)
49+
- `ref[string]`：官方线路参考编号或代码。模型：[https://wiki.openstreetmap.org/wiki/Key:ref](https://wiki.openstreetmap.org/wiki/Key:ref)
50+
- `seeAlso[*]`：指向关于此项目的其他资源的 URI 列表
51+
- `service[string]`：服务轨道的类型（如非干线）。模型：[https://wiki.openstreetmap.org/wiki/Key:service](https://wiki.openstreetmap.org/wiki/Key:service)
52+
- `source[string]`：作为 URL 提供的实体数据的原始来源字符序列。建议使用源提供商的完整域名或指向源对象的 URL
53+
- `tracks[number]`：平行轨道的数量。模型：[https://wiki.openstreetmap.org/wiki/Key:tracks](https://wiki.openstreetmap.org/wiki/Key:tracks)
54+
- `tunnel[boolean]`：指示该铁路段是否通过隧道。模型：[https://wiki.openstreetmap.org/wiki/Key:tunnel](https://wiki.openstreetmap.org/wiki/Key:tunnel)
55+
- `type[string]`：NGSI 实体类型。必须为 OSMRailway
56+
- `usage[string]`：铁路线路的预期用途。模型：[https://wiki.openstreetmap.org/wiki/Key:usage](https://wiki.openstreetmap.org/wiki/Key:usage)
57+
- `voltage[number]`：牵引用电气电压，单位为伏特。模型：[https://wiki.openstreetmap.org/wiki/Key:voltage](https://wiki.openstreetmap.org/wiki/Key:voltage)
58+
<!-- /30-PropertiesList -->
59+
<!-- 35-RequiredProperties -->
60+
61+
必需属性
62+
- `id`
63+
- `location`
64+
- `osmId`
65+
- `osmType`
66+
- `railwayType`
67+
- `type`
68+
<!-- /35-RequiredProperties -->
69+
<!-- 40-NotesYaml -->
70+
<!-- /40-NotesYaml -->
71+
<!-- 50-DataModelHeader -->
72+
73+
## 属性数据模型说明
74+
75+
按字母顺序排序（点击查看详情）
76+
<!-- /50-DataModelHeader -->
77+
<!-- 60-ModelYaml -->
78+
<details><summary><strong>完整 YAML 详情</strong></summary>
3879
```yaml
3980
OSMRailway:
4081
description: A railway track or infrastructure element from OpenStreetMap tagged with the railway key. Covers all types of rail infrastructure, from mainline heavy rail to trams, subways and funiculars.
@@ -553,16 +594,19 @@ OSMRailway:
553594
x-model-schema: https://smart-data-models.github.io/dataModel.OpenStreetMap/OSMRailway/schema.json
554595
x-model-tags: OSM OpenStreetMap Transportation Railway
555596
x-version: 0.0.1
556-
```
557-
</details>
558-
<!-- /60-ModelYaml -->
559-
<!-- 70-MiddleNotes -->
560-
<!-- /70-MiddleNotes -->
561-
<!-- 80-Examples -->
562-
## 示例载荷
563-
#### OSMRailway NGSI-v2 键值对示例
564-
这是一个 OSMRailway 的 JSON 格式键值对示例。这与使用 `options=keyValues` 时的 NGSI-v2 兼容，并返回单个实体的上下文数据。
565-
<details><summary><strong>显示/隐藏示例</strong></summary>
597+
```
598+
</details>
599+
<!-- /60-ModelYaml -->
600+
<!-- 70-MiddleNotes -->
601+
<!-- /70-MiddleNotes -->
602+
<!-- 80-Examples -->
603+
604+
## 示例有效负载
605+
606+
#### OSMRailway NGSI-v2 键值示例
607+
以下是以 JSON 键值格式表示的 OSMRailway 示例。当使用 `options=keyValues` 时，此格式与 NGSI-v2 兼容，并返回单个实体的上下文数据。
608+
609+
<details><summary><strong>显示/隐藏示例</strong></summary>
566610
```json
567611
{
568612
"id": "urn:ngsi-ld:OSMRailway:way:2903182",
@@ -604,11 +648,13 @@ OSMRailway:
604648
"https://www.openstreetmap.org/way/2903182"
605649
]
606650
}
607-
```
608-
</details>
609-
#### OSMRailway NGSI-v2 规范化示例
610-
这是一个 OSMRailway 的 JSON 格式规范化示例。这与不使用选项时的 NGSI-v2 兼容，并返回单个实体的上下文数据。
611-
<details><summary><strong>显示/隐藏示例</strong></summary>
651+
```
652+
</details>
653+
654+
#### OSMRailway NGSI-v2 规范化示例
655+
以下是以 JSON 规范化格式表示的 OSMRailway 示例。当不使用选项时，此格式与 NGSI-v2 兼容，并返回单个实体的上下文数据。
656+
657+
<details><summary><strong>显示/隐藏示例</strong></summary>
612658
```json
613659
{
614660
"id": "urn:ngsi-ld:OSMRailway:way:2903182",
@@ -728,11 +774,13 @@ OSMRailway:
728774
]
729775
}
730776
}
731-
```
732-
</details>
733-
#### OSMRailway NGSI-LD 键值对示例
734-
这是一个 OSMRailway 的 JSON-LD 格式键值对示例。这与使用 `options=keyValues` 时的 NGSI-LD 兼容，并返回单个实体的上下文数据。
735-
<details><summary><strong>显示/隐藏示例</strong></summary>
777+
```
778+
</details>
779+
780+
#### OSMRailway NGSI-LD 键值示例
781+
以下是以 JSON-LD 键值格式表示的 OSMRailway 示例。当使用 `options=keyValues` 时，此格式与 NGSI-LD 兼容，并返回单个实体的上下文数据。
782+
783+
<details><summary><strong>显示/隐藏示例</strong></summary>
736784
```json
737785
{
738786
"id": "urn:ngsi-ld:OSMRailway:way:2903182",
@@ -777,11 +825,13 @@ OSMRailway:
777825
"https://raw.githubusercontent.com/smart-data-models/dataModel.OpenStreetMap/refs/heads/master/context.jsonld"
778826
]
779827
}
780-
```
781-
</details>
782-
#### OSMRailway NGSI-LD 规范化示例
783-
这是一个 OSMRailway 的 JSON-LD 格式规范化示例。这与不使用选项时的 NGSI-LD 兼容，并返回单个实体的上下文数据。
784-
<details><summary><strong>显示/隐藏示例</strong></summary>
828+
```
829+
</details>
830+
831+
#### OSMRailway NGSI-LD 规范化示例
832+
以下是以 JSON-LD 规范化格式表示的 OSMRailway 示例。当不使用选项时，此格式与 NGSI-LD 兼容，并返回单个实体的上下文数据。
833+
834+
<details><summary><strong>显示/隐藏示例</strong></summary>
785835
```json
786836
{
787837
"id": "urn:ngsi-ld:OSMRailway:way:2903182",
@@ -887,13 +937,14 @@ OSMRailway:
887937
"https://raw.githubusercontent.com/smart-data-models/dataModel.OpenStreetMap/refs/heads/master/context.jsonld"
888938
]
889939
}
890-
```
891-
</details><!-- /80-Examples -->
892-
<!-- 90-FooterNotes -->
893-
<!-- /90-FooterNotes -->
894-
<!-- 95-Units -->
895-
请参阅 [FAQ 10](https://smartdatamodels.org/index.php/faqs/) 以获取有关如何处理量纲单位的答案
896-
<!-- /95-Units -->
897-
<!-- 97-LastFooter -->
898-
---
940+
```
941+
</details><!-- /80-Examples -->
942+
<!-- 90-FooterNotes -->
943+
<!-- /90-FooterNotes -->
944+
<!-- 95-Units -->
945+
946+
有关如何处理数量单位的说明，请参阅 [FAQ 10](https://smartdatamodels.org/index.php/faqs/)
947+
<!-- /95-Units -->
948+
<!-- 97-LastFooter -->
949+
---
899950
[Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM)<!-- /97-LastFooter -->

0 commit comments

Comments
 (0)