Idioma:
  • Português
  • Español

Distance Matrix

La API Distance Matrix es un servicio que proporciona distancia y tiempo de viaje para una variedad de orígenes y destinos considerando las especificaciones ingresadas en la request. La API devuelve información basada en la ruta recomendada entre los puntos de inicio y finalización.



Simulación de uso

Vamos a simular la obtención de la matriz de distancias entre 3 sitios, donde el método de cálculo de ruta elegido fue el más corto.

  • MASP

  • CEAGESP

  • ZOO de São Paulo

Visualización de puntos en el mapa

Datos de entrada

El parámetro avoidanceTypes tiene la función de incluir restricciones que se tendrán en cuenta en la construcción de la ruta, los valores disponibles son: TUNNELS, BRIDGES, FERRIES.


El parámetro “calculationMode se completó con THE_SHORTEST, esto asegura que la ruta calculada por la API de Distance Matrix es la ruta más corta, para el modo de cálculo más rápido, se usa el valor “THE_FASTEST”.

En los parámetros de “destinations” y “origins” se agregaron las coordenadas de los 3 sitios para que la API calcule la matriz de distancias entre los puntos. El parámetro siteid se utiliza para identificar los sitios con sus respectivos pares de coordenadas.

El parámetro restrictionZones» no se usó en esta simulación, pero este parámetro es capaz de determinar qué áreas deben evitarse al calcular el itinerario (usando la API de Restriction Zone).

Para la simulación se utilizó el perfil del itinerario de la ruta “MAPLINK”.


Ejemplo de request

En el caso de la simulación anterior, el código de request sería:

Ejemplo 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"
        }
    ],
    "tripProfile": "MAPLINK"
}

Ejemplo de response

En el caso de la simulación anterior, el código de response sería:

Ejemplo de response API Distance Matrix
{
    "id": "63ef8158277c7e6f4d53cec5",
    "clientId": "qBPERsYpGuBp9ksxA1EGncIYlVM8ULee",
    "elements": [
        {
            "origin": "MASP",
            "destination": "MASP",
            "distance": 0,
            "nominalDuration": 0,
            "averageSpeed": 0.0
        },
        {
            "origin": "MASP",
            "destination": "CEAGESP",
            "distance": 10987,
            "nominalDuration": 1392,
            "averageSpeed": 28.41
        },
        {
            "origin": "MASP",
            "destination": "ZOO",
            "distance": 13469,
            "nominalDuration": 1966,
            "averageSpeed": 24.66
        },
        {
            "origin": "CEAGESP",
            "destination": "MASP",
            "distance": 11171,
            "nominalDuration": 1366,
            "averageSpeed": 29.44
        },
        {
            "origin": "CEAGESP",
            "destination": "CEAGESP",
            "distance": 0,
            "nominalDuration": 0,
            "averageSpeed": 0.0
        },
        {
            "origin": "CEAGESP",
            "destination": "ZOO",
            "distance": 19974,
            "nominalDuration": 2334,
            "averageSpeed": 30.81
        },
        {
            "origin": "ZOO",
            "destination": "MASP",
            "distance": 13110,
            "nominalDuration": 1843,
            "averageSpeed": 25.61
        },
        {
            "origin": "ZOO",
            "destination": "CEAGESP",
            "distance": 19749,
            "nominalDuration": 2172,
            "averageSpeed": 32.73
        },
        {
            "origin": "ZOO",
            "destination": "ZOO",
            "distance": 0,
            "nominalDuration": 0,
            "averageSpeed": 0.0
        }
    ],
    "createdAt": 1676640602959
}

Resumen de cálculo

Salida Llegada Distancia Duración Velocidad media
MASP MASP 0 km 0 segundos 0 km/h
MASP CEAGESP 10.98 km 1392 segundos 28.41 km/h
MASP ZOO 13.46 km 1966 segundos 24.66 km/h
CEAGESP MASP 11.17 km 1366 segundos 29.44 km/h
CEAGESP CEAGESP 0 km 0 segundo 0 km/h
CEAGESP ZOO 19.97 km 2334 segundos 30.81 km/h
ZOO MASP 13.11 km 1843 segundos 25.61 km/h
ZOO CEAGESP 19.74 km 2172 segundos 32.73 km/h
ZOO ZOO 0 km 0 segundos 0 km/h
End of Content