ForHosting KIT · Viajes y geografía

Distancia total multiparada

Nueva York–Filadelfia 120 km, Washington 140 km y Richmond 110 km suman 370 km, con acumulados de 120, 260 y 370 km. Indique las distancias de sus tramos para obtener el total de la ruta y el kilometraje en cada parada. Gratis en su navegador.

  • Gratis
  • Funciona en su navegador
  • Sin registro
  • Sus datos no salen de su equipo
Úselo desde WebAPIEmailTelegramApp pronto
Si escribe
Origen
New York
Obtiene
Total
370 km
Total (km)
370
Total (mi)
229,907341
Cantidad de tramos
3

Planificar un viaje por varias ciudades, una gira de entregas o un itinerario con varios hoteles suele empezar con una lista de distancias de tramo en las que usted ya confía: de una app de mapas, una guía impresa o una hoja del despachador. Lo que aún necesita es un total limpio y una lectura de kilometraje acumulado en cada parada para que las paradas de combustible, los descansos y el reparto de costes sean honestos. Esta calculadora de distancia total de ruta multiparada acepta una lista ordenada de distancias de tramo, opcionalmente etiquetadas con nombres de destino, las suma en un total de ruta y construye una tabla acumulada al estilo odómetro desde el origen hasta el último punto de paso.

Cómo funcionan la distancia de itinerario multiparada y el kilometraje acumulado

Una ruta multiparada aquí es un itinerario abierto y ordenado de uno o más tramos. Cada tramo es una distancia no negativa que usted ya midió o estimó entre paradas consecutivas: de ciudad a ciudad, de depósito a cliente, de hotel a hotel. La capacidad no busca coordenadas ni inventa caminos por carretera; trata sus distancias como fuente de verdad y se centra en la contabilidad que los planificadores reutilizan de verdad.

Con n tramos hay n más una paradas: la parada cero es el origen con kilometraje acumulado cero, y tras cada tramo completado la suma parcial avanza en esa distancia. La distancia total de la ruta es simplemente la suma de todos los tramos. Esa identidad es la misma lógica de odómetro que usan los conductores al anotar hitos en un diario de viaje: partir de cero, sumar cada segmento y la lectura en la última parada iguala el total del viaje.

Las etiquetas opcionales de cada tramo nombran el destino de ese segmento; una cadena opcional de origen nombra la primera parada para que la tabla acumulada sea legible en la interfaz sin un segundo cruce. Se admiten tramos de longitud cero (parada en el mismo sitio o marcador de posición), pero se rechazan distancias negativas porque el kilometraje no puede retroceder en este modelo.

Dónde encajan los totales de ruta multiparada en productos y canalizaciones

Combínelo con herramientas de volumen de combustible o coste de viaje cuando necesite estimaciones de gasto; con velocidad media o ETA cuando necesite tiempo. No lo use para distancia de círculo máximo a partir de latitud y longitud: esa es otra intención de búsqueda servida por herramientas geográficas de polilínea que miden tramos haversine. Aquí el usuario ya posee las distancias y solo quiere totales de itinerario y kilometraje acumulado.

La validación fallida no consume saldo. Mantenga listas modestas para la UX interactiva, fije totales redondeados en las pruebas y obtendrá un bloque pequeño y auditable para cada canal que KIT ya sirve.

Tablas de itinerario de viaje por carretera

Pegue distancias de tramo de ciudad a ciudad, etiquete cada parada y publique la distancia total más el kilometraje acumulado en cada noche de hotel.

Progreso de entregas multiparada

Sume longitudes de depósito a parada y entre paradas, y muestre a los conductores cuántas millas quedan tras cada tramo completado.

Pasos previos de coste y combustible del viaje

Calcule una sola distancia total a partir de tramos conocidos antes de llamar a calculadoras de volumen de combustible, coste de combustible o presupuesto de viaje.

¿Cómo se calcula la distancia total de una ruta multiparada?

Cada distancia de tramo se valida como número finito no negativo y luego se suma. El kilometraje acumulado en la parada k es la suma de los primeros k tramos; el origen parte de cero.

¿Necesito coordenadas GPS o direcciones?

No. Proporcione las distancias de tramo que ya tenga (de mapas, manifiestos o estimaciones). Esta herramienta no geocodifica ni mide caminos de círculo máximo a partir de lat/lon.

¿Cuál es el número mínimo de tramos?

