ArcGIS Runtime SDK for iOS スタートアップガイド

(1)

10.2

ArcGIS Runtime SDK

for iOS

(2)

モバイルマッピングアプリケーションの開発 ... 3 ライブラリのインストール ... 3 Xcode プロジェクトの構成 ... 8 Xcode プロジェクトの作成 ... 9 対象 OS の設定 ... 11 ArcGIS フレームワークの追加 ... 12 関連するライブラリの追加 ... 13 フラグの修正 ... 15 アーキテクチャの設定 ... 16 リソースバンドルの追加 ... 18 アプリケーションの開発 ... 19 地図の表示 ... 19 主題図の追加 ... 25 GPS 位置の表示 ... 27 マップのナビゲート ... 29 アプリケーションの公開について ... 30 次のステップ ... 31 ArcGIS Resources ... 31 ... 32 トピックス ... 35 AGSMapView オブジェクトへのレイヤの追加 ... 35 レイヤの種類 ... 36

(3)

(4)

はじめに

このスタートアップガイドについて

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

ArcGIS Runtime SDK for iOS とは

ArcGIS Runtime SDK for iOS とは iOS 特有の操作性や機能と ArcGIS for Server のオンライン GIS リソースを統合したアプリケーションを開発するために提供される API ライブラリです。

ArcGIS Runtime SDK for iOS の詳細は下記をご参照ください。 ArcGIS Runtime SDK for iOS：

http://www.esrij.com/products/arcgis/developer/arcgis-runtime-sdks/arcgis-runtime-sdk-for-ios/

(5)

ArcGIS Runtime SDK for iOS の開発環境

本ガイドでは以下の環境にて ArcGIS Runtime SDK for iOS を用いたモバイルマッピングアプリケーションの開発手順を紹介します。本ガイドの手順を実行する前に以下の環境がご使用のマシンに適切にセットアップされている必要があります。

開発環境

 OS：Mountain Lion（Mac OS X 10.8.4 以降）、Mavericks（Mac OS X 10.9 以降）

 開発キット：iOS SDK 7 以降

 クライアント環境：iOS 6 以降

ArcGIS Runtime SDK for iOS がサポートする最新の動作環境につきましては下記をご参照ください。

ArcGIS Runtime SDK for iOS 動作環境：

http://www.esrij.com/products/arcgis/developer/arcgis-runtime-sdks/arcgis-runti me-sdk-for-ios/environments/

(6)

モバイルマッピングアプリケーションの開発

ライブラリのインストール

ArcGIS Runtime SDK for iOS を用いてモバイルマッピングアプリケーションを開発するには、まずライブラリを入手する必要があります。以下の手順に従い ArcGIS for Developers からライブラリをインストールしてください ※ 以下の手順はバージョン 10.2 のものです。バージョン 10.2 より前の SDK を使用する場合は以下のページよりダウンロードしてください（Esri グローバルアカウントでのログインが必要になります）。 http://www.esri.com/apps/products/download/index.cfm?fuseaction=download.al l#ArcGIS_Runtime_SDK_for_iOS

1. ArcGIS for Developers にアクセスします。

ArcGIS for Developers（ArcGIS Runtime SDK for iOS バージョン 10.2）： https://developers.arcgis.com/ios/?filename=AGSRuntimeSDKiOSv10.2.pkg&folde r=software/ArcGIS_RuntimeSDK/10.2

2. ArcGIS for Developers の認証ページに遷移します。

ArcGIS for Developers または ArcGIS Online 組織向けプランのアカウント情報を入力してログインして下さい。ArcGIS for Developers 開発者アカウントをお持ちでない方は以下のページにある「ArcGIS for Developers 開発者アカウン

(7)

3. ダウンロードした “AGSRuntimeSDKiOSv<バージョン>.pkg” ファイルをダブルクリックして、インストールを開始します。

4. [ArcGIS_Installer のインストール] ダイアログボックスが表示されます。[続ける] をクリックします。

(8)

5. 表示された内容を確認して、[続ける] をクリックします。

(9)

7. 使用許諾契約の条項に同意する場合は、[同意する] をクリックします。

(10)

9. [インストール] をクリックして、インストールを開始します。

(11)

11. インストールが終了したら、[閉じる] をクリックしてインストール作業を完了します。

Xcode プロジェクトの構成

