API Distances Matriz | Time and distance of trip

¿Qué se puede hacer con la matriz de distancias de la API?

¿Por qué usar la API Distance Matrix?

Cómo usar la matriz de distancia de la API

Parámetros de solicitud

https://api.distancematrix.ai/maps/api/distancematrix/json?origins=<origin_location_1|origin_location_2|...|origin_location_n>&destinations=<destination_location_1|destination_location_2|...|destination_location_n>&key=<your_access_token>

https://api.distancematrix.ai/maps/api/distancematrix/json?origins=51.4822656,-0.1933769&destinations=51.4994794,-0.1269979&key=<your_access_token>

Parámetros requeridos

https://api.distancematrix.ai/maps/api/distancematrix/json?origins=Westminster Abbey, 20 Deans Yd, Westminster, London SW1P 3PA, United Kingdom&destinations=St John's Church, North End Rd, Fulham, London SW6 1PB, United Kingdom&key=<your_access_token>

{
    "destination_addresses": [
        "St John's Church, North End Rd, London SW6 1PB, United Kingdom"
    ],
    "origin_addresses": [
        "Westminster Abbey, 20 Deans Yd, London SW1P 3PA, United Kingdom"
    ],
    "rows": [
        {
            "elements": [
                {
                    "distance": {
                        "text": "7.3 km",
                        "value": 7346
                    },
                    "duration": {
                        "text": "23 mins",
                        "value": 1401
                    },
                    "origin": "Westminster Abbey, 20 Deans Yd, Westminster, London SW1P 3PA, United Kingdom",
                    "destination": "St John's Church, North End Rd, Fulham, London SW6 1PB, United Kingdom",
                    "status": "OK"
                }
            ]
        }
    ],
    "status": "OK"
}

https://api.distancematrix.ai/maps/api/distancematrix/json?origins=51.4822656,-0.1933769&destinations=51.4994794,-0.1269979&key=<your_access_token>

{
    "destination_addresses": [
        "Westminster Abbey, London SW1P 3PA, UK"
    ],
    "origin_addresses": [
        "Chapel, London SW6 1BA, UK"
    ],
    "rows": [
        {
            "elements": [
                {
                    "distance": {
                        "text": "7.6 km",
                        "value": 7567
                    },
                    "duration": {
                        "text": "22 mins",
                        "value": 1359
                    },
                    "origin": "51.4822656,-0.1933769",
                    "destination": "51.4994794,-0.1269979",
                    "status": "OK"
                }
            ]
        }
    ],
    "status": "OK"
}

Parámetros opcionales

• modo (el predeterminado es conducir): especifica el modo de transporte que se utilizará al calcular la distancia. Los valores válidos y otros detalles de la solicitud se especifican en el Modos de viaje sección de este documento.
• idioma: idioma que se utiliza para devolver los resultados.
  
  • 
    Consulta la lista de idiomas compatibles.
    
  • 
    Si no se proporciona el idioma, la API intenta usar el idioma preferido, tal como se especifica en el encabezado Accept-Language, o el idioma nativo del dominio desde el que se envía la solicitud.
    
  • 
    La API hace todo lo posible para proporcionar una dirección física que sea legible tanto para el usuario como para los lugareños. Para lograr ese objetivo, devuelve las direcciones postales en el idioma local, transliteradas a un script que el usuario pueda leer si es necesario, respetando el idioma preferido. Todas las demás direcciones se devuelven en el idioma preferido. Todos los componentes de la dirección se devuelven en el mismo idioma, que se elige del primer componente.
    
  • 
    Si un nombre no está disponible en el idioma preferido, la API usa la coincidencia más cercana.
    
  • 
    El idioma preferido tiene una pequeña influencia en el conjunto de resultados que la API decide devolver y en el orden en que se devuelven. El geocodificador interpreta las abreviaturas de forma diferente según el idioma, como las abreviaturas de los tipos de calles o los sinónimos que pueden ser válidos en un idioma pero no en otro. Por ejemplo, utca y tér son sinónimos de calle en húngaro.
    

