diff --git a/Agent/doc/spec_JA.md b/Agent/doc/spec_JA.md index 0294417..bcf9ca3 100644 --- a/Agent/doc/spec_JA.md +++ b/Agent/doc/spec_JA.md @@ -1,336 +1,337 @@ - -[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) - エンティティエージェント -============ - - [オープン・ライセンス](https://github.com/smart-data-models//dataModel.DCAT-AP/blob/master/Agent/LICENSE.md) - [文書は自動的に生成される](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) - - - グローバルな記述:**DCAT-AP 2.1.1仕様を満たすエージェントスキーマ**。 - バージョン: 1.0.1 - - - - ## プロパティのリスト - - [*] 属性に型がない場合は、複数の型があるか、異なるフォーマット/パターンがある可能性があるためです。 -- `Type[string]`: このプロパティは、カタログまたはデータセットを利用可能にするエージェントのタイプを参照します。 . Model: [http://www.w3.org/2004/02/skos/core#Concept](http://www.w3.org/2004/02/skos/core#Concept) - `address[object]`: 郵送先住所 . Model: [https://schema.org/address](https://schema.org/address) - `addressCountry[string]`: 国。例えば、スペイン . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) - - `addressLocality[string]`: 番地がある地域と、その地域に含まれる地域 . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) - - `addressRegion[string]`: その地域がある地域、またその国がある地域 . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) - - `district[string]`: 地区とは行政区画の一種で、国によっては地方自治体によって管理されている。 - - `postOfficeBoxNumber[string]`: 私書箱の住所のための私書箱番号。例:03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) - - `postalCode[string]`: 郵便番号。例:24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) - - `streetAddress[string]`: 番地 . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) -- `areaServed[string]`: サービスまたは提供品が提供される地理的地域 . Model: [https://schema.org/Text](https://schema.org/Text) - `id[*]`: エンティティの一意識別子 - `location[*]`: アイテムへの Geojson 参照。Point、LineString、Polygon、MultiPoint、MultiLineString、MultiPolygon のいずれか。 - `name[array]`: このプロパティは、エージェントの名前を含む。 このプロパティは、異なるバージョンの名前(異なる言語での名前など)のために繰り返すことができます。 . Model: [dct:description](dct:description) - `type[string]`: NGSI エンティティタイプ。エージェントでなければなりません。 - - 必須プロパティ -- `id` - `name` - `type` - - DCAT-APバージョン2.1.1](https://codeload.github.com/SEMICeu/DCAT-AP/zip/refs/tags/v2.1.1)からの引用。DCAT 2.1.1のオリジナルのtype属性は、NGSI-LDでの使用を可能にするためにTypeに改名された。 - - - ## プロパティのデータモデル記述 - アルファベット順(クリックで詳細表示) - - -
full yaml details - ```yaml -Agent: - description: Agent Schema meeting DCAT-AP 2.1.1 specification - properties: - Type: - description: This property refers to a type of the agent that makes the Catalogue or Dataset available - type: string - x-ngsi: - model: "http://www.w3.org/2004/02/skos/core#Concept" - 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 - 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: This property contains a name of the agent. This property can be repeated for different versions of the name (e.g. the name in different languages) - items: - description: Every name in different languages - minItems: 1 - type: string - x-ngsi: - type: Property - type: array - x-ngsi: - model: dct:description - type: Property - type: - description: NGSI Entity type. It has to be Agent - enum: - - Agent - type: string - x-ngsi: - type: Property - required: - - id - - type - - name - 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/Agent/LICENSE.md - x-model-schema: https://smart-data-models.github.io/dataModel.DCAT-AP/Agent/schema.json - x-model-tags: "" - x-version: 1.0.1 -``` -
- - - - - ## ペイロードの例 - #### エージェント NGSI-v2 キー値の例 - JSON-LD形式のAgentのkey-valuesの例である。これはNGSI-v2と互換性があり、`options=keyValues`を使用すると、個々のエンティティのコンテキストデータを返す。 -
show/hide example + +[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) + エンティティエージェント +============ + + [オープン・ライセンス](https://github.com/smart-data-models//dataModel.DCAT-AP/blob/master/Agent/LICENSE.md) + [文書は自動的に生成される](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) + + + グローバルな記述:**DCAT-AP 2.1.1仕様を満たすエージェントスキーマ**。 + バージョン: 1.0.1 + + + ## プロパティのリスト + [*] 属性に型がない場合は、複数の型があるか、異なるフォーマット/パターンがある可能性があるためです。 +- `Type[string]`: このプロパティは、カタログまたはデータセットを利用可能にするエージェントのタイプを参照します。 . Model: [http://www.w3.org/2004/02/skos/core#Concept](http://www.w3.org/2004/02/skos/core#Concept) - `address[object]`: 郵送先住所 . Model: [https://schema.org/address](https://schema.org/address) - `addressCountry[string]`: 国。例えば、スペイン . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) + - `addressLocality[string]`: 番地がある地域と、その地域に含まれる地域 . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) + - `addressRegion[string]`: その地域がある地域、またその国がある地域 . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) + - `district[string]`: 地区とは行政区画の一種で、国によっては地方自治体によって管理されている。 + - `postOfficeBoxNumber[string]`: 私書箱の住所のための私書箱番号。例:03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) + - `postalCode[string]`: 郵便番号。例:24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) + - `streetAddress[string]`: 番地 . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) +- `areaServed[string]`: サービスまたは提供品が提供される地理的地域 . Model: [https://schema.org/Text](https://schema.org/Text) - `id[*]`: エンティティの一意識別子 - `location[*]`: アイテムへの Geojson 参照。Point、LineString、Polygon、MultiPoint、MultiLineString、MultiPolygon のいずれか。 - `name[array]`: このプロパティは、エージェントの名前を含む。 このプロパティは、異なるバージョンの名前(異なる言語での名前など)のために繰り返すことができます。 . Model: [dct:description](dct:description) - `type[string]`: NGSI エンティティタイプ。エージェントでなければなりません。 + + 必須プロパティ +- `id` - `name` - `type` + + DCAT-APバージョン2.1.1](https://codeload.github.com/SEMICeu/DCAT-AP/zip/refs/tags/v2.1.1)からの引用。DCAT 2.1.1のオリジナルのtype属性は、NGSI-LDでの使用を可能にするためにTypeに改名された。 + + + ## プロパティのデータモデル記述 + アルファベット順(クリックで詳細表示) + + +
full yaml details + ```yaml +Agent: + description: Agent Schema meeting DCAT-AP 2.1.1 specification + properties: + Type: + description: This property refers to a type of the agent that makes the Catalogue or Dataset available + type: string + x-ngsi: + model: "http://www.w3.org/2004/02/skos/core#Concept" + 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 + 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: This property contains a name of the agent. This property can be repeated for different versions of the name (e.g. the name in different languages) + items: + description: Every name in different languages + minItems: 1 + type: string + x-ngsi: + type: Property + type: array + x-ngsi: + model: dct:description + type: Property + type: + description: NGSI Entity type. It has to be Agent + enum: + - Agent + type: string + x-ngsi: + type: Property + required: + - id + - type + - name + 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/Agent/LICENSE.md + x-model-schema: https://smart-data-models.github.io/dataModel.DCAT-AP/Agent/schema.json + x-model-tags: "" + x-version: 1.0.1 +``` +
+ + + + + ## ペイロードの例 + #### エージェント NGSI-v2 キー値の例 + JSON-LD形式のAgentのkey-valuesの例である。これはNGSI-v2と互換性があり、`options=keyValues`を使用すると、個々のエンティティのコンテキストデータを返す。 +
show/hide example ```json { "id": "urn:ngsi-ld:id:ZLHO:07918336", "type": "Agent", - "name": "Agent 10.", + "name": [ + "Agent 10", + "Agente 10" + ], "location": { "type": "Point", "coordinates": [ @@ -347,17 +348,13 @@ Agent: "postOfficeBoxNumber": "", "areaServed": "European Union" }, - "name": [ - "Agent 10", - "Agente 10" - ], "Type": "EU Publications office" } ``` -
- #### エージェント NGSI-v2 正規化例 - 以下は、正規化された JSON-LD 形式のエージェントの例である。これは、オプションを使用しない場合、NGSI-v2と互換性があり、個々のエンティティのコンテキストデータを返します。 -
show/hide example +
+ #### エージェント NGSI-v2 正規化例 + 以下は、正規化された JSON-LD 形式のエージェントの例である。これは、オプションを使用しない場合、NGSI-v2と互換性があり、個々のエンティティのコンテキストデータを返します。 +
show/hide example ```json { "id": "urn:ngsi-ld:id:ZLHO:07918336", @@ -385,7 +382,7 @@ Agent: } }, "name": { - "type": "array", + "type": "StructuredValue", "value": [ "Agent 10", "Agente 10" @@ -397,45 +394,45 @@ Agent: } } ``` -
- #### エージェント NGSI-LD キー値の例 - 以下は、JSON-LD形式のAgentをkey-valuesとした例である。これは NGSI-LD と互換性があり、`options=keyValues` を使用すると個々のエンティティのコンテキストデータを返す。 -
show/hide example +
+ #### エージェント NGSI-LD キー値の例 + 以下は、JSON-LD形式のAgentをkey-valuesとした例である。これは NGSI-LD と互換性があり、`options=keyValues` を使用すると個々のエンティティのコンテキストデータを返す。 +
show/hide example ```json { - "id": "urn:ngsi-ld:id:ZLHO:07918336", - "type": "Agent", - "address": { - "streetAddress": "2 Rue Mercier", - "addressLocality": "Luxembourg", - "addressRegion": "Luxembourg", - "addressCountry": "Luxembourg", - "postalCode": "2985 ", - "postOfficeBoxNumber": "", - "areaServed": "European Union" - }, - "name": [ - "Agent 10", - "Agente 10" - ], - "Type": "EU Publications office", - "description": "organization the Agent 10 belongs to.", - "location": { - "type": "Point", - "coordinates": [ - 12.934074, - -149.532943 - ] - }, - "@context": [ - "https://raw.githubusercontent.com/smart-data-models/dataModel.DCAT-AP/master/context.jsonld" + "id": "urn:ngsi-ld:id:ZLHO:07918336", + "type": "Agent", + "address": { + "streetAddress": "2 Rue Mercier", + "addressLocality": "Luxembourg", + "addressRegion": "Luxembourg", + "addressCountry": "Luxembourg", + "postalCode": "2985 ", + "postOfficeBoxNumber": "", + "areaServed": "European Union" + }, + "name": [ + "Agent 10", + "Agente 10" + ], + "Type": "EU Publications office", + "description": "organization the Agent 10 belongs to.", + "location": { + "type": "Point", + "coordinates": [ + 12.934074, + -149.532943 ] + }, + "@context": [ + "https://raw.githubusercontent.com/smart-data-models/dataModel.DCAT-AP/master/context.jsonld" + ] } ``` -
- #### エージェント NGSI-LD 正規化例 - 以下は、正規化された JSON-LD 形式のエージェントの例である。これは、オプションを使用しない場合、NGSI-LDと互換性があり、個々のエンティティのコンテキストデータを返します。 -
show/hide example +
+ #### エージェント NGSI-LD 正規化例 + 以下は、正規化された JSON-LD 形式のエージェントの例である。これは、オプションを使用しない場合、NGSI-LDと互換性があり、個々のエンティティのコンテキストデータを返します。 +
show/hide example ```json { "id": "urn:ngsi-ld:id:ZLHO:07918336", @@ -478,12 +475,12 @@ Agent: ] } ``` -
- - - - マグニチュード単位の扱い方については、[FAQ 10](https://smartdatamodels.org/index.php/faqs/)を参照のこと。 - - ---- - [Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM) +
+ + + + マグニチュード単位の扱い方については、[FAQ 10](https://smartdatamodels.org/index.php/faqs/)を参照のこと。 + + +--- + [Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM)