Definir um ponto para um trajeto

Desenvolvedores do Espaço Econômico Europeu (EEE)

Se o endereço de faturamento estiver no Espaço Econômico Europeu, a partir de 8 de julho de 2025, os Termos de Serviço da Plataforma Google Maps para o EEE vão se aplicar ao uso dos Serviços. A funcionalidade varia de acordo com a região. Saiba mais.

Por padrão, os pontos de parada intermediários são usados para paradas de embarque e desembarque, mas também é possível especificar que um ponto de parada intermediário é apenas para passar.

Um trajeto que contém um waypoint de origem, um waypoint intermediário de passagem e um waypoint de destino tem apenas um trecho que conecta a origem e o destino, passando pelo waypoint intermediário (chamado de via).

Configure um ponto de passagem intermediário para ser um ponto de passagem direto definindo a propriedade via do ponto de passagem como true usando Waypoint (REST) ou Waypoint (gRPC).

A propriedade via é mais eficaz ao criar rotas em resposta ao usuário arrastando os pontos de referência no mapa. Assim, o usuário pode ver como a rota final pode ficar em tempo real e ajuda a garantir que os pontos de referência sejam colocados em locais acessíveis à API Compute Routes.

Atenção: usar o prefixo via: para evitar paradas resulta em rotas que são rígidas na interpretação do waypoint. Essa interpretação pode resultar em desvios graves no trajeto ou ZERO_RESULTS no código de status da resposta se a API Routes não conseguir criar um trajeto usando esse ponto.

O exemplo a seguir demonstra como marcar um ponto de parada intermediário como um ponto de parada de passagem.

{
  "location": {
    "latLng": {
      "latitude":37.419734,
      "longitude":-122.0827784
    }
  },
  "via": true
}

Acessar IDs de lugares para pontos de parada intermediários

Se você especificar a localização de uma origem, um destino ou um ponto de parada intermediário como uma string de endereço ou um plus code, a API tentará encontrar o local mais relevante com um ID de lugar correspondente. A matriz geocodingResults.intermediates nos resultados contém o ID do lugar correspondente ao local dos pontos de referência, além de outros dados sobre o local.

Observação: se um ponto de parada for especificado como um ID de lugar ou como coordenadas de latitude/longitude, ele será omitido dos resultados da pesquisa de ID de lugar.

Para cada elemento da matriz intermediates, use a propriedade intermediateWaypointRequestIndex para determinar qual ponto de referência intermediário na solicitação corresponde ao ID do lugar na resposta.

Exemplo:

• Você especifica três pontos de parada intermediários em uma solicitação. Dois desses pontos de referência são especificados por strings de endereço e um por coordenadas de latitude/longitude.

• Inclua geocodingResults na máscara de campo de resposta para especificar o retorno da matriz geocodingResults nos resultados.

curl -X POST -d '{
  "origin":{
    "address": "1600 Amphitheatre Parkway, Mountain View, CA"
  },
  "destination":{
    "address": "24 Willie Mays Plaza, San Francisco, CA 94107"
  },
  "intermediates": [
    {
      "address": "450 Serra Mall, Stanford, CA 94305, USA"
    },
    {
      "location":{
        "latLng":{
          "latitude": 37.419734,
          "longitude": -122.0807784
        }
      }
    },
    {
      "address": "1836 El Camino Real, Redwood City, CA 94063"
    }
  ],
  "travelMode": "DRIVE",
}'
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY'
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.legs,geocodingResults'
'https://routes.googleapis.com/directions/v2:computeRoutes'

A resposta inclui a matriz geocodingResults com o ID do lugar de origem, destino e dois dos três pontos de parada. Esses são os pontos de parada nos índices 0 e 2 da solicitação. Como o ponto de parada no índice 1 da solicitação foi especificado usando coordenadas de latitude/longitude, ele é omitido da matriz geocodingResults na resposta.

{
  "routes": [{...}],
  "geocodingResults": {
    "origin": {
      "geocoderStatus": {},
      "type": [
        "premise"
      ],
      "placeId": "ChIJj38IfwK6j4ARNcyPDnEGa9g"
    },
    "destination": {
     "geocoderStatus": {},
      "type": [
        "premise"
      ],
      "placeId": "ChIJI7ES6tl_j4ARVpDZoXbWAiY"
    },
    "intermediates": [
      {
        "geocoderStatus": {},
        "intermediateWaypointRequestIndex": 0,
        "type": [
            "street_address"
        ],
        "placeId": "ChIJvdLMGyq7j4ARScE5tWX_C0Y"
      },
      {
        "geocoderStatus": {},
        "intermediateWaypointRequestIndex": 2,
        "type": [
          "premise"
        ],
        "placeId": "ChIJkTc0GKajj4AR9UMsOSHwGD0"
      }
    ]
  }
}