FlatGeobufとは — Shapefileより速く読める理由と、座標系がヘッダーのどこに書かれるのか

,

FlatGeobufとは — Shapefileより速く読める理由と、座標系がヘッダーのどこに書かれるのか

FlatGeobufとは — Shapefileより速く読める理由と、座標系がヘッダーのどこに書かれるのか

お知らせ・2026年11月(記事本文の前に追加)

お知らせ(2026年11月)— ファイルフォーマット変換が使えるようになりました

iPhone アプリ JP-GeoConverter Pro(バージョン 2)に「ファイル変換」を載せました。CSV・SIMA・Shapefile・DXF・J-LandXML・LAS・PLATEAU・GeoTIFF など 18 形式を読み、13 形式に書き出せます。座標系は測地系 10 種類 × 緯度経度・平面直角 19 系・UTM 6 帯の 229 通りから選べ、形式と座標系の意味のある組み合わせは約 63 万通りです(組み合わせ上の数。数え方はこちらの記事)。

FlatGeobufは、FlatBuffersの上に地理データを並べた1ファイル完結のバイナリ形式です。 速さの理由は圧縮ではなく並べ方で、先頭にヘッダー、そのあとに空間インデックス、最後に地物が続きます。読む側はヘッダーだけを見て、必要な範囲の地物がファイルのどこにあるかを決められます。座標系はそのヘッダーの中の crs テーブルに入り、org と code(既定の組織はEPSG) という形で持つのが基本です。そして code の既定値は 0=不明。ここを埋め忘れると、Shapefileで .prj を入れ忘れたときと同じことが起こります。


ファイルは4つの並びでできている

仕様が定めている並びはこれだけです。

記号 中身
MB マジックバイト 0x6667620366676201
H ヘッダー(header.fbs で定義される可変長のFlatBuffer)
I 省略可能な空間インデックス(静的な packed Hilbert R-tree)
DATA 地物(feature.fbs で定義される可変長のFlatBuffer)の並び

マジックバイトには版が埋め込まれています。4バイト目がメジャー仕様版、最終バイトがパッチレベルで、あるメジャー版向けの実装はどのパッチレベルも受け付けるべきとされています。文字列はUTF-8が前提です。

インデックスが省略可能であることが、この形式の性格を決めています。インデックスを付けなければストリームとして書き出せ、追記もできます。逆に、ランダムな書き込みは意図的にサポートされていません。「作って配る」「読んで絞る」に特化した形式で、「開いて部分だけ書き換える」用途ではありません。


座標系は crs テーブルに入る

header.fbs の Crs テーブルは、次のフィールドを持ちます。

フィールド 意味
org 定義した組織の名前。大文字小文字を区別しない(EPSG でも epsg でもよい)。NULLならEPSG
code 組織が割り当てた数値ID。0は不明
name 人が読めるSRS名
description 人が読める説明
wkt 座標参照系のWKT表現
code_string 整数でないためにcodeへ入れられない(まれな)場合のテキストID

日本の実務での読み方は3点です。

1つめ。平面直角座標系なら code に1個入れれば済みます。 第9系なら EPSG:6677(JGD2011)のように、組織と数値IDだけで指定できます。Shapefileのように別ファイルのWKTを持ち歩く必要はありません。

2つめ。code の既定値が 0=不明であること。 crs を書かない、あるいは code を埋めない状態で出力すると、受け側は座標系を判断できません。緯度経度と平面直角座標のX・Yは数値の桁がまったく違うので人間なら気づきますが、自動処理では「0だから不明」として止まるか、ツールの既定値で勝手に解釈されるかのどちらかです。入れ忘れを前提にした受け入れチェックを置いてください。

3つめ。wkt も併せて入れられること。 EPSGコードだけでは表せない独自の原点や、座標系の実現まで含めて渡したいときは、code と wkt を両方入れておけば、コードを知らない相手にも定義が伝わります。WKT2とは で整理した「測地系と実現の区別」をそのまま持ち運べる枠です。


座標は xy という1本の配列に入る

feature.fbs の Geometry テーブルは、座標を次のように分けて持ちます。

  • xy — x と y を平らに交互に並べた配列(flat pairs)
  • z / m — 高さ、計測値の配列(任意)
  • t / tm — 測地時刻、ナノ秒時刻の配列(任意)
  • ends — 各パートが座標配列のどこで終わるかの印。外側のリングが先
  • type / parts — 型の混在したコレクション用。各パート自体がGeometry

