包括施設管理事業者情報の登録
以下は、包括施設管理を受託しているハリー株式会社の情報を一覧です。繰り返しますが、架空の法人であり、架空の住所です。
| 項目 | 登録したい情報 | 補足 |
|---|---|---|
| 法人名 | “ハリー株式会社” | |
| 法人のカナ名 | “ハリーカブシキガイシャ” | |
| 法人の英語名 | “Harry Corporation” | |
| 法人の登記住所/所在地 | “広島県呉市吉浦潭鼓町14-1” | 登記住所と実際の所在地は同じ住所としました。尚、この住所の表記は準拠規格に合っていないので、変換が必要です |
| 代表電話 | “0823-01-2345” | |
| 市役所の建物の名称 | “ハリービル” | |
| 法人番号 | “0990123456789” | |
| 市のホームページ | “https://ppp-datebase.co.jp/” |
これらの情報を登録する訳ですが、自治体と同様に下図のように、「法人(Organization)」、「土地(Land)」、「建物(Building)」、および「施設(Facility)」に一括して登録します。
技術情報
本協議会は共通化したデータ仕様に基づくデータの取り扱いについて規定していません。自治体によってはファイルとして保存する場合もあるでしょうし、都市OSを用意して登録する場合もあると思います。ここでは、都市OSに登録する例を紹介します。まずは、データモデル間の関係を押さえましょう。データモデルの関係は右図の様になっています。そのため、前記の表の項目を4つのデータモデルに振り分けて登録するだけでなく、矢印で示したリンクについても登録します。
参考までに、NGSI V2で登録するために指定する「コンピュータ用の帳票」も掲載します。なんとなく、帳票と言っている意味が分かるかと思います。因みに、下記形式はkeyValues形式という省略形です。見やすいのが特徴です。ダウンロードしたい方はこちら。
{
"actionType": "append",
"entities": [
{
"id": "urn:ngsi-ld:Organization:JP0990123456789",
"type": "Organization",
"businessCategory": "ビルメンテナンス業",
"category": "市区町村",
"contactPoint": [
{
"contactType": "総合",
"telephone": "0823-01-2345"
}
],
"description": "架空の事業者です",
"identificationGroup": [
{
"identificationType": "法人番号",
"identification": "0990123456789"
}
],
"name": "ハリー株式会社",
"nameEn": "Harry Corporation",
"nameKana": "ハリーカブシキガイシャ",
"refFaciliry": "urn:ngsi-ld:Facility:JP0990123456789-00000001",
"registeredAddress": {
"addressRegion": "広島県",
"addressLocality": "呉市",
"streetAddress": "吉浦潭鼓町14-1"
},
"url": "https://www.city.kure.lg.jp/"
},
{
"id": "urn:ngsi-ld:Land:0000000001010-0000",
"type": "Land",
"address": {
"addressRegion": "広島県",
"addressLocality": "呉市",
"streetAddress": "吉浦潭鼓町14-1",
"postalCode": "7370853"
},
"description": "ハリービルの敷地です"
},
{
"id": "urn:ngsi-ld:Building:0000000002010-0000",
"type": "Building",
"category": "事務所",
"description": "ハリー株式会社の本社ビルです",
"name": "ハリービル",
"nameEn": "Harry Building",
"nameKana": "ハリービル",
"refLand": ["urn:ngsi-ld:Land:0000000001010-0000"],
"usage": "業務施設"
},
{
"id": "urn:ngsi-ld:Facility:JP9000020342025-00000001",
"type": "Facility",
"category": "商業施設（建築）",
"subcategory": "その他建築関連店",
"description": "ハリー株式会社",
"facilityNo": 1,
"name": "ハリー株式会社",
"nameKana": "ハリーカブシキガイシャ",
"refBuilding": "urn:ngsi-ld:Building:0000000002010-0000"
}
]
}因みに、登録する際のAPIの指定は以下の通りです。前記のファイルをDドライブ直下にダウンロードして、PCのローカル環境にFiwra/Orionを起動して実行しました。従って、ファイルやURL等は適宜変更してください。
curl -iX POST -H "Content-Type: application/json" -d @d:\HarryCorp.json "http://localhost:1026/v2/op/update?options=keyValues"