• evitar: introduce restricciones en la ruta. Los valores válidos se especifican en Restricciones sección de este documento. Solo se puede especificar una restricción.
• unidades: especifica el sistema de unidades que se utilizará al expresar la distancia como texto. Consulte el Sistemas de unidades sección de este documento para obtener más información.
  
• arrival_time: especifica la hora de llegada deseada para las solicitudes de tránsito, en segundos desde la medianoche del 1 de enero de 1970, UTC. Puedes especificar departure_time o arrival_time, pero no ambos. Tenga en cuenta que arrival_time debe especificarse como un entero.
  

https://api.distancematrix.ai/maps/api/distancematrix/json?origins=51.507033,-0.1277161&destinations=52.486243,-1.890401&arrival_time=now&transit_mode=bus&mode=transit&key=<your_access_token>

{
    "destination_addresses": [
        "Raw Network, Sherborne B16 8FN, United Kingdom"
    ],
    "origin_addresses": [
        "Giaralis Karavasilis Tsavdaridis, 49 The Mall, London N14 6LR, United Kingdom"
    ],
    "rows": [
        {
            "elements": [
                {
                    "distance": {
                        "text": "166.4 km",
                        "value": 166409
                    },
                    "duration": {
                        "text": "4 hour 2 mins",
                        "value": 14524
                    },
                    "origin": "51.507033,-0.1277161",
                    "destination": "52.486243,-1.890401",
                    "status": "OK"
                }
            ]
        }
    ],
    "status": "OK"
}

• departure_time: la hora de salida deseada. Puede especificar la hora como un entero en segundos desde la medianoche del 1 de enero de 1970 (UTC). Como alternativa, puede especificar un valor de ahora, que establece la hora de salida en la hora actual (corrija al segundo más cercano). La hora de salida se debe establecer en la hora actual o en algún momento futuro. No puede estar en el pasado. Los resultados de una solicitud determinada pueden variar con el tiempo debido a los cambios en la red de carreteras, las condiciones medias del tráfico actualizadas y la naturaleza distribuida del servicio. Los resultados también pueden variar entre rutas casi equivalentes en cualquier momento o frecuencia. La hora de salida se puede especificar en dos casos:
  
  • 
    Para las solicitudes en las que el modo de viaje es tránsito: si lo desea, puede especificar uno de los modos departure_time o arrival_time. Si no se especifica ninguna hora, la hora de salida se establece de forma predeterminada en la hora actual (es decir, la hora de salida se establece de forma predeterminada en la hora actual).
    
  • 
    Para las solicitudes en las que el modo de viaje es conducir: puedes especificar la hora de salida para recibir una ruta y una duración del viaje (campo de respuesta: duration_in_traffic) que tengan en cuenta las condiciones del tráfico. La hora de salida debe configurarse en la hora actual o en algún momento futuro. No puede estar en el pasado.
    

https://api.distancematrix.ai/maps/api/distancematrix/json?origins=51.507033,-0.1277161&destinations=52.486243,-1.890401&departure_time=now&key=<your_access_token>

{
    "destination_addresses": [
        "Raw Network, Sherborne B16 8FN, United Kingdom"
    ],
    "origin_addresses": [
        "Giaralis Karavasilis Tsavdaridis, 49 The Mall, London N14 6LR, United Kingdom"
    ],
    "rows": [
        {
            "elements": [
                {
                    "distance": {
                        "text": "207.3 km",
                        "value": 207323
                    },
                    "duration": {
                        "text": "2 hour 27 mins",
                        "value": 8844
                    },
                    "duration_in_traffic": {
                        "text": "2 hour 29 mins",
                        "value": 8968
                    },
                    "origin": "51.507033,-0.1277161",
                    "destination": "52.486243,-1.890401",
                    "status": "OK"
                }
            ]
        }
    ],
    "status": "OK"
}

