Interfejs Routes Preferred API umożliwia wysyłanie żądań informacji o warunkach ruchu wzdłuż linii łamanej. Warunki ruchu są wyrażone w postaci kategorii prędkości (NORMAL, SLOW, TRAFFIC_JAM), które obowiązują w danym przedziale czasu linii łamanej odpowiedzi. Przedziały są definiowane przez indeksy ich początkowego (włącznie) i końcowego punktu łamanego (wyłącznie).
Przykładowe żądanie
Linia łamana z informacjami o ruchu jest dostępna na poziomie trasy i etapu.
Na poziomie trasy informacje o szybkości ruchu są podawane w polu SpeedReadingIntervals w polu odpowiedzi RouteTravelAdvisory.
Aby otrzymywać informacje o ruchu drogowym obok 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 części w sekcji RouteLegTravelAdvisory.
X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline,routes.travelAdvisory.speedReadingIntervals,routes.legs.polyline.encodedPolyline,routes.legs.travelAdvisory.speedReadingIntervals
Dodatkowe informacje o określaniu maski pola odpowiedzi znajdziesz w artykule „Choose Fields to Return” (Wybierz pola do zwrócenia).
Przykładowa odpowiedź
Jeśli żądania speedReadingIntervals
są wysyłane za pomocą maski pola, są one wypełniane w polu routes.travelAdvisory.speedReadingIntervals
.
Ruch na poziomie części jest dostępny dla: routes.legs.travelAdvisory.speedReadingIntervals
.
Każdy interwał jest opisany przez jego startPolylinePointIndex
, endPolylinePointIndex
oraz odpowiednią kategorię prędkości.
Pamiętaj, że brak indeksu początkowego w danym przedziale czasu odpowiada indeksowi 0 zgodnie z protokołami Proto3.
{ "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 linijek rozpoznających ruch za pomocą pakietu SDK Map Google
Zalecamy wyświetlanie na mapie linii łamanych związanych z natężeniem ruchu, korzystając z różnych funkcji oferowanych przez pakiety SDK Map Google, takich jak niestandardowe kolorowanie, kreski i wzory wzdłuż rozciągnięć linii łamanej. Szczegółowe informacje o korzystaniu z linii łamanych znajdziesz w artykule Funkcje Polyline na Androida i Funkcje Polyline na iOS.
Przykład renderowania linii łamanej
Użytkownicy pakietu SDK Map Google mogą zdefiniować własną logikę mapowania między kategoriami prędkości a schematami renderowania linii łamanych. Na przykład można wyświetlić prędkość „NORMAL” jako grubą niebieską linię na mapie, a „WOLNA” – jako grubą pomarańczową linię i tak dalej.
Poniższe fragmenty kodu dodają grubą niebieską linię łamaną z segmentami geodezyjnymi z Melbourne do Perth. Więcej informacji znajdziesz w artykułach Dostosowywanie wyglądu (na Androidzie) i Dostosowywanie Polyline (na 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