API Distances Matriz | Time and distance of trip

Pautas para desarrolladores
Antes de empezar
Es un servicio de API HTTP que está diseñado para calcular todas las combinaciones posibles entre el punto de partida y el destino y permite considerar la congestión del tráfico y un modo de transporte específico. Esta API de tiempo de viaje está disponible en cualquier parte del mundo y garantiza un nivel similar de precisión y respuesta con las mejores herramientas análogas, como la API de matriz de distancias de Google.

En esta documentación de la API Distance Matrix, encontrará una introducción sobre el uso del producto y material de referencia sobre los parámetros disponibles.

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

Este producto garantiza a los desarrolladores un cálculo del tiempo de viaje y la distancia entre algunos puntos. Por lo tanto, los diferentes tipos de servicios de entrega y mensajería, como la entrega de alimentos, productos y medicamentos, tienen importantes beneficios gracias a su uso. Además, puede utilizar nuestra API en la planificación de rutas, la logística y el transporte, así como en el desarrollo de software, el sector inmobiliario y los servicios domésticos y empresariales.

En particular, el producto es muy útil para las aplicaciones de taxi. Permite calcular el tiempo de entrega del automóvil respetando los atascos y la congestión.

Para elegir la ruta más corta del servicio de entrega de alimentos desde cafeterías y restaurantes, nuestra API de tiempo de viaje calcula el tiempo de entrega desde cada restaurante a la dirección del cliente teniendo en cuenta la congestión de la carretera.

¿Por qué usar la API Distance Matrix?

Puede utilizar nuestro producto para encontrar el punto de destino más cercano al punto de origen o para cualquier otro propósito. La API devolverá la duración y la distancia de la ruta más rápida o corta de cada elemento. A su vez, cada elemento es un par origen-destino.

Esta solución funciona en todo el mundo y está disponible para los modos de viaje en automóvil, a pie, en bicicleta y en transporte público.

Si el tráfico en tiempo real no afecta significativamente a su negocio, puede ahorrar tiempo y aumentar el rendimiento del producto utilizando su versión sin supervisión del tráfico. Para un gran volumen de cálculo, puede considerar nuestra API de matriz de distancia asincrónica.

Cómo usar la matriz de distancia de la API

Usted proporciona los datos de entrada (direcciones o coordenadas) para los que desee hacer una estimación. Recibirás una respuesta en formato JSON y la respuesta contendrá información sobre la duración de cada sección de ruta construida. El tiempo de viaje calculado para una sección de ruta siempre tiene en cuenta las condiciones actuales del tráfico y la previsión del tráfico.

Por ejemplo, hay tres ubicaciones de inicio A, B y C, y tres ubicaciones de destino E, B y D. La API de distancia devuelve la matriz de duraciones en segundos y distancias en metros entre las ubicaciones. No devuelve geometrías de ruta.
↓ origenes/destinos ➔
E
B
D
UN
A a E
A a B
A a D
B
B a E
B a B = 0
B a D
C
C a E
C a B
C a D
Es posible que el tiempo y la distancia entre los puntos no sean simétricos, ya que las rutas pueden diferir según la dirección debido a las calles de sentido único o a las restricciones de giro. Por ejemplo, de A a B puede tener una duración diferente a la de B a A.

En las siguientes secciones encontrará información más detallada basada en ejemplos de API de Distance Matrix.

Cómo usar la API Distance Matrix a través de Postman

Nuestra API es un servicio HTTP versátil adecuado para varios casos de uso y escenarios de integración. Se puede usar de cualquier forma que se adapte a sus necesidades, incluidas las solicitudes directas del navegador, la codificación en diferentes lenguajes de programación o la integración con aplicaciones y sistemas.
‍
Una de las maneras más fáciles y eficientes de empezar a interactuar e integrar nuestra API en sus proyectos es usar Cartero, conocida por su interfaz fácil de usar y sus potentes funciones.

