在流程中显示附近地点地图

按照本指南,在流程中加入交互式地图。你的应用将地图渲染为 自定义元素 中的原生 MapKit 视图,并在流程屏幕上请求位置授权。

Tip

此方案仅适用于 iOS 应用。使用其他框架构建的应用只会显示自定义元素的备用内容。Android 及跨平台框架的支持即将推出。

开始之前

  • 将你的应用更新至 Adapty iOS SDK 4.4 或更高版本。早期 SDK 版本会为每个自定义元素显示备用内容。
  • 配置你的应用以获取并展示流程。
  • 如需向用户申请位置权限,请在应用的 Info.plist 文件中添加 NSLocationWhenInUseUsageDescription 键,并将其值设置为提示文本,例如”Find fitness centers near you.”

1. 在屏幕上添加自定义元素

在 Flow & Paywall Builder 中,添加一个自定义元素到流程屏幕,并为地图进行如下设置:

  • Type:map。
  • ID:fitness_centers。
  • Height:保持默认的 Fixed 高度。地图会填满整个自定义元素。

请勿将自定义元素放入会响应触摸的容器中(例如轮播图)。否则,在地图上拖动时也会同时移动轮播图。

在自定义元素内部,添加一个带有地图图片的 Image。当以下情况发生时,用户将看到该图片作为备用内容:

  • 用户使用的应用版本无法显示地图。
  • 用户在屏幕打开前拒绝了位置权限。
  • 用户的设备运行的是 iOS 16。

如果用户尚未回应位置权限请求,iOS 会在地图出现时弹出提示。为了告知用户为何需要获取其位置,请在自定义元素上方添加一个文字元素,例如”Find fitness centers near you.”

2. 创建地图视图

创建位置访问的数据模型,以及一个包含地图的 SwiftUI 视图。该视图将请求位置访问权限,查找用户 2 公里范围内的健身中心,并为每个中心显示一个标记:

地图视图需要 iOS 17 或更高版本。在 iOS 16 上,用户会看到备用付费墙。如果用户在屏幕上拒绝了位置访问权限,视图会用一条关于如何在”设置”中开启访问权限的提示信息替换地图。

3. 将地图与自定义元素匹配

在您的全局解析器中,为 LocationAccess 模型添加一个属性,然后添加一个 case,使其为 map 类型和 fitness_centers ID 返回地图视图。高亮行显示了需要添加的内容。如果您的应用尚未设置全局解析器,请复制完整代码:

SDK 会在屏幕打开时调用解析器,也会在屏幕打开期间再次调用(例如产品加载时)。位置访问权限决定了解析器每次调用的返回值:

  • 尚未响应:地图视图,以便视图可以请求访问权限。
  • 已允许:地图视图,显示用户附近的健身中心。
  • 在屏幕打开前已拒绝:nil,因此用户看到的是备用付费墙,而不是关于设置的提示信息。
  • 在屏幕上拒绝:地图视图,因为视图在显示期间会设置 isMapOnScreen。如果解析器在此处返回 nil,SDK 将在下次调用时用备用付费墙替换关于设置的提示信息。

如果您的应用尚未设置全局解析器,请在应用启动时调用一次 AdaptyUI.setCustomElementsResolver(_:):

4. 在设备上测试

流程和付费墙编辑工具无法运行你的应用代码,因此其画布只会显示备用内容。要预览地图,请执行以下操作:

  1. 发布流程。若要查看最新发布版本而非缓存版本,请将设备注册为测试设备。
  2. 在 iOS 17 或更高版本上,运行包含解析器的应用构建版本。打开对应界面,允许位置访问权限。验证地图是否显示了你的位置以及附近健身中心的标记点。

要测试备用方案,请拒绝位置访问权限:在 Settings 应用中,前往 Privacy & Security > Location Services > 你的应用,然后选择 Never。接着重新打开该页面。

要了解为何显示备用方案而非地图,请按照 iOS 指南中在设备上测试部分的说明进行操作。