ArcGIS API for Silverlight スタートアップガイド (v2.x) Expression ...

ArcGIS API for Microsoft Silverlight スタートアップガイド Expression Blend 4 用

ArcGIS API for Microsoft Silverlight スタートアップガイド (v2.x)

目次はじめに................................................................................................ 2 このスタートゕップガ゗ドについて ............................................................ 2 ArcGIS API for Microsoft Silverlight とは ................................................... 2 ArcGIS API for Microsoft Silverlight の開発環境 .......................................... 3 Web マッピングアプリケーションの開発 .................................................... 4 API ラ゗ブラリの゗ンストール .................................................................. 4 Web マッピングゕプリケーションの開発 ................................................... 14 新規プロジェクトの作成 ......................................................................... 14 Map コントロールの追加 ........................................................................ 17 Navigation コントロールの追加 ............................................................... 28 OverviewMap コントロールの追加 ........................................................... 35 HeatMapLayer クラスの追加 .................................................................. 43 次のステップ ........................................................................................ 59 ArcGIS Resource Center Silverlight API ................................................... 59 トピックス ........................................................................................... 65 Map コントロールの Layers プロパテゖ ..................................................... 65 レ゗ヤの種類 ........................................................................................ 66 マップサービスレ゗ヤ ......................................................................... 68

Copyright ESRI Japan Corporation. All rights reserved.


マップサービスレ゗ヤの REST エンドポ゗ント .......................................... 69 フゖーチャレ゗ヤ ................................................................................. 71 フゖーチャレ゗ヤの REST エンドポ゗ント ............................................... 72 その他のレ゗ヤ ..................................................................................... 78



ArcGIS API for Microsoft Silverlight スタートアップガイド（バージョン 2.x） Microsoft Expression Blend 4 用

pg. 1 Copyright ESRI Japan Corporation. All rights reserved.


はじめに

このスタートアップガイドについてこのスタートゕップガ゗ドは初めて ArcGIS API for Microsoft Silverlight を使用して Web マッピングゕプリケーションを構築する開発者の方に最も基本的な開発手順の流れを紹介するものです。本書をお読み頂くことで、ArcGIS API for Microsoft Silverlight ラ゗ブラリの入手方法およびラ゗ブラリを使用した Web マッピングゕプリケーション開発の基礎を理解することができます。

ArcGIS API for Microsoft Silverlight とは

ArcGIS API for Microsoft Silverlight とは ArcGIS Web Mapping の一つであり、 Microsoft Silverlight の高い操作性・表現力と ArcGIS Server

や Bing Maps

などのオンラ゗ン GIS リソースを統合したゕプリケーションを開発するために提供される API ラ゗ブラリです。 ArcGIS Web Mapping の詳細は下記をご参照ください。 ArcGIS Web Mapping： http://www.esrij.com/products/arcgis/developer/arcgis-web-mapping/



ArcGIS API for Microsoft Silverlight の開発環境

本ガ゗ドでは以下の環境にて ArcGIS API for Microsoft Silverlight を用いた Web マッピングゕプリケーションの開発手順を紹介します。本ガ゗ドの手順を実行する前に以下の環境がご使用のマシンに適切にセットゕップされている必要があります。 Microsoft Expression Blend 4 本ガ゗ドで使用する Microsoft Expression Blend は、Silverlight ゕプリケーションのユーザ゗ンタフェースを設計するためのデザ゗ンツールです。コードとデザ゗ンを分離しながらも、Expression Blend と Visual Studio 間で同じプロジェクトフゔ゗ルの共有が可能なため、開発者やデザ゗ナーは、それぞれの役割に集中しながら、効率的に開発を進めることが可能です。 ArcGIS API for Microsoft Silverlight がサポートする最新の動作環境につきましては下記をご参照ください。 ArcGIS API for Microsoft Silverlight 動作環境： http://www.esrij.com/products/arcgis/developer/arcgis-web-mapping/arcgisapi-for-silverlight/environments/



Web マッピングアプリケーションの開発

API ライブラリのインストール ArcGIS API for Microsoft Silverlight を用いて Web マッピングゕプリケーションを開発するにはまず API ラ゗ブラリを入手する必要があります。以下の手順に従い ArcGIS Resource Center から API を゗ンストールしてください（以下の手順はバージョン 2.0 のものです）。 1.

ArcGIS Resource Center にゕクセスします。 ArcGIS Resource Center： http://resources.arcgis.com/ja/content/



2.

ページ左下の ArcGIS Products 一覧から [Web] または [Server] をクリックします。ここでは、[Server] をクリックします。

3.

ArcGIS Server の製品ページに移動します。ページ左の [Web APIs] をクリックします。

4.

ArcGIS Web Mapping のページに移動します。[ArcGIS API for Microsoft Silverlight/WPF] または画像をクリックします。



5.

ArcGIS API for Microsoft Silverlight のページに移動します。ページ内の [download] リンクをクリックします。

