Receber uma rota mais curta

Este produto ou recurso é experimental (pré-GA). Os produtos e recursos pré-GA têm suporte limitado, e é possível que as mudanças neles não sejam compatíveis com versões anteriores. As Soluções pré-GA são cobertas pelos Termos de Serviço da Plataforma Google Maps. Para mais detalhes, consulte as descrições da fase de lançamento.

A API Routes pode retornar rotas de carro otimizadas para uma distância de viagem menor quando você ativa rotas de distância mais curta.

Quando você solicita um trajeto de distância mais curta, o serviço retorna o seguinte:

• A rota padrão, que é otimizada principalmente para o tempo estimado de chegada.
• Um trajeto mais curto otimizado para minimizar a distância de toda a viagem.

Observação: o trajeto de distância mais curta retornado pela API Routes é otimizado para uma distância menor percorrida durante a viagem.

O que é e por que usar

Uma rota de distância mais curta prioriza a distância em vez do conforto ou da velocidade da direção. Por exemplo, ele pode preferir vias locais em vez de rodovias, pegar estradas de terra ou cortar estacionamentos. Ele não retorna nenhuma manobra que o Google Maps sabe que é ilegal.

Solicitar uma rota mais curta

Sua solicitação precisa atender aos seguintes critérios:

• Defina travelMode como DRIVE, BICYCLE ou TWO_WHEELER.
• Defina requestedReferenceRoutes como SHORTER_DISTANCE.
• Defina uma máscara de campo de resposta para retornar as propriedades de resposta associadas a um trajeto de distância mais curta:
  • routes.routeLabels: identifica cada rota como DEFAULT_ROUTE, SHORTER_DISTANCE ou DEFAULT_ROUTE_ALTERNATE.
  • routes.routeToken: um token de trajeto que pode ser transmitido ao SDK do Navigation para recuperar um trajeto personalizado.
• Não inclua waypoints intermediários Via.
• Não inclua o parâmetro optimizeWaypointOrder.
• Opcional: defina uma máscara de campo de resposta para retornar as seguintes propriedades associadas à rota padrão e à rota de distância mais curta:
  • routes.distanceMeters: retorna a distância da rota.
  • routes.duration: retorna a duração da rota.

Observação: qualquer solicitação que não atenda a esses critérios retorna um erro.

Para informações de referência, consulte ReferenceRoute e RouteLabel.

Exemplo de solicitação: rota de distância mais curta

O código a seguir mostra uma solicitação para um trajeto de distância mais curta. Neste exemplo, você usa a máscara de campo de resposta para retornar campos associados à rota padrão e à rota de distância mais curta com as seguintes máscaras de campo:

• routes.distanceMeters
• routes.duration

curl -X POST -H 'content-type: application/json' -d '{
  "origin": {
    "location": {
      "latLng": {
        "latitude": 41.76904801292959,
        "longitude": -72.67374935684933
      }
    }
  },
  "destination": {
    "location": {
      "latLng": {
        "latitude": 41.823042361105024,
        "longitude": -71.40933143059424
      }
    }
  },
  "travelMode":"DRIVE",
  "routingPreference":"TRAFFIC_AWARE",
  "requestedReferenceRoutes": ["SHORTER_DISTANCE"],
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY \
-H 'X-Goog-FieldMask: routes.distanceMeters,routes.duration,routes.routeLabels,routes.routeToken' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

Exemplo de resposta de rota mais curta

{
  "routes": [
    {
      "distanceMeters": 138943,
      "duration": "5373s",
      "routeToken": "CrsCCs4BMssBGq8BCkECFg9eN0MowaEI3Y4KqMEhzOTe-Qi3947kBsb8koUBkvX0oAKJ_b1S4uPoUvzzAYfXA92t_RXyw98Up6qKAaRaABIsNBjodKMdkMYAPMLMIajCwj-zsIxpgyBxOLYjdBBeKgkO3tFDDrj4YgZB5bMaFQAATME12CCCA9MEF-kO2wL_____DyoLHgAOAHN3DggAQQEyBAUBAQM9VDgqPkV88FI_SNO81oLq4JnjYyIXcklWWFo2cjhDZmltdk9NUDQ3aU1nUU0QBRpPCk0KGAoNCgIIAREAAAAAAIBmQBF56SYxqDm4QBISCAAQAxAGEBMQEhgCQgQaAggFIhsKF3JJVlhaLWFOQnZpbXZPTVA0N2lNZ1FNcAEoASIVAACBmRY1BjeCiUQewJGTrQ3DuHRp",
      "routeLabels": [
        "DEFAULT_ROUTE"
      ]
    },
    {
      "distanceMeters": 112610,
      "duration": "7165s",
      "routeToken": "CqgCCrsBMrgBGpwBCjYCFg1SN0MowaEI3Y4KjfqjF6Ls9BXc-QGiqCOpu7FDtfCXxSG2zLOGI_r4uQGc-we_nQ7MLAASLDQY6HSjHZDGg26EAFrPI5Q3NxvGA4ELazy3sLYqno_9eAFD2KxlCqAGQeWzGg4AAMQDGwyiAqwwKQggJCoLHgBsCQ8Acm0XWWcyAgQGPVQ4Kj5FfPBSP0jikPWC95WdhIwBIhdySVZYWjZHR0RiTzV2T01QOUpiQXlBTRAFGk8KTQoYCg0KAggCEQAAAAAAAFlAEU5iEFh5af1AEhIIABADEAYQExASGAJCBBoCCAUiGwoXcklWWFo3S09Cck81dk9NUDlKYkF5QU1wASgCIhUAAIGZFlj_CmMgGE6KGZcsE-tEywM",
      "routeLabels": [
        "SHORTER_DISTANCE"
      ]
    }
  ]
}

