ArcGIS API for Python のコンセプト

ArcGIS API for Python のコンセプト

ArcGIS API for Python (以下、Python API) は、Web GIS (ArcGIS Online / ArcGIS Enterprise) を活用してマップと地理空間データを扱うための Python ベースの API です。
Python のベスト プラクティスに基づき、標準的なイディオムやデータ構造を用いた、シンプルで使いやすい設計になっており、GIS データの可視化や解析の実行だけでなく、ユーザー、グループ、アイテムなどを管理するためのシンプルで使いやすいツールを提供します。 さらに、自身が所有しているデータだけでなく、Esri 等が提供するすぐに使えるマップやデータにアクセスすることも可能です。 また、Pandas や Jupyter Notebook といった、他の Python 向けのライブラリやツールとの連携で、より豊富な機能を活用することが可能です。


Python API のアーキテクチャ

Python API は、Web GIS プラットフォームを使用する目的で実装されています。 Python API には、ArcGIS プラットフォーム上で利用するデータやユーザの認証情報など、各オブジェクトを管理して作業するためのモジュール、クラス、関数、およびタイプがあります。

Python API は arcgis パッケージとして配布されています。 このパッケージの中には、最も基本になる gis モジュールを中心に、Web GIS で使用できる機能がさまざまなモジュールとして編成されています。

Python API のモジュールを表したダイアグラム

gisは最も重要なモジュールで、Web GIS への入口となり、ユーザー、グループ、およびコンテンツを管理 (作成、読み込み、更新、削除) する機能を提供します。Web GIS の管理者権限をもつユーザーは、自身の組織のメンバー、グループなどの管理にこのモジュールを使用します。

緑色のモジュールは、さまざまな空間解析に用いる地理情報データセットにアクセスするために使用します。これらのモジュールには、特定のタイプの空間データを操作するための関数、ジオプロセシング処理、ArcGIS で使用できる様々なデータに対応したクラス、およびそれらを補助するようなヘルパー クラスなどが含まれています。

青色のモジュールは、GIS のワークフローをサポートする追加的な機能を提供します。住所から緯度経度を特定するジオコーディング モジュール、フィーチャのジオメトリを表すモジュール、そしてサード パーティーのジオプロセシング ツールをインポートして使用するためのジオプロセシング モジュール等が含まれています。

オレンジ色のモジュールは、GIS データの分析結果を可視化して共有することを可能にします。 widgets モジュールには、Jupyter Notebook でマップとレイヤーを可視化する機能を実装しています。 mapping モジュールには、Web マップと Web シーンに対応し、それぞれのレイヤーを操作するためのタイプと関数があり、apps モジュールは ArcGIS で構築された Web アプリケーションの作成と管理に役立ちます。

各モジュールの詳しい内容は、米国Esri ガイドページ(英語)をご覧ください。


動作要件

Python API は次の環境と動作要件が必要です。

  • オペレーティング システム

    • Windows (32 /64 ビット) /macOS/ Linux
      ※macOS/Linux は国内サポート対象外となります
  • Python バージョン 3.9.x - 3.11

  • 開発環境

※ Jupyter Notebook および Jupyter Lab はオープンソースとして利用できる開発環境のひとつです。 Python API はこれらの開発ツールでの地図出力をサポートしてます。利用可能なブラウザは次の通りですが、詳細については Jupyter Notebook のシステム要件をご覧ください。

  • Google Chrome
  • FireFox
  • Safari

サポートする最新の動作環境につきましては米国Esri システム要件(英語)または、動作環境もご参照ください。


次は、Python API を利用するArcGIS API for Python のための基礎環境:conda入門についてご紹介します。