• traffic_model (el valor predeterminado es best_guess): especifica las suposiciones que se deben usar al calcular el tiempo de tráfico. Esta configuración afecta al valor devuelto en el campo duration_in_traffic de la respuesta, que contiene el tiempo previsto de tráfico según los promedios históricos. El parámetro traffic_model solo se puede especificar para las solicitudes en las que el modo de viaje sea conducir y en las que la solicitud incluya una hora de salida. Los valores disponibles para este parámetro son:
  
  • 
    best_guess (predeterminado) indica que la duration_in_traffic devuelta debe ser la mejor estimación del tiempo de viaje, dado lo que se sabe sobre las condiciones históricas del tráfico y el tráfico en tiempo real. El tráfico en tiempo real adquiere más importancia cuanto más se acerca la hora de salida a la fecha actual.
    
  • 
    pesimistic indica que la duration_in_traffic devuelta debería ser mayor que el tiempo de viaje real la mayoría de los días, aunque algunos días con condiciones de tráfico particularmente malas pueden superar este valor. Afecta al campo de la respuesta distance_in_traffic_model y devuelve la ruta más corta.
    
  • 
    optimista indica que la duración del tráfico devuelto debería ser inferior al tiempo de viaje real la mayoría de los días, aunque algunos días con condiciones de tráfico particularmente buenas pueden superar este valor. Afecta al campo de la respuesta distance_in_traffic_model y devuelve la ruta más corta.
    

https://api.distancematrix.ai/maps/api/distancematrix/json?origins=51.507033,-0.1277161&destinations=52.486243,-1.890401&traffic_model=pessimistic&departure_time=now&key=<your_access_token>

{
    "destination_addresses": [
        "Raw Network, Sherborne B16 8FN, United Kingdom"
    ],
    "origin_addresses": [
        "Giaralis Karavasilis Tsavdaridis, 49 The Mall, London N14 6LR, United Kingdom"
    ],
    "rows": [
        {
            "elements": [
                {
                    "distance": {
                        "text": "207.3 km",
                        "value": 207323
                    },
                    "duration": {
                        "text": "2 hour 27 mins",
                        "value": 8844
                    },
                    "duration_in_traffic": {
                        "text": "4 hour 0 mins",
                        "value": 14400
                    },
                    "distance_in_traffic_model": {
                        "text": "118 miles",
                        "value": 189274
                    },
                    "origin": "51.507033,-0.1277161",
                    "destination": "52.486243,-1.890401",
                    "status": "OK"
                }
            ]
        }
    ],
    "status": "OK"
}

• transit_mode: especifica uno o más modos de tránsito preferidos. Este parámetro solo se puede especificar para las solicitudes en las que el modo es de tránsito. El parámetro admite los siguientes argumentos:
  
  • 
    bus indica que la ruta calculada debería preferir viajar en autobús.
    
  • 
    metro indica que la ruta calculada debería preferir viajar en metro.
    
  • 
    tren indica que la ruta calculada debería preferir viajar en tren.
    
  • 
    tranvía indica que la ruta calculada debería preferir viajar en tranvía y tren ligero.
    
  • 
    rail indica que la ruta calculada debería preferir viajar en tren, tranvía, tren ligero y metro. Esto equivale a transit_mode=train|tram|subway.
    

https://api.distancematrix.ai/maps/api/distancematrix/json?origins=51.507033,-0.1277161&destinations=52.486243,-1.890401&transit_mode=bus|train|tram|subway&mode=transit&departure_time=now&key=<your_access_token>

{
    "destination_addresses": [
        "Raw Network, Sherborne B16 8FN, United Kingdom"
    ],
    "origin_addresses": [
        "Giaralis Karavasilis Tsavdaridis, 49 The Mall, London N14 6LR, United Kingdom"
    ],
    "rows": [
        {
            "elements": [
                {
                    "distance": {
                        "text": "207.3 km",
                        "value": 207323
                    },
                    "duration": {
                        "text": "2 hour 27 mins",
                        "value": 8844
                    },
                    "duration_in_traffic": {
                        "text": "2 hour 29 mins",
                        "value": 8968
                    },
                    "origin": "51.507033,-0.1277161",
                    "destination": "52.486243,-1.890401",
                    "status": "OK"
                }
            ]
        }
    ],
    "status": "OK"
}

Modos de viaje

• conducir (predeterminado) indica el cálculo de la distancia utilizando la red de carreteras.
  
• caminar solicita el cálculo de la distancia para caminar por senderos y aceras peatonales (cuando esté disponible).
  
• el ciclismo solicita el cálculo de la distancia para andar en bicicleta por carriles bici y calles preferidas (cuando esté disponible).
  
