你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Azure Maps iOS SDK（预览版）入门

项目
04/08/2024

Azure Maps iOS SDK 是适用于 iOS 的矢量地图库。本文将引导你完成安装 Azure Maps iOS SDK 和加载地图的过程。

注意

Azure Maps iOS SDK 停用

适用于 iOS 的 Azure Maps 本机 SDK 现已弃用，将于 2025 年 3 月 31 日停用。为了避免服务中断，请在 2025 年 3 月 31 日之前迁移到 Azure Maps Web SDK。有关详细信息，请参阅 Azure Maps iOS SDK 迁移指南。

先决条件

请务必完成快速入门：创建 iOS 应用一文中的步骤。

本地化地图

Azure Maps iOS SDK 提供三种方法用于设置地图的语言和区域视图。以下代码说明了将语言设置为法语 (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 程序中导航的各种方式。

缩放地图

使用双指触摸地图，收拢双指可以缩小，分开双指可以放大。
双击地图可将地图放大一个级别。
用双指双击地图可将地图缩小一个级别。
点击两次；在第二次点击时，用手指按住地图并向上拖动可以放大，向下拖动可以缩小。

平移地图

触摸地图并朝任意方向拖动。

旋转地图

用双指触摸地图并旋转。

调整地图俯仰角

用双指触摸地图，并同时向上或向下拖动双指。

Azure 政府版云支持

Azure Maps iOS SDK 支持使用 Azure 政府云。通过在指定身份验证详细信息的位置添加以下代码行，指定使用 Azure Maps 政府版云域：

AzureMaps.domain = "atlas.azure.us"

对地图和服务进行身份验证时，请确保使用 Azure 政府版云平台中的 Azure Maps 身份验证详细信息。

其他信息

有关更多代码示例，请参阅以下文章：

Share via