6.

ページの手順に従いダウンロードを行います。まず [Sign in] をクリックします。

7.

ESRI グローバルゕカウントを使用してログ゗ンします（グローバルゕカウントをお持ちでない場合は、[Create a new ESRI Global Account] をクリックしてゕカウントを作成してください）。



8.

手順 (6) のページに戻り、[ArcGIS API for Microsoft Silverlight/WPF download page] をクリックします。

9.

ラ゗センス使用許諾条項に同意する場合は [I agree to the terms and conditions] のチェックボックスをオンにして [Submit] をクリックします。



10. [Download] をクリックし、゗ンストールを開始します。

11. フゔ゗ルのダウンロード - セキュリテゖの警告ダ゗ゕログにて [実行] ボタンをクリックします。

12. [ArcGISSilverlightWPF2x.exe] が一時フォルダにダウンロードされます



13. Internet Explorer - セキュリテゖの警告ダ゗ゕログにて [実行する] ボタンをクリックします。

14. [Next] をクリックします。



15. 使用許諾契約書に同意する場合は [I accept the license agreement] を選択し、[Next] をクリックします。



16. API ラ゗ブラリの゗ンストールデゖレクトリと゗ンストールするコンポーネント※を選択し、[Next] をクリックします。

※

現在、日本国内では、API とともに提供されるゕプリケーションテンプレート（[Expression Blend Templates] および [Visual Studio Templates] ）はサポートされておりません。ゕプリケーションテンプレートについては、次のステップの「Samples： Template Gallery」をご参照ください。



17. [Next] をクリックします。

18. ゗ンストールが開始されます。



19. ゗ンストールが完了したら [Finish] をクリックします。



Web マッピングアプリケーションの開発以下の手順では Expression Blend 4 を用いて ArcGIS API for Microsoft Silverlight を使用した Web マッピングゕプリケーションのサンプルを作成します（※本スタートゕップガ゗ドではコードビハ゗ンドのプログラミング言語として C# を使用します）。

新規プロジェクトの作成

1.

Expression Blend 4 を起動し、[フゔ゗ル] > [新しいプロジェクト] をクリックします。



2.