• el tránsito solicita el cálculo de la distancia a través de rutas de transporte público (cuando estén disponibles). Si configuras el modo como tránsito, debes especificar una hora de salida o una hora de llegada. Si no se especifica ninguna hora, la hora de salida se establece de forma predeterminada en la hora actual (es decir, la hora de salida se establece de forma predeterminada en la hora actual). También debes incluir un transit_mode.
  

https://api.distancematrix.ai/maps/api/distancematrix/json?origins=51.4822656,-0.1933769&destinations=51.4994794,-0.1269979&mode=walking&departure_time=now&key=<your_access_token>

{
    "destination_addresses": [
        "Westminster Abbey, London SW1P 3PA, UK"
    ],
    "origin_addresses": [
        "Chapel, London SW6 1BA, UK"
    ],
    "rows": [
        {
            "elements": [
                {
                    "distance": {
                        "text": "5.7 km",
                        "value": 5699
                    },
                    "duration": {
                        "text": "1 hour 12 mins",
                        "value": 4379
                    },
                    "origin": "51.4822656,-0.1933769",
                    "destination": "51.4994794,-0.1269979",
                    "status": "OK"
                }
            ]
        }
    ],
    "status": "OK"
}

Traffic information

• El parámetro del modo de viaje es conducir o no está especificado (conducir es el modo de viaje predeterminado).
  
• La solicitud incluye un parámetro departure_time válido. El departure_time se puede establecer en la hora actual o en otro momento.
  

https://api.distancematrix.ai/maps/api/distancematrix/json?origins=51.4822656,-0.1933769&destinations=51.4994794,-0.1269979&mode=driving&departure_time=now&key=<your_access_token>

{
    "destination_addresses": [
        "Westminster Abbey, London SW1P 3PA, UK"
    ],
    "origin_addresses": [
        "Chapel, London SW6 1BA, UK"
    ],
    "rows": [
        {
            "elements": [
                {
                    "distance": {
                        "text": "7.6 km",
                        "value": 7567
                    },
                    "duration": {
                        "text": "22 mins",
                        "value": 1359
                    },
                    "duration_in_traffic": {
                        "text": "23 mins",
                        "value": 1395
                    },
                    "origin": "51.4822656,-0.1933769",
                    "destination": "51.4994794,-0.1269979",
                    "status": "OK"
                }
            ]
        }
    ],
    "status": "OK"
}

Restricciones

• evitar=peajes
  
• evitar=autopistas
  
• avoid=ferries
  
• avoid=interior
  

https://api.distancematrix.ai/maps/api/distancematrix/json?origins=51.4822656,-0.1933769&destinations=51.4994794,-0.1269979&mode=driving&departure_time=now&avoid=ferries&key=<your_access_token>

{
    "destination_addresses": [
        "Westminster Abbey, London SW1P 3PA, UK"
    ],
    "origin_addresses": [
        "Chapel, London SW6 1BA, UK"
    ],
    "rows": [
        {
            "elements": [
                {
                    "distance": {
                        "text": "7.6 km",
                        "value": 7567
                    },
                    "duration": {
                        "text": "22 mins",
                        "value": 1359
                    },
                    "duration_in_traffic": {
                        "text": "26 mins",
                        "value": 1568
                    },
                    "origin": "51.4822656,-0.1933769",
                    "destination": "51.4994794,-0.1269979",
                    "status": "OK"
                }
            ]
        }
    ],
    "status": "OK"
}

Sistemas de unidades

• units=metric (predeterminado) devuelve las distancias en kilómetros y metros.
  
• units=imperial devuelve las distancias en millas y pies.
  

https://api.distancematrix.ai/maps/api/distancematrix/json?origins=51.4822656,-0.1933769&destinations=51.4994794,-0.1269979&departure_time=now&units=imperial&key=<your_access_token>

