ArcGIS Pro用マイルパードルアドイン

m_d

<\/HEAD>

これは何ですか？<\/H3>このArcGIS Pro Add-inは、私の古いFlexウェブアプリケーション<\/A>の再構築版です。その目的は「1ドル分の燃料でどれだけ遠くまで運転できるか？」という質問に答えることです。ここで「燃料」という言葉に注目してください。なぜなら、乗用車でももはやガソリンだけで動くわけではなく、ハイブリッド車、ディーゼル車、電気自動車などが存在するからです。このアプリケーションの燃費データは米国環境保護庁（United States Environmental Protection Agency）<\/A>から取得しており、彼らのデータや方法論についての情報も見つけることができます。<\/P>

<\/P>

使い方<\/H3>ArcGIS Pro 1.4または1.4.1がインストールされていることを確認してください。<\/P>Add-inファイルをダウンロードしてください こちら（ArcGIS Pro 1.4または1.4.1用）<\/A><\/SPAN> または こちら（ArcGIS Pro 2.0用）<\/A><\/SPAN>。<\/LI>Add-inファイルをダブルクリックしてインストールします。<\/LI>ArcGIS Proを起動し、マップを挿入または開いてください。<\/LI>Add-Inペインの「Miles Per Dollar」ボタンをクリックします。<\/LI>1台から5台の車両を選択してリストに追加します。<\/LI><\/UL>

ユーザーインターフェースでは、年式、メーカー、モデル、タイプの順に選択する必要があります。<\/P>

<\/P>

• 「Start Analysis」をクリックし、その後アクティブなマップ上のポイントをクリックします。<\/LI>
• 結果はグラフィックとしてマップ上に配置されます。<\/LI><\/UL>

  結果は効率の高い順（最長から最短の走行距離）に並べられています。<\/P>

  <\/P>

  • 「Save Results」をクリックして分析グラフィックをフィーチャクラスに保存します。<\/LI><\/UL>

    車両と結果に関するすべてのデータはフィーチャクラスの属性として保存されます。<\/P>

    <\/P>

    <\/P>