新しいプロジェクトダ゗ゕログにて、[プロジェクトの種類] から [Silverlight]、[プロジェクト] 一覧から [Silverlight ゕプリケーション + Web サ゗ト] を選択します。[言語] のドロップダウンリストから [Visual C#] 、 [バージョン] のドロップダウンリストから [4.0] を選択します。必要に応じて [名前]、[場所]（ソリューションの格納デゖレクトリ）を変更して [OK] ボタンをクリックします。



3.

新しい Silverlight ゕプリケーションのプロジェクトと Silverlight ゕプリケーションをホストするための Web プロジェクトを含むソリューションが作成されます。



Map コントロールの追加

以下では Web マッピングゕプリケーション上に地図を表示させるために Map コントロールを追加する手順を紹介します。 1.

プロジェクトに ArcGIS for Microsoft Silverlight API ラ゗ブラリの参照設定を追加します。左側の [プロジェクト] パネルで、Silverlight ゕプリケーションを展開します。[参照] フォルダを右クリックし、[参照の追加] をクリックします。



2.

参照の追加ダ゗ゕログにて、API ラ゗ブラリの゗ンストールデゖレクトリ（例：C:\Program Files\ESRI SDKs\Silverlight\v2.x）に移動します。 [ESRI.ArcGIS.Client.dll] を選択して [開く] ボタンをクリックします。

3.

Silverlight ゕプリケーションプロジェクトに API ラ゗ブラリの参照が追加されたことを確認します。



4.

Expression Blend 4 の画面左端の [ツール] パネルから [ゕセット] ツールをクリックし、ゕセットパネルの [場所] カテゴリを展開します。ラ゗ブラリ一覧から [ESRI.ArcGIS.Client.dll] を選択すると、右側に Map コントロールと ScaleBar コントロール、TileEffect 効果が表示されます。

5.

MainPage.xaml のデザ゗ンビューに、Map コントロールをドラッグ＆ドロップします。



6.

Map コントロールのサ゗ズを画面左端のツールパネルの [選択内容] ツール、もしくは画面右の [プロパテゖ] パネルにある [レ゗ゕウト] カテゴリで設定します。

7.

[プロパテゖ] パネルにある Map コントロールの Name 属性を指定して、「MyMap」という名前を付けます。



8.

追加した Map コントロールに表示するレ゗ヤを追加します。 [プロパテゖ] パネルの [Map Settings] カテゴリを展開し、Layers (コレクション) の […] ボタンをクリックします。

9.

Layer コレクションエデゖター：Layers ダ゗ゕログが表示されます。[別のゕ゗テムを追加] ボタンをクリックします。



10. オブジェクトの選択ダ゗ゕログにて、[ArcGISTiledMapServiceLayer] を選択し、[OK] ボタンをクリックします。



11. Layer コレクションエデゖター：Layers ダ゗ゕログの右側のプロパテゖセクションの Url 欄にある [▼] ボタンをクリックします。



12. プロパテゖダ゗ゕログエデゖターダ゗ゕログの Service Browser として [arcgis online] を展開します。[World Street Map] を選択し、[OK] ボタンをクリックします。



13. Layer コレクションエデゖター：Layers ダ゗ゕログにて、プロパテゖセクションの共通プロパテゖの Url に以下の URL が入力されていることを確認し、[OK] ボタンをクリックします。 [http://services.arcgisonline.com:80/ArcGIS/rest/services/World_Stre et_Map/MapServer]



14. プロジェクトを実行します。Expression Blend 4 のメニューから [プロジェクト] を選択し、[プロジェクトの実行] をクリックします。



プロジェクトが開始され、Web マッピングゕプリケーションがブラウザに表示されます。

この時点でマウスによるドラッグやマウスホ゗ールで地図のナビゲーション操作が可能です。Web マッピングゕプリケーションが正常に実行されていることが確認できたらゕプリケーションを閉じてください。



Navigation コントロールの追加

以下では Web マッピングゕプリケーションに地図のナビゲーション操作を行うための Navigation コントロールを追加する手順を紹介します。 1.

プロジェクトに ArcGIS Silverlight API ラ゗ブラリの参照設定を追加します。左側の [プロジェクト] パネルで Silverlight ゕプリケーションを展開します。[参照] フォルダを右クリックし、[参照の追加] をクリックします。



2.

参照の追加ダ゗ゕログにて、API ラ゗ブラリの゗ンストールデゖレクトリ（例：C:\Program Files\ESRI SDKs\Silverlight\v2.x）に移動します。 [ESRI.ArcGIS.Client.Toolkit.dll] を選択して [開く] ボタンをクリックします。

3.




4.

Expression Blend 4 の画面左端のツールパネルから [ゕセット] ツールをクリックし、ゕセットパネルの [場所] カテゴリを展開します。ラ゗ブラリ一覧から [ESRI.ArcGIS.Client.Toolkit.dll] を選択すると、右側に Navigation コントロール等のコントロールが表示されます。

MainPage.xaml のデザ゗ンビューに、 Navigation コントロールをドラッグ＆ドロップします。



5.

Navigation コントロールのサ゗ズや配置位置を画面左端のツールパネルの [選択内容] ツール、もしくは画面右の [プロパテゖ] パネルにある [レ゗ゕウト] カテゴリで設定します。

6.

[プロパテゖ] パネルにある Navigation コントロールの Name 属性を指定して、「MyNavigation」という名前を付けます。



この状態でゕプリケーションを実行すると Navigation コントロールがすでに追加されていますが、Navigation コントロールを操作しても地図のナビゲーション操作を行うことはできません。Navigation コントロールを動作させるには Map コントロールと Navigation コントロールを関連付ける必要があります。 7.

Navigation コントロールを選択した状態で [プロパテゖ] パネルの [共通プロパテゖ] カテゴリの Map 欄にある [□]（詳細オプション）ボタンをクリックします。

8.

Map の詳細オプションのポップゕップメニューから [データバ゗ンド...] をクリックします。



9.

データバ゗ンドの作成ダ゗ゕログにて、[要素プロパテゖ] パネルのシーン要素一覧の中から [MyMap] を選択し、[OK] ボタンをクリックします。

上記の設定により Navigation コントロールによってナビゲーション操作が行われる Map コントロールが MyMap に設定されます。



10. プロジェクトの実行を行い、Navigation コントロールが追加され、地図ナビゲーション操作が行えることを確認します。Web マッピングゕプリケーションが正常に実行されていることが確認できたらゕプリケーションを閉じてください。



OverviewMap コントロールの追加

以下では Web マッピングゕプリケーションに地図の概観図を表示するための OverviewMap コントロールを追加する手順を紹介します。 1.

Expression Blend 4 の画面左端のツールパネルから [ゕセット] ツールをクリックし、ゕセットパネルの [場所] カテゴリを展開します。ラ゗ブラリ一覧から [ESRI.ArcGIS.Client.Toolkit.dll] を選択すると、右側に OverviewMap コントロール等のコントロールが表示されます。

2.

MainPage.xaml のデザ゗ンビュー内の Map コントロール上に、 OverviewMap コントロールをドラッグ＆ドロップします。



3.

OverviewMap コントロールのサ゗ズや配置位置を画面左端のツールパネルの [選択内容] ツール、もしくは画面右の [プロパテゖ] パネルにある [レ゗ゕウト] カテゴリで設定します。

4.

[プロパテゖ] パネルにある OverviewMap コントロールの Name 属性を指定して、「MyOverviewMap」という名前を付けます。



5.

OverviewMap コントロールを選択した状態で [プロパテゖ] パネルの [共通プロパテゖ] カテゴリの Map 欄にある [□] ボタン（詳細オプション）をクリックします。

6.

Map の詳細オプションのポップゕップメニューから [データバ゗ンド...] をクリックします。



7.

データバ゗ンドの作成ダ゗ゕログにて、[要素プロパテゖ] パネルのシーン要素一覧の中から [MyMap] を選択し、[OK] ボタンをクリックします。

上記の設定により OverviewMap コントロールによって地図の概観図が表示される Map コントロールが MyMap に設定されます。



8.

OverviewMap コントロールに表示するレ゗ヤを指定します。OverviewMap コントロールを選択した状態で [プロパテゖ] パネルの [共通プロパテゖ] カテゴリの Layer 欄にある [新規作成] ボタンをクリックします。

9.

オブジェクトの選択ダ゗ゕログにて、[ArcGISTiledMapServiceLayer] を選択し、[OK] ボタンをクリックします。



10. [共通プロパテゖ] カテゴリの Layer サブカテゴリにある Url 欄の [▼] ボタンをクリックします。

11. プロパテゖダ゗ゕログエデゖターダ゗ゕログの Service Browser として [arcgis online] を展開します。[World Imagery] を選択し、[OK] ボタンをクリックします。



12. [共通プロパテゖ] カテゴリの Url に以下の URL が入力されていることを確認します。 [http://services.arcgisonline.com:80/ArcGIS/rest/services/World_Ima gery/MapServer]

上記の設定により OverviewMap コントロールによって表示される地図の概観図のレ゗ヤが設定されます。



13. プロジェクトの実行を行い、OverviewMap コントロールが追加され、地図の概観図が表示されていることを確認します。Web マッピングゕプリケーションが正常に実行されていることが確認できたらゕプリケーションを閉じてください。



HeatMapLayer クラスの追加

以下では Web マッピングゕプリケーションにポ゗ントの密度を表すヒートマップレ゗ヤを追加します。また、ヒートマップレ゗ヤが密度解析を行う際に使用するセルサ゗ズを変更するためのスラ゗ダーを追加する手順を紹介します。 ※

ヒートマップレ゗ヤとは、分析対象や主題となるデータに含まれる地物や事象の頻度や程度、密度などを色別に表現し、可視化したものです。顧客情報や交通事故情報などの分布状況を表現するのに適しています。

※

以下の手順では、GUI による操作以外に一部コーデゖングが必要になります。

1.

プロジェクトに ArcGIS Silverlight API ラ゗ブラリの参照設定を追加します。左側の [プロジェクト] パネルで、Silverlight ゕプリケーションを展開します。[参照] フォルダを右クリックし、[参照の追加] をクリックします。



2.

参照の追加ダ゗ゕログにて、API ラ゗ブラリの゗ンストールデゖレクトリ（例：C:\Program Files\ESRI SDKs\Silverlight\v2.x）に移動します。 [ESRI.ArcGIS.Client.Toolkit.DataSource.dll] を選択して [開く] ボタンをクリックします。

3.




4.

MainPage.xaml のデザ゗ンビューで、Map コントロールを選択した状態で、画面右の [プロパテゖ] パネルの [Map Settings] カテゴリを展開し、 Layers（コレクション）欄の […] ボタンをクリックします。

5.

Layer コレクションエデゖター：Layers ダ゗ゕログが表示されます。[別のゕ゗テムを追加] ボタンをクリックします。



6.

オブジェクトの選択ダ゗ゕログにて、[HeatMapLayer] を選択し、[OK] ボタンをクリックします。



7.

Layer コレクションエデゖター：Layers ダ゗ゕログの右側のプロパテゖセクションに以下の値を入力し、[OK] ボタンをクリックします。 ID：「RandomHeatMapLayer」（レ゗ヤの ID） Opacity：「0.75」（透過率） Intensity：「20」（密度解析を行うためのセルサ゗ズを定義する値）



8.

MainPage.xaml の XAML ビューを開き、＜esri：HeatMapLayer＞タグ内に以下のコードが記入されていることを確認します。

9.

＜esri：HeatMapLayer＞タグ内に以下の゗ベントを追加します。

10. 手順 9 で追加した゗ベントのコードビハ゗ンドを記述します。 MainPage.xaml のデザ゗ンビューを開き、左側の [プロジェクト] パネルで、MainPage.xaml フゔ゗ルを展開し、MainPage.xaml.cs フゔ゗ルをダブルクリックします。



11. MainPage.xaml.cs のコードビューを開きます。

12. MainPage.xaml.cs に using ステートメントおよび手順 9 で追加した゗ベントの処理をコードビハ゗ンドフゔ゗ルに追加します。゗ベント処理では、例としてランダムに発生させた 1000 のポ゗ントをヒートマップレ゗ヤに追加しています。・・・ using ESRI.ArcGIS.Client.Toolkit.DataSources;

namespace SilverlightApplication1 { ・・・ private void HeatMapLayer_Initialized＾ (object sender, EventArgs e) { pg. 49 Copyright ESRI Japan Corporation. All rights reserved.


HeatMapLayer layer = sender as HeatMapLayer; Random rand = new Random(); for (int i = 0; i < 1000; i++) { double x = rand.NextDouble() * 40037507.0671618 - 19971868.8804086; double y = rand.NextDouble() * 40037507.0671618 - 19971868.8804086; layer.HeatMapPoints.Add＾ (new ESRI.ArcGIS.Client.Geometry.MapPoint(x, y)); } } }

※

「・・・」は省略記号を示します。実際のコードは、予め記入されているコードを省略せずに書いてください。

※

「^」は継続記号を示します。実際のコードでは「^」を削除し、改行を行いません。





13. プロジェクトの実行を行い、ポ゗ントの密度を表すヒートマップレ゗ヤが追加されていることを確認します。Web マッピングゕプリケーションが正常に実行されていることが確認できたらゕプリケーションを閉じてください。



14. ヒートマップレ゗ヤのポ゗ントの密度解析を行うためのセルサ゗ズを変更するスラ゗ダーを追加します。Expression Blend 4 の画面左端のツールパネルから [ゕセット] ツールをクリックし、ゕセットパネルの [コントロール] カテゴリを選択すると、右側に Slider 等のコントロールが表示されます。

15. MainPage.xaml のデザ゗ンビューに Slider コントロールをドラッグ&ドロップします。



16. Slider コントロールのサ゗ズや配置位置を画面左端のツールボックスの [選択内容] ツール、もしくは画面右の [プロパテゖ] パネルにある [レ゗ゕウト] カテゴリで設定します。

17. [プロパテゖ] パネルにある Slider コントロールの Name 属性を指定して、「MyIntensitySlider」という名前を付けます。



18. Slider コントロールの最大値および最小値を設定します。Slider コントロールを選択した状態で [プロパテゖ] パネルの [共通プロパテゖ] カテゴリの Maximum 欄に「100」、Minimum 欄に「1」を指定します。

19. ヒートマップレ゗ヤに追加したポ゗ントの密度解析を行うためのセルサ゗ズを変更するために HeatMapLayer クラスと Slider コントロールを関連付けます。Slider コントロールを選択した状態で [プロパテゖ] パネルの [共通プロパテゖ] カテゴリの Value 欄にある [□]（詳細オプション）ボタンをクリックします。



20. Value の詳細オプションのポップゕップメニューから [データバ゗ンド...] をクリックします。



21. [データバ゗ンドの作成] ダ゗ゕログにて、[要素プロパテゖ] パネルのシーン要素一覧の中から [MyMap] を選択し、[カスタムパス式の使用] チェックボックスにチェックを入れ、以下の式を入力します。 Layers[RandomHeatMapLayer].Intensity

バ゗ンドの方向の、[TwoWay] ラジオボタンにチェックを入れ、[OK] ボタンをクリックします。



上記の設定により、Slider コントロールによって操作される値が Map コントロール（MyMap）内のヒートマップレ゗ヤの Intensity に設定されます。 22. プロジェクトの実行を行い、スラ゗ダーの移動によって、密度解析を行うためのセルサ゗ズが変更されることを確認します。

以上でサンプルゕプリケーションの開発は終了です。 ※

本ガ゗ドでは Expression Blend の GUI の操作（コントロールやレ゗ヤの追加）によって自動的に生成された XAML コードについては解説を省略しております。コーデゖングについての説明は Microsoft Visual Studio 2010 版のスタートゕップガ゗ドに記載されておりますので、そちらをご参照下さい。



次のステップ本スタートゕップガ゗ドでは ArcGIS API for Microsoft Silverlight を用いた Web マッピングゕプリケーションを開発するための最も基本的な開発手順について紹介しました。今後、より高度なゕプリケーションを開発するためにはまず ArcGIS Resource Center をご参照ください。ArcGIS Resource Center には API の開発に必要となる参考ドキュメントやサンプルがすべて集約されています。

ArcGIS Resource Center Silverlight API http://help.arcgis.com/en/webapi/silverlight/index.html



Samples：Interactive SDK http://help.arcgis.com/en/webapi/silverlight/samples/start.htm

API を用いたラ゗ブサンプルとその開発コードです。はじめて API による開発を行う場合はまずこのサンプルと同じ Web ゕプリケーションを作成してみることをお勧めします。



Samples：Symbol Gallery http://help.arcgis.com/en/webapi/silverlight/samples/SymbolGalleryWeb/start.htm

グラフゖックレ゗ヤなどのシンボル表現に使用できるポ゗ント、ラ゗ン、ポリゴン用のシンボルギャラリーです。ギャラリー内の XAML をコピー & ペーストするだけでシンボルをゕプリケーションで利用することができます。



Samples：Template Gallery http://help.arcgis.com/en/webapi/silverlight/samples/TemplateGalleryWeb/start.htm

ArcGIS API for Microsoft Silverlight のゕプリケーションテンプレートギャラリーです。背景地図切り換えや概観図といった基本機能を備えたテンプレートゕプリケーションのソリューションをダウンロードすることができます。

テンプレートギャラリーのテンプレートのうち、一部のテンプレートについては日本語化されたテンプレートのサンプルを ESRI ジャパンの製品ページからダウンロードすることもできます。 ArcGIS API for Microsoft Silverlight ダウンロード： http://www.esrij.com/products/arcgis/developer/arcgis-web-mapping/arcg is-api-for-silverlight/downloads/



Concepts http://help.arcgis.com/en/webapi/silverlight/help/index.html

API の概要、地図の追加や ArcGIS サービスの利用方法などの各種開発手法をまとめた開発者ヘルプです。

API Reference http://help.arcgis.com/en/webapi/silverlight/apiref/api_start.htm

API のリフゔレンスです。API に含まれるクラスの各種プロパテゖ、メソッド等を確認することができます。



Code Gallery http://help.arcgis.com/en/webapi/silverlight/gallery.html

実際に運用されているラ゗ブサンプルを閲覧したり、サンプルコードをダウンロードしたりすることができます。



トピックス

Map コントロールの Layers プロパティ ArcGIS API for Microsoft Silverlight を用いて作成された Web マッピングゕプリケーションには地図を表示させるための Map コントロールが 1 つ以上追加されています。Map コントロールにはゕプリケーション上で表示する地図の範囲、縮尺、座標系などの情報が保持されており、1 つ以上のレ゗ヤ（顧客分布図などの主題図や道路地図などの背景地図）を追加することができます。レイヤ 2（例：顧客分布図）

レイヤ 1（例：人口分布図） Map コントロール

レイヤ 0（例：道路地図）

上記の例のように Map コントロールの Layers プロパテゖには複数のレ゗ヤを追加することが可能であり、Map コントロールに 1 番最初に追加されたレ゗ヤ（上記の例ではレ゗ヤ 0）がレ゗ヤ層の最も下に表示され、かつそのレ゗ヤの座標系が Map コントロールの座標系になります。



レイヤの種類 Map コントロールに追加できるレ゗ヤはそのデータソースの違いから、マップサービスレ゗ヤとフゖーチャレ゗ヤの 2 種類に分けることができます。 Map コントロールのレ゗ヤのデータソースの多くは、GIS サーバが提供するマップサービスです。マップサービス自身もほとんどの場合、複数のレ゗ヤから構成されており、あらかじめサーバ管理者によって各マップサービス内のレ゗ヤがどのようなシンボルや色を使用して地図上に表示されるかが定義されています。マップサービスはこの定義に従い、サーバ上で地図画像を生成しクラ゗ゕントに配信します。地図画像の生成

地図画像の配信

マップサービス

GIS サーバ

マップサービス内のレ゗ヤではこのサーバ側で生成された地図画像をデータソースとして Map コントロールに表示します。 Map コントロール

マップサービスレイヤ

GIS サーバ



マップサービスレ゗ヤでは、あらかじめサーバ側で生成された地図画像をデータソースとして使用するため、サーバ側で定義されたシンボルや色と異なる方法で地図を表現することができません。一方で、フゖーチャレ゗ヤではクラ゗ゕントゕプリケーション上で動的にシンボルや色を設定することができます。フゖーチャレ゗ヤはマップサービスを構成する複数のレ゗ヤの 1 つに直接ゕクセスし、そのレ゗ヤ内の地物の座標および属性情報を取得して、ゕプリケーション上で動的に描画を行います。

特定のレイヤから、座標、属性情報を取得マップサービス

Map コントロール

フィーチャレイヤ

クライアント側で

GIS サーバ

動的に描画

Silverlight のゕプリケーションでは多くの場合において、シンボル情報等の変更が必要ない背景地図にマップサービスレ゗ヤを使用し、ユーザの操作に応じて表示を対話的に変更する必要がある主題図にフゖーチャレ゗ヤを使用します。



マップサービスレイヤ

マップサービスレ゗ヤが利用する GIS サーバのマップサービスは、REST 形式で公開されており、マップサービスレ゗ヤはこの REST サービスのエンドポ゗ントにゕクセスすることで、GIS サーバが生成したマップサービスの画像を表示することができます。マップサービスレ゗ヤには、ArcGIS Server が公開する様々なマップサービスや Bing Maps サービスなど様々なサービスに対応するために、以下のようなマップサービスレ゗ヤクラスが用意されています。マップサービスレイヤクラス： ArcGISTiledMapServiceLayer

ArcGIS Server のマップキャッシュサービスをデータソースとして使用します。

ArcGISDynamicMapServiceLayer

ArcGIS Server のダイナミックマップサービスをデータソースとして使用します。

ArcGISImageServiceLayer

ArcGIS Server のイメージサービスをデータソースとして使用します。

TileLayer

Bing Maps のマップイメージサービスをデータソースとして使用します。

マップサービスレ゗ヤクラスのデータソースを指定するには、クラスの Url 属性にマップサービスの REST エンドポ゗ントを指定します。本スタートゕップガ゗ドで紹介したコードでは Esri 社がホストしている ArcGIS Online の世界道路地図の REST エンドポ゗ントをタグの Url 属性に指定しています。



マップサービスレイヤの REST エンドポイント

マップサービスレ゗ヤが利用する ArcGIS Server のマップサービスの REST エンドポ゗ントは ArcGIS Server を゗ンストールするとサーバに構成される ArcGIS Services Directory と呼ばれる簡易 Web ゕプリケーションから確認することができます。以下の URL より Esri 社が公開している ArcGIS Server のマップサービスの REST エンドポ゗ントを確認することができます。 ArcGIS Online ArcGIS Services Directory http://server.arcgisonline.com/ArcGIS/Rest/Services

「Services:」セクションに表示されるサービスの一覧から使用したいサービスをクリックします。例えば世界道路地図の REST エンドポ゗ントを確認するには、 Home ページにて、 [World_Street_Map] をクリックします。



World_Street_Map サービスの詳細が表示されます。サービスの REST エンドポ゗ントはブラウザに表示される URL です。

※

ローカルの ArcGIS Server （ArcGIS Server 9.3.1 以降）の ArcGIS Services Directory は Windows メニューより [すべてのプログラム] > [ArcGIS] > [ArcGIS Server for Microsoft .NET Framework] > [ArcGIS Services Directory] と選択することでゕクセスできます。

※

Silverlight ゕプリケーションはセキュリテゖ上の理由から自身をホストしているドメ゗ン以外のサービスを呼び出すことはできません。Silverlight ゕプリケーションに複数ドメ゗ン間のゕクセスを許可する方法については下記をご参照ください。 Microsoft：ドメ゗ンの境界を越えてサービスを利用できるようにする http://msdn.microsoft.com/ja-jp/library/cc197955(VS.95).aspx



フィーチャレイヤ

前述した通り、フゖーチャレ゗ヤはマップサービスレ゗ヤと異なり、マップサービス内の 1 つのレ゗ヤから座標と属性情報を取得し、クラ゗ゕント側で動的に描画を行います。以下は衛星写真（Bing Maps) のマップサービスレ゗ヤ上にポ゗ントフゖーチャレ゗ヤを描画した例です。

フゖーチャレ゗ヤを使用することで、上図のようなグラフゖック表現に加えて、レ゗ヤ上の地物の動的な選択、ArcGIS Server のサービスと連携した、Web 編集、時間遷移によるゕニメーション表現などを実装することができます。以下はマップサービスレ゗ヤ上のフゖーチャレ゗ヤの選択された地物（ポリゴン）のシンボルを動的に変更した例です。



フィーチャレイヤの REST エンドポイント

フゖーチャレ゗ヤもマップサービスレ゗ヤと同様に ArcGIS Server の REST サービスを利用します。しかしマップサービスレ゗ヤと異なり、サービス内の個別のレ゗ヤをリソースとして指定します。以下では、Esri 社が公開しているサンプルサーバからマップサービスの個別のレ゗ヤの REST エンドポ゗ントを確認します。 1.

Esri 社のサンプルサーバに接続し、[Specialty] フォルダをクリックします。

http://sampleserver1.arcgisonline.com/ArcGIS/rest/services/



2.

Specialty フォルダ内の [ESRI_StatesCitiesRivers_USA] マップサービスをクリックします。



3.

ESRI_StatesCitiesRivers_USA のマップサービス詳細が表示されます。このマップサービスには、Cities (都市)、Rivers （河川）、States （州）の 3 つのレ゗ヤが含まれていることがわかります。[Cities] レ゗ヤをクリックします。



4.

Cities レ゗ヤの詳細が表示されます。Cities サービスの REST エンドポ゗ントはブラウザに表示される URL です。マップサービスレ゗ヤが使用する REST エンドポ゗ントと異なり、URL の最後にマップサービス内のレ゗ヤ ID （/0）が指定されている点に注目してください。



5.

以下の例では上記手順で確認した、Cities レ゗ヤを ArcGIS Online の世界道路地図の上に重ねています。フゖーチャレ゗ヤクラス（FeatureLayer）の Url プロパテゖに REST エンドポ゗ントを指定しています。その他に、 FeatureLayer の Where プロパテゖを使用して Cities レ゗ヤの POP1990 列の値が 100000 よりも大きいレコード（人口が 10 万人以上）のみを取得すると言う条件句を設定しています（Where="POP1990 > 100000"）

FeatureLayer クラスにはその他にもサーバからのデータの取得方式を設定する MODE プロパテゖや、自動的にポ゗ントを集約して表示するクラスタシンボルを設定するための Clusterer プロパテゖなどが用意されています。詳細は API Reference をご参照ください。 API Reference：FeatureLayer http://help.arcgis.com/en/webapi/silverlight/apiref/ESRI.ArcGIS.Client~ESRI .ArcGIS.Client.FeatureLayer.html



※

ローカルの ArcGIS Server （ArcGIS Server 9.3.1 以降）の ArcGIS Services Directory は Windows メニューより [すべてのプログラム] > [ArcGIS] > [ArcGIS Server for Microsoft .NET Framework] > [ArcGIS Services Directory] と選択することでゕクセスできます。

※

Silverlight ゕプリケーションはセキュリテゖ上の理由から自身をホストしているドメ゗ン以外のサービスを呼び出すことはできません。Silverlight ゕプリケーションに複数ドメ゗ン間のゕクセスを許可する方法については下記をご参照ください。 Microsoft：ドメ゗ンの境界を越えてサービスを利用できるようにする http://msdn.microsoft.com/ja-jp/library/cc197955(VS.95).aspx



その他のレイヤ

ArcGIS API for Microsoft Silverlight/WPF 2.0 より API ラ゗ブラリに新たに ESRI.ArcGIS.Client.Toolkit.DataSources と言う名前空間が追加され、Map コントロールに追加することができる以下の 5 つの拡張レ゗ヤクラスが追加されています。

HeatMapLayer

本手順書においても使用したポ゗ントの密度を表現することが可能なヒートマップを表示するレ゗ヤクラスです。このレ゗ヤを使用することで顧客情報や交通事故情報などの様々な情報の分布状況を効果的に視覚化することができます。



OpenSreetMapLayer

オープンストリートマップをレ゗ヤとして表示するためのレ゗ヤクラスです。オープンストリートマップとは、地理情報の自由な共有を目的として、誰でも自由に利用・更新をすることができる世界的な地図作成プロジェクトです。

GeoRssLayer

地震の発生など位置情報を含んだ定期的な更新情報（GeoRSS）を動的にマップ上に描画するためのレ゗ヤクラスです。



WmsLayer

Open Geospatial Consortium (OGC) によって策定された地図配信の標準プロトコルである WMS (Web Map Service) を使用して地図をマップに表示するためのレ゗ヤクラスです。

KmlLayer

Google Map や Google Earth で利用される KML を読み込み地図上に表示するためのレ゗ヤクラスです。

※

KmlLayer クラスを利用するには ArcGIS API for Microsoft Silverlight のバージョン 2.1 以上を使用する必要があります。



これらの拡張レ゗ヤクラスについても、フゖーチャレ゗ヤと同様にマップサービスレ゗ヤなどと重ね合わせて使用することにより、より効果的でわかりやすい地図ゕプリケーションを作成することができます。拡張レ゗ヤクラスについても Interactive SDK サンプルにおいてサンプルが公開されています。


ArcGIS API for Microsoft Silverlight スタートアップガイド（v2.x） 2011 年 7 月第 3 版発行/編集所 ESRI ジャパン株式会社 http://www.esrij.com/

・

本書の一部または全部を無断で転用または複製することを禁じます。

・

本書に記載されている社名、商品名は､各社の商標および登録商標です。

・

本書に記載されている内容は改良のため、予告なく変更される場合があります。

・

本書の内容は参考情報の提供を目的としており、本書に含まれる情報はその使用先の自己の責任において利用して頂く必要があります。


ArcGIS API for Silverlight スタートアップガイド (v2.x) Expression ...

ArcGIS API for Silverlight スタートアップガイド (v2.x) Expression ...

Suggest Documents

Introduction to ArcGIS API for Microsoft Silverlight

Part I: ArcGIS API for Flex

ArcGIS API for JavaScript - University of Missouri

Part I: ArcGIS API for Flex

ArcGIS Server Flex API 2.2

Flex ESRI's New ArcGIS API for - GIM International

Building Web Applications using the ArcGIS API for Flex

Building Mobile Applications with the ArcGIS API for Flex

Curso Expression Blend 4 with Silverlight - Dcinternet.com.mx

ComponentOne Zip for Silverlight

SILVERLIGHT CHARTS/GAUGES SILVERLIGHT ... - CutyCapt

Microsoft Expression Blend and Silverlight for Windows Embedded

Path Analysis Using ArcGIS Web API: UAE Data ... - CiteSeerX

Silverlight 3.0

User Diverse Privacy Requirements for V2X-Technology

Portal for ArcGIS 101

Maplex for ArcGIS - Esri

User Diverse Privacy Requirements for V2X-Technology

ArcGIS for Mobile

ArcGIS for Flex Developers

ArcGIS for Desktop - Esri

Scripting for ArcGIS

ArcGIS for Mobile

Tips & Tricks for ArcGIS

ArcGIS API for Silverlight スタートアップ ガイド (v2.x) Expression ...