Idioma:
  • Português
  • Español

Distance Matrix

A Distance Matrix API é um serviço que fornece a distância e tempo de viagem para uma matriz de origens e destinos considerando as especificações inseridas na request. A API retorna informações com base na rota recomendada entre os pontos inicial e final.


Simulação de uso

Vamos simular a obtenção da matriz de distância entre 3 sites, onde o modo de cálculo da rota escolhido foi a mais curta.

  • MASP

     

     

  • CEAGESP

     

     

  • ZOO de São Paulo

     

     

Legenda: Visualização dos pontos no mapa.

Dados de entrada

O parâmetro “avoidanceTypes” possui a função de incluir restrições que serão consideradas na construção da rota, os valores disponíveis são: “TUNNELS”, “BRIDGES”, “FERRIES”, “TOLL_ROADS”, “TOLL_GATES”.

O parâmetro “calculationMode” foi preenchido com “THE_SHORTEST”, isso garante que o itinerário calculado pela API Distance Matrix é o trajeto mais curto, para o modo de cálculo mais rápido, é utilizado o valor “THE_FASTEST”.

Nos parâmetros “destinations” e “origins” foram adicionadas as coordenadas dos 3 sites para a API fazer o cálculo da matriz de distância entre os pontos. O parâmetro “siteid” é utilizado para identificar os sites com seus respectivos pares de coordenadas.

O parâmetro “restrictionZones” não foi utilizado nesta simulação, mas esse parâmetro consegue determinar quais áreas devem ser evitadas no momento do cálculo do itinerário (necessário utilizar a API Restriction Zone).

Para a simulação foi utilizado o perfil de itinerário de rotas “MAPLINK”.


Exemplo de request

No caso da simulação acima, o código de request seria:

Exemplo de request API Distance Matrix
{
    "avoidanceTypes": [],
    "calculationMode": "THE_SHORTEST",
    "destinations": [
        {
            "latitude": -23.561603,
            "longitude": -46.655840,
            "siteId": "MASP"
        },
        {
            "latitude": -23.535016,
            "longitude": -46.735701,
            "siteId": "CEAGESP"
        },
        {
            "latitude": -23.650886,
            "longitude": -46.626675,
            "siteId": "ZOO"
        }
    ],
    "origins": [
        {
            "latitude": -23.561603,
            "longitude": -46.655840,
            "siteId": "MASP"
        },
        {
            "latitude": -23.535016,
            "longitude": -46.735701,
            "siteId": "CEAGESP"
        },
         {
            "latitude": -23.650886,
            "longitude": -46.626675,
            "siteId": "ZOO"
        }
    ],
    "restrictionZones": [],
    "tripProfile": "MAPLINK"
}

Exemplo de response

No caso da simulação acima, o código de response seria:

Exemplo de response API Distance Matrix
{
    "id": "5f6295695f9698634f2de3bb",
    "clientId": "*",
    "elements": [
        {
            "origin": "MASP",
            "destination": "MASP",
            "distance": 0,
            "nominalDuration": 0,
            "averageSpeed": 0.0,
        },
        {
            "origin": "MASP",
            "destination": "CEAGESP",
            "distance": 11820,
            "nominalDuration": 1203,
            "averageSpeed": 35.37,
        },
        {
            "origin": "MASP",
            "destination": "ZOO",
            "distance": 13744,
            "nominalDuration": 1516,
            "averageSpeed": 32.64,
        },
        {
            "origin": "CEAGESP",
            "destination": "MASP",
            "distance": 10724,
            "nominalDuration": 1125,
            "averageSpeed": 34.32
        },
        {
            "origin": "CEAGESP",
            "destination": "CEAGESP",
            "distance": 0,
            "nominalDuration": 0,
            "averageSpeed": 0.0
        },
        {
            "origin": "CEAGESP",
            "destination": "ZOO",
            "distance": 19612,
            "nominalDuration": 2074,
            "averageSpeed": 34.04
        },
        {
            "origin": "ZOO",
            "destination": "MASP",
            "distance": 12240,
            "nominalDuration": 1390,
            "averageSpeed": 31.7
        },
        {
            "origin": "ZOO",
            "destination": "CEAGESP",
            "distance": 19657,
            "nominalDuration": 1932,
            "averageSpeed": 36.63
        },
        {
            "origin": "ZOO",
            "destination": "ZOO",
            "distance": 0,
            "nominalDuration": 0,
            "averageSpeed": 0.0
        }
    ],
    "createdAt": 1600296299267
}


Resumo do cálculo

Partida Chegada Distância Duração Velocidade média
MASP MASP 0 km 0 segundo 0 km/h
MASP CEAGESP 11.82 km 1203 segundos 35.37 km/h
MASP ZOO 13.74 km 1516 segundos 32.34 km/h
CEAGESP MASP 10.72 km 1125 segundos 34.32 km/h
CEAGESP CEAGESP 0 km 0 segundo 0 km/h
CEAGESP ZOO 16.61 km 2074 segundos 34.04 km/h
ZOO MASP 12.24 km 1390 segundos 31.70 km/h
ZOO CEAGESP 19.65 km 1932 segundos 36.63 km/h
ZOO ZOO 0 km 0 segundo 0 km/h
End of Content