{
    "destination_addresses": [
        "Westminster Abbey, London SW1P 3PA, UK"
    ],
    "origin_addresses": [
        "Chapel, London SW6 1BA, UK"
    ],
    "rows": [
        {
            "elements": [
                {
                    "distance": {
                        "text": "4.7 mi",
                        "value": 7567
                    },
                    "duration": {
                        "text": "22 mins",
                        "value": 1359
                    },
                    "duration_in_traffic": {
                        "text": "26 mins",
                        "value": 1568
                    },
                    "origin": "51.4822656,-0.1933769",
                    "destination": "51.4994794,-0.1269979",
                    "status": "OK"
                }
            ]
        }
    ],
    "status": "OK"
}

Ejemplo de respuesta

{
    "destination_addresses": [
        "Westminster Abbey, London SW1P 3PA, UK"
    ],
    "origin_addresses": [
        "Chapel, London SW6 1BA, UK"
    ],
    "rows": [
        {
            "elements": [
                {
                    "distance": {
                        "text": "7.6 km",
                        "value": 7567
                    },
                    "duration": {
                        "text": "22 mins",
                        "value": 1359
                    },
                    "origin": "51.4822656,-0.1933769",
                    "destination": "51.4994794,-0.1269979",
                    "status": "OK"
                }
            ]
        }
    ],
    "status": "OK"
}

Elementos de respuesta de la matriz de distancia

• el estado contiene los metadatos de la solicitud. Consulte Códigos de estado abajo.
  
• origin_addresses contiene una matriz de direcciones devueltas por la API desde tu solicitud original. El geocodificador las formatea y las localiza de acuerdo con el parámetro de idioma que se transfirió con la solicitud.
  
• destination_addresses contiene una matriz de direcciones devueltas por la API desde tu solicitud inicial. Al igual que con origin_addresses, están localizadas si es necesario.
  
• las filas contienen una matriz de elementos, que a su vez contienen elementos de estado, duración y distancia.
  

Códigos de estado

Códigos de estado de nivel superior

• Aceptar indica que la respuesta contiene un resultado válido.
• INVALID_REQUEST indica que la solicitud proporcionada no es válida.
• MAX_ELEMENTS_EXCEEDED indica que el producto de origen y destino supera el límite por consulta.
• OVER_DAILY_LIMIT indica cualquiera de las siguientes opciones:
  
  • 
    Falta la clave de API o no es válida.
    
  • 
    La facturación no se ha activado en tu cuenta.
    
  • 
    Se ha superado un límite de uso autoimpuesto.
    
  • 
    El método de pago proporcionado ya no es válido (por ejemplo, una tarjeta de crédito ha caducado).
    
• OVER_QUERY_LIMIT indica que el servicio ha recibido demasiadas solicitudes de tu aplicación dentro del período de tiempo permitido.
• REQUEST_DENIED indica que el servicio denegó el uso del servicio Distance Matrix por parte de su aplicación.
• UNKNOWN_ERROR indica que no se pudo procesar una solicitud de Distance Matrix debido a un error del servidor. La solicitud puede realizarse correctamente si lo vuelve a intentar.

Códigos de estado a nivel de elemento

• OK indica la respuesta y contiene un resultado válido.
  
• NOT_FOUND indica que el origen o el destino de este emparejamiento no se pudieron geocodificar.
  
• ZERO_RESULTS indica que no se encontró ninguna ruta entre el origen y el destino.
  
• MAX_ROUTE_LENGTH_EXCEEDED indica que la ruta solicitada es demasiado larga y no se puede procesar.
  
• UNKNOWN_ERROR indica que no se pudo procesar una solicitud de Distance Matrix debido a un error del servidor. La solicitud puede realizarse correctamente si lo vuelve a intentar.
  

Mensajes de error

Filas

Elementos

• estado: Consulte Códigos de estado para obtener una lista de los posibles códigos de estado.
  
• duración: el tiempo que se tarda en recorrer esta ruta, expresado en segundos (el campo de valor) y como texto.
  
• duration_in_traffic: el tiempo que se tarda en recorrer esta ruta, según las condiciones del tráfico actuales e históricas.
  
• distancia: la distancia total de esta ruta, expresada en metros (valor) y como texto. El valor textual usa el sistema de unidades especificado con el parámetro de unidad de la solicitud original o la región de origen.
  
• distance_in_traffic_model: la distancia más corta necesaria para recorrer esta ruta, según las condiciones del tráfico actuales e históricas.