事前登録の順番
繰返しになりますが、共通データ仕様では情報を登録する際にどの情報を先に登録すべきかという点に特に制約はありません。従って、事前登録する情報も登録する順序は決められていません。そうは言っても、やはり大まかな情報から登録した方が心地良い気がするので、本チュートリアルでは以下の様に大まかな情報から順番に登録します。
まずは、施設のオーナーである自治体の情報を登録します。今回は呉市の情報をそれっぽく登録してみます。
登録する自治体情報
ご参考までに、自治体の情報を再掲します。繰り返しますが、正しい情報ではない可能性がありますので、その点はご容赦下さい。
ケーススタディ#1と#2では、csvファイルとして一旦作成するために、自治体の情報は組織(Organization)の項目(Attribute)だけをcsv化していましたが、本ケーススタディではその様な制約は無いので、ひとつの自治体に関する情報を一括して出力します。
| 項目 | 登録したい情報 | 補足 |
|---|---|---|
| 自治体名 | 呉市 | |
| 自治体が所属する都道府県名 | 広島県 | |
| 自治体のカナ名 | クレシ | |
| 自治体の英語名 | Kure City | |
| 自治体の所在地 | 広島県呉市中央４丁目１−６ | 左記の住所の表記は準拠規格に合っていないので、変換が必要です |
| 郵便番号 | 37-0051、737-8501 | 呉市中央の郵便番号737-0051の他に、市役所には個別郵便番号737-8501が割り当てられています。左記の郵便番号の表記は準拠規格に合っていないので、変換が必要です。 |
| 自治体コード | 342025 | |
| 代表電話 | 0823-25-3100 | |
| 市役所の施設の名称 | 呉市役所 | 呉市役所という施設は複数の棟から構成され、入居している棟の棟名は”本庁舎”です |
| 市役所が入居している棟名 | 本庁舎 | |
| 法人番号 | 9000020342025 | |
| 市のホームページ | https://www.city.kure.lg.jp/ |
これらの情報を登録する訳ですが、自治体名は「法人(Organization)」の項目であり、市役所の所在地は「土地(Land)」の項目であり、建物の名称は「建物(Building)」の項目です。そこで、複数の帳票(データモデル)を下図のように一括して登録します。
つまり、自治体の情報は幾つかの帳票にまたがって登録することになります。数枚の帳票をホチキスで留めて提出するイメージでしょうか。
尚、市役所本庁舎も施設管理の対象かもしれませんが、この段階で事細かに登録する必要はあません。コンピュータ用の帳票は紙の帳票と異なり、何回かに分けて登録しても構わないためです。idが一致していると同じデータだと認識されるルールなので、必ずidは一致させる必要があります。
技術情報
本協議会はデータ仕様は共通化しますが、そのデータ仕様に基づいて作成された電子データの取り扱いについては規定していません。オーナーによってはテキストファイルとして保存する場合もあるでしょうし、エリアデータ連携基盤(都市OS)を用意して登録する場合もあると思います。本ケーススタディでは、JSON文をテキストファイルとして保存しておく例を紹介しています。
まずは、今回の例では市役所の建物は複数の棟からなる複合施設になっていて、市役所は複合施設データモデル間の関係を押さえましょう。データモデルの関係は右図の様になっています。複合施設なのでテナント施設の情報が存在します。複合施設ではない、つまり全ての建物・敷地・設備がひとつの施設で占有されている場合はテナント施設の情報は不要です。また、建物も複数の棟に分かれているため、棟の情報を登録する事も可能です。但し、オーナーの情報としては棟の情報は不要なので、ここでは省略する事にします。従って、前記の表の項目を5つのデータモデルに振り分けて登録すると共に、矢印で示したリンクについても登録します。
作成したJSON文は以下の通りです。
本協議会の説明文ではこの電子データの事を「コンピュータ用の帳票」とも表現していますが、下記の例をご覧頂くとなんとなく「帳票」と言っている意味が分かるかと思います。人間にとっては読みにくい帳票ですが、コンピューターにとっては読みやすい形式なのです。尚、下記形式はkeyValues形式という省略形です。見やすいのが特徴ですが、各項目(Attribute)の属性(type)の情報が欠落してしまうのが、欠点です。下記の例以外の項目を登録する事は可能です。その様な例も用意しましたので、ダウンロードしたい方はこちらをご覧ください。
[
{ <--- オーナーの法人情報
"id": "urn:ngsi-ld:Organization:JP9000020342025",
"type": "Organization",
"identificationGroup": [
{
"identificationType": "法人番号",
"identification": "9000020342025"
},
{
"identificationType": "自治体コード",
"identification": "342025"
}
],
"name": "呉市",
"containedInPlace": "広島県",
"nameKana": "クレシ",
"nameEn": "Kure City",
"category": "市区町村",
"url": "https://www.city.kure.lg.jp/",
"registeredAddress": {
"addressRegion": "広島県",
"addressLocality": "呉市",
"streetAddress": "中央4-1-6"
},
"contactPoint": [
{
"contactType": "総合",
"telephone": ["0823-25-3100"]
}
],
"refFaciliry": "urn:ngsi-ld:Facility:JP9000020342025-0100001" <--- テナント施設のFacilityへのリンク
},
{ <--- テナント施設の情報
"id": "urn:ngsi-ld:Facility:JP9000020342025-0100001",
"type": "Facility",
"name": "呉市役所",
"facilityID": "0100001",
"floor": "本庁舎",
"facilityParent": "urn:ngsi-ld:Facility:JP9000020342025-0000001", <--- 施設全体へのリンク
"refBuilding": "urn:ngsi-ld:Building:JP9000020342025-00000001" <--- 建物のBuildingへのリンク
},
{ <--- 施設の情報
"id": "urn:ngsi-ld:Facility:JP9000020342025-0000001",
"type": "Facility",
"name": "呉市役所",
"facilityID": "0000001",
"postalCode": "7378501",
"refBuilding": "urn:ngsi-ld:Building:JP9000020342025-00000001" <--- 棟のBuildingへのリンク
},
{ <--- 建物全体の情報
"id": "urn:ngsi-ld:Building:JP9000020342025-00000001",
"type": "Building",
"name": "呉市役所",
"refLand": ["urn:ngsi-ld:Land:JP9000020342025-00000001"] <--- 敷地のlandへのリンク
},
{
"id": "urn:ngsi-ld:Land:JP9000020342025-00000001",
"type": "Land",
"address": {
"addressRegion": "広島県",
"addressLocality": "呉市",
"streetAddress": "中央4-1-6",
"postalCode": "7370051"
}
}
]
