ArcGIS Developers 開発リソース集 > スタートアップガイド > アプリ開発 > iOS

iOS

マップを表示する

このチュートリアルでは ArcGIS Runtime SDK for iOS (バージョン 100.x) を使用して、マップとベースマップレイヤーを表示する方法を紹介します。

マップには、地理データのレイヤーが含まれています。マップには、ベースマップレイヤーと、オプションで1つ以上のデータレイヤーを追加できます。マップビューを使用し、場所とズームレベルを設定することで、マップの特定の領域を表示できます。

このチュートリアルでは、地形ベースマップレイヤーを使用して、富士山付近を表示する地図を作成します。

前提条件

このチュートリアルを実施するには、以下が必要です。

API キーにアクセスするための ArcGIS 開発者アカウント。アカウントをお持ちでない場合は、サインアップ（無料）してください。アカウントの作成方法は「開発者アカウントの作成」をご覧ください。
開発環境がシステム要件を満たしていることを確認します。
ArcGIS Runtime SDK for iOS がインストールされていること

ステップ

新しい Xcode プロジェクトを作成する

Xcode を使用してシングルビュー iOS アプリを作成し、SDK を参照するように構成します。

Xcode を開き、メニューバーから [File] > [New] > [Project] > [iOS] > [App] > [Next] をクリックします。
- [Choose options for your new project] ウィンドウで、次の値を設定します。
  - Product Name: <任意の名前>
  - Language: Swift
  - Interface: Storyboard
  - Organization Identifier: <任意の組織>
- 他のすべてのオプションのチェックを外します。
- [Next] > [Create] をクリックします。
「インストールガイドのプロジェクトの構成」の手順に従って、API への参照を追加します。

UI にマップビューを追加する

マップビューは、マップを表示する UI コンポーネントです。また、タッチジェスチャによるナビゲートなど、ユーザーによるマップの操作も処理します。Xcode とストーリーボードエディターを使用して、マップビューを UI に追加し、それをビューコントローラーのソースコードに接続します。iPhone のディスプレイ全体に表示されるようにマップビューのサイズを設定します。

Project Navigator で ViewController.swift をクリックします。
エディターで、API を参照するインポートステートメントを追加し、mapViewという名前で AGSMapView タイプの @IBOutlet を追加します。これにより、ストーリーボードで作成するマップビューへの参照が提供されます。AGSMapView は UIView のサブクラスです。

ViewController.swift
```
import UIKit

// 追加開始
import ArcGIS
// 追加終了

class ViewController: UIViewController {

    // 追加開始
    @IBOutlet weak var mapView: AGSMapView!
    // 追加終了

    override func viewDidLoad() {
        super.viewDidLoad()

    }

}
```
Project Navigator で Main.storyboard をクリックしストーリーボードエディターを開きます。
メニューで, [View] > [Show Library] をクリックしオブジェクトライブラリを表示します。
オブジェクトライブラリ上で
- uiview と入力するか、下にスクロールして View を見つけます。
- 新しい View をストーリーボードのメインビューにドラッグアンドドロップします。
ストーリーボードエディターの右下にある Add New Constraints をクリックします。パネル上で
- 上下左右のコンストレイントに0を入力します。
- Add 4 Constraints をクリックします。
新しい View が画面いっぱいに表示されます。
メニューで [View] > [Inspectors] > [Identity] をクリックします。インスペクターパネルで [Custom Class] > [Class] を AGSMapView に設定します。これにより、新しい View のタイプが AGSMapView に設定されます。
ストーリーボードエディターで、黄色の View Controller アイコンを右クリックして、コネクションパネルを表示します。 mapView アウトレットコネクタをストーリーボードの新しい AGSMapView ビューにドラッグします。これにより、ストーリーボードの AGSMapView が、ViewController クラスで以前に作成されたmapView アウトレットに接続されます。

マップを追加する

マップビューを使用して、富士山を中心としたマップを表示します。マップには、地形ベースマップレイヤーが含まれます。

Xcode の Project Navigator で ViewController.swift をクリックします。

エディタで、setupMap() という名前のプライベートメソッドを定義します。 setupMap() で AGSMap を作成します。AGSBasemapStyleArcGISTopographic という名前の地形図のベースマップスタイルを使用して ArcGISMap を構成します。

ViewController.swift

class ViewController: UIViewController {

    @IBOutlet weak var mapView: AGSMapView!

    // 追加開始
    private func setupMap() {

        let map = AGSMap(
            basemapStyle: .arcGISTopographic
        )

        mapView.setViewpoint(
            AGSViewpoint(
                latitude: 35.360626,
                longitude: 138.727363,
                scale: 200000
            )
        )

    }
    // 追加終了

    override func viewDidLoad() {
        super.viewDidLoad()

    }

}

地形図（.arcGISTopographic）以外にも、道路地図（.arcGISStreets）、衛星画像（.arcGISImagery）、オープンストリートマップ（.osmStreets）など、様々なスタイルが用意されています。

mapView アウトレットの map プロパティを新しい AGSMap に設定します。

ViewController.swift

private func setupMap() {

    let map = AGSMap(
        basemapStyle: .arcGISTopographic
    )

    // 追加開始
    mapView.map = map
    // 追加終了

    mapView.setViewpoint(
        AGSViewpoint(
            latitude: 35.360626,
            longitude: 138.727363,
            scale: 200000
        )
    )

}

ViewController の viewDidLoad メソッドで、ビューがロードされたら setupMap() を呼び出します。

ViewController.swift

override func viewDidLoad() {
    super.viewDidLoad()

    // 追加開始
    setupMap()
    // 追加終了

}

API キーを設定する

ArcGIS Online でホストされているサービス、Web マップ、Web シーンにアクセスできるようにするには、API キーが必要です。まだ作成していない場合は、ArcGIS Developers ダッシュボードに移動して、API キーを取得します。作成方法は「API キーの取得」をご覧ください。

Project Navigator で AppDelegate.swift をクリックします。

エディターで、API を参照するインポートステートメントを追加し、AppDelegate の application(_:didFinishLaunchingWithOptions:) メソッドで、API キーを使用して AGSArcGISRuntimeEnvironment の apiKey プロパティを設定します。

AppDelegate.swift

import UIKit

// 追加開始
import ArcGIS
// 追加終了

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {
    var window: UIWindow?

    func application(_ application: UIApplication,
                    didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {

        // 追加開始
        // 注：API キーをソースコードに保存することはベストプラクティスではありません。
        //チュートリアルでは便宜上ソースコードに記載しています
        AGSArcGISRuntimeEnvironment.apiKey = "<API キー>"
        // 追加終了

        return true
    }

}

<Command + R> を押してアプリを実行します。

富士山を中心とした地形ベースマップレイヤーのマップが表示されます。マップビューをピンチ、ドラッグ、およびダブルタップして、マップを操作します。

完成版のプロジェクトはこちらからダウンロードできます（マップの表示場所は本チュートリアルで設定した場所とは異なります）。

Web マップを表示する

「Web マップの作成」のガイドで Web マップを作成している場合は、作成した Web マップも基本的に同じステップで表示できます。

マップを表示するのステップで作成したプロジェクトの ViewController.swift を開き、setupMap() メソッドを下記のように書き換えます。

ViewController.swift

private func setupMap() {

    let portal = AGSPortal.arcGISOnline(withLoginRequired: false)
    let itemID = "<Web マップの ID>"
    let portalItem = AGSPortalItem(portal: portal, itemID: itemID)

    let map = AGSMap(item: portalItem)
    mapView.map = map

}

アプリの動作が確認できたら ArcGIS のセキュリティと認証について学びましょう！