Se exige al menos un tramo (dos paradas: origen y destino).

¿Puedo mezclar kilómetros y millas en una misma solicitud?

No. Todas las distancias de tramo deben compartir la misma unidad, elegida con unit km o mi.

¿Puedo poner nombre a cada parada?

Sí. Cada tramo puede llevar el nombre del lugar donde termina, y también puede nombrar el punto de partida. Los nombres solo rotulan la tabla de acumulados; nunca cambian las distancias ni el total.

Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.

POSThttps://api.kit.forhosting.com/travel/multi-stop-route-distance

¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.

curl -X POST https://api.kit.forhosting.com/travel/multi-stop-route-distance \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"legs":[{"distance":120,"label":"Philadelphia"},{"distance":140,"label":"Washington DC"},{"distance":110,"label":"Richmond"}]}'
{
  "legs": [
    {
      "distance": 120,
      "label": "Philadelphia"
    },
    {
      "distance": 140,
      "label": "Washington DC"
    },
    {
      "distance": 110,
      "label": "Richmond"
    }
  ]
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "travel.multi_stop_route_distance",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.

Por solicitud$0.002

Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.

HTTPCódigoSignificado
401unauthorizedAPI key ausente o inválida.
402insufficient_balanceEl saldo no cubre el precio de la tarea.
404unknown_typeEl tipo de tarea no existe.
429rate_limitedDemasiadas peticiones. Use el webhook en vez de sondear.

Elija kilómetros o millas estatutarias; cada respuesta correcta también devuelve total_km y total_mi.

Cómo funcionan la distancia de itinerario multiparada y el kilometraje acumulado

Cuando la unidad es kilómetros, total y total_km coinciden y total_mi se deriva con el factor internacional de 1.609344 kilómetros por milla estatutaria; cuando la unidad es millas, la conversión dual va al revés.

Contrato de entrada, unidades, alias y errores de validación

Cada entrada puede ser un objeto con un campo distance obligatorio y un label opcional, o un número finito simple tratado como distancia sin etiqueta. Legs vacíos, más de quinientas entradas o una unidad desconocida fallan la validación antes de cualquier suma y no se facturan. Intercambiar la unidad sin convertir los números es un error habitual del cliente: si su hoja está en millas, envíe unit mi en lugar de dejar el valor predeterminado. Envíe por POST un cuerpo JSON con un array legs obligatorio de al menos una entrada. Los valores de distancia deben ser finitos y no negativos; cadenas vacías, NaN, Infinity y campos distance ausentes fallan con invalid_input indicando la fila. El array acepta alias de transporte segments, stages y distances para que clientes móviles y de hojas de cálculo mapeen columnas sin reestructurar. La unit opcional elige la unidad de entrada y del total principal: km (predeterminado) o mi; los alias incluyen distance_unit. El origin opcional (alias start, start_label, origin_label) solo etiqueta la parada cero y nunca cambia el cálculo. Una carga útil correcta devuelve total y unit; siempre total_km y total_mi; leg_count y stop_count; legs como lista ordenada de índice de tramo, distancia, kilometraje acumulado tras ese tramo y label opcional; cumulative_at_stops con índice de parada, kilometraje acumulado y label opcional desde el origen hasta el último punto; más cadenas formula y method para auditoría y documentación. El precio es un fijo $0.002 por ítem correcto en la API; la ruta tier-A en el navegador es gratuita para comprobaciones interactivas.

Dónde encajan los totales de ruta multiparada en productos y canalizaciones

Use este endpoint cuando las distancias de tramo ya existan y necesite un total transparente más kilometraje acumulado por parada: planificadores de viajes por carretera que pegan longitudes de ciudad a ciudad desde una exportación de mapa, bocetos de entrega multiparada antes de módulos de combustible y coste, blogs de viaje que publican una tabla de itinerario con distancia en curso, paneles de flota que enriquecen una lista de paradas con progreso al estilo odómetro, y ejercicios de logística en aula que enseñan sumas de prefijo con datos reales de viaje. Invóquelo desde un Worker, un trabajo de backend o un script: pase legs, lea total y cumulative_at_stops, y opcionalmente guarde el desglose de legs junto a cada fila de la interfaz.

¿Cuánto cuesta la API?

Cada solicitud correcta se factura a $0.002 con su saldo prepago de ForHosting KIT. La validación fallida no se cobra. La herramienta del navegador es gratuita.

Ver la documentación completa del KIT →