Xcode は、iOS アプリケーションを開発するための標準の統合開発環境です。Xcode と iOS SDK は Mac App Store からダウンロードすることができます。ArcGIS Runtime SDK for

(12)

iOS を使用してモバイルマッピングアプリケーション開発するために、Xcode に組み込みのプロジェクトテンプレートを使用できます。ここでは、開発をスタートするために必要となるプロジェクトの作成と設定方法を説明します（以下の手順では、Xcode 5.0.2 を使用しています）。

Xcode プロジェクトの作成

1. Xcode を起動して、表示されたダイアログで [Create a new Xcode project] をクリックします。

(13)

3. 「Product Name」と「Class Prefix」に “sample” と入力し、「Device Family」で “iPhone” を選択し、[Next] をクリックします。

(14)

対象 OS の設定

1. 対象 OS を iOS 6 以上に設定します。[General]タブを選択し、[Deployment Target]を「6.0」以上に設定します。

(15)

ArcGIS フレームワークの追加

1. ArcGIS フレームワークをプロジェクトに追加するために、フレームワーク検索パスに「ArcGIS」を加えます。[Build Settings] タブを選択し、検索バーで "Framework Search Paths" と入力して[Framework Search Paths] セクションを検索します。

2. [TARGETS] カラム（赤枠）をダブルクリックし、表示されたダイアログで [+] をクリックして、「$(HOME)/Library/SDKs/ArcGIS/iOS/」と入力し、パスを追加します。

(16)

フラグの修正

ライブラリで定義された Objective-C カテゴリが正しくロードされることを確認するために、フラグをプロジェクトに追加する必要があります。

1. [Build Settings] タブを選択し、検索バーで "Other Linker Flags" と入力し、 [Other Linker Flags] セクションを検索します。

2. [TARGETS] カラムをダブルクリックし、表示されたダイアログで [+] をクリックして、“-ObjC”、“–framework”、“ArcGIS”、“–l”、“c++” を追加します。

(19)

アーキテクチャの設定

標準のアーキテクチャに armv7 および armv7s を設定します。

1. [Build Settings] タブを選択し、検索バーで "architectures" と入力し、 [Architectures] セクションを検索します。

(20)

2. [TARGETS] カラムをクリックし、表示されたダイアログで armv7 および armv7s を含む Standard architectures を選択します。

(21)

リソースバンドルの追加

Esri や Bing ロゴ、GPS ロケーションのイメージファイルなどのような SDK リソースは、 ArcGIS.bundle ファイルに統合されています。

1. Xcode アプリケーションの [File] メニューで、[Add Files to <プロジェクト名 >...] をクリックします。

2. 「${HOME}/Library/SDKs/ArcGIS/iOS/ArcGIS.framework/Versions/Curre nt/Resources」（インストール先がデフォルトの場合）にある ”ArcGIS.bundle” ファイルを選択し、[Add] をクリックします。

(22)

※ 「${HOME}/Library」フォルダはデフォルトで非表示になっています。ターミナルで以下のコマンドを入力して、フォルダを表示することができます。

chflags nohidden ~/Library/

アプリケーションの開発

ここからは、モバイルマッピングアプリケーションの開発方法の一例をご紹介します。

地図の表示

1. Project Navigator で MainStoryboard.storyboard ファイルを選択します。次に、地図を表示するための View オブジェクトを追加します。Object Library で View オブジェクトを、既に用意されている View 上にドラッグ&ドロップで追加します。

※ Utilities エリアが表示されていない場合は、上部パネルの View ボタンで Utilities エリアを表示します。

(23)

2. 追加した View オブジェクトを選択して、Identity Inspector を開き [Custome Class] セクションの「Class」で ”AGSMapView” と入力して、「return」キーを押します。選択している View オブジェクトの名前が ”Map View” に変わったことを確認します。

(24)

3. ツールバーで Assistant Editor を選択し、MainStoryboard.storyboard ファイルと sampleViewController.h ファイルを表示します。次に、最初に追加した View（Map View）オブジェクトを「control」キーを押しながら

sampleViewController.h のインターフェース宣言部分の下にドラッグ&ドロップします。

(25)

4. 表示されたダイアログで「Name」を ”mapView” と入力し、[Connect] ボタンをクリックします。

(26)

6. sampleViewController.h ファイルで下記のようにコードを記述して、ArcGIS.h ヘッダファイルを追加します（赤字がコードの追加部分です）。

#import <UIKit/UIKit.h>

