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

按照本教程,在流程中嵌入一个交互式地图。地图会显示用户 2 公里范围内的相关地点(如合作健身中心)。你的应用使用 MapLibre,以原生视图的形式在自定义元素中渲染该地图,并在流程屏幕上请求位置权限。

开始之前

  • 将您的应用更新至 Adapty Android SDK 4.4 或更高版本。早期 SDK 版本会对每个自定义元素显示备用内容。
  • 配置您的应用以获取并展示流程。
  • 如需向用户请求位置权限,请在继承自 ComponentActivity 的 Activity(例如 AppCompatActivity)中展示流程。
  • 通过 Gradle 将 MapLibre 添加到您的应用,使用 org.maplibre.gl:android-sdk-opengl 依赖包。使用该依赖包后,Google Play 也会将您的应用提供给不支持 Vulkan 的设备(默认的 android-sdk 依赖包需要 Vulkan 支持)。
  • 将 minSdk 设置为 23 或更高版本,因为 MapLibre 有此要求。

要将您的应用限制为近似位置,请在 AndroidManifest.xml 的 <manifest> 元素内添加以下内容。请确保 <manifest> 元素声明了 xmlns:tools="http://schemas.android.com/tools"。

<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<!-- removes precise location, which MapLibre declares -->
<uses-permission
    android:name="android.permission.ACCESS_FINE_LOCATION"
    tools:node="remove" />

1. 将自定义元素添加到屏幕

在流程与付费墙编辑工具中,向流程屏幕添加自定义元素,并为地图进行如下设置:

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

请勿将自定义元素放入响应触摸的容器(如轮播图)中,这样只有地图本身会响应拖拽操作。

在自定义元素内,添加一张带有地图图片的 Image。在以下情况下,用户会看到该图片作为备用内容:

  • 用户使用的应用版本不支持显示地图。
  • 用户在屏幕打开前拒绝了位置访问权限。

如果用户尚未回应位置访问请求,当地图出现时,您的应用会弹出该提示。为了让用户了解应用为何需要获取其位置信息,请在自定义元素上方添加一个文本元素,例如”查找您附近的健身中心”。

2. 创建地图视图

创建一个用于存储地点数据的类型,以及一个用于位置访问的模型:

创建一个带有地图的视图。该视图请求位置访问权限,并为用户 2 公里范围内的每个地点显示一个标记:

如果用户在界面上拒绝位置权限,视图会将地图替换为一条提示,说明如何在设置中开启权限。

3. 将映射与自定义元素关联

在你的全局解析器中,为 LocationAccess 模型和你的地点添加属性。然后为 map 类型和 fitness_centers ID 返回地图视图。高亮行显示了需要添加或修改的内容。如果你的应用还没有全局解析器,请复制完整代码:

每当屏幕打开以及屏幕处于打开状态时自定义元素发生重绘,SDK 都会调用解析器。位置访问权限决定了解析器每次调用的返回值:

  • 尚未回答:地图视图,以便视图可以请求访问权限。
  • 已允许:地图视图,显示用户附近的位置。
  • 在屏幕打开前已拒绝:不返回任何视图,用户将看到备用内容,而非关于”设置”的提示信息。
  • 在屏幕打开后拒绝:地图视图,因为视图在屏幕显示期间会设置 isMapOnScreen。如果解析器在此处不返回视图,SDK 将在下次调用时用备用内容替换关于”设置”的提示信息。

创建包含自定义元素的解析器,并将其设置为全局解析器。在应用启动时调用一次 AdaptyUI.setCustomElementsResolver:

4. 在设备上测试

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

  1. 发布流程。若要查看最新发布版本而非缓存版本,请将设备注册为测试设备。
  2. 若要在地图上看到标记,请在你的地点列表中添加一个距你当前位置 2 公里以内的地点。
  3. 运行包含解析器的应用构建版本,打开该页面,并允许位置访问。验证地图是否显示了你的位置以及你添加的地点标记。

要测试备用付费墙,请在 Settings 应用中关闭你的应用的位置访问权限。打开该界面,如果出现提示,请拒绝位置访问。地图视图将显示关于 Settings 的提示信息。再次打开该界面,确认备用付费墙已出现。

要了解为什么显示备用付费墙而不是地图,请参阅 Android 指南中在设备上测试部分的说明。