Solicitar informações de tráfego na polilinha

A API Routes Preferred oferece a possibilidade de 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, LENTO, ENGARRAFAMENTO) 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 reconhecimento de trânsito está disponível para o nível de rota e de trecho. No nível da rota, 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 junto com a polilinha da rota, inclua polyline e speedReadingIntervals na máscara do campo de resposta.

Se a máscara do campo contiver routes.legs.travelAdvisory.speedReadingIntervals, a resposta vai conter as informações de trânsito 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 a serem retornados" para mais detalhes sobre como especificar a máscara do campo de resposta.

Exemplo de resposta

Desde que speedReadingIntervals sejam solicitados pela máscara do campo, eles serão 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 a categoria de velocidade correspondente. A falta de índice inicial no intervalo corresponde ao índice 0, de acordo com as práticas do 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áfego usando o SDK do Maps

Recomendamos mostrar polilinhas com reconhecimento de trânsito no mapa usando os vários recursos oferecidos pelos SDKs do Google Maps, incluindo cores, traços e padrões personalizados ao longo dos trechos da polilinha. Para mais detalhes sobre como usar polilinhas, consulte Recursos de polilinha para Android e Recursos de polilinha para iOS.

Exemplo de renderização de polilinha

Os usuários do SDK do Maps têm a oportunidade de definir uma lógica de mapeamento personalizada entre as categorias de velocidade e os esquemas de renderização de polilinha. Por exemplo, é possível mostrar a velocidade "NORMAL" como uma linha azul espessa no mapa, enquanto a velocidade "LENTA" pode ser mostrada como uma linha laranja espessa e assim por diante.

Os snippets a seguir adicionam uma polilinha azul espessa com segmentos geodésicos de Melbourne a Perth. Para mais informações, consulte 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