Solicitar trajetos alternativos

Por padrão, a API Routes retorna a rota default, que normalmente é o trajeto mais rápido da origem ao destino. Quando você solicitar alternativas, a API retorna até três rotas, além da rota padrão trajeto. Seus clientes podem escolher o trajeto mais adequado às necessidades deles.

Considerações ao solicitar rotas alternativas

Para solicitar trajetos alternativos, considere as seguintes considerações:

  • Só é possível solicitar trajetos alternativos para trajetos sem valores intermediários waypoints. Solicitar rotas alternativas quando o trajeto especifica waypoints intermediários não causa um erro. No entanto, nenhuma alternativa rotas são retornadas.

  • A resposta contém no máximo três rotas alternativas. No entanto, às vezes, não há rotas alternativas disponíveis, então a resposta contém apenas a rota padrão.

  • Devido ao processamento adicional necessário para calcular valores rotas alternativas, a solicitação de trajetos alternativos pode aumentar o tempo de resposta dos a API.

Exemplo de solicitação de trajetos alternativos

Defina computeAlternativeRoutes como true para solicitar trajetos alternativos. O exemplo a seguir mostra como solicitar trajetos alternativos em uma computeRoutes (REST).

curl -X POST -d '{
  "origin":{
    "location":{
      "latLng":{
        "latitude":42.340173523716736,
        "longitude":-71.05997968330408
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude":42.075698891472804,
        "longitude": -72.59806562080408
      }
    }
  },
  "travelMode": "DRIVE",
  "routingPreference":"TRAFFIC_AWARE",
  "computeAlternativeRoutes": true
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.routeLabels' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

Neste exemplo, você especifica uma máscara de campo para que a resposta contenha apenas o Propriedades duration, distanceMeters, e routeLabels para cada trajeto. Seu o cliente poderá usar essas informações para escolher o caminho a seguir. Para mais informações, consulte Escolher quais informações retornar.

Exemplo de resposta de rotas alternativas

Na resposta, use a propriedade de matriz routeLabels para identificar o alcance rota:

  • Para a rota padrão, a propriedade routeLabels contém DEFAULT_ROUTE.

  • Para os trajetos alternativos, a propriedade routeLabels contém DEFAULT_ROUTE_ALTERNATE.

.

Neste exemplo, a resposta contém o trajeto padrão e duas alternativas rotas de prioridade mais alta. Os valores das propriedades duration e distanceMeters são diferentes para cada trajeto:

{
  "routes": [
    {
      "distanceMeters": 150322,
      "duration": "5309s",
      "routeLabels": [
        "DEFAULT_ROUTE"
      ]
    },
    {
      "distanceMeters": 157614,
      "duration": "6879s",
      "routeLabels": [
        "DEFAULT_ROUTE_ALTERNATE"
      ]
    },
    {
      "distanceMeters": 189311,
      "duration": "7376s",
      "routeLabels": [
        "DEFAULT_ROUTE_ALTERNATE"
      ]
    }
   ]
}

Incluir polilinhas na resposta

Para que o usuário selecione o trajeto mais facilmente, adicione o polyline para cada trajeto à resposta. É possível exibir cada polilinha em um mapa.

Para adicionar a polilinha, inclua routes.polyline na máscara de campo:

-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.routeLabels,routes.polyline'

A resposta contém a polilinha de cada trajeto:

{
  "routes": [
    {
      "distanceMeters": 150322,
      "duration": "5309s",
      "polyline": {
        "encodedPolyline": "mrlaGtavpLPLBTm…PgA^qC"
      },
      "routeLabels": [
        "DEFAULT_ROUTE"
      ]
    },
    {
      "distanceMeters": 157614,
      "duration": "6879s",
      "polyline": {
        "encodedPolyline": "DmEd`@e@pCo@pCs@z…PgA^qC"
      },
      "routeLabels": [
        "DEFAULT_ROUTE_ALTERNATE"
      ]
    },
    {
      "distanceMeters": 189311,
      "duration": "7376s",
      "polyline": {
        "encodedPolyline": "FVLL|Af@HPAV…PgA^qC"
      },
      "routeLabels": [
        "DEFAULT_ROUTE_ALTERNATE"
      ]
    }
   ]
}