#import <ArcGIS/ArcGIS.h>

@interface sampleViewController : UIViewController

@property (strong, nonatomic) IBOutlet AGSMapView *mapView; @end

7. Project Navigator で sampleViewController.m ファイルを選択し、下記のようにコードを記述して、viewDidLoad メソッド内で ArcGIS レイヤの追加を行います。

AGSTiledMapServiceLayer *tiledLayer = [AGSTiledMapServiceLayer tiledMapServiceLayerWithURL:[NSURL

(27)

上記のコードでは mapView オブジェクトに背景地図のレイヤとして、 ArcGISTiledMapServiceLayer クラスを追加しています。また

ArcGISTiledMapServiceLayer クラスの URL プロパティにデータソースとして、Esri 社がホストしている ArcGIS Online の世界の道路地図のサービスを指定しています。

8. ツールバーで、[Run] をクリックし、iPhone シミュレータでプロジェクトをデバッグします。

9. デバッグ実行が開始され、iPhone シミュレータ上でモバイルマッピングアプリケーションが起動します。

(28)

10. モバイルマッピングアプリケーションが正常に実行されていることが確認できたら、デバッグを停止します。

主題図の追加

以下ではモバイルマッピングアプリケーション上の地図に主題図を表示する手順を紹介します。 1. 下記のように viewDidLoad メソッド内に主題図を追加するコードを追加します。 AGSDynamicMapServiceLayer *dynamicLayer = [AGSDynamicMapServiceLayer dynamicMapServiceLayerWithURL:[NSURL URLWithString:@"http://sampleserver1.arcgisonline.com/ArcGIS/res t/services/Demographics/ESRI_Census_USA/MapServer"]];

dynamicLayer.visibleLayers = [NSArray arrayWithObjects:[NSNumber numberWithInt:5], nil];

(29)

上記のコードでは、「地図の表示」のステップで追加した、

ArcGISTiledMapServiceLayer の上に、ArcGISDynamicMapServiceLayer クラスを追加しています。また ArcGISDynamicMapServiceLayer クラスの URL プロパティにデータソースとして、Esri 社がホストしている ArcGIS Online のデータを追加しています。このデータには複数のレイヤが含まれているため、ArcGISDynamicMapServiceLayer クラスの visibleLayers プロパティで、特定のレイヤ（米国の州のポリゴン）のみを表示しています。 2. 地図の初期表示範囲を変更します。下記のように初期表示範囲を設定するコード

を追加します。

AGSEnvelope *envelope = [AGSEnvelope envelopeWithXmin:-15000000 ymin:200000 xmax:-7000000 ymax:8000000

spatialReference:self.mapView.spatialReference]; [self.mapView zoomToEnvelope:envelope animated:NO];

3. デバッグを行い、背景地図の上に米国の州を黒い線で象ったポリゴン主題図が表示されることを確認します。

(30)

この手順では、ArcGISDynamicMapServiceLayer クラスを追加し、背景レイヤと重ね合わせて表示しました。追加できる各種レイヤの詳細については、レイヤの種類を参照してください。

GPS 位置の表示

以下では、地図が読み込まれた後に iOS デバイスの GPS 位置を地図上に表示します。 1. 地図が読み込まれたイベントをハンドリングするために、デリゲートを実装することを宣言します。sampleViewController.h ファイルに下記のようにコードを追加します（赤字がコードの追加部分です）。

@interface sampleViewController : UIViewController

(31)

AGSMapViewLayerDelegate プロトコルでは、地図に追加されているレイヤに関連するイベント処理メソッドが定義されています。 2. sampleViewController.m を開き、viewDidLoad メソッド内の初期表示範囲を設定したコードの前に、下記のようにコードを追加して、AGSMapView オブジェクトのデリゲートを設定します（赤字がコードの追加部分です）。 [super viewDidLoad]; self.mapView.layerDelegate = self; 3. sampleViewController.m ファイルに GPS 位置を地図上に表示するコードを追加します。 -(void) mapViewDidLoad:(AGSMapView*)mapView { self.mapView.locationDisplay.autoPanMode = AGSLocationDisplayAutoPanModeNavigation; [self.mapView.locationDisplay startDataSource]; } 上記のコードでは、地図が読み込まれたときに、GPS 位置を地図上に表示します。AGSLocationDisplay クラスの AutoPanMode ではいくつかのモードが利用でき、徒歩や車での移動の際に、GPS による最適なナビゲートを提供します。

(32)

4. デバッグを行うと、現在地に青丸が表示されます（シミュレータでは、固定の位置が返されます）。位置情報の利用を許可するかのメッセージが表示された場合は [OK] をタップします。以上でサンプルアプリケーションの開発は終了です。より高度なアプリケーションの開発に関する参考ドキュメントやサンプルの詳細については次のステップをご参照ください。

マップのナビゲート

以下ではモバイルマッピングアプリケーションに使用する地図のナビゲーションについて紹介します。

ArcGIS Runtime SDK for iOS の AGSMapView オブジェクトは、iOS デバイス上で以下のジェスチャによる地図操作をサポートしています。

(33)

ピンチイン 画面の 2 箇所を別々の指で触り、その間隔を狭めることで地図を縮小する。 ピンチアウト 画面の 2 箇所を別々の指で触り、その間隔を広げることで地図を拡大する。 ダブルタップ 画面の 1 箇所をすばやく２回触ることで、地図を一定の倍率で拡大する。 2 本指でのダブルタップ 画面を 2 本の指ですばやく２回触ることで、地図を一定の倍率で縮小する。 スワイプ 画面を触り、触ったまま指を動かすことで、地図を移動する。 2 本指でのツイスト※ _{画面を 2 本指で触り、触ったまま指を動かす} ことで、地図を回転する。 ※ AGSMapView の allowRotationByPinching プロパティを有効したときに利用可能

アプリケーションの公開について

ArcGIS Runtime SDK for iOS を使用して開発したモバイルマッピングアプリケーションを公開する場合は、Esri 社に申請する必要があります。

アプリケーションの公開に関する詳細については「アプリケーション公開ガイド」をご参照

(34)

次のステップ

本スタートアップガイドでは ArcGIS Runtime SDK for iOS を用いたモバイルマッピングアプリケーションを開発するための最も基本的な開発手順について紹介しました。今後、より高度なアプリケーションを開発するためにはまず ArcGIS for Developers をご参照ください。ArcGIS Resources には SDK を利用した開発に必要となる参考ドキュメントやサンプルが集約されています。

ArcGIS Resources

https://developers.arcgis.com/en/ios/

(35)

Guide

https://developers.arcgis.com/en/ios/guide/introduction.htm

レイヤの追加や検索、編集、解析機能などの実装方法や開発ツールの使用方法など、各種開発手法をまとめたドキュメントです。

(36)

API Reference

https://developers.arcgis.com/en/ios/api-reference/index.htm

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

(37)

Sample Code

https://developers.arcgis.com/en/ios/sample-code/

Esri 社の開発者や全世界の開発者の方が作成したモバイルマッピングアプリケーションを紹介するページです。アプリケーションによっては、サンプルコードをダウンロードすることができます。

(38)

トピックス

AGSMapView オブジェクトへのレイヤの追加

ArcGIS Runtime SDK for iOS を用いて作成されたモバイルマッピングアプリケーションには、地図を表示させるための AGSMapView オブジェクトが 1 つ以上追加されています。 AGSMapView オブジェクトにはアプリケーション上で表示する地図の範囲、縮尺、座標系などの情報が保持されており、1 つ以上のレイヤ（顧客分布図などの主題図や道路地図などの背景地図）を追加することができます。最初に追加されたレイヤ（下記のコードの例では ”Layer0”）が最下層に表示されます。

Layer0 = [AGSTiledMapServiceLayer tiledMapServiceLayerWithURL: url0]; [self.mapView addMapLayer:Layer0 withName:@"Layer0"];

Layer1 = [AGSDynamicMapServiceLayer dynamicMapServiceLayerWithURL:url1]; [self.mapView addMapLayer:Layer1 withName:@"Layer1"];

Layer2 = [AGSDynamicMapServiceLayer dynamicMapServiceLayerWithURL:url2]; [self.mapView addMapLayer:Layer2 withName:@"Layer2"];

Layer2（例：顧客分布図） Layer1（例：人口分布図）

Layer0（例：道路地図）

(39)

レイヤの種類

AGSMapView オブジェクトに追加できるレイヤはそのデータソースの違いから、マップサービスレイヤとフィーチャレイヤの 2 種類に分けることができます。レイヤのデータソースの多くは、GIS サーバが提供するマップサービスです。マップサービス自身もほとんどの場合、複数のレイヤから構成されており、あらかじめサーバ管理者によって各マップサービス内のレイヤがどのようなシンボルや色を使用して地図上に表示されるかが定義されています。マップサービスはこの定義に従い、サーバ上で地図画像を生成しクライアントに配信します。マップサービス内のレイヤではこのサーバ側で生成された地図画像をデータソースとして AGSMapView オブジェクトに表示します。マップサービスレイヤでは、あらかじめサーバ側で生成された地図画像をデータソースとして使用するため、サーバ側で定義されたシンボルや色と異なる方法で地図を表現することができません。一方で、フィーチャレイヤではクライアントアプリケーション上で動的にシンボルや色を設定することができます。フィーチャレイヤはマップサービスを構成する GIS サーバ マップサービス 地図画像の生成 地図画像の配信 マップサービスレイヤ mapView GIS サーバ

(40)

て、アプリケーション上で動的に描画を行います。 iOS のモバイルマッピングアプリケーションでは多くの場合において、シンボル情報等の変更が必要ない背景地図にマップサービスレイヤを使用し、ユーザの操作に応じて表示を対話的に変更する必要がある主題図にフィーチャレイヤを使用します。 GIS サーバ マップサービス mapView フィーチャレイヤ 特定のレイヤから、 座標、属性情報を取得 クライアント側で 動的に描画

(41)

マップサービスレイヤ

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

マップサービスレイヤクラス：

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

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

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

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

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

(42)

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

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

ArcGIS Online ArcGIS Services Directory

http://server.arcgisonline.com/ArcGIS/Rest/Services

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

(43)

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

※ ローカルの ArcGIS for Server 10.2 の ArcGIS Services Directory は Windows メニューより [すべてのプログラム] > [ArcGIS] > [ArcGIS 10.2 for Server] > [Services Directory] と選択することでアクセスできます。

(44)

フィーチャレイヤ

前述した通り、フィーチャレイヤはマップサービスレイヤと異なり、マップサービス内の 1 つのレイヤから座標と属性情報を取得し、クライアント側で動的に描画を行います。以下は世界の道路地図のマップサービスレイヤ上にポイントフィーチャレイヤを描画した例です。フィーチャレイヤを使用することで、上図のようなグラフィック表現に加えて、レイヤ上の地物の動的な選択、ArcGIS for Server のサービスと連携した Web 編集などを実装することができます。

(45)

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

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

1. Esri のサンプルサーバに接続し、[Specialty] フォルダをクリックします。 http://sampleserver1.arcgisonline.com/ArcGIS/rest/services/

(46)

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

(47)

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

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

(48)

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

AGSTiledMapServiceLayer *tiledLayer = [AGSTiledMapServiceLayer tiledMapServiceLayerWithURL:[NSURL

URLWithString:@"http://services.arcgisonline.com/ArcGIS/rest/ser vices/World_Street_Map/MapServer"]];

[self.mapView addMapLayer:tiledLayer withName:@"Tiled Layer"]; AGSFeatureLayer *featureLayer = [AGSFeatureLayer

featureServiceLayerWithURL:[NSURL

URLWithString:@"http://sampleserver1.arcgisonline.com/ArcGIS/res t/services/Specialty/ESRI_StatesCitiesRivers_USA/MapServer/0"] mode: AGSFeatureLayerModeSnapshot];

featureLayer.definitionExpression = @"POP1990 > 100000";

[self.mapView addMapLayer:featureLayer withName:@"Feature Layer"]; 6. AGSFeatureLayer クラスにはその他にもサーバからのデータの取得方式を設定

する mode プロパティなどが用意されています。詳細は Reference をご参照ください。

Reference：AGSFeatureLayer

(49)

その他のレイヤ

マップサービスレイヤ、フィーチャサービスレイヤの他にも、AGSMapView オブジェクトに追加することができる以下のようなレイヤクラスが利用できます。 AGSOpenStreetMapLayer オープンストリートマップをレイヤとして表示するためのレイヤクラスです。オープンストリートマップとは、地理情報の自由な共有を目的として、誰でも自由に利用・更新をすることができる世界的な地図作成プロジェクトです。

(50)

AGSSketchGraphicsLayer

(51)

これらのレイヤクラスについても、フィーチャレイヤと同様にマップサービスレイヤなどと重ね合わせて使用することにより、より効果的でわかりやすいモバイルマッピングアプリケーションを作成することができます。

(52)