请求多段线的路况信息

借助 Routes Preferred API，您可以请求有关多段线路交通状况的信息。交通状况以速度类别（NORMAL、SLOW、TRAFFIC_JAM）表示，适用于响应多段线的给定间隔。这些间隔由多段线起点（包括）和终点（不包括）的索引定义。

请求示例

路况感知多段线可用于路线级和路段级。在路线一级，交通速度信息以 SpeedReadingIntervals 的形式提供在 RouteTravelAdvisory 响应字段下。如需同时接收路线的多段线和交通信息，请在响应字段掩码中同时添加 polyline 和 speedReadingIntervals。

如果字段掩码包含 routes.legs.travelAdvisory.speedReadingIntervals，则响应将包含 RouteLegTravelAdvisory 下的路段级别交通数据。

X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline,routes.travelAdvisory.speedReadingIntervals,routes.legs.polyline.encodedPolyline,routes.legs.travelAdvisory.speedReadingIntervals

如需详细了解如何指定响应字段掩码，请参阅“选择要返回的字段”。

示例响应

只要通过字段掩码请求 speedReadingIntervals，系统就会在 routes.travelAdvisory.speedReadingIntervals 下填充这些值。您可以在 routes.legs.travelAdvisory.speedReadingIntervals 下找到航段级流量。每个间隔由 startPolylinePointIndex、endPolylinePointIndex 和相应的速度类别描述。请注意，根据 proto3 实践，如果间隔时间内缺少起始索引，则对应于索引 0。

{
  "routes": [
    {
      "legs": {
        "polyline": {
          "encodedPolyline": "}boeF~zbjVAg@EmB`GWHlD"
        },
        "travelAdvisory": {
          "speedReadingIntervals": [
            {
              "endPolylinePointIndex": 1,
              "speed": "NORMAL"
            },
            {
              "startPolylinePointIndex": 1,
              "endPolylinePointIndex": 2,
              "speed": "SLOW"
            },
            {
              "startPolylinePointIndex": 2,
              "endPolylinePointIndex": 4,
              "speed": "NORMAL"
            }
          ] 
        }
      },
      "polyline": {
        "encodedPolyline": "}boeF~zbjVAg@EmB`GWHlD"
      },
      "travelAdvisory": {
        "speedReadingIntervals": [
          {
            "endPolylinePointIndex": 1,
            "speed": "NORMAL"
          },
          {
            "startPolylinePointIndex": 1,
            "endPolylinePointIndex": 2,
            "speed": "SLOW"
          },
          {
            "startPolylinePointIndex": 2,
            "endPolylinePointIndex": 4,
            "speed": "NORMAL"
          }
        ] 
      }
    }
  ]
}

使用 Maps SDK 渲染考虑交通状况的多段线

我们建议您使用 Google Maps SDK 提供的各种功能（包括沿多段线路段自定义颜色、描边和图案）在地图上显示感知交通状况的多段线。如需详细了解如何使用多段线，请参阅适用于 Android 的多段线地图项和适用于 iOS 的多段线地图项。

多段线渲染示例

Maps SDK 用户可以定义速度类别与多段线渲染架构之间的自定义映射逻辑。例如，您可以决定在 Google 地图上将“正常”速度显示为粗蓝线，将“缓慢”速度显示为粗橙线，以此类推。

以下代码段将会添加一条蓝色的粗多段线，其中包含从墨尔本至珀斯的测地线段。如需了解详情，请参阅自定义外观（适用于 Android）和自定义多段线（适用于 iOS）。

Android

Java

Polyline line = map.addPolyline(new PolylineOptions()
    .add(new LatLng(-37.81319, 144.96298), new LatLng(-31.95285, 115.85734))
    .width(25)
    .color(Color.BLUE)
    .geodesic(true));

Kotlin

val line: Polyline = map.addPolyline(
  PolylineOptions()
    .add(LatLng(-37.81319, 144.96298), LatLng(-31.95285, 115.85734))
    .width(25f)
    .color(Color.BLUE)
    .geodesic(true)
)

iOS

Objective-C

GMSMutablePath *path = [GMSMutablePath path];
[path addLatitude:-37.81319 longitude:144.96298];
[path addLatitude:-31.95285 longitude:115.85734];
GMSPolyline *polyline = [GMSPolyline polylineWithPath:path];
polyline.strokeWidth = 10.f;
polyline.strokeColor = .blue;
polyline.geodesic = YES;
polyline.map = mapView;

Swift

let path = GMSMutablePath()
path.addLatitude(-37.81319, longitude: 144.96298)
path.addLatitude(-31.95285, longitude: 115.85734)
let polyline = GMSPolyline(path: path)
polyline.strokeWidth = 10.0
polyline.geodesic = true
polyline.map = mapView