Cesium Ion API
2026年04月29日 14:36
GISBoxは、OSGB/GEOTIFF/RVTなどの複数のGISフォーマットでの編集をサポートし、3DTiles/Terrainへの変換や公開が可能なワンストップ3DGIS データ編集、変換、公開プラットフォームです。
概要
Cesium Ion API は、Cesium が提供するクラウド型インターフェースサービスであり、ホストされている全球の地理空間データ(高精度地形、衛星画像、3Dモデルなど)へアクセスするためのAPIです。認証には Access Token を使用し、開発者は自身のアプリケーションからAPIを呼び出すことで、高品質な3D地理データを迅速に読み込み、没入型の地球可視化を実現できます。また、ユーザー自身の空間データ資産をアップロード・管理する機能も備えており、これらのデータをAPI経由で公開・共有することも可能です。
構成要素
以下は、一般的なCesium関連プロジェクトで見られる典型的なファイル構成を箇条書き形式で説明したものです。
- ルートパスのファイル:index.html(CesiumJSライブラリを読み込み、3D地球シーンを初期化するためのプロジェクトのエントリーページ);package.json(プロジェクトの依存関係、バージョン情報、および実行スクリプトを定義するファイル);README.md(機能、インストール手順、使用方法を説明するプロジェクトドキュメント);server.cjs(ローカルデバッグおよびプレビューのための組み込みNode.jsサーバー設定)。
- Appsフォルダ:CesiumViewer(Viewerインスタンスの初期化方法を示す基本的なビューアサンプル);Sandcastle(APIの使用方法を学習するためのインタラクティブなコードデモ集);SampleData(geoJSON、KML、glTFなどの形式のテストデータリソースを格納)。
- Buildフォルダ:Cesium/(本番環境向けに圧縮されたCesiumJSライブラリ);CesiumUnminified/(ソースコードエラーのデバッグを容易にするための非圧縮版ライブラリ);Documentation/(開発者参照用に生成されたAPIドキュメント)。
- Sourceフォルダ:Jasmineフレームワークを使用したユニットテストケースの集合で、API機能の安定性を確保するための自動テストを実行する。
- Specsフォルダ:業界別のサービスコンポーネントを格納するディレクトリで、スマートリテール、スマート交通、スマート物流、スマートエネルギー、スマート金融などの分野ごとに分かれており、それぞれのモジュールには対応するデータモデルとビジネスロジックが含まれる。
- ThirdPartyフォルダ:CodeMirror(コードエディタ)、Jasmine(テストフレームワーク)、JSHint(構文チェックツール)などのサードパーティ依存ライブラリを格納する。
長所
- 高品質データをすぐに利用可能:Cesium World Terrain、Bing Maps の衛星画像、OSM Buildings など、全球をカバーする高精度データを提供します。地形は最大50cm解像度、画像は最大15cm解像度に対応しており、データ取得のハードルを大幅に下げます。
- 高効率なストリーミング機構D Tiles 標準を使用してデータを分割配信し、ブラウザキャッシュとCDN高速化を組み合わせることで、大規模3Dデータのリアルタイム読み込みを実現します。
- マルチプラットフォーム統合が容易CesiumJSと深く統合されており、簡単なAPI呼び出しで利用可能です。また、ArcGIS や Google Maps などのプラットフォームとも互換性があります。
- カスタムデータのクラウドホスティング対応ユーザーは独自の3Dモデル、点群データ、画像データをアップロードでき、自動的に3D Tiles形式へ変換されクラウドで安全にホスティングされます。これによりチーム間共有やマルチデバイスアクセスが容易になります。
- アジア太平洋地域での性能最適化東京などにエッジノードを配置することで、2023年には日本でストリーミング速度が152%向上、シンガポールでは43%向上し、アクセス遅延が大幅に改善されました。
短所
- ネットワーク依存度が高い:すべてのデータはオンラインで取得する必要があり、オフライン環境では利用できません。そのため、軍事やエネルギーなどのネットワーク制限がある分野では利用が難しい場合があります。
- 無料利用枠が限定的:無料アカウントでは1日あたり500回のAPIリクエスト制限があります。これを超える場合は有料プランへのアップグレードが必要です。また、Access Token が漏洩すると不正利用による高額請求のリスクがあります。
- データ制御の制限:公式データを利用する場合、データ内容や更新頻度をユーザーが自由に変更することはできません。測量や軍事用途など高精度カスタム地形が必要な場合は、オフラインソリューションを構築する必要があります。
- セキュリティおよびコンプライアンスのリスク:Access Token をフロントエンドコードにハードコードし、GitHubなどの公開リポジトリに公開してしまうとトークン漏洩の原因となり、不正利用やコスト増加を招く可能性があります。
- 特定クラウドアーキテクチャへの依存:データは主にAWS S3(米国東部リージョン)に保存されています。アジア太平洋地域にレプリカが存在するものの、越境通信はネットワークポリシーの影響を受ける可能性があり、データ主権の観点から企業によっては独自のオフラインシステムを構築する場合があります。
応用シーン
Cesium Ion API は、高精度3D地理可視化が求められるさまざまな分野で利用されています。例えば、スマートシティにおけるデジタルツイン構築、災害指揮システムにおける災害シミュレーション、航空宇宙分野での衛星や航空機の軌跡追跡、自動運転や地質探査における環境モデリングなどが挙げられます。また、文化観光プロジェクトにおける3Dナビゲーションシステムの開発や、教育・研究分野における地理データの動的可視化にも活用されており、現実の地理環境をベースとした没入型のインタラクションや意思決定支援を可能にします。
例
1. Cesium ion を利用して宇宙スケールまで拡張した可視化を実現する例。

ファイルの開き方
1. 3Dタイルデータを読み込み・表示するためのオブジェクト。

関連地図サービス
Alibaba Cloud AMap
Gaode LBS Cloud
GeoServer REST API
Tencent Maps API
参考
- https://cesium.com/learn/ion/rest-api/
- https://cesium.com/learn/apis/
- https://github.com/CesiumGS/cesium-ion-rest-api-examples/blob/main/README.md