API de Distance Matrix

La API de Matrix calcula tiempos de viaje y distancias entre cada combinación de orígenes y destinos en una sola solicitud. Los casos de uso típicos incluyen encontrar el conductor o técnico más cercano a un trabajo, resolver problemas de enrutamiento de vehículos, estimar ventanas de tiempo de entrega para clientes, y calcular la cobertura del área de servicio para la planificación de instalaciones.

La API de Direcciones devuelve una sola ruta detallada entre dos puntos, incluyendo instrucciones de giro y geometría. La API de Matrix devuelve una tabla de distancias y duraciones para múltiples pares origen-destino sin geometría de ruta. Si necesita comparar muchas ubicaciones de manera eficiente, la API de Matrix es más rápida y rentable que realizar llamadas individuales a Directions.

La API admite matrices de hasta 100 orígenes por 100 destinos en una sola solicitud, proporcionando hasta 10.000 pares origen-destino por llamada. Las matrices no necesitan ser cuadradas: puede enviar 1 origen por 100 destinos para una búsqueda de ubicación cercana, o 50 por 50 para una asignación completa flota-cliente.

La API de Matrix admite conducción, caminata, ciclismo y transporte público. El modo de viaje se establece por solicitud. Todos los pares en una sola solicitud utilizan el mismo modo. Si necesita resultados de modo mixto, envíe solicitudes separadas para cada modo y combine las respuestas en su aplicación.

De forma predeterminada, la API de Matrix utiliza velocidades de flujo libre representativas de las condiciones de viaje típicas. Las duraciones ajustadas al tráfico en tiempo real están disponibles en los planes elegibles. Establezca el parámetro departure_time en una marca de tiempo futura para recibir estimaciones de viaje según la hora del día basadas en patrones de tráfico históricos.

Envíe su única ubicación de consulta como origen y su lista de ubicaciones candidatas como destinos. La API devuelve el tiempo de viaje y la distancia desde el punto de consulta a cada candidato en una sola llamada. Ordene la respuesta por duración para encontrar la opción más cercana. Esto es significativamente más eficiente que llamar a la API de Direcciones en un bucle para cada candidato.