Mit der Routes Preferred API können Sie Informationen zu den Verkehrsbedingungen entlang der Polylinie anfordern. Die Verkehrslage wird in Form von Geschwindigkeitskategorien (NORMAL, SLOW, TRAFFIC_JAM) angegeben, die für ein bestimmtes Intervall des Antwortpolygons gelten. Die Intervalle werden durch die Indexe ihrer Polylinienpunkte am Anfang (inklusive) und Ende (exklusiv) definiert.

Beispielanfrage

Die verkehrsabhängige Polylinie ist sowohl auf Routen- als auch auf Streckenebene verfügbar. Auf Routenebene werden die Informationen zur Verkehrsgeschwindigkeit als SpeedReadingIntervals im Antwortfeld RouteTravelAdvisory bereitgestellt. Wenn Sie neben der Polylinie der Route auch Informationen zur Verkehrslage erhalten möchten, geben Sie sowohl polyline als auch speedReadingIntervals in die Antwortfeldmaske ein.

Wenn die Feldmaske routes.legs.travelAdvisory.speedReadingIntervals enthält, enthält die Antwort die Verkehrsdaten auf Streckenabschnittsebene unter RouteLegTravelAdvisory.

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

Weitere Informationen zur Angabe der Antwortfeldmaske finden Sie unter Zurückzugebende Felder auswählen.

Beispielantwort

Solange speedReadingIntervals über die Feldmaske angefordert werden, werden sie unter routes.travelAdvisory.speedReadingIntervals eingefügt. Die Zugriffe auf Streckenebene sind unter routes.legs.travelAdvisory.speedReadingIntervals verfügbar. Jedes Intervall wird durch startPolylinePointIndex, endPolylinePointIndex und die entsprechende Geschwindigkeitskategorie beschrieben. Beachten Sie, dass der fehlende Startindex im Intervall gemäß den proto3-Praktiken dem Index 0 entspricht.

{
  "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"
          }
        ] 
      }
    }
  ]
}

Stauabhängige Polylinien mit dem Maps SDK rendern

Wir empfehlen, verkehrsabhängige Polylinien auf der Karte mithilfe der verschiedenen Funktionen der Google Maps SDKs anzuzeigen, einschließlich benutzerdefinierter Farben, Striche und Muster entlang der Polylinienabschnitte. Weitere Informationen zur Verwendung von Polylinien finden Sie unter Polylinienelemente für Android und Polylinienelemente für iOS.

Beispiel für das Rendern von Polylinien

Nutzer des Maps SDK können eine benutzerdefinierte Zuordnungslogik zwischen den Geschwindigkeitskategorien und den Polylinien-Rendering-Schemas definieren. So kann beispielsweise die Geschwindigkeit „NORMAL“ als dicke blaue Linie auf der Karte dargestellt werden, während „LANGSAM“ als dicke orangefarbene Linie angezeigt wird.

Mit den folgenden Snippets wird eine dicke blaue Polylinie mit geodätischen Segmenten von Melbourne nach Perth hinzugefügt. Weitere Informationen finden Sie unter Darstellung anpassen (Android) und Polylinie anpassen (iOS).

Android

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));

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

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;

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