高さが別配列であるのが、GeoJSONとの一番大きな違いです。GeoJSONでは1点が [経度, 緯度, 高さ] という配列で、高さが座標値の3番目に混ざります。FlatGeobufでは xy と z が別なので、高さを落とす・足すが配列ごとの操作になります。高さを使わない処理で z を読み飛ばすのも簡単です。

なお、xy という名前そのものが並び順を語っています。x が先、y が後。日本の平面直角座標系をここに入れるなら、測量の世界のX(北)とY(東) との対応を自分で決めて、変換の入口で1回だけ揃えるのが安全です。


図形の型はWKBの2D列挙と同じ

GeometryType の列挙は、仕様のコメントに「WKBの2D図形型の列挙と同じ」と明記されています。Point〜GeometryCollectionの7つに加えて、CircularString・CompoundCurve・CurvePolygon・MultiCurve・MultiSurface・Curve・Surface・PolyhedralSurface・TIN・Triangle まで番号が振られています。円弧の補間はSQL-MM Part 3の定義に従うとされています。

ただし「仕様に番号がある」ことと「手元のツールが読める」ことは別です。円弧を含むデータを受け渡す予定があるなら、相手のツールで1件通してから本番にしてください。

ヘッダー側の geometry_type は、地物ごとに型が違う場合は Unknown にしておくという決まりです。columns も同様に、地物ごとにスキーマが違うなら省略できます。


属性の列は型が細かい

Column テーブルの ColumnType には、Byte/UByte/Bool/Short/UShort/Int/UInt/Long/ULong/Float/Double/String に加えて、Json・DateTime・Binary があります。DateTimeはISO 8601、Jsonはアプリ固有の汎用JSON型という位置づけです。

さらに各列に width / precision / scale / nullable / unique / primary_key を持てます。既定は width / precision / scale がいずれも -1(不明)、nullable が true、unique と primary_key が false です。Shapefileの dBASE 属性で悩んだ「フィールド名が短い」「型が足りない」という制約は、ここにはありません。

ヘッダーの features_count は 0が「不明」、index_node_size は既定 16 で、0ならインデックスなしを意味します。envelope は全体の範囲です。


速さは「並べ方」から来ている

公開されている予備的な測定結果は、Shapefileを1とした相対値です(デンマークの道路データ、906,602件のLineString)。

試験 GeoPackage FlatGeobuf
全データの読み込み 1.02 0.46
空間フィルタ付きの読み込み 0.94 0.71
全データの書き出し 0.77 0.39
空間インデックス付きの書き出し 1.58 0.65
ファイルサイズ 0.72 0.77

デンマークの地籍データ(250万件のポリゴン)でも読み書きはGeoPackageより速く、ただしファイルサイズは大きくなっています(0.95 対 0.77)。

傾向は読み取れます。FlatGeobufは速さを取り、サイズは取りに行っていません。 圧縮をかけずに素直に並べているので、読むときにデコードの手間がほとんどかからない。配布用に小さくしたいなら、転送時の圧縮や、列指向のGeoParquetのほうが向きます。


HTTPで部分だけ取るときの注意

ファイルの一部をHTTPで取るときはRangeリクエストを使います。ヘッダーとインデックスを読んでから、必要な地物の範囲だけを取りに行く形です。

ここに1つ実務的な落とし穴があります。クロスオリジンでRangeヘッダーを使うと、OPTIONSのプリフライトリクエストが発生します。 公開資料でも、CloudFrontのようなCDNでOPTIONSのキャッシュを有効にすることが推奨されています。自前のサーバーやストレージに置く場合も、OPTIONSへの応答とCORSヘッダーを設計に入れておかないと、「ローカルでは動くのにWebに置くと遅い/動かない」になります。


3つの「クラウド向け」を並べると

同じ「部分だけ読む」という発想の形式を、役割で並べると見通しがよくなります。

形式 中身 部分取得の鍵 座標系の置き場所
Cloud Optimized GeoTIFF ラスタ タイル+概観画像+IFDの並び GeoTIFFのGeoKey
GeoParquet 列指向のテーブル 行グループ+列の統計 geo メタデータの crs(PROJJSON)
FlatGeobuf 地物の並び ヘッダー+Hilbert R-tree ヘッダーの Crs(org/code/wkt)

