spec_JA.md

エンティティ基準要件

オープン・ライセンス

文書は自動的に生成される

グローバルな説明すべての公共サービスがすべての人に必要とされ、利用されているわけではない。例えば、欧州諸国が運営するビザ・サービスは欧州市民には必要ないが、他国から来た一部の市民には必要であったり、失業給付や助成金を提供する公共サービスは特定の社会集団を対象としていたりする。CPSV は、この分類のために中核的基準および中核的証拠語彙（Core Criterion and Core Evidence Vocabulary: CCCEV - https://joinup.ec.europa.eu/release/core-criterion-and-core-evidence-vocabulary-v100）を再利用している。CCCEV はより詳細な情報を提供するが、基準要件クラスには 3 つの必須プロパティがある。

バージョン: 0.0.1

プロパティのリスト

^{_{[*] 属性に型がない場合は、複数の型があるか、異なるフォーマット/パターンがある可能性があるためです}}。

• address[object]: 郵送先住所 . Model: https://schema.org/address
  • addressCountry[string]: 国。例えば、スペイン . Model: https://schema.org/addressCountry
  • addressLocality[string]: 番地がある地域と、その地域に含まれる地域 . Model: https://schema.org/addressLocality
  • addressRegion[string]: その地域がある地域、またその国がある地域 . Model: https://schema.org/addressRegion
  • district[string]: 地区とは行政区画の一種で、国によっては地方自治体によって管理されている。
  • postOfficeBoxNumber[string]: 私書箱の住所のための私書箱番号。例：03578 . Model: https://schema.org/postOfficeBoxNumber
  • postalCode[string]: 郵便番号。例：24004 . Model: https://schema.org/https://schema.org/postalCode
  • streetAddress[string]: 番地 . Model: https://schema.org/streetAddress
• alternateName[string]: この項目の別名
• areaServed[string]: サービスまたは提供品が提供される地理的地域 . Model: https://schema.org/Text
• criterionReqType[array]: このプロパティは、管理語彙（TBC）に記述される基準要件のタイプを表す。 . Model: dct:type
• dataProvider[string]: ハーモナイズされたデータ・エンティティの提供者を識別する一連の文字。
• dateCreated[date-time]: エンティティの作成タイムスタンプ。これは通常、ストレージプラットフォームによって割り当てられます。
• dateModified[date-time]: エンティティの最終変更のタイムスタンプ。これは通常、ストレージプラットフォームによって割り当てられる。
• description[string]: この商品の説明
• id[*]: エンティティの一意識別子
• identifier[string]: このプロパティは、基準要件の識別子を表します。 . Model: dct:identifier
• location[*]: アイテムへの Geojson 参照。Point、LineString、Polygon、MultiPoint、MultiLineString、MultiPolygon のいずれか。
• name[string]: このアイテムの名前
• owner[array]: 所有者の固有IDを参照するJSONエンコードされた文字列を含むリスト。
• seeAlso[*]: アイテムに関する追加リソースを指すURIのリスト
• source[string]: エンティティ・データの元のソースを URL として示す一連の文字。ソース・プロバイダの完全修飾ドメイン名、またはソース・オブジェクトの URL を推奨する。
• type[string]: CriterionRequirementでなければならない。 . Model: https://schema.org/Text

必須プロパティ

• criterionReqType
• id
• identifier
• name
• type

プロパティのデータモデル記述

アルファベット順（クリックで詳細表示）

full yaml details

CriterionRequirement:      
  description: 'Not all public services are needed or usable by everyone. For example, the visa service operated by European countries is not needed by European citizens but is needed by some citizens from elsewhere, or public services offering unemployment benefits and grants are targeting specific societal groups. The CPSV reuses the Core Criterion and Core Evidence Vocabulary (CCCEV - https://joinup.ec.europa.eu/release/core-criterion-and-core-evidence-vocabulary-v100) for this class. The CCCEV provides more details but the Criterion Requirement class has three mandatory properties.'      
  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      
    criterionReqType:      
      description: This property represents the type of Criterion Requirement as described in a controlled vocabulary (TBC)      
      items:      
        type: string      
      type: array      
      x-ngsi:      
        model: dct:type      
        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: Property      
    identifier:      
      description: This property represents an Identifier for the Criterion Requirement      
      type: string      
      x-ngsi:      
        model: dct:identifier      
        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: The name of this item      
      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: Property      
      type: array      
      x-ngsi:      
        type: Property      
    seeAlso:      
      description: list of uri pointing to additional resources about the item      
      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      
    type:      
      description: It has to be CriterionRequirement      
      enum:      
        - CriterionRequirement      
      type: string      
      x-ngsi:      
        model: https://schema.org/Text      
        type: Property      
  required:      
    - id      
    - type      
    - identifier      
    - name      
    - criterionReqType      
  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.CPSV-AP/blob/master/CriterionRequirement/LICENSE.md      
  x-model-schema: https://smart-data-models.github.io/dataModel.CPSV-AP/CriterionRequirement/schema.json      
  x-model-tags: CEFAT4CITIES      
  x-version: 0.0.1      

