Data Models (データモデル)¶
以下は、NGSI-LD チュートリアルで使用される農業データモデル (Agricultural Data Model) で定義されている属性の詳細です。
Building (建物)¶
Building は人間の構築構造であり、そこでは生活、仕事、治癒などに関連してさまざまな活動が行われます。 Smart-Data-Models で定義
Swagger : Building
id
: Building のID を保持する URN - 必須- 属性型: Property.
-
type
: エンティティ型 - 必須- 属性型: Property.
-
address
: メーリング・アドレス - 必須- 属性型: Property. address
- 引用規格:
https://schema.org/address
category
: building が属するカテゴリ - 必須- 属性型: EnumProperty.
containedInPlace
: building が存在する URL- 属性型: Relationship. URL
dataProvider
: この情報のプロバイダに関する情報への URL を指定- 属性型: Property. URL
description
: アイテムの説明- 属性型: Property. Text
- 引用規格:
http://purl.org/dc/elements/1.1/description
floorsAboveGround
: building 内の地上階の数- 属性型: Property. Integer
floorsBelowGround
: building 内の地下階の数- 属性型: Property. Integer
location
: アイテムの現在の場所- 属性型: GeoProperty. Point or LineString or Polygon or MultiPoint or MultiLineString or MultiPolygon
- 引用規格:
http://geojson.org/geojson-spec.html#geometry-objects
occupier
: building の居住者へのリンク- 属性型: Relationship. URL
openingHours
:- 属性型: Property. openingHours
- 引用規格:
https://schema.org/openingHours
owner
: building の所有者- 属性型: Relationship. URL
refMap
: building の地図を保持する URL- 属性型: Property. URL
source
: エンティティ・データのソースを提供する一連の文字temperature
: 温度単位 (degree_Celsius, degree_Fahrenheit, または degree_kelvin) で測定される特定の値によって 特徴付けられるいくつかの測定に関連するプロパティfillingLevel
: 充填レベルである特定の値によって特徴付けられるいくつかの測定値に関連するプロパティ
Temperature Sensor (温度センサ)¶
センサで構成され、カテゴリ saref:Sensor
を持ち、温度を感知する目的で使用されるデバイス。
Smart-Data-Models の Device の拡張
Swagger : Device
id
: 温度センサの ID を保持する URN - 必須- 属性型: Property.
-
type
: エンティティ型 - 必須- 属性型: Property.
-
batteryLevel
: デバイスのバッテリ・レベル。バッテリがフルのときは1.0
に等しくなければならない。空のときは0.0
。 一時的に決定できない場合は-1
- 許容値: 間隔 [0,1] および -1
- 属性型: Property. Number
category
: DeviceModelcategory
属性を参照 - 必須- 属性型: EnumProperty.
configuration
: デバイスの技術的な構成。この属性は、デバイスの構成に関係するパラメータ (タイムアウト, レポート期間 など) をキャプチャし、現在このモデルで定義されている標準属性でカバーされていないプロパティのディクショナリになること を目的としています- 属性型: Property. StructuredValue
- メタデータ:
dateModified
: この属性の最終更新タイムスタンプ- 属性型: Property. DateTime
controlledAsset
: デバイスによって制御されるアセット(s) (ビルディング, オブジェクトなど)- 属性型: Relationship. URL
controlledProperty
: DeviceModel の属性controlledProperty
を参照してください。オプションですが、クエリの 最適化をお勧めします- 属性型: EnumProperty.
dataProvider
: この情報のプロバイダに関する情報への URL を指定- 属性型: Property. URL
dateFirstUsed
: デバイスが最初に使用された時刻を示すタイムスタンプ- 属性型: Property. DateTime
dateInstalled
: デバイスがいつインストールされたかを示すタイムスタンプ- 属性型: Property. DateTime
dateLastCalibration
: デバイスの最後のキャリブレーションがいつ行われたかを示すタイムスタンプ- 属性型: Property. DateTime
dateLastValueReported
: デバイスがクラウドにデータを正常に報告した最後の時間を示すタイムスタンプ- 属性型: Property. DateTime
dateManufactured
: デバイスがいつ製造されたかを示すタイムスタンプ- 属性型: Property. DateTime
description
: アイテムの説明- 属性型: Property. Text
- 引用規格:
http://purl.org/dc/elements/1.1/description
deviceState
: 運用上の観点から見たこのデバイスの状態。その値はベンダーに依存する可能性があります- 属性型: Property. Text
firmwareVersion
: このデバイスのファームウェア・バージョン- 属性型: Property. Text
hardwareVersion
: このデバイスのハードウェア・バージョン- 属性型: Property. Text
ipAddress
: デバイスの IP アドレス。デバイスに複数の IP アドレスがある場合は、カンマ区切りの値のリストにすることが できます- 属性型: Property. Text
location
: アイテムの現在の場所- 属性型: GeoProperty. Point or LineString または Polygon または MultiPoint または MultiLineString または MultiPolygon
- 引用規格:
http://geojson.org/geojson-spec.html#geometry-objects
macAddress
: デバイスの MAC アドレス- 属性型: Property. Text
mcc
: モバイル国コード(Mobile Country Code) - このプロパティは、デバイスが接続されているモバイル・ネットワークの 国を一意に識別します- 属性型: Property. Text
mnc
: このプロパティは、デバイスが接続されているネットワークの Mobile Network Code (MNC) を識別します。MNC は、 Mobile Country Code (MCC) ("MCC / MNC tuple" とも呼ばれます) と組み合わせて使用され、GSM, CDMA, iDEN, TETRA, 3G / 4G public land mobile networks および 一部の衛星モバイルを使用して携帯電話事業者/通信事業者を一意に識別します- 属性型: Property. Text
name
: デバイスに付けられたニーモニック名- 属性型: Property. Text
osVersion
: ホスト・オペレーティング・システム・デバイスのバージョン- 属性型: Property. Text
owner
: デバイスのオーナー- 属性型: Relationship. Person or Organization
provider
: デバイスのプロバイダ- 属性型: Property. provider
refDeviceModel
: デバイスのモデル- 属性型: Relationship. DeviceModel
rssi
: ワイヤレス対応デバイスの受信信号強度インジケータ。信号強度が最大のとき、1.0
と等しくなければなりません。 信号が欠落しているときは、0.0
。判断できない場合は、-1.0
です- 許容値: インターバル [0,1] および -1
- 属性型: Property. Number
serialNumber
: メーカーが割り当てたシリアル番号。以下を参照してください https://schema.org/serialNumber- 属性型: Property. Text
softwareVersion
: このデバイスのソフトウェア・バージョン- 属性型: Property. Text
source
: エンティティ・データのソースを提供する一連の文字supportedProtocol
: DeviceModel のsupportedProtocol
属性を参照してください。ソフトウェアの更新により、 新しいプロトコルがサポートされている場合に必要です。それ以外の場合は、DeviceModel
レベルで伝える方がよいでしょう- 属性型: EnumProperty.
value
: 観測値または報告値。アクチュエータ・デバイスの場合、これは制御アプリケーションが作動設定を変更できるように する属性です。たとえば、現在オンになっているスイッチ・デバイスはText
タイプの"on"
の値を報告できます。明らかに、 参照されるスイッチを切り替えるには、この属性値を"off"
に変更する必要があります- 属性型: Property. Text または QuantitativeValue
temperature
: 温度単位 (degree_Celsius, degree_Fahrenheit または degree_kelvin) で測定される特定の値によって 特徴付けられるいくつかの測定に関連するプロパティ - 必須
Filling Level Sensor (充填レベル・センサ)¶
センサで構成され、saref:Sensor
カテゴリーを持ち、充填レベルを感知する目的で使用されるデバイス。Smart-Data-Models
の Device の拡張
Swagger : Device
id
: 充填レベル・センサの ID を保持する URN - 必須- 属性型: Property.
-
type
: エンティティ型 - 必須- 属性型: Property.
-
batteryLevel
: デバイスのバッテリー・レベル。バッテリーがいっぱいになったときは、1.0
でなければなりません。i バッテリーが空のときは、0.0
。一時的に決定できない場合は、-1
です - 許容値: 間隔 [0,1] および -1
- 属性型: Property. Number
category
: DeviceModel のcategory
属性を参照してください - 必須- 属性型: EnumProperty.
configuration
: デバイスの技術構成。この属性は、デバイスの構成に関係するパラメータ (タイムアウト, レポート期間など) をキャプチャし、現在このモデルで定義されている標準属性でカバーされていないプロパティのディクショナリー になることを意図している- 属性型: Property. StructuredValue
- メタデータ:
dateModified
: この属性の最終更新タイムスタンプ- 属性型: Property. DateTime
controlledAsset
: デバイスによって制御されるアセット (s) (building, object, 等)- 属性型: Relationship. URL
controlledProperty
: DeviceModel の属性controlledProperty
を参照してください。オプションですが、クエリの 最適化をお勧めします- 属性型: EnumProperty.
dataProvider
: この情報のプロバイダに関する情報への URL を指定- 属性型: Property. URL
dateFirstUsed
: デバイスが最初に使用された時刻を示すタイムスタンプ- 属性型: Property. DateTime
dateInstalled
: デバイスがいつインストールされたかを示すタイムスタンプ- 属性型: Property. DateTime
dateLastCalibration
: デバイスの最後のキャリブレーションがいつ行われたかを示すタイムスタンプ- 属性型: Property. DateTime
dateLastValueReported
: デバイスがデータをクラウドに正常に報告した最後の時間を示すタイムスタンプ- 属性型: Property. DateTime
dateManufactured
: デバイスの製造日時を示すタイムスタンプ- 属性型: Property. DateTime
description
: アイテムの説明- 属性型: Property. Text
- 引用規格:
http://purl.org/dc/elements/1.1/description
deviceState
: 運用の観点から見たこのデバイスの状態。その値はベンダーによって異なります- 属性型: Property. Text
firmwareVersion
: このデバイスのファームウェア・バージョン- 属性型: Property. Text
hardwareVersion
: このデバイスのハードウェア・バージョン- 属性型: Property. Text
ipAddress
: デバイスの IP アドレス。デバイスに複数の IP アドレスがある場合は、値のコンマ区切りリストにすることが できます- 属性型: Property. Text
location
: アイテムの現在の場所- 属性型: GeoProperty. Point or LineString または Polygon または MultiPoint または MultiLineString または MultiPolygon
- 引用規格:
http://geojson.org/geojson-spec.html#geometry-objects
macAddress
: デバイスの MAC アドレス- 属性型: Property. Text
mcc
: モバイル国コード(Mobile Country Code) - このプロパティは、デバイスが接続されているモバイル・ネットワークの 国を一意に識別します- 属性型: Property. Text
mnc
: このプロパティは、デバイスが接続されているネットワークの Mobile Network Code (MNC) を識別します。MNC は、 Mobile Country Code (MCC) ("MCC / MNC tuple" とも呼ばれます) と組み合わせて使用され、GSM, CDMA, iDEN, TETRA, 3G / 4G public land mobile networks および 一部の衛星モバイルを使用して携帯電話事業者/通信事業者を一意に識別します- 属性型: Property. Text
name
: デバイスに付けられたニーモニック名- 属性型: Property. Text
osVersion
: ホスト・オペレーティング・システム・デバイスのバージョン- 属性型: Property. Text
owner
: デバイスのオーナー- 属性型: Relationship. Person or Organization
provider
: デバイスのプロバイダ- 属性型: Property. provider
refDeviceModel
: デバイスのモデル- 属性型: Relationship. DeviceModel
rssi
: ワイヤレス対応デバイスの受信信号強度インジケータ。信号強度が最大のとき、1.0
と等しくなければなりません。 信号が欠落しているときは、0.0
。判断できない場合は、-1.0
です- 許容値: Interval [0,1] and -1
- 属性型: Property. Number
serialNumber
: メーカーが割り当てたシリアル番号。以下を参照してください https://schema.org/serialNumber- 属性型: Property. Text
softwareVersion
: このデバイスのソフトウェア・バージョン- 属性型: Property. Text
source
: エンティティ・データのソースを提供する一連の文字supportedProtocol
: DeviceModel のsupportedProtocol
属性を参照してください。ソフトウェアの更新により、 新しいプロトコルがサポートされている場合に必要です。それ以外の場合は、DeviceModel
レベルで伝える方がよいでしょう- 属性型: EnumProperty.
value
: 観測値または報告値。アクチュエータ・デバイスの場合、これは制御アプリケーションが作動設定を変更できるように する属性です。たとえば、現在オンになっているスイッチ・デバイスはText
タイプの"on"
の値を報告できます。明らかに、 参照されるスイッチを切り替えるには、この属性値を"off"
に変更する必要があります- 属性型: Property. Text or QuantitativeValue
fillingLevel
: 充填レベルである特定の値によって特徴付けられるいくつかの測定に関連するプロパティ - 必須
Person (人)¶
人 (生きている、死んでいる、死んでいない、または架空の)。schema.org
の Person のサブセット
id
: 個人の ID を保持する URN - 必須- 属性型: Property.
-
type
: エンティティ型 - 必須- 属性型: Property.
-
additionalName
: 個人の追加名。ミドルネームに使用できます- 属性型: Property. Text
address
: 郵送先住所 (mailing address)- 属性型: Property. address
- 引用規格:
https://schema.org/address
email
: 電子メール・アドレス- 属性型: Property. Text
familyName
: 苗字。米国では、人の姓 (last name)。これは、name プロパティの代わりに givenName と一緒に使用できます- 属性型: Property. Text
faxNumber
: ファックス番号- 属性型: Property. Text
gender
: 何かの性別、通常は人ですが、架空の人物、動物なども含まれます。http://schema.org/Male
とhttp://schema.org/Female
を使用できますが、テキスト文字列も使用できます。二元的な性別 (binary gender) として 識別されない人々に受け入れられます。性別プロパティは、拡張された意味で使用することもできます。たとえば、 スポーツチームの性別です。個人の性別と同様に、すべての可能性を列挙しようとはしていません。男女混合の SportsTeam は、"Mixed" のテキスト値で示すことができます。 いずれか:female
,male
- 属性型: EnumProperty. GenderType
givenName
: 名(Given name)。米国では、人の名。これは、name プロパティの代わりに familyName と一緒に使用できます- 属性型: Property. Text
honorificPrefix
: Dr/Mrs/Mr などの人の名前の前にある敬語の接頭辞- 属性型: Property. Text
honorificSuffix
: MD/PhD/MSCSW などの人の名前の前にある敬語の接尾辞- 属性型: Property. Text
isicV4
: すべての経済活動の産業分類の国際標準 (Industrial Classification of All Economic Activities; ISIC)、 特定の組織、ビジネス・パーソン、または場所の改訂4コード (Revision 4 code)- 属性型: Property. Text
jobTitle
: その人の役職 (たとえば、財務マネージャー)- 属性型: Property. Text
name
: アイテムの名前- 属性型: Property.
taxID
: 組織または個人の税/会計 ID。たとえば、米国の TIN またはスペインの CIF/NIF- 属性型: Property. Text
telephone
: 電話番号- 属性型: Property. Text
vatID
: 組織または個人の付加価値税 ID (Value-added Tax ID)- 属性型: Property. Text