Analisar a resposta da matriz de rota

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 valer para o uso dos serviços. A funcionalidade varia de acordo com a região. Saiba mais.

Uma solicitação de matriz de rotas usa como entrada uma matriz de waypoints de origem e destino. A API Routes calcula o trajeto de cada waypoint de origem até cada waypoint de destino. Por exemplo, se você especificar dois waypoints de origem e dois de destino, a API vai calcular quatro rotas separadas.

A resposta da API contém uma matriz, em que cada elemento corresponde ao trajeto de um waypoint de origem até um waypoint de destino. Portanto, se você especificar dois waypoints de origem e dois de destino, a matriz de resposta vai conter quatro elementos, um para cada trajeto calculado.

Com a resposta, você pode oferecer aos clientes diferentes opções de trajeto e permitir que o usuário selecione o trajeto adequado para as necessidades dele.

Observação: a Route Matrix não retorna informações detalhadas do trajeto, como trechos, etapas e polilinhas. Para receber informações detalhadas sobre o trajeto, informe uma única origem e um único destino para Compute Routes.

Sobre máscaras de campo

Ao chamar um método para calcular um trajeto, é necessário especificar uma máscara de campo que define quais campos você quer que sejam retornados na resposta. Não há uma lista padrão de campos retornados. Se você omitir essa lista, os métodos vão retornar um erro.

Os exemplos neste documento mostram todo o objeto de resposta sem considerar as máscaras de campo. Em um ambiente de produção, sua resposta incluiria apenas os campos que você especificar explicitamente na máscara de campo.

Para mais informações, consulte Escolher quais informações retornar.

Sobre a exibição de direitos autorais

Você precisa incluir a seguinte declaração de direitos autorais ao mostrar os resultados aos usuários:

Powered by Google, ©YEAR Google

Exemplo:

Powered by Google, ©2023 Google

Identificar o trajeto na resposta

Use as propriedades de resposta originIndex e destinationIndex para identificar cada trajeto na resposta. Essas propriedades contêm o índice com base em zero dos waypoints de origem e destino de entrada usados para calcular o trajeto. Isso significa que o primeiro waypoint de origem e o primeiro waypoint de destino na solicitação estão no índice 0 da matriz.

Por exemplo, uma rota na resposta contém:

"originIndex": 1,
"destinationIndex": 0

Essas propriedades indicam que o trajeto foi calculado do waypoint de origem no índice 1 na matriz de entrada e do waypoint de destino no índice 0.

Para a próxima rota:

"originIndex": 4,
"destinationIndex": 1

A rota foi calculada do waypoint de origem no índice 4 na matriz de entrada e do waypoint de destino no índice 1 na matriz de entrada.

Sobre as informações de trajeto na resposta

A resposta da API contém uma matriz, em que cada elemento define o trajeto de um waypoint de origem até um waypoint de destino. Esses elementos são RouteMatrixElements no método gRPC ou o corpo da resposta na resposta HTTP.

Além das propriedades originIndex e destinationIndex, cada elemento contém apenas informações básicas específicas desse trajeto, como distanceMeters, duration e travelAdvisory. Para receber informações mais detalhadas sobre um trajeto, como uma polilinha, use computeRoutes.

A resposta tem o formato:

[
  // One array element for each combination of origin and destination waypoints.
  {
    // The route for source waypoint 0 and destination waypoint 0.
    "originIndex": 0,
    "destinationIndex": 0,
    "status": {
      object (Status)
    },
    "condition": enum (RouteMatrixElementCondition),
    "distanceMeters": integer,
    "duration": string,
    "staticDuration": string,
    "travelAdvisory": {
      object (RouteTravelAdvisory)
    },
    "fallbackInfo": {
      object (FallbackInfo)
    }
  }
  {
    // The route for source waypoint 0 and destination waypoint 1.
    "originIndex": 0,
    "destinationIndex": 1,
    "status": {
      object (Status)
    },
    "condition": enum (RouteMatrixElementCondition),
    "distanceMeters": integer,
    "duration": string,
    "staticDuration": string,
    "travelAdvisory": {
      object (RouteTravelAdvisory)
    },
    "fallbackInfo": {
      object (FallbackInfo)
    }
  }
  …
]