ArcGIS for Developers 開発リソース集

シンプルな地図アプリの作成 (.NET)

.NET SDK を用いたネイティブ地図アプリの作成方法を紹介します。

開発環境

ArcGIS Runtime SDK for .NET を使用した開発には、Visual Studio が必要です。

また、この後使用するサンプルアプリは ArcGIS Runtime SDK のライブラリを Nuget パッケージとして参照する方法を用いています。 ArcGIS Runtime SDK のライブラリをローカル環境にダウンロードしてお使いになりたい方はローカル環境にダウンロードしてお使いになりたい方はドキュメントダウンロードのページにあるインストールガイドをご覧ください。

なお、ArcGIS Runtime SDK を使用するには ArcGIS Online 開発者アカウントが必要です。作成方法は「開発者アカウントの作成」をご参照ください。

サンプルプロジェクトのダウンロード

このリポジトリ（arcgis-dev-resources）には開発を試してみたい方向けのサンプルコードが含まれています。ダウンロードする際の方法は 2 通りあります。

リポジトリをご自身のアカウントに Fork（複製）
1. GitHub にログインして、arcgis-dev-resources ページを開いて [Fork] をクリックすると、ご自身のアカウントに同じリポジトリが作成されます。
2. Fork 後はご自身のローカルマシンにクローンを作成します。

zip ファイルでダウンロード（※GitHub アカウントをお持ちでない方向け）

arcgis-dev-resources ページを開いて [Download ZIP] をクリックするとプロジェクトファイル一式が手に入ります。

既知の制限

既知の問題により、ソリューションを正しくデバッグ実行するには、ソリューションのクローンもしくはダウンロード先のディレクトリパスに日本語などの 2 バイト文字を含めないでください（※ ArcGIS Runtime SDK for .NET を別途ご使用のマシンにインストールする場合は、この制限事項は適用されません）。

地図の表示

まずはダウンロードしたサンプルプロジェクトを実行してみましょう。

ダウンロードしたサンプルプロジェクト（arcgis-dev-resources/startup/dotnet/map/sample.sln）を Visual Studio で開きます。
mainWindow.xaml.cs の 54 行目にある以下のコードの <Web マップ ID> と記載されている箇所に Web マップの作成で作成した Web マップ ID を上書きします。
```
var item = await ArcGISPortalItem.CreateAsync(portal, "Web マップ ID");
```
まだ Web マップを作成しておらず、すぐに試してみたい方はサンプル Web マップをご利用ください。
サンプルプロジェクトを実行すると、以下のように地図が表示されます。

Web マップを表示するには、ポータルサイトから指定した ID を持つ Web マップを取得し、MapView のマップとして表示します。

住所検索機能の追加

ArcGIS Online のジオコーディングサービスを利用した住所検索機能を追加します。[検索] ボタンをクリックすることで、テキストボックス内の文字列を使用して、住所検索を行うサンプルです。

MainWindow.xaml.cs に住所検索機能で使用する以下のメンバー変数を定義します。
- WORLD_GEOCODE_SERVICE_URL
  ArcGIS Online のジオコーディングサービスの URL です。ArcGIS for Developers の開発者はこのクラウドサービスを利用して住所検索を実行することができます。
- onlineLocatorTask
  住所検索を実行するための OnlineLocatorTask クラスです。
```
//ArcGIS Online ジオコーディングサービスの URL  
private const string WORLD_GEOCODE_SERVICE_URL = "http://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer";
//住所検索用のジオコーディング タスク  
private OnlineLocatorTask onlineLocatorTask;
```
コンストラクター内でメンバー変数として定義した OnlineLocatorTask クラスを初期化します。初期化時のパラメーターとして ArcGIS Online のジオコーディングサービスの URL を指定します。OnlineLocatorTask クラスが住所検索のリクエストを発行する際にこの URL が使用されます。

  /// <summary>  
  /// コンストラクタ  
  /// </summary>  
  public MainWindow()  
  {  
    InitializeComponent();  

    //住所検索用のジオコーディング タスクを初期化  
    onlineLocatorTask = new OnlineLocatorTask(new Uri(WORLD_GEOCODE_SERVICE_URL));  
  }

住所検索に使用する検索文字列などを指定する住所検索パラメーターを作成します。パラメーターの作成には OnlineLocatorFindParameters クラスを使用します。

//住所検索用のパラメータを作成  
OnlineLocatorFindParameters parameters = new OnlineLocatorFindParameters(addressTextBox.Text)  
{  
 MaxLocations = 5,  
 OutSpatialReference = SpatialReferences.WebMercator,  
 OutFields = OutFields.All  
};

OnlineLocatorTask クラスの FindAsync 非同期メソッドを使用して住所検索を実行します。パラメーターとして事前に作成した住所検索パラメーターを指定しています。
```
//住所の検索  
IList<LocatorFindResult> resultCandidates = await onlineLocatorTask.FindAsync(parameters, CancellationToken.None);
```

住所検索を実行し結果の取得に成功したら、検索結果に対して地図上に表示するなどの何らかの処理を実行します。サンプルアプリケーションでは、ジオコーディングサービスから返された検索結果候補の一番最初の検索結果候補（最も一致していると思われる検索結果）を地図上に拡大表示します。

//常に最初の候補を採用  
LocatorFindResult candidate = resultCandidates.FirstOrDefault();  

//最初の候補からグラフィックを作成  
Graphic locatedPoint = new Graphic() { Geometry = candidate.Feature.Geometry };  

//住所検索結果表示用のグラフィックスオーバーレイにグラフィックを追加  
geocodeResultGraphicsLayer.Graphics.Add(locatedPoint);  

//追加したグラフィックの周辺に地図を拡大  
await mainMapView.SetViewAsync((MapPoint)locatedPoint.Geometry, 36112);

アプリの動作が確認できたら ArcGIS の OAuth 認証について学びましょう！

開発環境

サンプル プロジェクトのダウンロード

既知の制限

地図の表示

住所検索機能の追加

サンプルプロジェクトのダウンロード