He aquí cómo hacerlo:
  • Para empezar con Postman, instálalo en tu ordenador o accede a la versión web de un navegador.
  • Importe nuestra colección de API preconfigurada:
  • Tras la importación, Postman añadirá automáticamente la colección a tu espacio de trabajo.
  • Para los usuarios de la versión en línea de Postman, pueden abrir directamente el enlace de la colección y crear una bifurcación. Para ello, haga clic en los tres puntos situados junto al nombre de la colección.
  • Configure su entorno en Postman, vaya a la sección Variables y añada su token de autenticación en el campo «Token de autorización de API».
  • No olvides guardar estos cambios.
  • Haga su primera solicitud: seleccione un punto final de nuestra colección, configure los parámetros de su solicitud y pulse enviar para ver la respuesta.
Tenga en cuenta que puede obtener su token individual en el panel de administración. Lee cómo hacerlo en el artículo.
No olvides guardar estos cambios.
En la colección Postman, puedes encontrar todos los parámetros que necesitas para configurar tus solicitudes. Si tienes alguna pregunta, no dudes en contacta con nosotros.

Cuando te sientas cómodo con lo básico, puedes explorar las funciones más avanzadas de nuestra API. La documentación detallada que aparece a continuación lo guiará a través de las funcionalidades específicas de nuestra API.

Parámetros de solicitud

La solicitud de la API Distance Matrix se creó específicamente para que fuera similar al formato de solicitud de la API de Google Distance Matrix. Puedes obtener más información en Migrar a la API Distancematrix.ai página.
Una solicitud de API de Distance Matrix tiene el siguiente formulario:
OBTENER:
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>
¡Copiado!
Un ejemplo de solicitud de la matriz de distancias de la API:
OBTENER:
https://api.distancematrix.ai/maps/api/distancematrix/json?origins=51.4822656,-0.1933769&destinations=51.4994794,-0.1269979&key=<your_access_token>
¡Copiado!

Parámetros requeridos

orígenes: un punto de partida para calcular la distancia y el tiempo de viaje. Puede indicar una o más ubicaciones separadas por el carácter vertical (|) en forma de dirección o coordenadas de latitud/longitud:
1. Si pasa una dirección, el servicio geocodifica la cadena y la convierte en una coordenada de latitud/longitud para calcular la distancia. Esta coordenada puede ser diferente de la que devuelve la API de geocodificación (por ejemplo, la entrada de un edificio en lugar de su centro).
Mostrar ejemplo
Ocultar ejemplo
Example of request with Addresse:
OBTENER:
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>
¡Copiado!
Respuesta
CUERPO
{
    "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"
}
¡Copiado!
2. Si pasa las coordenadas de latitud/longitud, se utilizan sin cambios para calcular la distancia. Asegúrese de que no haya espacio entre los valores de latitud y longitud.
Mostrar ejemplo
Ocultar ejemplo
Ejemplo de solicitud con coordenadas:
OBTENER:
https://api.distancematrix.ai/maps/api/distancematrix/json?origins=51.4822656,-0.1933769&destinations=51.4994794,-0.1269979&key=<your_access_token>
¡Copiado!
Respuesta
CUERPO
{
    "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"
}
¡Copiado!
  • destinos: una o más ubicaciones para usar como destino final para calcular la distancia y el tiempo de viaje. Las opciones del parámetro de destino son las mismas que las del parámetro original, tal y como se ha descrito anteriormente.
  • clave: la clave de API de su aplicación.

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.
    • __wf_reserved_heredar
      Consulta la lista de idiomas compatibles.
    • __wf_reserved_heredar
      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.
    • __wf_reserved_heredar
      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.
    • __wf_reserved_heredar
      Si un nombre no está disponible en el idioma preferido, la API usa la coincidencia más cercana.
    • __wf_reserved_heredar
      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.
