Android Google Maps中如何设置polyline为渐变样式？

Google Maps Android SDK本身并没有直接提供渐变Polyline的原生API，但咱们可以通过分段绘制多个小Polyline并依次设置过渡颜色的方式来实现这个效果，这是目前最直观、易上手的方案。下面是具体的实现步骤和代码示例：

一、生成渐变颜色数组 #

首先需要一个工具方法，根据你想要的起始色、结束色和分段数，生成一系列平滑过渡的颜色。比如从亮红到深蓝的渐变：

fun generateGradientColors(startColor: Int, endColor: Int, steps: Int): List<Int> {
    val colors = mutableListOf<Int>()
    // 拆分RGB通道
    val startRed = Color.red(startColor)
    val startGreen = Color.green(startColor)
    val startBlue = Color.blue(startColor)
    val endRed = Color.red(endColor)
    val endGreen = Color.green(endColor)
    val endBlue = Color.blue(endColor)

    // 计算每个通道的步长
    val redStep = (endRed - startRed) / (steps - 1).toFloat()
    val greenStep = (endGreen - startGreen) / (steps - 1).toFloat()
    val blueStep = (endBlue - startBlue) / (steps - 1).toFloat()

    // 生成每一步的颜色，确保值在0-255范围内
    for (i in 0 until steps) {
        val currentRed = (startRed + redStep * i).coerceIn(0, 255).toInt()
        val currentGreen = (startGreen + greenStep * i).coerceIn(0, 255).toInt()
        val currentBlue = (startBlue + blueStep * i).coerceIn(0, 255).toInt()
        colors.add(Color.rgb(currentRed, currentGreen, currentBlue))
    }
    return colors
}

二、拆分路径并绘制渐变线段 #

接下来，把你的原始路径点列表拆分成多个连续的小线段，给每个线段分配对应的渐变颜色。假设你已经有了List<LatLng>类型的路径点集合pathPoints：

fun drawGradientPolyline(googleMap: GoogleMap, pathPoints: List<LatLng>, startColor: Int, endColor: Int, width: Float) {
    // 分段数：数值越大渐变越平滑，建议根据路径长度调整，比如固定50段或按距离分段
    val segmentCount = 50
    if (pathPoints.size < 2 || segmentCount < 2) return

    val gradientColors = generateGradientColors(startColor, endColor, segmentCount)
    // 计算每段需要跨越的路径点间隔
    val pointStep = (pathPoints.size - 1) / (segmentCount - 1).toFloat()

    // 绘制前segmentCount-1段
    for (i in 0 until segmentCount - 1) {
        val startIdx = (i * pointStep).toInt()
        val endIdx = ((i + 1) * pointStep).toInt()
        val segmentPath = listOf(pathPoints[startIdx], pathPoints[endIdx])

        googleMap.addPolyline(
            PolylineOptions()
                .addAll(segmentPath)
                .color(gradientColors[i])
                .width(width)
                .jointType(JointType.ROUND) // 圆角衔接更自然
                .startCap(RoundCap())
                .endCap(RoundCap())
        )
    }
    // 单独处理最后一段，避免索引越界
    val lastSegment = listOf(pathPoints[pathPoints.size - 2], pathPoints.last())
    googleMap.addPolyline(
        PolylineOptions()
            .addAll(lastSegment)
            .color(gradientColors.last())
            .width(width)
            .jointType(JointType.ROUND)
            .startCap(RoundCap())
            .endCap(RoundCap())
    )
}

三、调用方法实现渐变Polyline #

在你的地图初始化完成后（比如onMapReady回调里），直接调用这个方法就行：

// 示例：从红色(#FF0000)渐变到蓝色(#0000FF)，线宽10dp
val startColor = Color.parseColor("#FF0000")
val endColor = Color.parseColor("#0000FF")
drawGradientPolyline(googleMap, yourPathPointsList, startColor, endColor, 10f)

一些优化小技巧 #

• 动态分段：如果路径很长，建议根据路径总距离来计算分段数（比如每5米一段），这样渐变会更均匀。可以用Google Maps Utils库的SphericalUtil.computeDistanceBetween()计算两点距离，记得在build.gradle中添加依赖：

  implementation 'com.google.maps.android:android-maps-utils:2.2.0'
  

• 性能控制：如果路径点特别多，别设置太多分段（比如最多100段），不然会影响地图流畅度；也可以在地图缩放级别低的时候减少分段数。
• 多色渐变：如果想要彩虹渐变之类的效果，只需要修改generateGradientColors方法，支持传入多个颜色点，比如从红→黄→绿→蓝，依次生成过渡色就行。

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