AxelGlobe CLI (α)
AxelGlobeとの統合をターミナルから直接 構築、テスト、管理します。 AxelGlobe CLIは、AxelGlobeとの統合をターミナルから直接構築、テスト、および管理するのに役立つ開発者向けツールです。AxelGlobe CLIは、インストールが簡単で、Linuxで動作し、AxelGlobeの開発者エクスペリエンスを向上させるためのさまざまな機能を提供します。
0. 注意
本CLIの開発は近い将来終了する予定になっております。APIの利用を検討することを推奨しております。
1. インストール
要件
axelglobe-cliでは、次の環境がサポートされています。
Linux | Win | MacOS | |
---|---|---|---|
x64 | ○ | ✕ | ✕ |
x86 | ✕ | ✕ | ✕ |
armv6 | ✕ | ✕ | ✕ |
armv7 | ✕ | ✕ | ✕ |
インストール
リリースページからダウンロードします。
- axelglobe-cliの配布を終了しました。
- axelglobe-cliを使用中のお客様におかれましては、AxelGlobe APIを利用することを推奨しておりますが、サポート終了まで引き続きご利用になれます。
- Zip 解凍して適切な場所に移動させ、そのパスをあなたの環境の
$PATH
に追加します。
2. 構成
認証情報の設定
$HOME/.axelglobe
が AxelGlobe Web プラットフォームツールのデフォルトディレクトリとなります。
$HOME/.axelglobe/credentials
に, 認証情報を構成することができます。
axelglobe_access_key_id
: AxelGlobe ユーザーアカウントのEメールアドレス (1.0.0 で, これはトークンアクセスキーに置き換えられる予定です。)axelglobe_secret_access_key
: AxelGlobe ユーザーアカウントのパスワード (1.0.0 で, これはトークンアクセスキーに置き換えられる予定です。)- axelglobe-cli用に設計されたユーザーを使用して、ユーザーを割り当ててください。
Operator
(オペレーター)ロール は、権限に制限があります。 credentials
は複数の認証情報プロファイルを含むことができます。(現時点では、default
プロファイルのみがサポートされています。)
[default]
axelglobe_access_key_id=example@axelspace.com
axelglobe_secret_access_key=SuperSecret
3. はじめてみよう
view id の取得
AxelGlobe 画像製品のダウンロードをリクエストするには、 view
id
が必要です。
View
は、 AOI
、 title
などを含むデータです。
AOI
はArea Of Interestの略語です。AOI
はcell
のセットで構成されています。Cell
は、AxelGlobe Web プラットフォーム上の地理的位置の最小単位です。
$ axelglobe read-views
ダウンロードをリクエストする
取得した view
id
を使用して、キャプチャされた日付を指定してAxelGlobe 画像製品のダウンロードをリクエストできます。
$ axelglobe request-download \
--view-id "VmlldzpkNzIyNjc0NS0yNDA2LTQzMTUtODdkMS1mNzdhZGJhZDI0MDY=" \
--dates "2019-03-02" --dates "2019-03-03" \
--bundle-compression "ZIP" \
--product-format "GEO_TIFF_NO_COMPRESSION"
ダウンロードリクエストのステータスを確認する
- ダウンロードをリクエストすると、
download history
(ダウンロード履歴),id
を取得できます。 - AxelGlobe では、ユーザーがダウンロードするファイルを
download bundle
(ダウンロードバンドル)と呼びます。 download bundle
をダウンロードする準備ができるまで、数分かかります。download history
は、ユーザーがダウンロードをリクエストした履歴です。
# Polling `download history` by id
$ axelglobe read-download-history \
--id "RG93bmxvYWRIaXN0b3J5OmM0MDQ0YmNiLTMxZWUtNGMyNS1iNjE0LTQyN2I5MzFmMTM4Yg=="
バンドルをダウンロード
download history
の status
「ステータス」が READY
に変わるとダウンロード可能です。download history
には複数の download bundle
が含まれます。
バンドルのダウンロードをリクエストすると、バンドルをダウンロードするためのURLを取得できます。
$ axelglobe request-download-bundle \
--download-history-id "RG93bmxvYWRIaXN0b3J5OmJiMzkwYmJiLTdkMzAtNGMyOC1iMWNmLWEyNjlmYTBmMDAwNw==" \
--download-bundle-id "RG93bmxvYWRCdW5kbGU6MjcxYWIwY2YtNGU0YS00ZGRlLTkwNDUtMjU2MGViODJjM2Vm" \
--download-dir "./"
以上で AxelGlobe 画像製品を入手できます!
4. コマンド
axelglobe-cliは help
オプションを提供しています。 すべてのコマンドとその例を見ることができます。
$ axelglobe --help
各コマンドに help
オプションも提供します。 各コマンドオプションの説明を確認できます。
$ axelglobe request-download --help