GeoJSONビューア - 地図表示・構文チェック

GeoJSON ガイド

{ "type": "Point", "coordinates": [139.7, 35.68] }

{
  "type": "MultiPoint",
  "coordinates": [[139.7, 35.68], [135.5, 34.7]]
}

{
  "type": "LineString",
  "coordinates": [[139.7, 35.68], [135.5, 34.7]]
}

{
  "type": "MultiLineString",
  "coordinates": [
    [[139.70, 35.69], [139.77, 35.71]],
    [[139.70, 35.66], [139.77, 35.65]]
  ]
}

{
  "type": "Polygon",
  "coordinates": [
    [
      [139.7, 35.6], [139.8, 35.6],
      [139.8, 35.7], [139.7, 35.7],
      [139.7, 35.6]
    ]
  ]
}

{
  "type": "MultiPolygon",
  "coordinates": [
    [
      [
        [139.7, 35.6], [139.8, 35.6],
        [139.8, 35.7], [139.7, 35.7],
        [139.7, 35.6]
      ]
    ],
    [
      [
        [139.82, 35.6], [139.92, 35.6],
        [139.92, 35.7], [139.82, 35.7],
        [139.82, 35.6]
      ]
    ]
  ]
}

{
  "type": "GeometryCollection",
  "geometries": [
    { "type": "Point", "coordinates": [139.70, 35.66] },
    {
      "type": "LineString",
      "coordinates": [
        [139.74, 35.68], [139.77, 35.71]
      ]
    }
  ]
}

{
  "type": "Feature",
  "geometry": {
    "type": "Point",
    "coordinates": [139.7, 35.68]
  },
  "properties": { "name": "Tokyo" }
}

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [139.7, 35.68]
      },
      "properties": { "name": "東京" }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [135.5, 34.7]
      },
      "properties": { "name": "大阪" }
    }
  ]
}

{
  "type": "Polygon",
  "bbox": [139.7, 35.6, 139.8, 35.7],
  "coordinates": [
    [
      [139.7, 35.6], [139.8, 35.6],
      [139.8, 35.7], [139.7, 35.6]
    ]
  ]
}

バリデーションの内容

地図に表示するたびに、RFC 7946 に沿っているかを確認します。仕様に反していて描けないものをエラー、描けるけれど直したほうがよいものを警告として分けて表示します。検証はすべてブラウザ内で行われ、サーバーには何も送られません。

エラー

• JSONとして解析できない。
• type がその場所に書けない型になっている。いちばん外側は9種類のGeoJSONの型のいずれか、入れ子のジオメトリは Feature と FeatureCollection を除く7つのいずれかである必要があります。
• 座標1点が数値の組になっていない。座標であるべきところが空の配列、数値が1つだけ、文字列で書かれた数値など。
• 座標が経度±180・緯度±90の範囲を超えている。[緯度, 経度] の順で書かれたデータもここで見つかります。
• coordinates の入れ子の深さが、ジオメトリの型と合っていない。または枝によって揃っていない。
• 必須のメンバーが無い。
• リングや線の座標が足りない。ポリゴンのリングは4つ以上、線は2つ以上必要です。

警告

• リングが閉じていない。最初と最後の座標が一致していません。
• リングが右手の法則に従っていない。外周は反時計回り、穴は時計回りが正しい向きです。
• 座標の3つ目が数値でない。3つ目は高度で、書くかどうかは自由ですが、書くなら数値である必要があります。
• bbox がおかしい。読み取れない、南が北より上にある、データがはみ出している、のいずれかです。
• 属性がおかしい。Feature に properties が無い、id が文字列でも数値でもない、同じ属性がフィーチャによって数値だったり文字列だったりする、のいずれかです。
• GeometryCollection の中に GeometryCollection が入っている。仕様では入れ子を避けることが推奨されています。
• crs が書かれている。RFC 7946 はこれを廃止して座標をWGS84に固定したため、別の座標系で記録されている可能性があります。

用語集

RFC 7946

GeoJSON を定義する仕様。座標参照系を WGS84 に、座標の順序を経度・緯度に固定し、型をちょうど9種類と定めています。2008年の草案に沿って作られた古いデータは、別の座標系を使っていることがあります。

CRS（座標参照系）

数値の組がどこを指すかを決める取り決めです。同じ [139.7, 35.68] でも、どのCRSで読むかによって指す場所が変わります。2008年のGeoJSONには crs メンバーがあり、任意のCRSを宣言できましたが、RFC 7946 はこれを廃止してWGS84に一本化しました。そのため crs が書かれたデータは仕様より前のもので、座標がWGS84でない可能性があります。

WGS84

RFC 7946 がすべての座標に固定している測地系で、GPSが返すのも地図サービスが前提にするのもこれです。測地系とは座標系を地球のどこに固定するかの取り決めで、これが違うと同じ緯度経度が別の場所を指します。値を見ても分かりません。古い測地系の座標も経度±180・緯度±90に普通に収まったまま、数百メートルずれた位置に描画されます。

右手の法則

ポリゴンのリングを回る向きのことです。RFC 7946 は外周を反時計回り、穴を時計回りと定めています。MapLibre や Leaflet は逆向きでも描くので、地図の上では違いが出ません。向きを見るのは取り込む側で、Elasticsearch の geo_shape は逆向きのポリゴンを日付変更線をまたぐものと解釈します。

よくある質問

Q: 貼り付けたGeoJSONはサーバーに送信されますか？

A: 送信されません。解析・検証・描画はすべてブラウザ内で行われます。

Q: 「JSONとしては正しいですが、GeoJSONではありません」と出るのはなぜ？

A: JSONとしては解析できたものの、type が無いか、9種類のGeoJSONの型のいずれでもない場合に出ます。たとえば {"a":1} はJSONとしては正しくても GeoJSON ではありません。

Q: バリデーションでは何をチェックしていますか？

A: エラーとして扱い描画しないのは、JSONとして解析できないもの、type がその場所に書けない型になっているもの、座標が数値の組になっていないものや経度±180・緯度±90の範囲を超えているもの、coordinates の入れ子の深さが型と合わないもの、必須のメンバーが無いもの、リングや線の座標が足りないものです。警告として表示しつつ描画するのは、リングが閉じていない場合、右手の法則に従っていない場合、bbox が読み取れない場合と bbox の外にデータがはみ出している場合です。座標の精度は検証していません。上の「バリデーションの内容」に1つずつ挙げています。

Q: GeoJSONは緯度と経度のどちらを先に書きますか？

A: 経度が先です。RFC 7946 は最初の2つを「経度、緯度の順でなければならない」と定めており、bbox も同じ並びで [西, 南, 東, 北] の順です。Google マップなど多くの地図が「緯度, 経度」で見せるため逆に覚えやすいところですが、GeoJSON では必ず経度を先に書きます。日本の座標は経度が122〜154なので、逆に書くと緯度が90を超えてエラーになります。