このツールでできること
GeoParquetファイルは人間が直接読める形式ではありません。GeoJSONとは異なり、テキストエディタで開いても座標を確認することはできず、一般的なGISデスクトップツールの多くもこの形式を直接開くことができません。そのため、.parquetファイルを手に入れても、実際に何が含まれているのか(フィーチャー数、ジオメトリの種類、カラム構成、対象範囲など)を把握するまでにギャップが生じます。
このビューアは、そのギャップを埋めます。ファイルをドロップすると、Parquetコンテナを読み込み、ファイル自体のGeoParquetメタデータを確認してジオメトリ列とそのエンコーディングを特定し、すべてのWKB(Well-Known Binary)値を実際の座標にデコードして、結果を地図上に描画します。任意のフィーチャーをクリックすると属性テーブル全体を確認でき、色やスタイルを調整してパターンを見やすくすることもできます。また、より多くのツールが対応しているGeoJSON形式が必要な場合には、すべてをそのままエクスポートすることも可能です。ファイルはどこにもアップロードされません。Parquetリーダーはお使いの端末上で完全に動作するWebAssemblyビルドです。
ビューアがGeoParquetファイルを読み取る仕組み
この処理は3段階で進みます。まず、RustのParquetライブラリのWebAssemblyビルドが生のカラムデータを読み込み、GeoPandasやDuckDBが内部で使用しているのと同じインメモリ形式であるApache Arrowテーブルとして返します。次に、ビューアはテーブルのスキーマメタデータから"geo"という名前のキーを探します。これは、すべてのGeoParquetファイルが持つ小さなJSONブロックで、主要なジオメトリ列を示し、そのエンコーディングを宣言し、含まれるジオメトリの種類を一覧化しています。このキーが存在しない場合、そのファイルは単なるParquetファイルであり、GeoParquetではないと判断し、推測することなくその旨を明示します。
第三に、ビューアはジオメトリ列の各行(生のWKBバイト値を保持しています)を順に処理し、それぞれを座標にデコードします。バイト順を示す1バイトのフラグ、ジオメトリの種類を示す4バイトのコード、そして8バイトの数値のペアとして表される座標そのものです。同じデコーダーは、PostGISがEWKB出力に付加するSRIDフラグや、ISO WKB規格によるZ/M次元マーカーも認識するため、空間データベースからエクスポートされたファイルも正しく読み取ることができます。他のすべてのカラムのプロパティも、Arrowがすでに保存している形式のまま読み取られ、各フィーチャーに付加され、全体が地図上に描画できる標準的なGeoJSON FeatureCollectionになります。
ステップバイステップガイド
「Upload」をクリックして.parquetファイルを選択するか、地図上にドラッグ&ドロップするか、「Sample Data」をクリックしてすぐに使える小さなサンプルを読み込みます。
ファイルはブラウザ内で完全にデコードされます。File Infoパネルには、フィーチャー数、ジオメトリの種類、ジオメトリ列名、CRS、ファイルサイズが、ファイル自体のメタデータから直接表示されます。
地図上の任意の点、線、ポリゴンをクリックすると、そのフィーチャーに保存されているすべてのプロパティを一覧表示するポップアップが開きます。
Styleパネルを使用して、地図上のすべてのフィーチャーに適用される色、線の太さ、塗りつぶしの不透明度を変更できます。
「Download as GeoJSON」をクリックすると、デコードされたすべてのフィーチャーを標準的なGeoJSONファイルとしてエクスポートできます。
実際の活用例
コードを書かずにGeoParquetファイルを直接開くことが、実際に役立つ場面をご紹介します。
- データパイプラインの出力を素早く確認する。 スクリプトやETLジョブがGeoParquetファイルを出力する場合、最新の出力をこのビューアに直接ドラッグすることで、そのファイルを下流で使用する前にジオメトリと属性が正しいかを素早く確認できます。
- コードを書く前にオープンデータセットを探索する。 Overture MapsやSource Cooperative上のコレクションなど、GeoParquet形式で配布されているデータセットがあります。小さな抜粋をダウンロードしてここで表示すれば、DuckDBやGeoPandasを構築する前に、どのようなカラムやジオメトリの種類が含まれているかを正確に把握できます。
- GeoJSONからGeoParquetへの変換を検証する。 当サイトのGeoJSONからGeoParquetへの変換ツールなどでファイルを変換した後、結果をこのビューアに読み込むことで、すべてのフィーチャーとプロパティが正しく保持されたことを確認できます。
- オープンデータとして公開する前にデータを確認する。 自治体や研究チームは、GeoJSONと並んでGeoParquetを公開することが増えています。空のジオメトリ列や間違った半球のバウンディングボックスといった明らかな問題を、ファイルを公開する前にここで手早く目視確認できます。
- GeoParquet形式を教育・実演する。 ファイル情報パネルには、主要なジオメトリ列、CRS、エンコーディングがファイル自体のメタデータから直接表示されるため、GeoParquetファイルの中身を学生や同僚にわかりやすく示す手段として便利です。
- 他のビューアがない状況でファイルから使えるデータを取り出す。 すべてのGISデスクトップツールがGeoParquetに対応しているわけではありません。今すぐ.parquetファイルの中身を確認したい場合や、その形式しか理解しないツールのためにGeoJSONとして取り出したい場合、このツールを使えば何もインストールせずに済みます。
よくある質問
ここではどのようなファイルを開けますか?
GeoParquet仕様に準拠したファイルであれば開けます。具体的には、ジオメトリ列を説明するスキーマレベルの"geo"メタデータキーを持つ、通常のApache Parquetファイルです。GeoPandas、DuckDBの空間拡張機能、ogr2ogr、Apache Sedona、あるいは当サイトのGeoJSONからGeoParquetへの変換ツールで生成されたファイルはすべて動作します。
ビューアが対応しているジオメトリエンコーディングは何ですか?
WKB(Well-Known Binary)です。これは現在のGeoParquetファイルで既定かつ圧倒的に一般的なエンコーディングです。GeoParquet 1.1では、各ジオメトリタイプごとに独立したネイティブArrowエンコーディングも定義されていますが、これらを使用するファイルはまだ対応しておらず、該当する場合はビューアが明確にお知らせします。
マルチパートジオメトリを含む、点・線・ポリゴンファイルに対応していますか?
はい。Point、LineString、Polygon、MultiPoint、MultiLineString、MultiPolygonはすべて正しくデコードされ、同じ列内に複数のジオメトリタイプが混在するファイルにも対応しています。
3D(Z)座標や測定値(M)座標はどう扱われますか?
このリーダーは、PostGISのEWKB形式とISO WKB形式の両方によるZ・M次元の表記方法を認識し、これらの追加値を正しくスキップすることで、残りのジオメトリを問題なくデコードします。GeoJSON出力と地図は本質的に2次元であるため、表示にはXとYのみが使用されます。
ビューアはどの列がジオメトリを保持しているかをどうやって把握しますか?
ファイルの"geo"メタデータにある"primary_column"フィールドを読み取ります。これはすべての有効なGeoParquetファイルに含まれている必要があります。ビューアがCRSを報告し、デコードを試みる前にエンコーディングを確認するのも、この情報に基づいています。
ファイルに"geo"メタデータがまったくない場合はどうなりますか?
その場合、そのファイルは単なるParquetファイルであり、GeoParquetファイルではないと判断し、推測することなくその旨を表示します。付随するメタデータのないジオメトリ列は、WKB、WKT、あるいはまったく別のものである可能性があるため、自動的にデコードする安全な方法はありません。
ファイルサイズに制限はありますか?
アップロードは100MBまでに制限されています。非常に大きなファイルは、各フィーチャーがLeafletレイヤーになるため、地図の描画が遅くなることがあります。数十万行を超えるファイルでは、初回の描画に数秒かかることが予想されます。
データをGeoJSONとして取り出すことはできますか?
はい。「Download as GeoJSON」ボタンをクリックすると、デコードされたすべてのフィーチャー(ジオメトリとプロパティを含む)を、どのGISツールでも開ける標準的なGeoJSON FeatureCollectionとしてエクスポートできます。
ファイルはサーバーにアップロードされますか?
いいえ。Parquetファイルの読み込み、WKBジオメトリのデコード、地図の描画は、すべてWebAssemblyを使用してブラウザ内でローカルに行われます。ファイルがお使いの端末から出ることはありません。
読み込み処理はApache Arrowとparquet-wasmのWebAssemblyビルドを使用して、すべてブラウザ内で完結します。ファイルがサーバーにアップロードされることは一切ありません。 地図タイル © OpenStreetMap の貢献者、Protomapsで描画（ホスティング：KONAKTIVE）、予備としてCARTO。