Mostrar idiomas
Ocultar idiomas
Código de idioma
Idioma
Código de idioma
Idioma
af
afrikáans
ja
japonés
sq
albanesa
kn
canarés
am
amárico
kk
Kazajo
ar
árabe
km
Jemer
hy
armenio
ko
coreano
az
Azerbaiyano
cielo
Kirguís
eu
vasco
lo
Lao
be
Bielorruso
lv
letón
bn
bengalí
lt
lituano
bs
bosnio
km
macedónio
bg
búlgaro
ms
malayo
my
birmano
ml
Malayalam
ca
catalán
señor
marathi
zh
chino
mn
mongol
zh-CN
Chino (simplificado)
nuevo
nepalés
zh-HK
Chino (Hong Kong)
no
noruego
zh-TW
Chino (tradicional)
pl
polaco
hr
croata
pt
portugués
cs
checa
pt-BR
Portugués (Brasil)
da
danés
pt-PT
Portugués (Portugal)
nl
holandesa
pa
panyabí
en
Inglés
o
rumano
en-AU
Inglés (australiano)
ru
rusa
en-GB
Inglés (Gran Bretaña)
sr
serbio
et
estonio
es
cingalés
fa
farsi
sk
eslovaco
fi
finlandés
sl
esloveno
fil
filipino
sí
española
fr
francesa
es-419
Español (Latinoamérica)
fr-CA
Francés (Canadá)
sw
swahili
gl
gallego
sv
sueco
ka
georgiano
té
Tamil
de
alemán
te
Telugu
el
griego
la
tailandés
gu
Guyaratí
tr
turca
iw
hebreo
Reino Unido
ucraniana
hi
hindi
nuestro
Urdu
hu
húngara
nosotros
Uzbeko
is
islandés
vi
vietnamita
id
indonesio
zu
zulú
it
italiano


  • 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.
Mostrar ejemplo
Ocultar ejemplo
Ejemplo de solicitud con arrival_time:
OBTENER:
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>
¡Copiado!
Respuesta
CUERPO
{
    "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"
}
¡Copiado!
  • 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:
    • __wf_reserved_heredar
      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).
    • __wf_reserved_heredar
      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.
* Nota: Si no se especifica la hora de salida, la elección de la ruta y la duración se basan en la red de carreteras y en las condiciones del tráfico en función del tiempo promedio. 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.
Mostrar ejemplo
Ocultar ejemplo
Ejemplo de solicitud con departure_time:
OBTENER:
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>
¡Copiado!
Respuesta
CUERPO
{
    "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"
}
¡Copiado!
  • 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:
    • __wf_reserved_heredar
      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.
    • __wf_reserved_heredar
      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.
    • __wf_reserved_heredar
      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.
Mostrar ejemplo
Ocultar ejemplo
Ejemplo de solicitud con traffic_model:
OBTENER:
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>
¡Copiado!
Respuesta
CUERPO
{
    "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"
}
¡Copiado!
  • 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:
    • __wf_reserved_heredar
      bus indica que la ruta calculada debería preferir viajar en autobús.
    • __wf_reserved_heredar
      metro indica que la ruta calculada debería preferir viajar en metro.
    • __wf_reserved_heredar
      tren indica que la ruta calculada debería preferir viajar en tren.
    • __wf_reserved_heredar
      tranvía indica que la ruta calculada debería preferir viajar en tranvía y tren ligero.
    • __wf_reserved_heredar
      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.
Mostrar ejemplo
Ocultar ejemplo
Ejemplo de solicitud con transit_mode:
OBTENER:
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>
¡Copiado!
Respuesta
CUERPO
{
    "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"
}
¡Copiado!

Modos de viaje

Para el cálculo de las distancias, puede especificar el modo de transporte que va a utilizar. De forma predeterminada, las distancias se calculan para el modo de conducción. Se admiten los siguientes 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.
Mostrar ejemplo
Ocultar ejemplo
Ejemplo de solicitud con modos de viaje:
OBTENER:
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>
¡Copiado!
Respuesta
CUERPO
{
    "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"
}
¡Copiado!

Traffic information