技術的詳細<\/H3>まず重要なステップとして、ArcGIS Pro 1.4用Visual Studioプロジェクトを使用する前におそらく必要になることがあります。私のPro 1.4.1開発マシンではArcGIS ProがEドライブにインストールされているため、プロジェクトで参照されているアセンブリはすべてそのドライブ上のパスになっています。プロジェクトをコンパイルする前にVisual Studioで「Pro Fix References」ツールを実行する必要があるでしょう。私のPro 2.0開発マシンではすべてCドライブにインストールされており、そのバージョンのコードを使う場合は問題ないと思います。<\/P><\/P><\/P>これはSDKプロジェクトであり、add-inボタンとDockPaneとして実装されています。以下はいくつか使用しているパターンと技術です。<\/P><\/P>状態に基づくMVVMコントロールの有効化／無効化<\/LI><\/UL>ユーザーが迷わないように可能な限り誘導し、その時点で使用すべきでないボタンやドロップダウンは非表示または無効化しています。これは標準的なMVVM手法であり、ComboBoxアイテムで使われている様子が内で見られます。ComboBoxのIsEnabledプロパティへの{Binding}文を確認すると、それらが内の参照されたプロパティとValueConvertersによって制御されていることがわかります。ボタンは主に内で定義された(delegate command)アイテムにバインドされています。ボタン有効化・無効化にはBooleanメソッド（CanAddSelectedVehicle(), CanStartSAAnalysis()など）が使われています。<\/P>RESTジオプロセシングサービスの利用<\/LI><\/UL>ArcGIS Proドキュメントではローカル*.agsファイルを作成・使用し、それを使ってジオプロセシングサービスを実行することが推奨されています。しかし、このAdd-inではそのようなファイルを配布したくなかったため、HTTP呼び出しを.NETコードから直接行う方法を選びました。簡単にするためにGPサービスは公開共有設定としており、認証トークン取得について心配する必要がありませんでした。<\/P>
一つ問題だったのは、すべてのジオプロセシングパラメータが.NETオブジェクトとして設定・シリアライズ可能ではないことです。そのため、一部はPerformAnalysis()メソッド内でJSON文字列を直接構築しています。
sStartLocParam = "{\"geometryType\":\"esriGeometryPoint\",\"features\":
   [{\"geometry\":" + sStartGeom + "}]}";
A PropertyChangedBase を使ったカスタムモデルクラスへのバインディング<\/LI>Application state は主にモデルレベルのプロパティやクラスで表現されています。「Start Analysis」ボタンはSelectedVehiclesリストに少なくとも一台車両が入っていないと有効にならず、「Save Results」ボタンもResultsリストに少なくとも一つ分析結果がないと有効になりません。この仕組みは最初から問題なく機能しましたが、VehicleクラスやResultクラスの値がテキストボックスやツールチップに表示されないことがありました。その原因はこれらクラスが値変更時にバインディング機構へ通知するための仕組み（INotifyPropertyChangedなど）を持っていなかったためであり、ベースクラスをobjectからPropertyChangedBaseへ変更したことで解決しました。ユーザー代理でカスタムMapToolをプログラム的に呼び出す方法<\/LI>私はシンプルで案内されたワークフローを望みました：複数台車両を選択し、関心エリアへ移動し、その後開始地点をクリックして分析実行。しかし調査したところマップ上でマウスクリック位置を取得できる唯一の方法はMapTool経由でした。このツールは通常ArcGIS Proツールバー上のボタンとして存在し、それをクリックしてからマップ上クリック操作となります。この実装だとユーザーには不便だと思いました：車両選択後、分析開始にはツールバーへ戻ってボタン押下という操作になるためです。そのためMapToolボタン自体は提供せず、「Start Analysis」ボタンから非表示MapToolを検索して呼び出す方式としました。このロジックは内StartSAAnalysis()メソッドで確認できます。分析サービスについて
走行可能エリア計算サービスは基本的にはNetwork Analystサービスエリア操作です。米国限定（ガソリン価格情報対象地域）の最適化された道路階層データを使用しています。このAdd-inでは燃費と燃料価格データをメートル単位へ変換し、その距離情報をパラメータとしてサービスへ送信します。サービスが走行エリアポリゴン生成後、それら周囲へ境界円も生成しますが現在これら円は利用していません。ただ将来的には活用する可能性があります。今後の展望

このアイデアは拡張可能です。保存されたフィーチャクラスへ自動的にカラースケール（カラーマップ）適用し、ArcGIS Proによるランダム単色シンボロジー適用よりも視覚的効果向上させることが考えられます。</ P >< P >ポリゴンを3D空間で押し出して表示し、結果同士比較するよりグラフィカルな方法も検討しています。またRESTジオプロセシングサービスから返される最小境界円も現在無視していますが、それらも2Dまたは3Dコンテキスト提供へ活用可能です。</ P >< P >多数分析結果探索用途向けにはMiles per Dollar分析MapToolを分析完了後も有効化したまま残しています。ただしタッチスクリーン利用者の場合、結果表示後パンやズーム操作したい場合もあるでしょう。</ P > MapToolがアクティブな状態で、これにより新しい分析が開始されますが、これはおそらくユーザーが望んでいることではありません。改善点としては、タッチ入力デバイスを検出し、分析が完了した後にナビゲーションツールを有効にすることが考えられます。<\/P>

<\/P>

リソース／リンク<\/H3>Add-in<\/H5>ArcGIS Pro 1.4\/1.4.1用：
https:\/\/apl.maps.arcgis.com\/home\/item.html?id=10b707923f1a485eb61249945cc44e0c<\/A><\/P>

ArcGIS Pro 2.0用：

https:\/\/apl.maps.arcgis.com\/home\/item.html?id=a92f391d071b4fbc8b7eb22d79e19d40<\/A><\/P>

ソースコード<\/H5>https:\/\/github.com\/markdeaton\/milesperdollar-pro-addin-cs<\/A><\/P>

このリポジトリには2つのブランチがあります。 "master" はVisual Studio 2015のプロジェクトおよびProバージョン1.4x用のコードです。 "Pro_2.0" はVisual Studio 2017のプロジェクトおよびProバージョン2.0用のコードです。<\/P><\/BODY><\/HTML>