Azure Maps iOS SDK の概要 (プレビュー)

[アーティクル]
04/15/2024

Azure Maps iOS SDK は iOS 用のベクターマップライブラリです。この記事では、Azure Maps iOS SDK のインストールおよびマップの読み込みのプロセスを説明します。

Note

Azure Maps iOS SDK の廃止

iOS 用 Azure Maps Native SDK は非推奨となり、2025 年 3 月 31 日に廃止されます。サービスの中断を回避するには、2025 年 3 月 31 日までに Azure Maps Web SDK に移行します。詳細については、「Azure Maps iOS SDK 移行ガイド」を参照してください。

前提条件

必ず、iOS アプリの作成のクイックスタートに関する記事の手順を完了してください。

マップのローカライズ

Azure Maps iOS SDK には、マップの言語と地域ビューを設定するための 3 つの方法が用意されています。次のコードは、"言語" をフランス語 ("fr-FR") に、"地域ビュー" を Auto に設定するさまざまな方法を示しています。

静的 language および view プロパティを使用して言語と地域ビューの情報を AzureMaps クラスに渡して、アプリで既定の言語と地域ビューのプロパティを設定します。

// Alternatively use Azure Active Directory authenticate.
AzureMaps.configure(aadClient: "<Your aad clientId>", aadAppId: "<Your aad AppId>", aadTenant: "<Your aad Tenant>")

// Set your Azure Maps Key.
// AzureMaps.configure(subscriptionKey: "<Your Azure Maps Key>")

// Set the language to be used by Azure Maps.
AzureMaps.language = "fr-FR"

// Set the regional view to be used by Azure Maps.
AzureMaps.view = "Auto"

言語と地域ビューの情報はマップコントロール init に渡すこともできます。
```
MapControl(options: [
    StyleOption.language("fr-FR"),
    StyleOption.view("Auto")
])
```
言語と地域ビューのプロパティをプログラムで設定する最後の方法では、setStyle メソッドを使用します。マップの言語と地域ビューを変更する必要がある場合は、いつでもマップの setStyle メソッドを使用することができます。
```
mapControl.getMapAsync { map in
    map.setStyleOptions([
        StyleOption.language("fr-FR"),
        StyleOption.view("Auto")
    ])
}
```

言語が fr-FR に設定され、地域ビューが Auto に設定されている Azure Maps アプリケーションの例を次に示します。

ラベルをフランス語で表示するマップイメージ。

サポートされている言語と地域ビューの完全な一覧については、「Azure Maps でのローカライズのサポート」を参照してください。

マップ内を移動する

このセクションでは、Azure Maps プログラムでのさまざまな操作方法について詳しく説明します。

マップをズームする

2 本の指でマップをタッチし、指でつまむようにすると縮小し、指を広げると拡大します。
マップをダブルタップし、1 レベル分拡大します。
2 本の指でダブルタップし、マップを 1 レベル分縮小します。
2 回タップします。2 回目のタップで指をマップに置いたままにして、上にドラッグすると拡大し、下にドラッグすると縮小します。

マップをパンする

マップをタッチし、任意の方向にドラッグします。

マップを回転する

2 本の指でマップをタッチし、回転します。

マップのピッチを調整する

2 本の指でマップをタッチして、上または下にドラッグします。

Azure Government クラウドのサポート

Azure Maps iOS SDK では、Azure Government クラウドを使用できます。 Azure Maps の認証詳細が指定されている次のコード行を追加することで Azure Maps Government クラウドの使用を指定します。

AzureMaps.domain = "atlas.azure.us"

マップとサービスを認証するときは、Azure Government クラウドプラットフォームからの Azure Maps 認証の詳細を必ず使用してください。