ペイロードの例

基準要件 NGSI-v2 キー値 例

以下は、JSON-LD 形式の CriterionRequirement のキー値の例です。これは NGSI-v2 と互換性があり、options=keyValues を使用すると、個々のエンティティのコンテキストデータを返します。

show/hide example

{  
  "id": "urn:ngsi-ld:CPSV-AP:CriterionRequirement:d70d5a06-bbf3-438f-ba65-10f93544a200",  
  "type": "CriterionRequirement",  
  "identifier": "CriterionRequirementd70d5a06bbf3438fba6510f93544a200",  
  "name": "DEFAULT NAME",  
  "criterionReqType": [  
    "Holding a ticket",  
    "Being older than eighteen"  
  ]  
}  

基準要件 NGSI-v2 正規化 例

以下は、正規化された JSON-LD 形式の CriterionRequirement の例です。これは、オプションを使用しない場合に NGSI-v2 と互換性があり、個々のエンティティのコンテキスト・データを返します。

show/hide example

{  
  "id": "urn:ngsi-ld:CPSV-AP:CriterionRequirement:d70d5a06-bbf3-438f-ba65-10f93544a200",  
  "type": "CriterionRequirement",  
  "identifier": {  
    "type": "Text",  
    "value": "CriterionRequirementd70d5a06bbf3438fba6510f93544a200"  
  },  
  "name": {  
    "type": "Text",  
    "value": "DEFAULT NAME"  
  },  
  "criterionReqType": {  
    "type": "StructuredValue",  
    "value": [  
      "Holding a ticket",  
      "Being older than eighteen"  
    ]  
  }  
}  

基準要件 NGSI-LD キー値の例

以下は、JSON-LD 形式の CriterionRequirement のキー値の例です。これは NGSI-LD と互換性があり、options=keyValues を使用すると、個々のエンティティのコンテキストデータを返します。

show/hide example

{  
  "id": "urn:ngsi-ld:CPSV-AP:CriterionRequirement:d70d5a06-bbf3-438f-ba65-10f93544a200",  
  "type": "CriterionRequirement",  
  "identifier": "CriterionRequirementd70d5a06bbf3438fba6510f93544a200",  
  "name": "DEFAULT NAME",  
  "criterionReqType": [  
    "Holding a ticket",  
    "Being older than eighteen"  
  ],  
  "@context": [  
    "https://smart-data-models.github.io/dataModel.CPSV-AP/context.jsonld",  
    "https://raw.githubusercontent.com/smart-data-models/dataModel.CPSV-AP/master/context.jsonld"  
  ]  
}  

基準要件 NGSI-LD 正規化例

以下は、正規化された JSON-LD 形式の CriterionRequirement の例です。これは、オプションを使用しない場合に NGSI-LD と互換性があり、個々のエンティティのコンテキストデータを返します。

show/hide example

{  
    "id": "urn:ngsi-ld:CPSV-AP:CriterionRequirement:d70d5a06-bbf3-438f-ba65-10f93544a200",  
    "type": "CriterionRequirement",  
    "identifier": {  
        "type": "Property",  
        "value": "CriterionRequirementd70d5a06bbf3438fba6510f93544a200"  
    },  
    "name": {  
        "type": "Property",  
        "value": "DEFAULT NAME"  
    },  
    "criterionReqType": {  
        "type": "Property",  
        "value": [  
            "Holding a ticket",  
            "Being older than eighteen"  
        ]  
    },  
    "@context": [  
        "https://smart-data-models.github.io/dataModel.CPSV-AP/context.jsonld",  
        "https://raw.githubusercontent.com/smart-data-models/dataModel.CPSV-AP/master/context.jsonld"  
    ]  
}  

マグニチュード単位の扱い方については、FAQ 10を参照のこと。

---

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