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