Com a API Routes Preferred, é possível solicitar informações sobre as condições de trânsito ao longo da polilinha. As condições de trânsito são expressas em termos de categorias de velocidade (NORMAL, SLOW, TRAFFIC_JAM) aplicáveis a um determinado intervalo da polilinha de resposta. Os intervalos são definidos pelos índices dos pontos de polilinha inicial (inclusivo) e final (exclusivo).
Exemplo de solicitação
A polilinha com informações de trânsito está disponível para o nível do trajeto e do trecho.
No nível do trajeto, as informações de velocidade do tráfego são fornecidas como SpeedReadingIntervals no campo de resposta RouteTravelAdvisory.
Para receber informações de trânsito com a polilinha do trajeto, inclua polyline
e speedReadingIntervals
na máscara de campo de resposta.
Se a máscara de campo contiver routes.legs.travelAdvisory.speedReadingIntervals
, a resposta conterá os dados de tráfego no nível do trecho em RouteLegTravelAdvisory.
X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline,routes.travelAdvisory.speedReadingIntervals,routes.legs.polyline.encodedPolyline,routes.legs.travelAdvisory.speedReadingIntervals
Acesse "Escolher campos para retornar" para mais detalhes sobre como especificar a máscara de campo de resposta.
Exemplo de resposta
Desde que speedReadingIntervals
sejam solicitados pela máscara de campo, eles vão ser preenchidos em routes.travelAdvisory.speedReadingIntervals
.
O trânsito no nível do trecho está disponível em routes.legs.travelAdvisory.speedReadingIntervals
.
Cada intervalo é descrito por startPolylinePointIndex
, endPolylinePointIndex
e pela categoria de velocidade correspondente.
A falta do índice inicial no intervalo
corresponde ao índice 0, de acordo com as práticas de 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" } ] } } ] }
Renderizar polilinhas com reconhecimento de trânsito usando o SDK do Maps
Recomendamos a exibição de polilinhas com informações de trânsito no mapa usando os vários recursos oferecidos pelos SDKs do Google Maps, incluindo cores, traços e padrões ao longo dos trechos de polilinha. Para mais detalhes sobre o uso de polilinhas, consulte Recursos de polilinha para Android e Recursos de polilinha para iOS.
Exemplo de renderização de polilinhas
Os usuários do SDK do Maps podem definir uma lógica de mapeamento personalizada entre as categorias de velocidade e os esquemas de renderização de polilinhas. Por exemplo, é possível exibir a velocidade "NORMAL" como uma linha azul grossa no mapa, enquanto a velocidade "LENTA" pode ser exibida como uma linha laranja grossa e assim por diante.
Os snippets a seguir adicionam um polígono azul espesso com segmentos geodésicos de Melbourne a Perth. Para mais informações, consulte Como personalizar aparências (para Android) e Personalizar a polilinha (para 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