Mapbox 访问令牌指南：在 Jetpack Compose 中使用

2024-03-22 13:16:43

Mapbox 在 Jetpack Compose 中使用访问令牌指南

在使用 Mapbox 的强大地图服务时，开发者们可能会遇到需要提供访问令牌的问题。如果没有有效的访问令牌，开发者将无法使用 MapView、MapSurface 或其他地图组件。在本指南中，我们将深入探讨解决此问题的方法，并提供逐步说明，帮助你顺利使用 Mapbox。

理解问题

Mapbox 要求开发者提供访问令牌，以验证其对地图服务的访问权限。此令牌是使用 Mapbox 帐户创建的，并在帐户设置中提供。如果没有提供有效的访问令牌，Mapbox 将抛出 MapboxConfigurationException，提示开发者提供访问令牌。

解决方案

为 Mapbox 提供访问令牌有两种方法：

创建字符串资源: 在 res/values/strings.xml 文件中创建名为 mapbox_access_token 的字符串资源，并将其值设为你的访问令牌。
以编程方式设置: 在代码中，使用 MapboxOptions.accessToken 方法设置访问令牌。

修改的可组合代码

应用上述解决方案后，你现有的可组合代码将如下所示：

    MapboxMap(
        modifier = Modifier.fillMaxSize(),
        mapInitOptionsFactory = { context ->
            MapInitOptions(
                context = context,
                styleUri = Style.SATELLITE_STREETS,
                accessToken = mapbox_access_token
            )
        },
        mapViewportState = MapViewportState().apply {
            setCameraOptions {
                zoom(2.0)
                center(Point.fromLngLat(-98.0, 39.5))
                pitch(0.0)
                bearing(0.0)
            }
        },
    ) // : MapboxMap