Distance Matrix

---

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.

---

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