3次元地図のソフトウェア Cesium を Python から使う

Cesium とは，３次元の「地図」をウエブブラウザで表示するための JavaScript ライブラリ． Cesium を Python から使えるソフトウェア cesiumpy をこのWebページで紹介します．

Web ページ: https://github.com/sinhrks/cesiumpy

謝辞：このページで紹介するソフトウェア等の作者に感謝します．

前準備

Python 3.12 のインストール（Windows 上） [クリックして展開]

以下のいずれかの方法で Python 3.12 をインストールする。Python がインストール済みの場合、この手順は不要である。

方法1：winget によるインストール

管理者権限のコマンドプロンプトで以下を実行する。管理者権限のコマンドプロンプトを起動するには、Windows キーまたはスタートメニューから「cmd」と入力し、表示された「コマンドプロンプト」を右クリックして「管理者として実行」を選択する。

winget install --scope machine --id Python.Python.3.12 -e --silent --disable-interactivity --force --accept-source-agreements --accept-package-agreements --override "/quiet InstallAllUsers=1 PrependPath=1 Include_pip=1 Include_test=0 Include_launcher=1 InstallLauncherAllUsers=1"

--scope machine を指定することで、システム全体（全ユーザー向け）にインストールされる。このオプションの実行には管理者権限が必要である。インストール完了後、コマンドプロンプトを再起動すると PATH が自動的に設定される。

方法2：インストーラーによるインストール

Python 公式サイト（https://www.python.org/downloads/）にアクセスし、「Download Python 3.x.x」ボタンから Windows 用インストーラーをダウンロードする。
ダウンロードしたインストーラーを実行する。
初期画面の下部に表示される「Add python.exe to PATH」に必ずチェックを入れてから「Customize installation」を選択する。このチェックを入れ忘れると、コマンドプロンプトから python コマンドを実行できない。
「Install Python 3.xx for all users」にチェックを入れ、「Install」をクリックする。

インストールの確認

コマンドプロンプトで以下を実行する。

python --version

バージョン番号（例：Python 3.12.x）が表示されればインストール成功である。「'python' は、内部コマンドまたは外部コマンドとして認識されていません。」と表示される場合は、インストールが正常に完了していない。

sinhrks/cesiumpy の設定手順

正確には https://github.com/sinhrks/cesiumpy をご覧ください。私が行った設定手順の記録です．

GitHUB の sinhrks/cesiumpy のWeb ページを開く
https://github.com/sinhrks/cesiumpy
「Clone or download」を展開し，「Download ZIP」をクリック
.zip ファイルのダウンロードが始まるので確認する．
ダウンロードした .zip ファイルを展開（解凍）する．分かりやすいディレクトリに置く．
Windows での展開（解凍）に便利な 7-Zip: 別ページ »で説明

この .zip ファイルは，E:\cesiumpy-master\cesiumpy-master に展開（解凍）したものとして，説明を続けるので，適切に読み替えてください．
Windows では，コマンドプロンプトを 管理者として実行する．
先ほど展開（解凍）したディレクトリに移動
インストールしたいので、次のコマンドを実行
Ubuntu では「sudo python3 setup.py install」
```
python -m pip install -r requirements.txt
python setup.py install
```
（省略）
Jupyter notebook を起動
```
jupyter notebook
```
Python プログラムを動かして，結果を Web ブラウザでビジュアルに見たい．
* 「jupyternotebook」を入れたのに，jupyter notebook が起動しない という場合には，次の操作で，インストールを行ってから，もう一度試してみる．
```
python -m pip install -U jupyterlab jupyter jupyter-console jupytext spyder
```
ここから先は，Jupyter notebook の画面で説明する．
次のプログラムを実行．
```
import cesiumpy
```
次のプログラムを実行．
```
v = cesiumpy.Viewer()
```
次のプログラムを実行．
```
print(v)
```
下の図のようにエラーが出た場合には、もう一度同じことを繰り返す
Jupyter ノートブック (Jupyter Notebook) には Web ブラウザが内蔵されている（Web ブラウザで動く Python 開発環境）． いま表示されている地図はマウスで操作したりできる．