座標系の書き方が3つとも違うのが、変換を書く側の現実です。GeoKey、PROJJSON、org+code。どれも「EPSGコード1個で済むなら済ませる」で揃えられますが、省略時の扱いが揃っていません。GeoParquetは crs を省略するとOGC:CRS84とみなされ、FlatGeobufは code が0なら不明。同じ「書かなかった」が、形式によって「WGS84のつもり」と「不明」に分かれます。 一括変換のパイプラインを組むときは、ここを明示的に埋める処理を入れてください。


対応ツール

リファレンス実装はJavaScript・TypeScript・C++・C#・Go・Java・Rustで公開されています。GDAL/OGRドライバとGeoServerのWFS出力形式があり、対応アプリケーションとしてGDAL 3.1以降・QGIS 3.16以降、ほかにFiona・GeoServer・PostGIS・MapServer・pyogrio が挙げられています。

QGISで開けてGDALで変換できるので、実務の入口としては ogr2ogr で1本通すのが早いです(ogr2ogrでの座標系変換)。


まとめ

  • FlatGeobufは MB → ヘッダー → (任意の)インデックス → 地物 の4つの並び。マジックバイトは 0x6667620366676201
  • インデックスは 静的な packed Hilbert R-tree。省略できるのでストリーム書き出し・追記が可能。ランダム書き込みは非対応
  • 座標系はヘッダーの Crs。org のNULLはEPSG、code の 0は不明。wkt も併せて持てる
  • 座標は xy に平らなx,yペアで入り、z・m・t・tm は別配列。高さが座標値に混ざらない
  • 図形型はWKBの2D列挙と同じ。円弧系の型も番号はあるが、ツールの対応は要確認
  • 速さを取ってサイズは取っていない(Shapefileを1として読み0.46・書き0.39・サイズ0.77)
  • HTTPのRangeを使うとき、クロスオリジンではOPTIONSのプリフライトが発生する
  • COG・GeoParquet・FlatGeobufで「座標系を書かなかった」ときの既定が揃っていない

出典

  • FlatGeobuf 公式サイト(FlatBuffersに基づくバイナリ符号化・SQL-MM Part 3の円弧補間・BSD 2-Clause、ファイル並びMB/H/I/DATA、マジックバイト 0x6667620366676201 と4バイト目=メジャー版・最終バイト=パッチレベル、静的なpacked Hilbert R-tree、インデックス省略によるストリーム・追記とランダム書き込み非対応、HTTPのRangeリクエストとクロスオリジンでのOPTIONSプリフライト・CDNでのOPTIONSキャッシュ推奨) https://flatgeobuf.org/
  • FlatGeobuf src/fbs/header.fbs(GeometryType の列挙=WKB 2D図形型と同じ、ColumnType の一覧、Column の width/precision/scale/nullable/unique/primary_key の既定値、Crs の org(NULL=EPSG)・code(0=不明)・name・description・wkt・code_string、Header の envelope・geometry_type(混在時はUnknown)・features_count(0=不明)・index_node_size(既定16・0=インデックスなし)) https://github.com/flatgeobuf/flatgeobuf/blob/master/src/fbs/header.fbs
  • FlatGeobuf src/fbs/feature.fbs(Geometry の xy=平らなx,yペアの配列、z・m・t・tm、ends=パートの終端で外側のリングが先、type・parts、Feature の geometry・properties・columns と root_type) https://github.com/flatgeobuf/flatgeobuf/blob/master/src/fbs/feature.fbs
  • FlatGeobuf README(文字列はUTF-8前提、Shapefileを1とした予備的な性能比較の表、デンマーク道路906,602件のLineStringとデンマーク地籍250万件のポリゴン、リファレンス実装の言語一覧、GDAL/OGRドライバとGeoServer WFS出力、対応アプリケーション=GDAL 3.1以降・QGIS 3.16以降ほか) https://github.com/flatgeobuf/flatgeobuf

本記事の仕様とバージョン情報は2026年10月時点の各公開資料の記載に基づきます。仕様の版によってフィールドや既定値が変わるため、実際の受け渡しでは対象バージョンの定義ファイルで確認してください。


次に確認する


開発者より: アプリ・Kindle本・公開プロジェクトの一覧は GitHub: amru195704 にまとめています。


お願い
本記事の情報は参考目的で掲載しており、正確性・完全性を保証するものではありません。誤記・不正確な情報がございましたら、コメント欄よりご指摘いただければ、確認のうえ修正いたします。


アプリを入手(App Store):JP-GeoConverter Pro(座標変換) | JP-GeoPrism(測地系の可視化・学習)


コメントを残す

メールアドレスが公開されることはありません。 ※ が付いている欄は必須項目です

トップへ戻る