Wysyłanie żądań informacji o ruchu na Polyline

Interfejs Routes Preferred API umożliwia wysyłanie żądań o informacje o warunkach natężenia ruchu na odcinku polilinii. Warunki na drogach są wyrażone w postaci kategorii prędkości (NORMAL, SLOW, TRAFFIC_JAM) dla danego przedziału łamanego odpowiedzi. Przedziały są definiowane przez indeksy punktów początkowych (włącznie) i końcowych (wyłącznie) ścieżki wielokąta.

Przykładowe żądanie

Polilinia uwzględniająca natężenie ruchu jest dostępna zarówno na poziomie trasy, jak i etapu. Na poziomie trasy informacje o prędkości ruchu są podawane w interwałach odczytu prędkości w polu odpowiedzi Informacje o przebiegu podróży. Aby otrzymywać informacje o natężeniu ruchu wzdłuż linii łamanej trasy, w masce pola odpowiedzi umieść zarówno polyline, jak i speedReadingIntervals.

Jeśli maska pola zawiera routes.legs.travelAdvisory.speedReadingIntervals, odpowiedź będzie zawierać dane o ruchu na poziomie nogi z sekcji RouteLegTravelAdvisory.

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

Aby dowiedzieć się więcej o określaniu maski pola odpowiedzi, zapoznaj się z sekcją „Wybieranie pól do zwrócenia”.

Przykładowa odpowiedź

Dopóki żądania speedReadingIntervals są żądane za pomocą maski pola, są wypełniane wartością routes.travelAdvisory.speedReadingIntervals. Dane o ruchu na poziomie segmentu są dostępne w sekcji routes.legs.travelAdvisory.speedReadingIntervals. Każdy przedział jest opisany przez startPolylinePointIndex, endPolylinePointIndex i odpowiadającą kategorię prędkości. Zwróć uwagę, że brak indeksu początkowego w interwale odpowiada indeksowi 0 zgodnie ze protokołem 3.

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

Renderowanie linii łamanych z uwzględnieniem natężenia ruchu za pomocą pakietu SDK Map

Zalecamy wyświetlanie na mapie linii łamanych uwzględniających natężenie ruchu za pomocą różnych funkcji dostępnych w pakietach SDK Map Google, takich jak niestandardowe kolory, obrysy i wzory na odcinkach linii łamanej. Więcej informacji o używaniu linii łamanych znajdziesz w artykułach Funkcje linii łamanych na Androida i Funkcje linii łamanej w iOS.

Przykład renderowania linii łamanej

Użytkownicy pakietu Maps SDK mogą zdefiniować niestandardową logikę mapowania między kategoriami prędkości a schematami renderowania linii złożonych. Na przykład prędkość „NORMALNA” może być wyświetlana na mapie jako gruba niebieska linia, a „WOLNA” – w postaci grubej pomarańczowej linii itd.

Poniższe fragmenty kodu dodają grubą niebieską linię łamaną z segmentami geodezyjnymi z Melbourne do Perth. Więcej informacji znajdziesz w sekcjach Dostosowywanie wyglądu (w Androidzie) i Dostosowywanie linii łamanej (w 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