Traffic information is use when todo Se aplica lo siguiente (estas son las condiciones necesarias para recibir el campo duration_in_traffic en la respuesta de Distance Matrix):
  • 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.
Si lo desea, puede incluir el parámetro traffic_model en la solicitud para especificar las suposiciones que se utilizarán para calcular el tiempo de tráfico.
Mostrar ejemplo
Ocultar ejemplo
Example of request with traffic information:
OBTENER:
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>
¡Copiado!
Respuesta
CUERPO
{
    "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"
}
¡Copiado!

Restricciones

Se pueden calcular las distancias que cumplan con ciertas restricciones. Las restricciones se indican mediante el uso del parámetro avoid y un argumento para ese parámetro que indica la restricción que se debe evitar. Se admiten las siguientes restricciones:
  • evitar=peajes
  • evitar=autopistas
  • avoid=ferries
  • avoid=interior
* Nota: la adición de restricciones no excluye las rutas que incluyen la función restringida; simplemente sesga el resultado hacia rutas más favorables.
Mostrar ejemplo
Ocultar ejemplo
Example of request with restrictions:
OBTENER:
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>
¡Copiado!
Respuesta
CUERPO
{
    "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"
}
¡Copiado!

Sistemas de unidades

Los resultados de la matriz de distancia contienen texto dentro de los campos de distancia para indicar la distancia de la ruta calculada. Se puede especificar el sistema de unidades que se va a utilizar:
  • units=metric (predeterminado) devuelve las distancias en kilómetros y metros.
  • units=imperial devuelve las distancias en millas y pies.
Mostrar ejemplo
Ocultar ejemplo
Ejemplo de solicitud con sistema de unidades:
OBTENER:
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>
¡Copiado!
Respuesta
CUERPO
{
    "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"
}
¡Copiado!
* Nota: esta configuración del sistema de unidades solo afecta al texto que se muestra en los campos de distancia. Los campos de distancia también contienen valores que siempre se expresan en metros.

Ejemplo de respuesta

La respuesta contiene una matriz de objetos de filas, cada fila contiene un origen emparejado con cada destino. Cada elemento del objeto de la matriz contiene las propiedades de una sola variante de ruta. Para obtener una descripción detallada de los elementos, consulte la sección Elementos de respuesta de la matriz de distancia.
Respuesta
CUERPO
{
    "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"
}
¡Copiado!

Elementos de respuesta de la matriz de distancia

Las respuestas de Distance Matrix contienen los siguientes elementos raíz:
  • 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

Los campos de estado del objeto de respuesta contienen el estado de la solicitud y pueden contener información de depuración útil. La API Distance Matrix muestra un campo de estado de nivel superior con información sobre la solicitud en general, así como un campo de estado para cada campo de elemento con información sobre ese emparejamiento origen-destino en particular.

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:
    • __wf_reserved_heredar
      Falta la clave de API o no es válida.
    • __wf_reserved_heredar
      La facturación no se ha activado en tu cuenta.
    • __wf_reserved_heredar
      Se ha superado un límite de uso autoimpuesto.
    • __wf_reserved_heredar
      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

Si el código de estado de nivel superior no es correcto, es posible que haya un campo error_message adicional en el objeto de respuesta Distance Matrix. Este campo contiene información más detallada sobre los motivos detrás del código de estado dado.

Filas

Cuando la API Distance Matrix devuelve resultados, los coloca dentro de una matriz de filas JSON. Incluso si no se devuelven resultados (por ejemplo, cuando los orígenes o los destinos no existen), sigue devolviendo una matriz vacía.

Las filas se ordenan según los valores del parámetro de origen de la solicitud. Cada fila corresponde a un origen y cada elemento de esa fila corresponde a una combinación del origen con un valor de destino.

Cada matriz de filas contiene una o más entradas de elementos, que a su vez contienen la información sobre un único emparejamiento origen-destino.

Elementos

La información sobre cada emparejamiento origen-destino se devuelve en una entrada de elemento. Un elemento contiene los siguientes campos:
  • 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.
