Analisar a resposta da matriz de rota

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

Uma solicitação de matriz de rotas recebe como entrada uma matriz de waypoints de origem e destino. A API Routes calcula o trajeto de cada waypoint de origem para 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 para um 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 rota calculada.

Usando a resposta, você pode oferecer aos clientes diferentes opções de trajeto e permitir que o usuário selecione a rota adequada às necessidades dele.

Sobre máscaras de campo

Ao chamar um método para calcular um trajeto, é necessário especificar uma máscara de campo que defina 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 o objeto de resposta inteiro sem considerar as máscaras de campo. Em um ambiente de produção, a resposta só incluiria os campos especificados 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:

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 baseado 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, um trajeto na resposta contém:

"originIndex": 1,
"destinationIndex": 0

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

Para o próximo trajeto:

"originIndex": 4,
"destinationIndex": 1

O trajeto foi calculado a partir do waypoint de origem no índice 4 na matriz de entrada e do waypoint de destino no índice 1 na matriz de entrada.

Sobre a resposta

O objeto JSON que representa a resposta da API contém uma matriz, em que cada elemento define o trajeto de um waypoint de origem para um de destino.

Além das propriedades originIndex e destinationIndex, cada trajeto contém informações específicas, como distanceMeters, duration e travelAdvisory.

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)
    }
  }
  …
]