TileJSON
2026年03月10日 10:05

GISBoxは、OSGB/GEOTIFF/RVTなどの複数のGISフォーマットでの編集をサポートし、3DTiles/Terrainへの変換や公開が可能なワンストップ3DGIS データ編集、変換、公開プラットフォームです。

概要

TileJSON は、マップタイルレイヤーとその機能を機械可読な JSON 形式で記述するためのオープン標準です。もともとは Mapbox によって同社のマッピングプラットフォーム向けの仕様として開発されましたが、その後コミュニティ主導の標準として広く採用されるようになりました。TileJSON は、ラスタータイル、ベクタータイル、地形タイルなどのタイルセットに関するメタデータを宣言するために使用されます。TileJSON ファイルには、タイルサーバーのエンドポイント URL、タイル形式(PNG、MVT、GeoTIFF など)、空間範囲(bounds)、座標参照系(一般的には Web Mercator - EPSG:3857)、最小および最大ズームレベル、著作権表示(attribution)、その他の説明的メタデータなどの重要な情報が構造化されて含まれます。この標準により、地図クライアント、スタイリングツール、データカタログは、タイルソースの内部構造を事前に理解したり手動設定を行ったりすることなく、自動的にタイルサービスを発見して利用できるようになります。

データフォーマットの概要

TileJSON は、タイルサービスを定義する主要なプロパティを含む構造化された JSON ドキュメントです。主なフィールドには、tiles({z}/{x}/{y} プレースホルダーを含むタイルエンドポイント URL の配列)、識別用の namedescription、必要なクレジット表記を示す attribution、WGS84 座標系で表される地理範囲を示す bounds、利用可能なズームレベルを示す minzoommaxzoom、タイルエンコーディング形式(PNG、MVT など)を指定する format などがあります。また、vector_layers のような拡張フィールドを使用することで、ベクタータイルの属性フィールドに関する詳細なスキーマ情報を提供することも可能です。この軽量で自己記述的な形式により、クライアントはサービスの事前知識がなくても自動的にマップソースを構成できます。

長所

  1. 相互運用性と標準化:TileJSON はタイルサービスを記述するための共通フォーマットを提供し、MapLibre GL、OpenLayers、ArcGIS、QGIS などの TileJSON 対応クライアントが追加の統合コードなしでタイルを取得・表示できます。
  2. シンプルで可読性が高い:JSON 形式は開発者にとって読み書きやデバッグが容易であり、同時に機械処理にも適しています。
  3. 自己記述型タイルサービス:1つの TileJSON ファイルに attribution、bounds、ズームレベル、形式などの必要なメタデータが含まれるため、新しいタイルソースを統合する際の手動設定や推測作業を減らせます。
  4. 広いエコシステムでの採用:ほとんどの現代的な Web マッピングライブラリ、モバイル SDK、デスクトップ GIS ソフトでネイティブにサポートされており、タイルサービス公開の事実上の標準となっています。
  5. 拡張性:JSON 構造を利用して仕様外のカスタムプロパティを追加することができ、後方互換性を保ちながら追加メタデータを提供できます。

短所

  1. タイルサービスに限定:TileJSON はタイルデータ専用の仕様であり、WMS、WFS、Feature API など他の地理空間サービスを記述することはできません。
  2. 実装の不完全性の可能性:すべてのフィールドが必須ではないため、タイル提供者が attribution や bounds など重要な情報を省略する場合があり、クライアント間で表示体験が不一致になることがあります。
  3. 静的ドキュメントである点:TileJSON は通常静的なファイルであり、ズームレベルの追加などタイルサービスの変更を自動的に反映しないため、更新時には手動で修正する必要があります。
  4. ベクタータイルレイヤー情報の不足:vector_layers 拡張は存在するものの採用状況が一様ではなく、属性フィールドの説明が不十分な場合があります。
  5. 標準化された検証機構の欠如:XML スキーマのような厳格な検証フレームワークが普及しておらず、クライアント実装によってはパースエラーが発生する可能性があります。

応用シーン

TileJSON は、事前生成されたタイルサービスを利用する現代の Web およびモバイル地図アプリケーションにおいて、サービス発見と設定の基盤として利用されます。クライアントは TileJSON エンドポイントを参照するだけで、ズーム制限、著作権表示、タイル URL の構築などを自動的に設定できます。ベクタータイルのワークフローでは、スタイル仕様内でデータソースを定義するために TileJSON が参照されることが多く、地理空間データカタログやデータマーケットプレイスでは、タイルレイヤーの公開やメタデータの提供にも利用されます。また、モバイルマッピング SDK では、bounds やズーム範囲を基にオフラインタイルの事前キャッシュ計画に活用されます。TileJSON の強みは、タイルサービスを単なるエンドポイントから自己記述型のリソースへと変換し、地理空間ソフトウェアエコシステム全体にスムーズに統合できる点にあります。

1. TileJSON。


関連地図サービス

GeoWebCache

OpenAerialMap API

GeoServer REST API

Planet Labs API

参考

  1. https://docs.mapbox.com/help/glossary/tilejson/
  2. https://openlayers.org/en/latest/examples/tilejson.html
  3. https://loaders.gl/docs/modules/mvt/formats/tilejson