日本語
Geometry ドラフト 値型
ジオメトリ
location などの GeoProperty の値として使う GeoJSON ジオメトリ(RFC 7946)です。点(Point)、線(LineString)、面(Polygon)、それぞれの複数形(MultiPoint、MultiLineString、MultiPolygon)、それらをまとめた GeometryCollection を表します。座標は WGS 84 で、経度、緯度(、高さ)の順です。使える種類は、モデルごとに絞れます(例:点だけ)。
| 種類 | 値型:属性の値の中で使い、単独のエンティティにはならない |
| IRI | https://datamodels.jp/ns/common/Geometry |
| @context | https://datamodels.jp/context/common/v1.jsonld |
| JSON Schema | /schema/common/Geometry/v1.json |
| ライセンス | CC0 1.0:ファイル(@context、JSON Schema、例)は条件なしで使えます |
この @context と JSON Schema の URL(バージョンの別名)は、常に互換性のある最新版を指します。
内容が変わらない URL はバージョンにあります。詳しくはURL とバージョンを見てください。
型と関係
値型として使う他の分野ほか N 件: その型のページに続きがある
このモデルを使う
他のモデルは、属性の値としてこの値型を参照します。その属性を持つデータを検証すると、この値型のスキーマも読み込まれます(JSON を検証する)。
例
例の多くは架空のシナリオ(東京都千代田区の大雨対応)です。地名とコードは実在のものですが、出来事・人・チームは架空です。公開されている一覧の実際の行を写した例もあり、そのときは注記に出典があります。書き方は例の書き方にあります。
json
{
"type": "Polygon",
"coordinates": [
[
[
139.7515,
35.693
],
[
139.755,
35.693
],
[
139.755,
35.6955
],
[
139.7515,
35.6955
],
[
139.7515,
35.693
]
]
]
}ファイル: example.json
改善の提案
属性が足りない、説明がおかしいと思ったら、Issue で知らせてください。新しい属性やモデルは提案フォームから提案できます。進め方は貢献するにあります。 ソースファイル(注記、対応表)は GitHub にあります。
参照している標準
このモデルが対応している標準と、項目ごとの対応です。開くと対応表が見られます。
自治体標準オープンデータセット・データ項目定義書A(20260801版)の緯度・経度(デジタル庁)
定義書Aの 01〜03、05、07〜15 のデータセットが、場所を「緯度」「経度」の 2 列で持つ。記載ルールは GIF コアデータパーツの「地理座標」に従い、値は10進数の度の文字列(例 43.064310)。これは type が Point の Geometry になる。座標の順は GeoJSON では経度が先。
| このモデル | 対応先 | 備考 |
|---|---|---|
type | 対応なし | 常に Point |
coordinates | 経度 (longitude), 緯度 (latitude) | [経度, 緯度] の順の数値にする(文字列から変換) |
coordinates[2] | 対応なし | 「高度の種別」「高度の値」(heightType, height)は階数・標高・地表高のいずれかで、GeoJSON の3番目の座標(楕円体高)とは意味が違う。座標には入れない |
この標準のデータを変換するための対応表(YAML): jichitai-opendata-location.yaml(説明は対応表)
この標準のライセンス: 公共データ利用規約(第1.0版)(PDL1.0、CC BY 4.0 と互換)
注記
- エンティティの型ではなく、値型です。コアの location GeoProperty(またはほかの GeoProperty)の値として使い、エンティティのスキーマから $ref でこのスキーマを参照します。メンバーの名前(type、coordinates、bbox)とジオメトリの型(Point、Polygon など)は NGSI-LD のコアコンテキストの語で、GeoJSON-LD の語彙に展開されます。カタログが新たに定めるのは、これらのジオメトリ全体を表すクラスだけです。
- RFC 7946 よりも厳しくしています。位置は 2 つか 3 つの数値で、マルチ系のジオメトリ、Polygon、GeometryCollection は、少なくとも 1 つのメンバーを持ちます。使えるジオメトリの型は、モデルの側で $ref の横に type の制約を書いて絞ります(DesignatedShelter が Point に絞っているように)。
- RFC 7946 §3.1.6 は、すべての線形リングが閉じている(最初と最後の位置が同じ)ことを求めています。これは JSON Schema では表せないので、カタログの検証ツールが、カタログのすべての例のリングを検査します。利用する側では、GeoJSON を扱えるライブラリでインスタンスを検査してください。
- クラス(https://datamodels.jp/ns/common/Geometry)を新たに定めたのは、GeoJSON-LD の語彙(https://purl.org/geojson/vocab#)が個々のジオメトリの型しか定めておらず、ジオメトリ一般のクラスを持たないためです。OGC の Simple Features の語彙(http://www.opengis.net/ont/sf#Geometry)にはそうしたクラスがありますが、NGSI-LD の GeoJSON の値は、Simple Features ではなく GeoJSON-LD の型に展開されます。
- 検討した上流(2026-09-25)は 2 つです。geojson.org の GeoJSON スキーマは JSON Schema draft-07 で、このカタログが使う 2020-12 とは違います。GeometryCollection は別のファイルにあり、URL にバージョンが無く、空の座標の配列も受け付けます。Smart Data Models の Location-Commons(common-schema.json)には、GeometryCollection の無い 6 種類しかありません。再利用できるジオメトリではなく location の属性全体を定義していて、master にしか公開されていません。どちらもそのままでは参照できないので、このスキーマは同じ RFC 7946 の構造に従って書きました。
- NGSI-LD のコアコンテキスト(v1.8)は coordinates と bbox を定義していますが、geometries は定義していません。そのため JSON-LD の処理では、GeometryCollection の geometries がコアコンテキストの既定の語彙に展開されます。また、メンバーが 1 つだけのコレクションは、圧縮すると配列ではなくオブジェクトに戻ります。GeoJSON をそのまま保存するブローカーには影響しません。