Exemplo de solicitação: trajeto mais curto e econômico

O código a seguir mostra uma solicitação para uma rota de distância mais curta e uma rota com economia de combustível.

`

 curl -X POST -d '{
"origin": {  "location": {  "latLng": {  "latitude": 41.76904801292959,
"longitude": -72.67374935684933  }  }  },  "destination": {  "location": {
"latLng": {  "latitude": 41.823042361105024,  "longitude": -71.40933143059424  }
 }  },  "travelMode":"DRIVE",  "routingPreference":"TRAFFIC_AWARE_OPTIMAL",
"requestedReferenceRoutes": ["SHORTER_DISTANCE", "FUEL_EFFICIENT"] }' 

-H 'Content-Type: application/json' 

-H 'X-Goog-Api-Key: YOUR_API_KEY' 

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

'https://routes.googleapis.com/directions/v2:computeRoutes'

Exemplo de resposta: menor distância e trajeto mais econômico

Nesse caso, a distância mais curta e o trajeto mais econômico são os mesmos. Portanto, esse trajeto é retornado e o routeLabel é incluído para os dois tipos de trajeto.

{  "routes": [  {  "distanceMeters": 138943,  "duration": "5375s",
"routeToken":
"Cr8CCs4BMssBGq8BCkECFg9eN0MowaEI3Y4KqMEhzOTe-Qi3947kBsb8koUBkvX0oAKJ_b1S4uPoUvzzAYfXA92t_RXyw98Up6qKAaRaABIsNBjodKMdkMYAPMLMIajCwj-zsIxpgyBxOLYjdBBeKgkO3tFDDrj4YgZB5bMaFQAATME12CCCA9MEF-kO2wL_____DyoLHgAOAHN3DggAQQEyBAUBAQM9VDgqPkV88FI_SNO81oLq4JnjYyIXS1laWFo4T19JcWVCM2ZFUDFMbms4UXcQBRpTClEKGAoNCgIIAREAAAAAAIBmQBFOYhBYGTy4QBIWCAAQAxAGEBMQEhgCQgQaAggFSgIIASIbChdLWVpYWjlpV0g2ZUIzZkVQMUxuazhRd3ABKAEiFQAAgZkW4Df4cspNNJZWlMZuUUxLPQ",
 "routeLabels": [  "DEFAULT_ROUTE"  ]  },  {  "distanceMeters": 112610,
"duration": "7156s",  "routeToken":
"CqwCCrsBMrgBGpwBCjYCFg1SN0MowaEI3Y4KjfqjF6Ls9BXc-QGiqCOpu7FDtfCXxSG2zLOGI_r4uQGc-we_nQ7MLAASLDQY6HSjHZDGg26EAFrPI5Q3NxvGA4ELazy3sLYqno_9eAFD2KxlCqAGQeWzGg4AAMQDGwyiAqwwKQggJCoLHgBsCQ8Acm0XWWcyAgQGPVQ4Kj5FfPBSP0jikPWC95WdhIwBIhdLWVpYWi1UNklfT055OVlQczhhcWlRSRAFGlMKUQoYCg0KAggCEQAAAAAAAFlAEU5iEFh5af1AEhYIABADEAYQExASGAJCBBoCCAVKAggBIhsKF0tZWlhaNERXSF9PTnk5WVBzOGFxaVFJcAEoAiIVAACBmRaESp2EJS5nmwiEF8KH15_f",
 "routeLabels": [  "FUEL_EFFICIENT",  "SHORTER_DISTANCE"  ]  }  ] }

Regiões compatíveis

Os trajetos de distâncias mais curtas são aceitos em todas as regiões.

Faturamento

A Plataforma Google Maps não cobra um valor extra pelo uso de um recurso experimental. A cobrança será feita com base no uso da API e em outros parâmetros definidos.

Saiba mais sobre o faturamento da API Routes.