PREGUNTAS MÁS FRECUENTES

¿Cómo utilizar la API de distancias?

Utilizar una API de distancias como Distancematrix.ai es, por lo general, un proceso sencillo. Estos son los pasos básicos para utilizar la API:

  • Regístrese en la plataforma y obtenga una clave de API. La clave de API es un identificador único que le permite acceder a la API.
  • Elija su producto de API: La API de Distancematrix.ai ofrece varios métodos para diferentes tipos de cálculos de distancia, como la distancia entre dos puntos, la matriz de distancias para múltiples orígenes y destinos, y estimaciones de tiempo de viaje. Elija la forma de utilizar la API que mejor se adapte a sus necesidades.
  • Configure sus parámetros: Dependiendo del producto que elija, deberá establecer parámetros como los orígenes y destinos (en forma de direcciones o coordenadas de latitud y longitud), el modo de transporte (conducción, caminata, etc.) y otras opciones, como evitar peajes o autopistas.
  • Envíe su solicitud: Una vez que haya configurado sus parámetros, puede enviar una solicitud a la API de matriz de distancias utilizando su clave de API. La API procesará su solicitud y devolverá los resultados de distancia y los tiempos de viaje en el formato especificado en su solicitud.
  • Almacene y utilice los resultados: Finalmente, puede analizar los resultados devueltos por la API y utilizarlos en su aplicación o sitio web. La API puede devolver resultados en formato JSON, que puede convertirse fácilmente a varios formatos, incluidos XML y CSV.

Los pasos específicos para utilizar la API de Distancematrix.ai pueden variar según su lenguaje de programación o framework. Sin embargo, proporcionamos documentación detallada de la API de matriz de distancias y código de ejemplo para ayudarle a comenzar.

¿Cuál es la diferencia entre una API de matriz de distancias y otras API?

La API de matriz de distancias, la API de distancia en mapas y la API de matriz de direcciones son tipos de API que proporcionan datos relacionados con distancias, pero cada una tiene sus particularidades.
Una API de matriz de distancias está diseñada para calcular las distancias entre múltiples orígenes y destinos. Proporciona una matriz de distancias que puede utilizarse para calcular tiempos de viaje u optimizar rutas de entrega o logística. Este tipo de API es útil para empresas que necesitan planificar y optimizar rutas de viaje u operaciones logísticas.

Por otro lado, una API de distancia en mapas proporciona datos de distancia para un área geográfica específica, como la distancia entre dos puntos en un mapa. Este tipo de API es útil para aplicaciones que necesitan mostrar datos de distancia en un mapa, como un rastreador de actividad física o una aplicación de viajes.

Una API de matriz de direcciones, como la API de Directions de Google Maps, proporciona indicaciones paso a paso entre dos o más puntos. Incluye información como la distancia, el tiempo de viaje estimado y la ruta a seguir. Este tipo de API es útil para aplicaciones que requieren capacidades de navegación o enrutamiento, como una aplicación de transporte compartido o un dispositivo GPS.

En resumen, aunque la API de matriz de distancias, la API de distancia en mapas y la API de matriz de direcciones proporcionan datos relacionados con distancias, están optimizadas para diferentes casos de uso. La API de matriz de distancias de Distancematrix.ai incluye actualmente productos de matriz de distancias y geocodificación. Actualmente no ofrecemos soluciones de mapas o direcciones. Sin embargo, puede utilizar los datos en su negocio para optimizar rutas de viaje u operaciones logísticas; estos datos están destinados a aplicaciones que necesitan mostrar información de distancia en un mapa y a aquellas que requieren capacidades de navegación o enrutamiento.

Fácil de integrar la API Distance Matrix
Comenzar
Cómo migrar a DistanceMatrix
__wf_reserved_heredar
No es necesario realizar ningún pago por adelantado.
Empieza gratis y obtén al instante
acceso a todos los Distancematrix.ai
productos y características