サービス
AmigoCloud API
2026年08月13日 10:47
GISBoxは、OSGB/GEOTIFF/RVTなどの複数のGISフォーマットでの編集をサポートし、3DTiles/Terrainへの変換や公開が可能なワンストップ3DGIS データ編集、変換、公開プラットフォームです。
概要
AmigoCloud APIはクラウドベースの地理空間データサービスのオープンインターフェースです。ユーザーは専用APIキーを使用して認証後、クラウド上のGISデータセットを読み取り、書き込み、検索、管理などの操作が可能です。GDAL/OGRドライバとの互換性があり、ベクターおよびラスター等多种な空間データフォーマットをサポートし、Python開発キットを提供して開発者に統合を容易にしています。モバイル端末でのオフラインデータ収集やマルチデバイスデータ同期などのシナリオに適しています。
構成要素
公開されたGDAL/OGRドライバドキュメントおよびAmigoCloud APIに関する情報をもとに、AmigoCloud APIのファイル/データ構造は以下の層で説明できます：
- プロジェクト（Project）レベル：各AmigoCloudアカウントには複数のプロジェクトを作成可能で、プロジェクトIDはデータへのアクセスの基本単位です。形式は通常、AmigoCloud:<project_id>です。
- データセット（Dataset）レベル：プロジェクト内のデータセット（データベースのテーブルに相当）があり、各データセットには独自のdataset_idと名前があります。アクセスにはdatasets=id1,id2,... パラメータを使用します。
- 要素/レコード（Feature/Record）レベル：データセット内には地理的要素（点、線、面など）が格納され、各要素にはシステムが自動生成するamigo_id（GUID）が一意の識別子として使用されます。また、幾何フィールドと属性フィールドを含みます。
- 幾何フィールド（Geometry）：ポイント、ラインストリング、ポリゴンなどの複数の幾何タイプをサポートし、幾何列はデフォルトでは空（GEOMETRY_NULLABLE=YES）を許可しており、設定により変更可能です。
- 属性フィールド（Attributes）：各要素は任意の数の属性列を持つことができ、型には文字列、数値、日付などが含まれます。属性フィルタ検索もサポートされています。
長所
- GDAL/OGRエコシステムとのシームレスな統合：GDAL/OGRのネイティブドライバとして、ogrinfo、ogr2ogrなどの成熟したコマンドラインツールでクラウドデータに直接アクセス可能であり、クライアントの追加開発が不要で学習コストが低い。
- 完全なCRUD機能：OGR APIを使ってINSERT（CreateFeature）、UPDATE（SetFeature）、DELETE（DeleteFeature）、CREATE TABLE（CreateLayer）、DROP TABLE（DeleteLayer）などのデータベースレベル操作を実現可能で、機能が豊富です。
- 空間と属性の両方のフィルタをサポート：空間フィルタ（SetSpatialFilter）と属性フィルタ（SetAttributeFilter）をサーバー側で実行させることにより、データ送信量を減らし、クエリ効率を向上させます。
- 多形式の対応：GDALドライバ層を通じて40種以上のベクターおよびラスター形式（シェイプファイル、GeoJSON、GeoPackage、FlatGeobufなど）のインポート・エクスポートが可能で、形式の変換が簡単です。
- Python開発キットの提供：公式のPython SDKがあり、スクリプトや自動化フローでクラウドGISデータ操作を簡単に組み込むことができます。
- オフラインと多端同期のシナリオへの適応：特にモバイル端末でオフラインでデータを収集した後、クラウドにアップロードして統一的な管理と同期を行うGISワークフローに適しています。
短所
- ネットワークに依存、オフラインでは使用不可：すべての操作はクラウドサービスへのHTTPSリクエストを通じて行われるため、ネットワークがない場合に完全に利用できず、純粋なオフライン作業には不向きです。
- 頻繁なやりとりでパフォーマンスが低下：大量のクライアントとサーバーとのやりとり（例えば要素を1つずつ挿入する場合）が発生すると、デフォルトの同期公開モードでパフォーマンスが大幅に低下する可能性があります。
- AmigoCloudプラットフォームに強く依存：すべてのサービスはAmigoCloudのバックエンドによって定義され制御されるため、権限や利用可能性、サービスの安定性はこのプラットフォームに依存し、サプライヤーロックのリスクがあります。
- ドキュメントやコミュニティリソースが限られている：ArcGIS OnlineやGeoServerなどの主なクラウドGISプラットフォームと比較すると、AmigoCloudの公開ドキュメントや コミュニティディスカッション、サードパーティチュートリアルは限られているため、問題発生時のトラブルシューティングが困難です。
- プロフェッショナルなGISクラウドプラットフォームに劣る機能深度：高度な空間分析、複雑な編集トランザクション、バージョン管理、細かい権限制御などの企業向けGIS機能が不足しており、複雑な空間処理には不向きで、軽量なデータ管理に適しています。
- 幾何フィールドがデフォルトで空を許可する：GEOMETRY_NULLABLEはデフォルトでYESであり、データの整合性が厳格な場合、明示的に設定する必要があります。設定しないと無効な幾何記録が生成される可能性があります。
応用シーン
AmigoCloud APIは、空間データをクラウドに集中管理し、複数端末間で共有する必要がある場面に適しています。例えば、野外でのオフラインデータ収集後にクラウドにアップロードして統合管理や同期を行うGISワークフローに適しています。また、チームによるGISプロジェクトにも適しており、複数人が同一データセットに対して同時の読み込み・書き込み・更新・削除操作を行うことで、データのリアルタイム更新と共有が可能です。さらに、複数のベクターおよびラスター形式をサポートしているため、クラウド上で異なる形式の空間データの変換と配布にも活用できます。自動化スクリプトや軽量なWebアプリケーションでの空間データサービスのバックエンドとしても利用可能です。
例
1. AmigoCloud地図。
ファイルの開き方
1. 汚染された土地評価。
