如何在Kotlin中使用Mapbox显示编码折线的静态图片？

核心原因：编码折线无法直接用于静态API #

Mapbox静态地图API不支持直接传入编码折线（Polyline）作为路径参数，必须先解码为经纬度坐标序列再按格式拼接，这是你收到Not found错误的主要原因。

步骤1：解码编码折线为经纬度坐标 #

在Kotlin里有两种常用解码方式：

方式1：使用Mapbox官方库解码 #

1. 先在build.gradle中添加依赖：

implementation("com.mapbox.mapboxsdk:mapbox-java:5.8.0")

2. 解码代码示例：

import com.mapbox.core.utils.PolylineUtils

// 你的编码折线
val encodedPolyline = "ki{eFvqfiVsBmA`Feh@qg@iX`B}JeCcCqGjIq~@kf@cM{KeHeX`@_GdGkSeBiXtB}YuEkPwFyDeAzAe@pC~DfGc@bIOsGmCcEiD~@oBuEkFhBcBmDiEfAVuDiAuD}NnDaNiIlCyDD_CtJKv@wGhD]YyEzBo@g@uKxGmHpCGtEtI~AuLrHkAcAaIvEgH_EaDR_FpBuBg@sNxHqEtHgLoTpIiCzKNr"

// 解码为经纬度列表（精度设为5，匹配该Polyline的编码精度）
val coordinates = PolylineUtils.decode(encodedPolyline, 5)

方式2：手动实现解码（无第三方依赖） #

如果不想引入库，可以自己写解码逻辑：

fun decodePolyline(encoded: String, precision: Int): List<Pair<Double, Double>> {
    val coordinates = mutableListOf<Pair<Double, Double>>()
    var index = 0
    var lat = 0
    var lng = 0
    val factor = Math.pow(10.0, precision.toDouble())

    while (index < encoded.length) {
        var result = 0
        var shift = 0
        var b: Int
        do {
            b = encoded[index++].code - 63
            result = result or (b and 0x1F shl shift)
            shift += 5
        } while (b >= 0x20)
        val dlat = if (result and 1 != 0) (result shr 1).inv() else result shr 1
        lat += dlat

        result = 0
        shift = 0
        do {
            b = encoded[index++].code - 63
            result = result or (b and 0x1F shl shift)
            shift += 5
        } while (b >= 0x20)
        val dlng = if (result and 1 != 0) (result shr 1).inv() else result shr 1
        lng += dlng

        coordinates.add(Pair(lng / factor, lat / factor))
    }
    return coordinates
}

// 使用示例
val coordinates = decodePolyline(encodedPolyline, 5)

步骤2：拼接合法的静态地图URL #

解码后，把坐标按经度,纬度;经度,纬度的格式拼接，再组合成完整URL：

// 转换坐标为API要求的字符串格式
val pathStr = coordinates.joinToString(";") { "${it.first},${it.second}" }

// 替换为你的Mapbox Access Token
val accessToken = "YOUR_MAPBOX_ACCESS_TOKEN"
// 构建静态地图URL
val staticMapUrl = "https://api.mapbox.com/styles/v1/mapbox/streets-v12/static/path-5+ff0000-1($pathStr)/auto/600x400?access_token=$accessToken"

• 参数说明：
  • path-5+ff0000-1：定义路径样式（宽度5px、红色、完全不透明）
  • auto：自动适配路径的中心点和缩放级别，也可手动指定经度,纬度,缩放级别
  • 600x400：图片尺寸，可按需调整

其他注意事项 #

• URL编码：无需手动处理坐标中的特殊字符，Kotlin的URLEncoder.encode会自动处理，但要确保路径参数格式正确
• Token权限：确认你的Mapbox Access Token开启了static images权限，可在Mapbox控制台配置
• 路径长度限制：静态API对坐标点数量有上限，若路径过长，可使用PolylineUtils.simplify方法简化坐标

内容的提问来源于stack exchange，提问作者Atul Sharma