Analisar a resposta da matriz de rota

Uma solicitação de matriz de rota usa como entrada uma matriz de origem e destino waypoints. A API Routes calcula a rota de cada origem para cada waypoint de destino. Por exemplo, se você especificar duas e dois waypoints de destino, a API calcula quatro pontos diferentes rotas de prioridade mais alta.

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

Usando a resposta, você pode fornecer aos clientes diferentes opções de trajeto e, em seguida, permita que o usuário selecione a rota apropriada para seus requisitos.

Sobre as máscaras de campo

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

Os exemplos neste documento mostram todo o objeto de resposta sem levar máscaras de campo em consideração. Em um ambiente de produção, a resposta seria inclua 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ê deve incluir a seguinte declaração de direitos autorais ao exibir os resultados aos seus usuários:

Powered by Google, ©YEAR Google

Exemplo:

Powered by Google, ©2023 Google

Identifique a rota na resposta

Use as propriedades de resposta originIndex e destinationIndex para identificar cada rota na resposta. Essas propriedades contêm o índice baseado em zero do os waypoints origin e destination de entrada usados para calcular a trajeto. Isso significa o primeiro waypoint de origem e o primeiro waypoint de destino da solicitação estejam 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 a partir da origem ponto de referência no índice 1 na matriz de entrada e do waypoint de destino em índice 0.

Para a próxima rota:

"originIndex": 4,
"destinationIndex": 1

O trajeto foi calculado a partir do ponto de referência de origem no índice 4 na entrada e do ponto de referência de destino no índice 1 da matriz de entrada.

Sobre a resposta

O Objeto JSON que representa a resposta da API contém uma matriz, na qual cada elemento de matriz define o trajeto de um waypoint de origem até um waypoint de destino.

Junto com as propriedades originIndex e destinationIndex, cada trajeto contém informações específicas desse trajeto, como distanceMeters, duration e travelAdvisory.

A resposta tem o seguinte 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)
    }
  }
  …
]