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