Cesium を使ってみる

概要

Cesium は、3次元の地図を Web ブラウザで表示するための JavaScript ライブラリである。ここでは、CesiumJS を入手してローカルサーバで動かし、航空写真の表示、地図の表示、3次元データの取り込みを確認する。

目次

関連する外部ページ

サイト内の関連情報

キーワード:Cesium、3次元地図、JavaScript、航空写真の表示、地図の表示、Cesium のデモサイト

前準備

Node.js のインストール

CesiumJS の同梱サーバの実行には Node.js 22 以降が必要である。

Cesium サーバの準備

  1. Web ページを開く

    https://cesium.com/downloads/

  2. Download CesiumJS」から、CesiumJS の最新版(Cesium-バージョン番号.zip)をダウンロードする
  3. ダウンロードが始まる
  4. ダウンロードした .zip ファイルを展開(解凍)する。C:\ の直下など、分かりやすいディレクトリに置く
    Windows での展開(解凍)に便利な 7-Zip: 別ページ »で説明
  5. Windowsコマンドプロンプトで、Cesium を展開したディレクトリに移動し、次のコマンドを実行する。これは依存パッケージを取得するものである
    npm install
  6. 同じディレクトリで、次のコマンドを実行する。これはポート 8080 番で Web サーバを開設するものである
    npm start
  7. Cesium の確認のため、Web ブラウザで次の URL を開く
    http://localhost:8080
  8. 表示された画面で「Run tests」をクリックする。終了までしばらく待つ
  9. 結果を確認する
  10. 使い終わったら、コマンドプロンプトで Ctrl + C を押して Web サーバを止める

Cesium の航空写真(World Imagery)や地形(World Terrain)は、Cesium ion から配信される。配布版には試用向けのアクセストークンが埋め込まれているが、継続して使う場合は、無料の Cesium ion アカウントを作成して自分のアクセストークンを取得し、Cesium.Ion.defaultAccessToken に設定する(https://ion.cesium.com/tokens)。

Cesium を使ってみる

Cesium の次の機能を確認する。

航空写真の表示、地図の表示

  1. Web ブラウザで次の URL を開く
    http://localhost:8080
  2. Hello World」をクリックする
  3. 地球が表示される
  4. 好きな場所(例:福山大学)を表示してみる
  5. 画面右上の地図の選択のメニュー(Base Layer Picker)を開く
  6. 地図の選択で「Cesium World Terrain」を選ぶと、表示が地形付きに切り替わる。マウス操作で回転させると、地形の起伏を確認できる
  7. 地図の選択で「OpenStreetMap」を選ぶと、表示が切り替わる

3次元オブジェクトの表示機能

  1. Sandcastle」をクリックする。Sandcastle は、Cesium のサンプルを閲覧・編集・実行できるアプリケーションである
  2. ギャラリーのラベルから「3D Tiles」または「Photogrammetry」を選び、写真測量データを表示する例を開く
  3. サンプルを実行する。別ウィンドウで開くこともできる
  4. 地図に 3次元オブジェクトが読み込まれる。マウス操作でズームや回転ができる

Cesium 関連サイトの紹介

3D Tiles サイトの紹介

次の Web ページを開く。

https://github.com/CesiumGS/3d-tiles

3D Tiles は、大規模な 3次元地理空間データを配信・表示するための仕様である。仕様書と、関連するツールやデータのリンク集が公開されている。

Cesium JapanGSI サイトの紹介

次の Web ページを開く。

https://github.com/tilemapjp/Cesium-JapanGSI

国土地理院が提供する地図画像タイルを、Cesium の地図タイルレイヤとして利用するためのライブラリである。国土地理院自身が公開しているデモは次の URL で確認できる。

https://gsi-cyberjapan.github.io/gsitiles-cesium/index.html