PMTiles ビューア

このツールでできること

PMTilesファイルは、地図タイルを1つにまとめたフラットなバイナリアーカイブです。データベースへの問い合わせやタイルサーバーの起動なしに、通常のHTTPバイトレンジリクエストだけで個々のタイルを取り出せるように設計されています。この効率のよさには代償もあります。人がファイルの中身をひと目で確認したいと思っても、地図ライブラリを自分で組み込むか、コマンドラインツールを使わない限り、.pmtilesファイルに何が入っているのかを確認する標準的な手段がありません。

このビューアは、その手間をなくします。ファイルを読み込むと、アーカイブの127バイトのヘッダーとJSONメタデータを読み取り、タイル形式、ズーム範囲、地理的な範囲、そしてファイルに含まれる名前・説明・出典表示を表示したうえで、画面に見えているすべてのタイルをLeafletの地図上に直接描画します。処理はすべてローカルで完結します。ファイルはブラウザのFile APIを使ってディスクから直接読み込まれ、データがサーバーへ送信されることは一切ありません。

ビューアがPMTilesファイルを読み取る仕組み

このビューアは、MapLibre GLでも使われているのと同じリーダー実装である公式の「pmtiles」JavaScriptライブラリを使用しています。これをFileベースのソースと組み合わせることで、HTTP経由ではなくアップロードされたファイルから直接バイトレンジを取り出せるようにしています。最初の読み取りでは、ヘッダーと圧縮されたタイルディレクトリだけを取得します。これだけで、1枚もタイルをデコードしないうちに、アーカイブのズーム範囲・範囲・形式をすぐに把握できます。

地図をパンしたりズームしたりすると、画面に見えている各タイルがz/x/y座標で要求されます。リーダーはその座標を、ヒルベルト曲線によるタイルIDで整理されたアーカイブのディレクトリの中から探し、二分探索でそのタイルのバイトオフセットと長さを特定し、該当するバイト部分だけを取得して、生のタイル画像を返します。この一連の処理を、小さなカスタムLeafletレイヤーがラップしているため、タイルは他の一般的なタイルソースと同じように地図上に自然に表示されます。アーカイブに記録された最大ズームレベルを超えて拡大した場合も、最も近い利用可能なタイルを再利用して表示します。

PMTilesの歴史と技術的な特徴

PMTilesは、オープンソースの地図プロジェクトであるProtomapsから生まれました。その根底にあるのは、地図の配信にサーバーは不要で、きちんと整理されたファイルと、バイトレンジを返せる何かさえあればよいという考え方です。ProtomapsはPMTilesの仕様自体をパブリックドメインとして公開しており、Go、JavaScript、Pythonなど複数の言語によるリファレンス実装(リーダーおよびライター)はBSD 3-Clauseライセンスで公開されています。このフォーマットはこれまでに複数回改訂されており、現在唯一実際に使われているバージョンであるv3では、以前のレイアウトに代わってヒルベルト曲線によるディレクトリ方式が採用されました。これは、当サイトのMBTilesからPMTilesへの変換ツールでも同じ方式が実装されています。

PMTilesが解決しようとしている課題は、主にコストと複雑さの問題です。世界全体をカバーするタイルピラミッドは、数億枚もの個別タイルを含むことがあります。Protomaps自身のドキュメントでは、3億枚のタイルを例に挙げており、これらを別々のオブジェクトとして保存すると、クラウドストレージのリクエスト料金だけで約1,500ドルかかり、アップロードに数日かかる場合があるとされています。1つのPMTilesアーカイブは、そのピラミッド全体を1つのファイルにまとめ、内部で同一のタイルを重複排除します(Protomapsによれば、世界規模のベクターベースマップでサイズを70%以上削減できるとされています)。さらに、S3、Cloudflare R2、GitHub Pagesのような単純な静的ファイルホスティングから、通常のHTTPレンジリクエストで個々のタイルを配信できるため、タイルサーバーもデータベースもサーバーレス関数も必要ありません。もちろん、前段にAWS LambdaやCloudflare Workersを置いて運用することも問題なくできます。

知っておくとよい技術的な事実がいくつかあります。公式のリーダーライブラリはJavaScript、Python、Dart、Kotlin/JVM、Go、C++、Rustに対応しており、フォーマット自体もMapLibre GL JS、Leaflet、OpenLayersで直接サポートされています。PMTilesは設計上、読み取り専用です。既存のアーカイブ内の一部のタイルだけを更新する方法はなく、更新するにはファイル全体を書き直す必要があります。これは、フォーマットのシンプルさと、1ファイル完結・バイトレンジ対応というレイアウトを実現するために意図的に選ばれたトレードオフです。ヘッダー自体は固定で127バイトしかなく、リーダーは1回のリクエストでこれを取得するだけで、タイルを1枚も読み込む前に、アーカイブのズーム範囲、範囲、タイル形式、タイル数を把握できます。

手順ガイド

ステップ1

「PMTilesをアップロード」をクリックして.pmtilesファイルを選択するか、パネルにファイルをドラッグ&ドロップします。あるいは「サンプルPMTilesを試す」をクリックすると、その場で生成された小さなサンプルを読み込めます。

ステップ2

アーカイブ内のタイルがファイルから直接読み取られ、地図上に描画されます。ファイル情報パネルには、タイル数、形式、ズーム範囲、範囲、そしてファイル自身のヘッダーから取得したメタデータが表示されます。

実際の活用例

コードを書かずにPMTilesファイルを直接開くことが、実際に役立つ場面を紹介します。

1. 公開前にPMTilesファイルを確認する。 PMTilesアーカイブを作成・変換した後、静的ファイルホストにアップロードする前に、ここで開いてズーム範囲、範囲、タイル形式が正しいことを確認できます。
2. ダウンロードしたオープンデータセットを検証する。 大きなベースマップの一部を切り出した地域データなど、PMTiles形式で配布されているデータセットは、コードを書く前にそのまま開いて中身を確認できます。
3. MBTilesからPMTilesへの変換結果を検証する。 当サイトのMBTilesからPMTilesへの変換ツールなどでファイルを変換した後、その結果をこのビューアに読み込むことで、すべてのタイルが正しい位置に変換されたかを確認できます。
4. 地図アプリを公開する前にベースマップを確認する。 オフライン対応やセルフホスト型の地図を開発しているチームは、アプリが実際に読み込むPMTilesアーカイブそのものを事前に確認できます。誤ったズーム範囲や空のエリアも、公開前に発見できます。
5. アーカイブされたタイルセットを点検する。 PMTilesは名前、説明、出典表示、範囲といったメタデータを自身の中に保持しているため、外部のドキュメントがなくても、何年も前に作られたアーカイブファイルの内容を特定・確認できます。

よくある質問