

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Amazon Location Service Routes
<a name="routes"></a>

![\[Información general de las rutas de Amazon Location Service.\]](http://docs.aws.amazon.com/es_es/location/latest/developerguide/images/routesV2/route-banner.png)


Con las rutas de Amazon Location Service, puede calcular el tiempo y la distancia de viaje entre varios puntos de inicio y final, visualizar los trazados del GPS de los vehículos alineados con las carreteras y comprender mejor las áreas en las que puede operar. Esto ayuda a reducir los costos operativos y a mejorar la experiencia del cliente.

## Características
<a name="routes-features"></a>

**Planificación de una ruta**  
Calcule las rutas entre dos o más ubicaciones teniendo en cuenta varios factores, como la distancia, el tiempo y las condiciones de la carretera. También puede ver rutas alternativas para el mismo conjunto de ubicaciones.

**Optimización de rutas**  
Optimice las rutas en función del tiempo o la distancia, eligiendo la ruta más rápida o la más corta. También puede secuenciar los puntos de referencia para optimizar el problema del viajante.

**Análisis de rutas**  
Analice las métricas de rendimiento, como el tiempo de viaje, la distancia o el número de paradas, para asegurarse de que la ruta cumpla los objetivos deseados.

**Área de servicio**  
Define el área geográfica a la que se puede prestar servicio desde una ubicación en particular en función de la distancia o los límites de tiempo.

**Costos de peaje**  
Calcule los costos asociados a la infraestructura de peaje de la ruta.

**Evasiones**  
Limite el cálculo de las rutas evitando las autopistas, los túneles, los transbordadores y las autopistas de peaje.

**Límites de velocidad**  
Encuentra los límites de velocidad para cada segmento de una ruta y asegúrese de que los conductores cumplan con las normativas locales.

![\[Una aplicación mediante características de rutas de Amazon Location Service.\]](http://docs.aws.amazon.com/es_es/location/latest/developerguide/images/routesV2/route-demo.png)


## Casos de uso
<a name="routes-usecases"></a>

**Proporción de rutas eficientes e indicaciones paso a paso**  
Planifique las rutas desde cualquier ubicación de inicio (dirección, POI o coordenadas GPS) y calcule la mejor ruta a varios destinos, teniendo en cuenta las dimensiones y las restricciones del vehículo.  
Para obtener más información, consulte [Cálculo de las rutas](calculate-routes.md).

**Optimización de las rutas de entrega**  
Utilice la secuenciación de puntos de referencia para resolver el problema del viajante y calcular la ruta óptima a varios destinos, minimizando el tiempo y la distancia.  
Para obtener más información, consulte [Optimización de paradas](actions-optimize-waypoints.md).

**Garantía de que las entregas se realicen desde el almacén más cercano**  
Utilice el enrutamiento matricial y la secuenciación de puntos de referencia para identificar la ruta más rápida desde los almacenes hasta cada cliente, maximizando la eficiencia y minimizando los costos.  
Para obtener más información, consulte [Cálculo de las rutas](calculate-routes.md) y [Cálculo de matriz de rutas](calculate-route-matrix.md).

**Mejore el envío de taxis y viajes compartidos**  
Utilice el enrutamiento matricial para identificar el vehículo disponible más cercano y calcular las rutas óptimas en función del tráfico en tiempo real. Esto garantiza que el vehículo más cercano llegue al cliente de manera eficiente, lo que aumenta la satisfacción del cliente y la productividad empresarial. Realice más viajes, ahorre en combustible y ofrezca una experiencia de servicio superior.  
Para obtener más información, consulte [Cálculo de las rutas](calculate-routes.md), [Cálculo de matriz de rutas](calculate-route-matrix.md) y [Cálculo de isolíneas](calculate-isolines.md).

**Búsqueda de áreas de servicio**  
Utilice las rutas de isolíneas para determinar el alcance geográfico de su empresa, en función de las limitaciones de tiempo o distancia. Esto permite a la empresa identificar clientes potenciales y elaborar planes de envío. Los proveedores de atención médica a domicilio pueden asegurarse de tener suficiente personal y recursos para atender a todos los pacientes en 15 minutos. La isolínea lo ayuda a optimizar las áreas de servicio, garantizar las entregas puntuales y ubicar nuevas instalaciones.  
Para obtener más información, consulte [Cálculo de isolíneas](calculate-isolines.md).

**Ajuste del trazado de GPS de las carreteras**  
Alinee los trazados de GPS con las carreteras y visualice los movimientos de los vehículos, lo que garantiza el cumplimiento de las rutas y la normativa. Los administradores de flotas pueden ver si los vehículos se mantienen en las rutas planificadas e identificar las desviaciones. Verifique que los conductores sigan las directrices, detecten las ineficiencias y garanticen el cumplimiento de las normas. Corrige las imprecisiones y variaciones del GPS y presenta una visión realista de la actividad del vehículo. Permita una mejor toma de decisiones en torno a la optimización de las rutas, el comportamiento de los conductores y la administración de la flota.  
Para obtener más información, consulte [Ajustar a carreteras](snap-to-roads.md).

## API
<a name="routes-apis"></a>

En esta tabla se proporciona información general de las principales API de Amazon Location Service para la planificación de rutas y el procesamiento de datos basado en la ubicación. Cada API ofrece una funcionalidad única, como el cálculo de rutas, la optimización de los puntos de referencia y el ajuste de los trazados de GPS en las carreteras para un seguimiento preciso.


**API**  

| Nombre de API | Descripción | Obtención de más información | 
| --- | --- | --- | 
| Cálculo de las rutas | Calcule el tiempo, la distancia y las indicaciones paso a paso de un viaje entre un punto de partida y varios destinos, teniendo en cuenta las restricciones de vehículos y el tráfico en tiempo real. | [Cálculo de las rutas](calculate-routes.md) | 
| Cálculo de matriz de rutas | Calcule la distancia de ruta y el tiempo entre un conjunto de puntos de salida y un conjunto de destinos, teniendo en cuenta el tráfico en tiempo real. | [Cálculo de matriz de rutas](calculate-route-matrix.md) | 
| Cálculo de isolíneas | Identifique el área geográfica a la que se puede llegar en un tiempo o una distancia específicos en función de los modos de viaje. | [Cálculo de isolíneas](calculate-isolines.md) | 
| Optimización de paradas | Encuentre el orden más eficiente para viajar a varios destinos, lo que reduce el tiempo y la distancia de viaje y, al mismo tiempo, tiene en cuenta factores como las restricciones de tráfico y vehículos. | [Cómo optimizar las paradas para una ruta](optimize-waypoints.md) | 
| Ajustar a carreteras | Haga coincidir los trazados del GPS con el segmento de carretera más cercano para mejorar la precisión del seguimiento de vehículos y la visualización de la ruta. | [Ajustar a carreteras](snap-to-roads.md) | 

# Conceptos de rutas
<a name="routes-concepts"></a>

Los conceptos de rutas de Amazon Location Service proporcionan un marco sólido para planificar y optimizar los viajes, ya sea para una navegación sencilla o para una logística compleja. Las rutas incluyen varios componentes, como puntos de referencia, tramos, pasos y unidades, y cada uno de ellos contribuye a la granularidad y flexibilidad de los cálculos de las rutas. Al utilizar la API de Rutas, puede calcular las distancias de viaje, estimar los tiempos de viaje y optimizar los viajes con varias paradas. Además, características como la geometría de las rutas, la detección del tráfico, los límites de velocidad, los costos de los peajes y la codificación flexible de polilíneas mejoran las capacidades de visualización, análisis y eficiencia operativa. En esta sección se describe la terminología, las prácticas recomendadas y los patrones de uso detallados, y lo guiará a través de la implementación de soluciones de rutas eficaces para la navegación, la entrega, los servicios de campo, etc.

**Topics**
+ [Terminología de rutas](routes-terminology.md)
+ [Dónde (origen, destino, punto de referencia y rastros)](concepts-where.md)
+ [Cuándo (salida y llegada)](concepts-when.md)
+ [Cómo (modo de viaje, evasión y exclusión)](concepts-how.md)
+ [Conocimiento del tráfico](concepts-traffic-awareness.md)
+ [Optimización de la secuencia de rutas y puntos de referencia](optimize-route-waypoint.md)
+ [Horarios y avisos del conductor](driver-schedule-notices.md)

# Terminología de rutas
<a name="routes-terminology"></a>

**Ruta**  
Una ruta proporciona detalles para viajar desde una posición de salida a través de las posiciones de los puntos de referencia hasta un destino. Incluye la distancia de viaje, el tiempo de viaje, la geometría de la ruta, los límites de velocidad, los tramos y otros atributos.

**Matriz de rutas**  
Matriz que representa la distancia y el tiempo de viaje desde un conjunto de orígenes hasta un conjunto de destinos. Es útil como entrada para aplicaciones de planificación u optimización de rutas.

**Puntos de referencia**  
Los puntos de referencia son paradas intermedias a lo largo de una ruta desde el punto de partida hasta el destino. La ruta sigue el orden de escala según se especificó en la solicitud.

**Tramo**  
Un tramo representa el viaje entre dos posiciones consecutivas de una ruta. Si las posiciones no están ubicadas en una carretera, se mueven a la carretera más cercana. Una ruta sin puntos de referencia consta de un solo tramo. Las rutas con uno o más puntos de referencia tienen varios tramos, y cada tramo representa el viaje de un punto de referencia al siguiente. Determinados tramos, como los que implican transbordadores, contienen información específica relativa a ese tipo de trayecto.

**Paso**  
Un paso es un segmento dentro de un tramo que proporciona detalles resumidos de esa parte del viaje. Algunos tipos de pasos incluyen:  
+ **Pasos predeterminados**: pasos básicos con instrucciones legibles por humanos, adecuados para aplicaciones web que muestran información general de la ruta.
+ **Pasos paso a paso**: pasos detallados adecuados para aplicaciones paso a paso, que proporcionan instrucciones detalladas.
+ **Pasos antes del viaje**: pasos que debe completar antes de iniciar el viaje. Ejemplo: embarcar en un transbordador.
+ **Pasos después del viaje**: pasos que hay que completar al llegar al final de un viaje. Ejemplo: desembarcar de un transbordador.

**Intervalo**  
Un intervalo representa un tramo continuo de una carretera que comparte un conjunto coherente de atributos. Se crean nuevos intervalos a lo largo de una ruta cada vez que cambia uno de los atributos solicitados.

**Segmento**  
Un segmento es una parte transitable de una carretera, que normalmente se representa como un tramo lineal.

**Geometría de ruta**  
La geometría de la ruta describe el camino de una ruta para su visualización, análisis u otros usos. La geometría de cada tramo de la ruta se puede representar como una polilínea comprimida y codificada o como una simple cadena de líneas.

**Polilínea flexible**  
Formato de polilínea codificado y compacto para representar la geometría. Recomendado para limitar el tamaño de la respuesta y optimizado para la decodificación del lado del cliente.

**Cadena de línea simple**  
Un formato de LineString de GeoJSON que representa la geometría. Este formato produce una mayor carga útil de respuesta y es una matriz ordenada de coordenadas que se puede usar para trazar rutas en un mapa.

# Dónde (origen, destino, punto de referencia y rastros)
<a name="concepts-where"></a>

Especifica la ubicación para el cálculo de la ruta, incluido el lugar donde comienza, termina y las paradas intermedias (o lugares por los que pasa).


**Especifica el lugar para el cálculo de la ruta**  

| Parámetro | Descripción | Rutas | Matriz de rutas | Isolínea | Optimización de paradas | Ajustar a carreteras | 
| --- | --- | --- | --- | --- | --- | --- | 
| Orígenes | Posición inicial de la ruta. | Sí, con opciones | Sí, con opciones | Sí, con opciones | Sí, con opciones | No | 
| Puntos de referencia | Las posiciones intermedias se incluirán a lo largo de la ruta. | Sí, con opciones | Sí, con opciones | Sí, con opciones | Sí, con opciones | No | 
| Destinos | Posición final de la ruta. | Sí, con opciones | Sí, con opciones | Sí, con opciones | Sí, con opciones | No | 
| Puntos de seguimiento | Trazado de GPS que incluye información de posición histórica emitida por un modo de viaje. Estas posiciones incluyen las imprecisiones típicas del GPS y las brechas que se producen cuando el dispositivo no puede emitir o registrar esta información. | No | No | No | No | Sí, con opciones | 

## Opciones configurables
<a name="configurable-options"></a>

Ofrece opciones para personalizar el comportamiento de enrutamiento de los puntos de referencia, los orígenes y los destinos.

**Opciones de puntos de referencia**


| Parámetro | Descripción | Rutas | Matriz de rutas | Isolínea | Optimización de paradas | Ajustar a carreteras | 
| --- | --- | --- | --- | --- | --- | --- | 
| AvoidActionsForDistance | Evita realizar acciones durante la distancia proporcionada. Suele utilizarse para garantizar que los conductores tengan tiempo suficiente para tomar decisiones cerca de los puntos de referencia. | Sí | No | No | No | No | 
| AvoidUTurns | Especifica si se permiten los cambios de sentido en el punto de referencia. | Sí | No | No | No | No | 
| Heading | El GPS se dirige a la posición del punto de referencia. | Sí | No | No | Sí | No | 
| Coincidencia | Opciones para configurar la adaptación de la posición proporcionada a la red de carreteras. | Sí, con opciones | No | No | No | No | 
| SideOfStreet | Especifica el lado de la calle que coincide con la posición del punto de referencia. | Sí, con opciones | No | No | Sí, con opciones | No | 
| StopDuration | Duración hasta la parada en la posición del punto de referencia. | Sí | No | No | No | No | 
| Position | Longitud y latitud del punto de referencia. | Sí | No | No | Sí | No | 
| PassThrough | Determina si el punto de referencia debe tratarse como una parada o un punto de paso. | Sí | No | No | No | No | 
| Id | Cadena del identificador del punto de referencia. | No | No | No | Sí | No | 
| AccessHours | Especifica las horas de acceso para visitar el destino. | No | No | No | Sí | No | 
| AppointmentTime | Hora de cita programada en el punto de referencia. | No | No | No | Sí | No | 
| ServiceDuration | Tiempo de servicio en el punto de referencia, como la duración de una cita. | No | No | No | Sí | No | 
| Antes | Define qué puntos de referencia se deben visitar después de este. | No | No | No | Sí | No | 

**Opciones de origen**


| Parámetro | Descripción | Rutas | Matriz de rutas | Isolínea | Optimización de paradas | Ajustar a carreteras | 
| --- | --- | --- | --- | --- | --- | --- | 
| AvoidActionsForDistance | Evita realizar acciones durante la distancia proporcionada. | Sí | Sí | Sí | No | No | 
| AvoidUTurns | Especifica si se permiten los cambios de sentido en el origen. | Sí | No | No | No | No | 
| Heading | El GPS se dirige a la posición del origen. | Sí | Sí | Sí | No | No | 
| Coincidencia | Opciones para hacer coincidir la posición de origen con la red de carreteras. | Sí, con opciones | Sí, con opciones | Sí, con opciones | No | No | 
| SideOfStreet | Especifica el lado de la calle que coincide con la posición de origen. | Sí, con opciones | Sí, con opciones | Sí, con opciones | No | No | 
| Id | Cadena del identificador para el origen. | No | No | Sí | No | No | 

**Opciones de destino**


| Parámetro | Descripción | Rutas | Matriz de rutas | Isolínea | Optimización de paradas | Ajustar a carreteras | 
| --- | --- | --- | --- | --- | --- | --- | 
| AvoidActionsForDistance | Evita realizar acciones durante la distancia proporcionada en el destino. | Sí | Sí | Sí | No | No | 
| AvoidUTurns | Especifica si se permiten los cambios de sentido en el destino. | Sí | No | No | No | No | 
| Heading | El GPS se dirige a la posición de destino. | Sí | Sí | Sí | Sí | No | 
| Coincidencia | Opciones para hacer coincidir la posición de destino con la red de carreteras. | Sí, con opciones | Sí, con opciones | Sí, con opciones | No | No | 
| SideOfStreet | Especifica el lado de la calle que coincide con la posición de destino. | Sí, con opciones | Sí, con opciones | Sí, con opciones | Sí, con opciones | No | 
| StopDuration | Duración hasta la parada en el destino. | Sí | No | No | No | No | 
| Id | Cadena del identificador del destino. | No | No | Sí | No | No | 
| AccessHours | Especifica las horas de acceso para visitar el destino. | No | No | Sí | No | No | 
| AppointmentTime | Hora programada de la cita en el destino. | No | No | Sí | No | No | 
| ServiceDuration | Tiempo de servicio en el destino, como la duración de una cita. | No | No | Sí | No | No | 

# Cuándo (salida y llegada)
<a name="concepts-when"></a>

Especifica la hora para el cálculo de la ruta. La hora no solo determina las marcas temporales de salida y llegada, sino que también influye en los datos de tráfico que se van a utilizar.


| Parámetro | Descripción | Rutas | Matriz de rutas | Isolínea | Optimización de paradas | Ajustar a carreteras | 
| --- | --- | --- | --- | --- | --- | --- | 
| Hora de salida | Hora de salida desde el origen. Si no se proporciona la hora de llegada ni la hora de salida, no se utiliza la información de tráfico dinámica y solo se aplican las velocidades de flujo libre basadas en el tráfico histórico. | Sí | Sí | Sí | Sí | No | 
| Salida ahora | Utiliza la hora actual como hora de salida desde el origen. | Sí | Sí | Sí | No | No | 
| Hora de llegada | Hora de llegada al destino. Si no se proporciona la hora de llegada ni la hora de salida, no se utiliza la información de tráfico dinámica y solo se aplican las velocidades de flujo libre basadas en el tráfico histórico. | Sí | No | Sí | No | No | 

# Cómo (modo de viaje, evasión y exclusión)
<a name="concepts-how"></a>

Utilice las siguientes opciones para especificar el modo de viaje y las características relacionadas que se utilizarán para calcular la ruta.

**Opciones de modo de viaje**

Especifica el modo de transporte al calcular una ruta. Esta configuración influye en la velocidad estimada de viaje, la compatibilidad de las carreteras y el uso potencial de transbordadores cuando sea necesario.


| Parámetro | Descripción | Rutas | Matriz de rutas | Isolínea | Optimización de paradas | Ajustar a carreteras | 
| --- | --- | --- | --- | --- | --- | --- | 
| Car | Modo de viaje en coche. | Sí, con opciones | Sí, con opciones | Sí, con opciones | Sí | Sí | 
| Scooter | Modo de viaje en moto. | Sí, con opciones | Sí | Sí, con opciones | Sí | Sí | 
| Peatonal | Modo de viaje a pie. | Sí, con opciones | Sí | Sí | Sí, con opciones | Sí | 
| Camión | Modo de viaje en camión. | Sí, con opciones | Sí, con opciones | Sí, con opciones | Sí, con opciones | Sí, con opciones | 

**Opciones de evasión, exclusión y autorización**

Determina si se debe incluir, excluir o evitar un conjunto específico de características durante el cálculo de la ruta.


| Parámetro | Descripción | Rutas | Matriz de rutas | Isolínea | Optimización de paradas | Ajustar a carreteras | 
| --- | --- | --- | --- | --- | --- | --- | 
| Evasión | Características que se evitan en el mejor de los casos. Si el enrutador no puede encontrar una ruta válida, se ignorará la evasión y un aviso indicará que no se ha podido cumplir con la evasión. | Sí, con opciones | Sí, con opciones | Sí, con opciones | Sí, con opciones | No | 
| Exclusion | Características que están estrictamente excluidas. Si el enrutador no puede encontrar una ruta válida con las opciones de exclusión, no se devuelve ninguna ruta. | Sí, con opciones | Sí, con opciones | No | No | No | 
| Permitir | Características que deben habilitarse de forma explícita. | Sí, con opciones | Sí, con opciones | Sí, con opciones | Sí, con opciones | No | 

**Lista de evasiones**

Muestra las características que se evitan en el mejor de los casos. Si el enrutador no puede encontrar una ruta válida, se ignorará la evasión y un aviso indicará que no se ha podido cumplir con la evasión.


| Parámetro | Descripción | Rutas | Matriz de rutas | Isolínea | Optimización de paradas | Ajustar a carreteras | 
| --- | --- | --- | --- | --- | --- | --- | 
| Áreas | Áreas que se deben evitar con excepciones. | Sí, con opciones | Sí, con opciones | Sí, con opciones | Sí, con opciones | No | 
| Autopistas de acceso controlado | Carreteras de alta velocidad con puntos de entrada limitados. | Sí | Sí | Sí | Sí | No | 
| Trenes portacoches | Trenes que transportan vehículos a través de túneles. | Sí | Sí | Sí | No | No | 
| Carreteras de tierra | Caminos sin pavimentar con superficies naturales. | Sí | Sí | Sí | Sí | No | 
| Transbordadores | Barcos que transportan vehículos a través de cuerpos de agua | Sí | Sí | Sí | No | No | 
| Transbordadores | Transbordadores que transportan vehículos por vías férreas. | No | No | Sí | Sí | No | 
| Transbordadores de ferrocarril | Transbordadores que transportan vehículos por vías férreas. | No | No | Sí | Sí | No | 
| Cierre de temporada | Las carreteras están cerradas durante determinadas temporadas. | Sí | No | Sí | No | No | 
| Túneles | Pasajes subterráneos para el tráfico de vehículos. | Sí | Sí | Sí | Sí | No | 
| Peaje | Carreteras que requieren un pago para acceder. | Sí | Sí | Sí | Sí | No | 
| Transpondedores de peaje | Evita las carreteras en las que los transpondedores de peaje son el único medio de pago. | Sí | No | Sí | No | No | 
| Cambios de sentido | Puntos que permiten a los vehículos girar en sentido contrario. | Sí | Sí | Sí | Sí | No | 
| Categorías de zona | Categorías de zonas que se deben evitar. | Sí | Sí | Sí | No | No | 

**Lista de exclusiones**

Muestra características que están estrictamente excluidas. Si el enrutador no puede encontrar una ruta válida con las opciones de exclusión, no se devuelve ninguna ruta.


| Parámetro | Descripción | Rutas | Matriz de rutas | Isolínea | Optimización de paradas | Ajustar a carreteras | 
| --- | --- | --- | --- | --- | --- | --- | 
| Países | Código de país 2 o código de país 3 para los países que deberían excluirse estrictamente del cálculo de rutas. | Sí | Sí | No | Sí | No | 

**Lista de permitidos**

Muestra las características que se deben habilitar de forma explícita para el cálculo de rutas.


| Parámetro | Descripción | Rutas | Matriz de rutas | Isolínea | Optimización de paradas | Ajustar a carreteras | 
| --- | --- | --- | --- | --- | --- | --- | 
| HOV | Habilite el uso de carriles para vehículos de alta ocupación para calcular las rutas. | Sí | Sí | Sí | No | No | 
| CALIENTE | Habilite el uso de carriles de peaje de alta ocupación para calcular las rutas. | Sí | Sí | Sí | No | No | 

# Conocimiento del tráfico
<a name="concepts-traffic-awareness"></a>

Determina el tipo de información relacionada con el tráfico que se utiliza durante el cálculo de la ruta. El flujo de tráfico representa la congestión, excluida la congestión relacionada con incidentes de larga duración. La precisión de los datos de tráfico de flujo disminuye con el tiempo, lo que hace que los datos históricos de tráfico sean más fiables para los eventos pasados.


| Parámetro | Descripción | Rutas | Matriz de rutas | Isolínea | Optimización de paradas | Ajustar a carreteras | 
| --- | --- | --- | --- | --- | --- | --- | 
| Uso | Habilite o desactive los datos de tráfico durante el cálculo de la ruta. Cuando se habilita, si no se proporcionan `DepartureTime`, `ArrivalTime` o `DepartNow`, solo se considerarán los cierres prolongados. De lo contrario, si se proporciona una hora, se tendrán en cuenta todos los datos de tráfico. | Sí | Sí | Sí | Sí | No | 
| FlowEventThresholdOverride | Duración en segundos durante la que se considera válido un evento de tráfico de flujo. Mientras sean válidos, los datos de tráfico de flujo se utilizarán en lugar de los datos de tráfico históricos. | Sí | Sí | Sí | No | No | 

# Optimización de la secuencia de rutas y puntos de referencia
<a name="optimize-route-waypoint"></a>

## Optimización del enrutamiento
<a name="optimize-routing"></a>

Criterios de optimización para calcular una ruta. Puede ser la ruta más rápida medida por el tiempo o la ruta más corta medida por la distancia.


| Opción | Descripción | Medida | 
| --- | --- | --- | 
| Ruta más rápida | Calcule la ruta más rápida, centrándose en minimizar el tiempo de viaje. Esto tiene en cuenta las condiciones del tráfico, los límites de velocidad de la carretera y otros factores. | Time | 
| Ruta más corta | Calcula la ruta más corta, minimizando la distancia recorrida. Suele utilizarse cuando la distancia es el factor clave, como la reducción de los costos de combustible o las emisiones. | Distancia | 

## Optimización de paradas
<a name="optimize-waypoint"></a>

Criterios de optimización para secuenciar las paradas de una ruta. 

# Horarios y avisos del conductor
<a name="driver-schedule-notices"></a>

## Horario del conductor
<a name="driver-schedule"></a>

Ajustes del conductor para definir los horarios de trabajo y descanso. Esto es obligatorio en muchas jurisdicciones.


| Parámetro | Description (Descripción) | Rutas | Matriz de rutas | Isolínea | Optimización de paradas | Ajustar a carreteras | 
| --- | --- | --- | --- | --- | --- | --- | 
| Ciclos de descanso personalizados | Ciclos de descanso definidos por la duración del viaje, seguidos de una duración de descanso. Se puede proporcionar cualquier número de ciclos de este tipo. | Sí, con opciones | No | No | No | No | 
| Ciclo de descanso largo y ciclo de descanso corto | Ciclos de descanso definidos por un ciclo corto y un ciclo largo. A una corta duración de viaje le sigue una corta duración de reposo de viaje. Los viajes cortos se pueden repetir hasta que se alcance una duración larga, momento en el que se aplica la duración de los descansos prolongados. | No | No | No | Sí, con opciones | No | 

## Avisos, advertencias y restricciones
<a name="notices-warnings-constraints"></a>

Información complementaria que proporciona información sobre las decisiones tomadas durante el cálculo de la ruta.


| Parámetro | Description (Descripción) | Rutas | Matriz de rutas | Isolínea | Optimización de paradas | Ajustar a carreteras | 
| --- | --- | --- | --- | --- | --- | --- | 
| ​Avisos | Avisos sobre el cálculo de rutas. Además, pueden incluir una anotación en el aviso en la que se indique si los resultados del cálculo de la ruta se pueden utilizar tal cual o si será necesario inspeccionarlos manualmente antes de su uso. | Sí, con los detalles | No | No | No | Sí | 
| FailedConstraints | Restricciones incluidas en la solicitud que no se pudieron cumplir, lo que provocó el error del problema de optimización. | No | No | No | Sí, con los detalles | No | 

# Ruta APIs
<a name="choose-routes-apis"></a>

Las rutas ofrecen la posibilidad de calcular rutas optimizadas entre ubicaciones. Estas características son compatibles con las aplicaciones que requieren planificación logística, cálculos de distancia y optimización de rutas. Los usuarios también pueden vincular los puntos de ubicación a las carreteras para mejorar la precisión. Para obtener más información, consulte[Amazon Location Service Routes](routes.md).
+ **CalculateIsolines**: Genera isolíneas en función del tiempo o la distancia de viaje, útiles para definir áreas de servicio o zonas de accesibilidad. Para obtener más información, consulte. [Cálculo de isolíneas](calculate-isolines.md)
+ **CalculateRouteMatrix**: Proporciona una matriz de distancias y tiempos de viaje entre varios orígenes y destinos, lo que facilita la logística y la planificación de viajes. Para obtener más información, consulte[Cálculo de matriz de rutas](calculate-route-matrix.md).
+ **CalculateRoutes**: Calcula las rutas optimizadas para point-to-point la navegación con varias paradas, incluidas las preferencias de ruta personalizables. Para obtener más información, consulte[Cálculo de las rutas](calculate-routes.md).
+ **OptimizeWaypoints**: Optimiza el orden de los puntos de referencia para la ruta de viaje más eficiente, minimizando la distancia o el tiempo. Para obtener más información, consulte. [Optimización de paradas](actions-optimize-waypoints.md)
+ **SnapToRoads**: Alinea las coordenadas con las rutas de carretera más cercanas, lo que mejora la precisión del GPS al alinear los puntos con las carreteras conocidas. Para obtener más información, consulte. [Ajustar a carreteras](snap-to-roads.md)

La siguiente tabla presenta una serie de casos de uso empresarial que se resuelven mejor con Routes APIs.


| **Necesidad empresarial** | **API útil** | **Ejemplos** | 
| --- | --- | --- | 
| **Cálculo de la distancia y el tiempo de viaje para un origen y un destino**Admite lo siguiente: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` |  | 
| **Búsqueda de polilínea de ruta para un origen y un destino**Admite lo siguiente: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` |  | 
| **Búsqueda de rutas paso a paso hacia un origen y un destino**Admite lo siguiente: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` |  | 
| **Búsqueda de una ruta partiendo ahora**Admite lo siguiente: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` |  | 
| **Búsqueda de una ruta si sale a una hora específica**Admite lo siguiente: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` |  | 
| **Búsqueda de una ruta si necesita llegar a una hora específica**Admite lo siguiente: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` |  | 
| **Búsqueda de las rutas más cortas**Admite lo siguiente: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` |  | 
| **Búsqueda de las rutas más rápidas**Admite lo siguiente: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` |  | 
| **Búsqueda de rutas alternativas**Admite lo siguiente: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` |  | 
| **Búsqueda de rutas sensibles al tráfico**Admite lo siguiente: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` |  | 
| **Búsqueda de rutas con evasión, como peajes, cambios de sentido, transbordadores, autopistas, túneles, etc.**Admite lo siguiente: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` |  | 
| **Búsqueda de rutas con evasión personalizada pasando por una polilínea o un polígono**Admite lo siguiente: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` |  | 
| **Cálculo del costo del peaje**Admite lo siguiente: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` | [Cálculo del costo del peaje](calculate-toll-cost.md) | 
| **Búsqueda del límite de velocidad de un tramo de carretera en una ruta**Admite lo siguiente: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` |  | 
| **Dibujo de una ruta en un mapa**Admite el marcado de puntos de referencia. | `GetTile`y `GetStyleDescriptor` con el motor de renderizado (MapLibre) con Calculate route  |  | 
| **Cálculo de una matriz de ruta de distancia y tiempo para múltiples orígenes y destinos**Admite lo siguiente:[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/location/latest/developerguide/choose-routes-apis.html) | `CalculateRouteMatrix` | [Cómo calcular una matriz de ruta de distancia y tiempo para múltiples orígenes y destinos](calculate-route-matrix-distance.md) | 
| **Cálculo de la matriz de rutas con evasión**Admite lo siguiente:[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/location/latest/developerguide/choose-routes-apis.html) | `CalculateRouteMatrix` | [Cómo calcular la matriz de rutas con evasión](calculate-route-matrix-with-avoidance.md) | 
| **Cálculo de un área de servicio en función del tiempo (isócrono)**Admite modos de viaje, como camión, peatón, coche y moto.  | `CalculateIsolines` | [Cómo calcular un área de servicio en función de los rangos de tiempo](calculate-service-area-based-on-time.md) | 
| **Cálculo de un área de servicio en función de la distancia (isodistancia)**Admite modos de viaje, como camión, peatón, coche y moto.  | `CalculateIsolines` |  | 
| **Cálculo de un área de servicio con evasión**Admite modos de viaje, como camión, peatón, coche y moto.  | `CalculateIsolines` |  | 
|  **Cálculo de un área de servicio en sentido inverso** Admite modos de viaje, como camión, peatón, coche y moto.  | `CalculateIsolines` |  | 
|  **Cálculo de un área de servicio para varios rangos de tiempo o distancia** Admite modos de viaje, como camión, peatón, coche y moto.  | `CalculateIsolines` |  | 
| **Optimización de los puntos de referencia para las rutas (problema del viajante)** Admite modos de viaje, como camión, peatón, coche y moto.  | `OptimizeWaypoint` | [Cómo optimizar las paradas para una ruta](optimize-waypoints.md) | 
| **Optimización de las paradas de una ruta teniendo en cuenta el tráfico** Admite modos de viaje, como camión, peatón, coche y moto.  | `OptimizeWaypoint` |  | 
| **Optimización de las paradas de una ruta teniendo en cuenta la hora de acceso** Admite modos de viaje, como camión, peatón, coche y moto. | `OptimizeWaypoint` |  | 
| **Coincidencia de trazados del GPS con la red de carreteras**Admite modos de viaje, como camión, peatón, coche y moto. | Ajustar a carreteras  | [Cómo hacer coincidir los trazados del GPS con una red de carreteras](how-to-match-gps-traces.md) | 
| **Visualización de los rastros de GPS coincidentes en un mapa**Admite modos de viaje, como camión, peatón, coche y moto. | `GetStyleDescriptor`con motor de renderizado (MapLibre) con Snap to road  |  | 

# Cálculo de las rutas
<a name="calculate-routes"></a>

La API de Rutas calcula las rutas entre dos o más ubicaciones con o sin evasiones para diferentes modos de viaje, como en automóvil, camión, moto y como peatón. Con esta API, puede personalizar las opciones de enrutamiento y solicitar información adicional relacionada con las rutas para satisfacer necesidades específicas. Esta API admite la turn-by-turn navegación y personaliza los cálculos de rutas mediante la aplicación de parámetros como evitar las autopistas, las autopistas o los transbordadores. La API también muestra los límites de velocidad y los costos de los peajes.

Para obtener más información, consulta [CalculateRoutes](https://docs.aws.amazon.com/location/latest/APIReference/API_CalculateRoutes.html)la *referencia de la API de Amazon Location Service*.

Para ver solicitudes de ejemplo, respuestas, cURL y comandos de la CLI para esta API, consulte [Cómo usar Cálculo de rutas](https://docs.aws.amazon.com/location/latest/developerguide/calculate-routes-how-to.html).

![\[Información general de las rutas de Amazon Location Service.\]](http://docs.aws.amazon.com/es_es/location/latest/developerguide/images/routesV2/P2P-Turn-by-turn-navigation.gif)


## Casos de uso
<a name="use-cases"></a>
+ **Muestre los detalles geográficos en un mapa de rutas:** utilice las características de mapeo avanzadas para visualizar rutas detalladas con abundante información geográfica, incluidos puntos de referencia, terreno e infraestructura urbana. Mejore la toma de decisiones al permitir a los usuarios ver rutas claras desde su punto de partida hasta su destino. Esta característica puede facilitar la navegación, la planificación y diversos escenarios logísticos, además de mostrar las rutas para los distintos modos de viaje, como coches, camiones, motos y peatones. Personalice las rutas agregando elementos como evasiones o cálculos de peajes.
+ **Mostrar turn-by-turn navegación:** proporciona un soporte de navegación perfecto en dispositivos web y móviles. Los usuarios pueden acceder a turn-by-turn las indicaciones, lo que garantiza un viaje eficiente. Ambas plataformas pueden aprovechar las instrucciones de navegación para ofrecer rutas para viajes personales o de negocios, incluidos los límites de velocidad.
+ **Calcule los costos de los peajes a lo largo de las rutas:** incorpore los cálculos de los costos de los peajes en la planificación de rutas para proporcionar estimaciones de precios precisas para las rutas que incluyen autopistas de peaje, puentes o túneles. Muestre los costos de los peajes por adelantado para ayudar a los conductores y planificadores a tomar decisiones rentables y evitar los peajes cuando sea necesario.
+ **Garantice el cumplimiento de los límites de velocidad:** integre los datos sobre los límites de velocidad para ayudar a los conductores a mantenerse dentro de los límites legales, lo que reduce el riesgo de multas y promueve una conducción más segura y eficiente en el consumo de combustible. La logística y la administración de flotas también pueden beneficiarse al supervisar el cumplimiento de la velocidad en tiempo real.
+ **Ayude con las soluciones de enrutamiento de carga y vehículos:** simplifique las operaciones de enrutamiento de carga y vehículos integrando las capacidades de rutas, navegación y seguimiento en los portales logísticos. Planifique de manera eficiente las rutas para múltiples entregas, realice un seguimiento de los envíos en tiempo real y administre los costos de combustible mediante un mejor enrutamiento.

## Explicación de la solicitud
<a name="understanding-request"></a>

**nota**  
 Para los clientes que estén en `ap-southeast-1` y`ap-southeast-5`, los campos de solicitud y respuesta admitidos pueden diferir. Consulta la [referencia de la CalculateRoutes API](https://docs.aws.amazon.com/location/latest/APIReference/API_CalculateRoutes.html) para obtener más información. 

La solicitud requiere los parámetros `Origin` y `Destination`, mientras que parámetros opcionales como `Allow`, `Avoid` y `Traffic` personalizan la ruta para adaptarla a necesidades y restricciones específicas.

**Origen**  
La posición inicial de la ruta en longitud y latitud.

**Destino**  
La posición final de la ruta.

**Puntos de referencia**  
Posiciones intermedias para incluirlas a lo largo de una ruta entre las posiciones inicial y final.

**OptimizeRoutingFor**  
Criterios de optimización para la ruta, como la ruta más rápida o más corta.

**LegGeometryFormat**  
Formato de la geometría devuelto para cada tramo de la ruta.

**Evitar**  
Las características que se deben evitar durante el cálculo de la ruta, se ignoran si no se encuentra una ruta alternativa.

**Tráfico**  
Opciones relacionadas con el tráfico que afectan a los cálculos de las rutas.

**Peajes**  
Opciones relacionadas con los peajes que afectan a los cálculos de las rutas y a los costos de los peajes.

**LegAdditionalFeatures**  
Características que se pueden habilitar en la respuesta para cada tramo del viaje.

**SpanAdditionalFeatures**  
Abarque características que se pueden habilitar en la respuesta para cada tramo del viaje.

## Explicación de la respuesta
<a name="understanding-response"></a>

La respuesta proporciona detalles de la ruta, como los tramos del viaje, avisos sobre los cálculos de la ruta e información resumida, que incluye la distancia y la duración.

**Rutas**  
Conjunto de rutas que contiene los tramos y las propiedades asociadas.

**​Avisos**  
Advertencias o mensajes informativos sobre la ruta.

**LegGeometryFormat**  
Especifica el formato de la geometría de la ruta.

### Detalles del tramo
<a name="leg-details"></a>

Cada tramo de un viaje puede ser del tipo transbordador, peatonal o vehículo, según el modo de transporte. Aunque cada tramo contiene propiedades independientes del modo de transporte, puede encontrar propiedades específicas en:

**FerryLegDetails**  
Propiedades específicas de transbordador para el tramo.

**VehicleLegDetails**  
Propiedades específicas de vehículo para el tramo.

**PedestrianLegDetails**  
Propiedades específicas de peatón para el tramo.

### Steps
<a name="steps"></a>

Cada tramo de un viaje se divide en pasos que describen las acciones que se deben realizar en algunos tramos de la ruta. Un paso puede ser predeterminado, adecuado para aplicaciones básicas o TurnByTurn adecuado para la turn-by-turn navegación. Cada paso contiene propiedades independientes del tipo de paso, como la duración y la distancia, y otras propiedades específicas ExitStepDetails, que solo se aplican a los pasos de salida.

**BeforeTravelSteps**  
Pasos a seguir antes de iniciar el viaje.

**TravelSteps**  
Pasos a seguir durante el viaje.

**AfterTravelSteps**  
Pasos a seguir después de completar el viaje.

### Intervalos
<a name="spans"></a>

Cada tramo de un viaje se puede dividir en unidades de seguimiento. Una unidad de seguimiento es una parte del tramo con los mismos valores para el conjunto de `SpanAdditionalFeatures` solicitado. Las unidades de seguimiento se dividen por las propiedades de las carreteras, como `SpeedLimit`, nombres de las carreteras o regiones. Las unidades de seguimiento devueltas se pueden usar para visualizar los atributos de la carretera y la información relacionada con el acceso.

# Cálculo del costo del peaje
<a name="calculate-toll-cost"></a>

En este tema se proporciona información general de los campos y las definiciones relacionados con el cálculo de los costos de peaje. Con estos campos, puede especificar parámetros como los métodos de pago, la moneda y las características del vehículo para personalizar los cálculos de los costos de los peajes.


| Nombre del campo | Rutas | 
| --- | --- | 
| Transpondedores | Sí, con opciones | 
| Viñetas | Sí, con opciones | 
| Currency (Moneda) | Sí, con opciones | 
| EmissionType | Sí, con opciones | 
| VehicleCategory | Sí, con opciones | 

## Definiciones
<a name="definitions"></a>

En esta sección se proporcionan breves definiciones de cada campo utilizado en el cálculo del costo de los peajes.

****Transpondedores****  
Los transpondedores son un método de pago de peajes, lo que puede resultar en un precio diferente en comparación con el de otros métodos de pago.

****Viñetas****  
Una viñeta es una forma de tarificación vial. Cuando un usuario tiene la viñeta requerida, no es necesario pagar peajes adicionales.

****Currency (Moneda****  
La divisa en la que se declaran los costos de los peajes. Además de la moneda local, se incluye una moneda convertida, que también afecta a la moneda utilizada en el resumen de peajes de la respuesta.

****EmissionType****  
El tipo de emisión del vehículo, que se utiliza para calcular los costos de los peajes en función de las emisiones del vehículo.

****VehicleCategory****  
La subcategoría de vehículos utilizada para calcular el costo del peaje.

# Descripción de los pasos de la ruta
<a name="understanding-route-steps"></a>

En esta sección se definen las diversas acciones y pasos que se deben tomar para completar un tramo de un viaje. Los pasos de la ruta varían en función del modo de viaje y sirven de guía para las aplicaciones de información general y para la navegación detallada paso a paso.

## Información general de pasos de rutas
<a name="route-steps-overview"></a>

Los siguientes tipos de pasos de rutas definen las acciones necesarias para completar un tramo de ruta y varían según el modo de viaje y la etapa del viaje.


| **Step type (Tipo de paso** | **Descripción** | 
| --- | --- | 
| Default steps | Pasos básicos que proporcionan instrucciones legibles para las personas, que suelen utilizarse en aplicaciones basadas en la web para ofrecer una visión general de la ruta. | 
| Turn by turn steps | Pasos detallados para crear una aplicación de navegación paso a paso, que ofrezca indicaciones más detalladas. | 
| Before travel steps | Pasos que hay que completar antes de iniciar la sección de viajes, como subir a un transbordador. | 
| After travel steps | Pasos que se deben realizar una vez finalizada la sección de viajes, como bajar de un transbordador. | 

## Desglose de pasos por modo de viaje
<a name="route-step-types"></a>


| **Sección** | **N.° de paso** | **Antes del viaje** | **Turismo** | **Después del viaje** | 
| --- | --- | --- | --- | --- | 
| Vehículo | Llegada | No | Sí | No | 
| Vehículo | Continuar | No | Sí | No | 
| Vehículo | ContinueHighway | No | Sí | No | 
| Vehículo | Salida | No | Sí | No | 
| Vehículo | Exit (Salir) | No | Sí | No | 
| Peatonal | Llegada | No | Sí | No | 
| Peatonal | Cargo | No | Sí | No | 
| Transbordador | Wait | No | No | Sí | 
| Transbordador | Embarcar | Sí | No | No | 
| Transbordador | Desembarcar | No | No | Sí | 

# Cálculo de matriz de rutas
<a name="calculate-route-matrix"></a>

El servicio de enrutamiento de matrices calcula las matrices d enrutamiento, lo que proporciona horas o distancias de viaje entre varios orígenes y destinos. Este servicio ofrece opciones de personalización flexibles, lo que le permite especificar los modos de viaje, las condiciones del tráfico y otros parámetros de enrutamiento. Los cálculos de matrices pueden variar en tamaño y forma, admiten matrices cuadradas y no cuadradas y se adaptan a datos de tráfico dinámicos o de flujo libre.

Para obtener más información, consulta [CalculateRouteMatrix](https://docs.aws.amazon.com/location/latest/APIReference/API_CalculateRouteMatrix.html)la *referencia de la API de Amazon Location Service*.

Para ver solicitudes de ejemplo, respuestas, cURL y comandos de la CLI para esta API, consulte [Cómo usar Calcular matriz de ruta](https://docs.aws.amazon.com/location/latest/developerguide/calculate-route-matrix-how-to.html).

## Casos de uso
<a name="route-matrix-use-cases"></a>
+ **Optimice las rutas de entrega para la logística y el comercio electrónico:** calcule de manera eficiente el tiempo y la distancia de viaje entre varios lugares de recogida y entrega para optimizar las rutas. Las empresas de logística pueden utilizar esta característica para minimizar los costos y el tiempo de entrega mediante la planificación de rutas eficientes entre ciudades. Es ideal para configurar plazos de entrega optimizados para servicios el mismo día o al día siguiente y planificar rutas de entrega con múltiples paradas.
+ **Una conductores y pasajeros en las aplicaciones de transporte compartido:** use los cálculos de ruta para unir conductores con los pasajeros más cercanos mediante la búsqueda de la ruta más rápida entre ubicaciones. Las aplicaciones para compartir viajes pueden mejorar la experiencia del usuario al proporcionar estimaciones de la llegada de los conductores en tiempo real, lo que garantiza que las recogidas y las devoluciones sean rápidas. Admite varios modos de transporte, como coches, bicicletas y motos.
+ **Planifique y optimice las rutas para la administración de flotas:** administre grandes flotas mediante la optimización de las rutas para reducir el consumo de combustible y el tiempo de viaje. Los administradores de flotas pueden asignar las rutas más eficientes a los vehículos para realizar múltiples paradas, lo que aumenta la eficiencia operativa general. Los casos de uso incluyen flotas de servicios, empresas de transporte y servicios públicos, donde la planificación óptima de las rutas es esencial para las visitas a las instalaciones.

## Explicación de la solicitud
<a name="route-matrix-request"></a>

**nota**  
 En el caso de los clientes que estén en `ap-southeast-1` y`ap-southeast-5`, los campos de solicitud y respuesta admitidos pueden diferir. Consulta la [referencia de la CalculateRouteMatrix API](https://docs.aws.amazon.com/location/latest/APIReference/API_CalculateRouteMatrix.html) para obtener más información. 

La solicitud incluye los **orígenes** y los **destinos** para el cálculo de las rutas, con parámetros opcionales para personalizar la matriz en función de las preferencias y restricciones. Para obtener más detalles, consulte la referencia de la API para la API de Calcular matriz de ruta.
+ `Origins`: lista de coordenadas de origen en longitud y latitud.
+ `Destinations`: lista de coordenadas de destino.
+ `OptimizeRoutingFor`: criterios de optimización como la ruta “más rápida” o “más corta”.
+ `RoutingBoundary`: define los límites para el cálculo, ya sea como “ilimitados” o restringidos a una geometría específica.
+ `Avoid`: características que se deben evitar durante el cálculo de la ruta. Se ignora si no se encuentra una ruta viable.
+ `Traffic`: las opciones relacionadas con el tráfico afectan a los cálculos de las rutas.

## Explicación de la respuesta
<a name="route-matrix-response"></a>

La respuesta incluye una matriz de rutas calculadas entre los orígenes y los destinos, con detalles como la distancia y la duración. También se proporcionan los errores y los límites de las rutas, si corresponde. Consulte la referencia de la API para obtener más detalles sobre la API de Calcular matriz de ruta.
+ `RouteMatrix`: Matriz que contiene las distancias de viaje (en metros) y las duraciones (en segundos) entre los orígenes y los destinos.
+ `ErrorCount`: número de errores encontrados durante los cálculos de la ruta.
+ `RoutingBoundary`: límite dentro del cual se calcula la matriz.

# Cálculo de isolíneas
<a name="calculate-isolines"></a>

La API de Cálculo de isolíneas le permite determinar las áreas a las que se puede llegar dentro de los límites de tiempo o distancia especificados. Al tener en cuenta factores como las restricciones de la carretera, las condiciones del tráfico y el modo de viaje, genera isolíneas que delimitan las áreas accesibles, lo que respalda las aplicaciones de planificación urbana, logística y accesibilidad de los servicios. Esta API se puede utilizar para la planificación urbana, el análisis inmobiliario y los estudios de accesibilidad, ya que permite visualizar el alcance de los servicios, las opciones de transporte o los recursos dentro de un plazo o límite de distancia establecidos. Al mostrar estas isolíneas en un mapa, los usuarios pueden evaluar el alcance del viaje dentro de las limitaciones específicas, lo que mejora la toma de decisiones a la hora de seleccionar el sitio, la cobertura de los servicios y la asignación de recursos.

Para obtener más información, consulte [CalculateIsolines](https://docs.aws.amazon.com/location/latest/APIReference/API_CalculateIsolines.html) en la *Referencia de la API de Amazon Location Service*.

Para ver ejemplos de solicitudes, respuestas, cURL y comandos de la CLI para esta API, consulte [Cómo usar el cálculo de isolíneas](https://docs.aws.amazon.com/location/latest/developerguide/calculate-isolines-how-to.html).

## Casos de uso
<a name="use-cases"></a>
+ **Evalúe la accesibilidad de la atención médica mediante isolíneas de tiempo de viaje:** genere isolíneas para evaluar el acceso a los centros de salud de varios vecindarios en función de la duración del viaje. Las organizaciones de salud pueden usar esta característica para identificar áreas desatendidas y tomar decisiones fundamentadas sobre la ubicación de las clínicas o los servicios de salud móviles, lo que mejora el acceso a la atención médica comunitaria.
+ **Analice el alcance de la comercialización con vistas a la expansión del comercio minorista mediante isolíneas de tiempo de viaje:** cree isolíneas para representar el acceso de los clientes a las ubicaciones minoristas en función de los tiempos de viaje. Las empresas minoristas pueden evaluar la ubicación de nuevas tiendas y comprender la demografía de los clientes, con estas visualizaciones para ampliar y optimizar estratégicamente el potencial de ventas.
+ **Optimice la logística y las zonas de entrega con isolíneas:** genere isolíneas para definir las zonas de entrega en función de los requisitos logísticos urgentes. Las empresas de logística pueden visualizar las áreas a las que se puede llegar en plazos específicos desde los centros de distribución, lo que mejora la planificación de rutas, la eficiencia operativa y las entregas puntuales.
+ **Planifique el acceso turístico y recreativo con isolíneas:** visualice los tiempos de viaje desde las atracciones turísticas hasta los alojamientos cercanos. Las oficinas de turismo pueden ayudar a los viajeros a encontrar opciones de alojamiento adecuadas, promover las empresas locales y mejorar la experiencia de viaje al mostrar estas isolíneas en un mapa.
+ **Mejore la planificación de la respuesta a emergencias mediante isolíneas:** genere isolíneas para evaluar los tiempos de respuesta desde las ubicaciones de los servicios de emergencia hasta diversas áreas de la comunidad. Los equipos de administración de emergencias pueden identificar las regiones dentro de los tiempos de respuesta críticos, lo que optimiza la asignación de recursos para mejorar la respuesta durante los incidentes.
+ **Analice los patrones de transporte para planificar la fuerza laboral con isolíneas:** genere isolíneas para visualizar los tiempos de traslado e identificar las áreas con tiempos de viaje elevados. Las empresas pueden utilizar estos conocimientos para políticas de trabajo remoto o reubicaciones de oficinas, lo que mejora la satisfacción y la productividad de los empleados.

## Explicación de la solicitud
<a name="understanding-request"></a>

La solicitud acepta parámetros como `Origin`, `Destination` y `Thresholds` para definir isolíneas. Los parámetros opcionales, como `Allow`, `Avoid` y `TravelModeOptions`, permiten personalizar las restricciones de las isolíneas. Para obtener más información, consulte .

**Origen**  
El punto de partida para el cálculo de la isolínea en longitud y latitud.

**Umbrales**  
Límites de tiempo o distancia utilizados para definir el límite de la isolínea.

**TravelMode**  
El modo de transporte, como coche, peatón o camión.

**OptimizeIsolineFor**  
Criterios de optimización, como un cálculo preciso, equilibrado o rápido.

**DepartureTime**  
Hora de salida, si se especifica, para calcular las isolíneas dependientes del tiempo.

**ArrivalTime**  
Hora de llegada, si se especifica, para calcular las isolíneas dependientes del tiempo.

**IsolineGranularity**  
El número máximo de puntos y la resolución del límite de la isolínea.

## Explicación de la respuesta
<a name="understanding-response"></a>

La respuesta incluye isolíneas con propiedades como `IsolineGeometryFormat`, que describen el área accesible en función de los parámetros de la solicitud.

**Isolíneas**  
Isolíneas calculadas con propiedades asociadas, incluidas geometrías y conexiones.

**Geometrías**  
Lista de geometrías que describe los límites de las isolíneas calculados.

**Connections**  
Conexiones entre geometrías de isolínea, incluida la geometría de cada conexión.

# Optimización de paradas
<a name="actions-optimize-waypoints"></a>

La API de Optimización de paradas calcula la secuencia más eficiente para visitar varios puntos de referencia a lo largo de una ruta. Mediante algoritmos avanzados, esta API minimiza el tiempo y la distancia de viaje y, al mismo tiempo, tiene en cuenta factores como las condiciones del tráfico, los obstáculos y las especificaciones del vehículo. La integración de la API de Optimización de paradas ayuda a las empresas a optimizar las operaciones, reducir el consumo de combustible, mejorar la eficiencia de las entregas y mejorar la satisfacción de los clientes. La API proporciona rutas optimizadas, lo que permite una mejor toma de decisiones y asignación de recursos en escenarios de viaje con varias paradas.

Para obtener más información, consulte [OptimizeWaypoints](https://docs.aws.amazon.com/location/latest/APIReference/API_OptimizeWaypoints.html) en la *Referencia de la API de Amazon Location Service*.

Para ver ejemplos de solicitudes, respuestas, cURL y comandos de la CLI para esta API, consulte [Cómo usar optimización de paradas](https://docs.aws.amazon.com/location/latest/developerguide/optimize-waypoints-how-to.html).

## Casos de uso
<a name="use-cases"></a>
+ **Mejore la eficiencia de la entrega en múltiples paradas:** optimice de manera eficiente la secuencia de múltiples paradas de entrega para reducir el tiempo y los costos de viaje. Los servicios de entrega pueden agilizar las operaciones al calcular la ruta más eficiente para los conductores, minimizar los gastos de combustible y garantizar las entregas puntuales, lo que mejora la satisfacción del cliente y la eficiencia operativa.
+ **Optimice las operaciones del servicio de campo:** optimice la secuencia de visitas a varios sitios de trabajo en un solo día, lo que reduce el tiempo de viaje de los técnicos del servicio de campo. Esto permite a las empresas completar más trabajos a diario, lo que mejora la productividad y la prestación de servicios.
+ **Planifique rutas turísticas eficientes para las agencias de viajes:** optimice los itinerarios que incluyan múltiples atracciones para maximizar las visitas turísticas y minimizar el tiempo de viaje. Las agencias de viajes pueden usar esta característica para crear planes óptimos para las visitas guiadas, lo que mejorará la experiencia turística general al aprovechar mejor el tiempo disponible.
+ **Mejore la eficiencia de los conductores que comparten el transporte:** optimice las secuencias de recogida y devolución de varios pasajeros, reduciendo los tiempos de espera y mejorando la experiencia de los pasajeros. Los servicios de transporte compartido pueden maximizar las ganancias de los conductores y garantizar un servicio puntual a los pasajeros al optimizar las paradas.
+ **Optimice las rutas para los servicios de recopilación de residuos:** planifique las rutas de recopilación de elementos no utilizados para minimizar la distancia y el tiempo de viaje, lo que ayuda a las empresas de gestión de residuos a agilizar sus operaciones y garantizar una recopilación puntual, lo que permite ahorrar costos y reducir el impacto ambiental.
+ **Coordine la logística de eventos y conferencias:** administre la logística de transporte para entregar equipos y suministros a varios lugares, lo que optimiza las rutas de carga y descarga. Esto permite a los planificadores de eventos agilizar el transporte, reducir los retrasos y garantizar la llegada puntual del material para los eventos.
+ **Mejore las rutas de respuesta a emergencias:** planifique las rutas más rápidas para múltiples emergencias y optimice los tiempos de respuesta en situaciones críticas. Los servicios de emergencia pueden mejorar la eficiencia de la respuesta y, potencialmente, salvar vidas mediante el uso de puntos de referencia optimizados.
+ **Facilite la planificación de las rutas de ventas para los representantes de campo:** optimice las rutas para que los representantes de ventas visiten varios clientes en un día, lo que minimiza el tiempo de viaje y maximiza las visitas de los clientes. Esto ayuda a las empresas a aumentar la productividad y aprovechar más oportunidades de venta.

## Explicación de la solicitud
<a name="understanding-request"></a>

La solicitud requiere parámetros como `Origin` y `Waypoints` para calcular una secuencia optimizada. Parámetros opcionales como `Avoid`, `Traffic` y `Driver` permiten una personalización adicional.

**Waypoints**  
Una lista de puntos de referencia que se van a optimizar en secuencia.

**Origen**  
La posición inicial de la ruta para la optimización.

**Destino**  
Una posición final opcional de la ruta para la optimización.

**OptimizeSequencingFor**  
Criterios para secuenciar la optimización, como la ruta más rápida o más corta.

**Tráfico**  
Opciones relacionadas con el tráfico que afectan a los cálculos de las rutas.

**Controlador**  
Ciclos de trabajo y descanso del conductor para garantizar el cumplimiento de las normas de conducción regionales.

**Agrupamiento en clústeres**  
La agrupación en clústeres le permite especificar cómo se pueden agrupar los puntos de referencia cercanos para mejorar la secuencia optimizada.

Cada parada también puede especificar las restricciones que se deben cumplir, por ejemplo `AppointmentTime`, `AccessHours` y ordenar las restricciones como `Before` de otro punto de referencia.

## Explicación de la respuesta
<a name="understanding-response"></a>

La respuesta proporciona detalles de la secuencia de puntos de referencia optimizada, incluido `OptimizedWaypoints` y la secuencia general `Distance` y `Duration` del viaje. 

**OptimizedWaypoints**  
Una lista de puntos de referencia en su orden optimizado.

**ImpedingWaypoints**  
Puntos de referencia que impiden una secuencia optimizada, incluidas las restricciones erróneas que no se cumplieron.

**Connections**  
Detalles sobre el viaje entre puntos de referencia, incluidas la distancia y la duración.

**TimeBreakdown**  
Desglose de las duraciones de `Travel`, `Rest`, `Service` y `Wait` totales de la ruta.

**ClusterIndex**  
Índice del clúster al que está asociado el punto de referencia. El índice se incluye en la respuesta solo si se realizó la agrupación en clústeres mientras se procesaba la solicitud.

# Ajustar a carreteras
<a name="snap-to-roads"></a>

La API de Ajustar a carreteras mejora la precisión del posicionamiento geográfico al alinear las coordenadas del GPS con los segmentos de carretera más cercanos en un mapa digital. Esta API toma datos sin procesar de longitud y latitud, que suelen recopilarse desde dispositivos móviles o vehículos, y los “ajusta” a la red de carreteras correspondiente, corrigiendo las imprecisiones causadas por la desviación del GPS o la pérdida de señal. Al integrar la API de Ajustar a carreteras, puede asegurarse de que las aplicaciones proporcionen datos fiables y precisos, lo que contribuye a una mejor toma de decisiones y a una mayor eficiencia operativa en diversos escenarios.

Para obtener más información, consulte [SnapToRoads](https://docs.aws.amazon.com/location/latest/APIReference/API_SnapToRoads.html) en la *Referencia de la API de Amazon Location Service*.

Para ver ejemplos de solicitudes, respuestas, cURL y comandos de la CLI para esta API, consulte [Ajustar a carreteras](https://docs.aws.amazon.com/location/latest/developerguide/snap-to-roads-how-to.html).

## Casos de uso
<a name="use-cases"></a>
+ **Mejore la precisión de la navegación ajustándose a la red de carreteras:** alinee de manera eficiente las coordenadas GPS con los segmentos de carretera más cercanos para mejorar la precisión de la navegación. Esta característica es valiosa para los servicios de cartografía y navegación, ya que proporciona a los usuarios indicaciones precisas y actualizaciones de ubicación en tiempo real, lo que mejora la experiencia de navegación.
+ **Mejore la precisión de los datos para las aplicaciones de administración de flotas:** corrija las posiciones notificadas de los vehículos ajustando sus coordenadas GPS a las carreteras más cercanas. En los sistemas de administración de flotas, esta característica garantiza un seguimiento preciso de los vehículos, lo que permite optimizar la logística y mejorar la eficiencia operativa.

## Explicación de la solicitud
<a name="understanding-request"></a>

La solicitud requiere que `TracePoints` coincidan con las carreteras, con parámetros opcionales como `SnappedGeometryFormat` y `SnapRadius` para controlar el formato de la geometría y el radio de ajuste.

**TracePoints**  
Una lista de coordenadas que se van a ajustar a la red de carreteras.

**SnappedGeometryFormat**  
El formato de la geometría devuelta, como “FlexiblePolyline” o “Simple”.

**SnapRadius**  
El radio alrededor de los puntos de seguimiento dentro del cual se considera el ajuste de carreteras.

## Explicación de la respuesta
<a name="understanding-response"></a>

La respuesta contiene una geometría corregida y puntos de seguimiento ajustados, con propiedades como `SnappedGeometry` y `SnappedTracePoints` que indican precisión y confianza en el ajuste.

**SnappedGeometry**  
La geometría corregida de la ruta ajustada.

**SnappedTracePoints**  
Las coordenadas ajustadas de los puntos de seguimiento se ajustaron a las carreteras.

**Avisos**  
Advertencias o mensajes informativos sobre el proceso de ajuste.

# Procedimiento
<a name="routes-how-to"></a>

Esta sección proporciona guías para aprovechar las rutas APIs para resolver los desafíos de enrutamiento y navegación. Estos tutoriales cubren las tareas esenciales para integrar la funcionalidad de enrutamiento en las aplicaciones. Cada tema se centra en un caso de uso específico, lo que le permite implementar de manera eficiente características de enrutamiento avanzadas adaptadas a las necesidades de su empresa.

**Topics**
+ [Obtención de información sobre cómo usar CalculateRoutes](calculate-routes-how-to.md)
+ [Obtención de información sobre cómo usar CalculateIsolines](calculate-isolines-how-to.md)
+ [Obtención de información sobre cómo usar CalculateRouteMatrix](calculate-route-matrix-how-to.md)
+ [Aprenda a usar OptimizeWaypoints](optimize-waypoints-how-to.md)
+ [Obtención de información sobre cómo usar SnapToRoads](snap-to-roads-how-to.md)

# Obtención de información sobre cómo usar CalculateRoutes
<a name="calculate-routes-how-to"></a>

En esta sección se ofrecen instrucciones paso a paso para usar `CalculateRoutes`. En este tema se detallan las instrucciones para encontrar rutas con configuraciones específicas, como incorporar la navegación paso a paso, configurar los modos de viaje y agregar puntos de referencia.

**Topics**
+ [Cómo encontrar una ruta para un origen y un destino](calculate-routes-origin-destination-waypoints.md)
+ [Cómo encontrar rutas con direcciones paso a paso](how-to-find-turn-by-turn-route.md)
+ [Cómo encontrar un límite de velocidad para un tramo de carretera](calculate-routes-speed-limit-road.md)
+ [Cómo encontrar rutas alternativas](calculate-routes-alternate.md)
+ [Cómo calcular los peajes de una ruta](calculate-routes-tolls.md)
+ [Cómo crear rutas con evasión personalizada](calculate-routes-custom-avoidance-poly.md)
+ [Cómo crear rutas con evasión personalizada de varios elementos potenciales](calculate-routes-custom-avoidance-multiple.md)
+ [Cómo encontrar la ruta más rápida](calculate-routes-custom-avoidance-fast.md)
+ [Cómo encontrar las rutas más cortas](calculate-routes-custom-avoidance-shortest.md)

# Cómo encontrar una ruta para un origen y un destino
<a name="calculate-routes-origin-destination-waypoints"></a>

La API de CalculateRoutes le ayuda a encontrar las mejores rutas entre el origen y el destino, así como las mejores oportunidades para que los conductores descansen. Admite modos de viaje como camión, peatón, coche y moto. También admite hasta 25 puntos de referencia (escalas), incluidos el origen y el destino con solo algunas restricciones.

## Casos de uso potenciales
<a name="potential-use-cases"></a>
+ **Encuentre rutas de punto a punto:** determine la mejor ruta entre dos ubicaciones en función de los distintos modos de viaje y las opciones adicionales.

## Ejemplos
<a name="calculate-routes-examples"></a>

### Cálculo de las rutas desde el origen hasta el destino con el coche como TravelMode
<a name="calculate-routes-car-mode"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        -123.118105,
        49.282423
    ],
    "Destination": [
        -123.020098,
        49.232872
    ]
}
```

------
#### [ Sample response ]

```
{
    "LegGeometryFormat": "FlexiblePolyline",
    "Notices": [],
    "Routes": [
        {
            "Legs": [
                {
                    "Geometry": {
                        "Polyline": "Redacted"
                    },
                    "TravelMode": "Car",
                    "Type": "Vehicle",
                    "VehicleLegDetails": {
                        "AfterTravelSteps": [],
                        "Arrival": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    -123.020098,
                                    49.232872
                                ],
                                "Position": [
                                    -123.0203051,
                                    49.2328499
                                ]
                            }
                        },
                        "Departure": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    -123.1181051,
                                    49.282423
                                ],
                                "Position": [
                                    -123.1180883,
                                    49.2824349
                                ]
                            }
                        },
                        "TravelSteps": [
                            {
                                "Distance": 1288,
                                "Duration": 102,
                                "Type": "Depart"
                            },
                            {
                                "Distance": 262,
                                "Duration": 24,
                                "Type": "Ramp"
                            },
                            {
                                "Distance": 1356,
                                "Duration": 134,
                                "Type": "Turn"
                            },
                            {
                                "Distance": 7092,
                                "Duration": 568,
                                "Type": "Keep"
                            },
                            {
                                "Distance": 65,
                                "Duration": 26,
                                "Type": "Turn"
                            },
                            {
                                "Distance": 50,
                                "Duration": 18,
                                "Type": "Turn"
                            },
                            {
                                "Distance": 0,
                                "Duration": 0,
                                "Type": "Arrive"
                            }
                        ]
                    }
                }
            ]
        }
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/routes?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "Origin": [
    -123.118105,
    49.282423
  ],
  "Destination": [
    -123.020098,
    49.232872
  ]
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-routes --key ${YourKey} \
--origin -123.118105 49.282423 \
--destination -123.020098 49.232872
```

------

# Cómo encontrar rutas con direcciones paso a paso
<a name="how-to-find-turn-by-turn-route"></a>

La API de CalculateRoutes le ayuda a encontrar las mejores rutas entre el origen y el destino, así como las mejores oportunidades para que los conductores descansen. Admite modos de viaje como coche, camión, peatón y moto. También admite hasta 25 puntos de referencia (escalas), incluidos el origen y el destino, con solo algunas restricciones.

## Casos de uso potenciales
<a name="potential-use-cases-turn-by-turn"></a>
+ **Cree una aplicación móvil de navegación:** utilice la API para obtener instrucciones de navegación paso a paso.
+ **Muestre las indicaciones en una plataforma web:** muestre una guía de rutas detallada para las aplicaciones web que le ayudarán a navegar.

## Ejemplos
<a name="calculate-routes-examples-turn-by-turn"></a>

### Cálculo de las rutas con coche como TravelMode
<a name="calculate-routes-car-mode-turn-by-turn"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        -123.118105,
        49.282423
    ],
    "Destination": [
        -123.020098,
        49.232872
    ],
    "TravelStepType": "TurnByTurn",
    "TravelMode": "Car"
}
```

------
#### [ Sample response ]

```
{
    "LegGeometryFormat": "FlexiblePolyline",
    "Notices": [],
    "Routes": [
        {
            "Legs": [
                {
                    "Geometry": {
                        "Polyline": "Redacted"
                    },
                    "TravelMode": "Car",
                    "Type": "Vehicle",
                    "VehicleLegDetails": {
                        "Arrival": {
                            "Place": {
                                "Position": [-123.0203051, 49.2328499]
                            }
                        },
                        "Departure": {
                            "Place": {
                                "Position": [-123.1180883, 49.2824349]
                            }
                        },
                        "TravelSteps": [
                            {
                                "Distance": 1288,
                                "Duration": 102,
                                "Type": "Depart",
                                "NextRoad": {
                                    "RoadName": "W Georgia St",
                                    "RouteNumber": "HWY-1A"
                                }
                            },
                            {
                                "Distance": 262,
                                "Duration": 24,
                                "Type": "Keep",
                                "NextRoad": {
                                    "RoadName": "Main St",
                                    "RouteNumber": "HWY-1A"
                                }
                            },
                            {
                                "Distance": 1356,
                                "Duration": 134,
                                "Type": "Turn",
                                "NextRoad": {
                                    "RoadName": "Main St",
                                    "RouteNumber": "HWY-1A"
                                }
                            },
                            {
                                "Distance": 7092,
                                "Duration": 568,
                                "Type": "Keep",
                                "NextRoad": {
                                    "RoadName": "Kingsway",
                                    "RouteNumber": "HWY-1A"
                                }
                            },
                            {
                                "Distance": 65,
                                "Duration": 26,
                                "Type": "Turn"
                            },
                            {
                                "Distance": 0,
                                "Duration": 0,
                                "Type": "Arrive"
                            }
                        ]
                    }
                }
            ]
        }
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/routes?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "Origin": [
    -123.118105,
    49.282423
  ],
  "Destination": [
    -123.020098,
    49.232872
  ],
  "TravelStepType": "TurnByTurn",
  "TravelMode": "Car"
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-routes --key ${YourKey} \
--origin -123.118105 49.282423 \
--destination -123.020098 49.232872 \
--travel-step-type "TurnByTurn" \
--travel-mode "Car"
```

------

# Cómo encontrar un límite de velocidad para un tramo de carretera
<a name="calculate-routes-speed-limit-road"></a>

La API de CalculateRoutes le ayuda a encontrar las mejores rutas entre el origen y el destino, así como las mejores oportunidades para que los conductores descansen. Admite modos de viaje como coche, camión, peatón y moto. También admite hasta 25 puntos de referencia (escalas), incluidos el origen y el destino, con solo algunas restricciones.

## Casos de uso potenciales
<a name="potential-use-cases"></a>
+ **Audite el cumplimiento de los límites de velocidad:** manténgase al tanto de los límites de velocidad y de su cumplimiento.
+ **Informe al conductor del límite de velocidad:** notifica al conductor el límite de velocidad cuando no esté claro lo contrario.

## Ejemplos
<a name="calculate-routes-speed-examples"></a>

### Búsqueda de los límites de velocidad en el coche como TravelMode
<a name="calculate-routes-speed"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        13.055211,
        52.704802
    ],
    "Destination": [
        13.551910,
        52.282705
    ],
    "TravelMode": "Car",
    "SpanAdditionalFeatures": ["SpeedLimit"]
}
```

------
#### [ Sample response ]

```
{
    "LegGeometryFormat": "FlexiblePolyline",
    "Notices": [],
    "Routes": [
        {
            "Legs": [
                {
                    "Geometry": {
                        "Polyline": "Redacted"
                    },
                    "TravelMode": "Car",
                    "Type": "Vehicle",
                    "VehicleLegDetails": {
                        "AfterTravelSteps": [],
                        "Arrival": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    13.55191,
                                    52.282705
                                ],
                                "Position": [
                                    13.5507836,
                                    52.2859121
                                ]
                            }
                        },
                        "Departure": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    13.055211,
                                    52.704802
                                ],
                                "Position": [
                                    13.0555036,
                                    52.7056073
                                ]
                            }
                        },
                        "Incidents": [],
                        "Notices": [],
                        "PassThroughWaypoints": [],
                        "Spans": [
                            {
                                "GeometryOffset": 0,
                                "SpeedLimit": {
                                    "Unlimited": true
                                }
                            },
                            {
                                "GeometryOffset": 151,
                                "SpeedLimit": {
                                    "MaxSpeed": 120.00000762939453
                                }
                            },
                            {
                                "GeometryOffset": 167,
                                "SpeedLimit": {
                                    "MaxSpeed": 80
                                }
                            },
                            {
                                "GeometryOffset": 195,
                                "SpeedLimit": {
                                    "MaxSpeed": 120.00000762939453
                                }
                            },
                            {
                                "GeometryOffset": 220,
                                "SpeedLimit": {
                                    "Unlimited": true
                                }
                            },
                            {
                                "GeometryOffset": 356,
                                "SpeedLimit": {
                                    "MaxSpeed": 120.00000762939453
                                }
                            },
                            {
                                "GeometryOffset": 358,
                                "SpeedLimit": {
                                    "MaxSpeed": 100
                                }
                            },
                            {
                                "GeometryOffset": 368,
                                "SpeedLimit": {
                                    "MaxSpeed": 80
                                }
                            },
                            {
                                "GeometryOffset": 384,
                                "SpeedLimit": {
                                    "MaxSpeed": 60.000003814697266
                                }
                            },
                            {
                                "GeometryOffset": 639,
                                "SpeedLimit": {
                                    "MaxSpeed": 80
                                }
                            },
                            {
                                "GeometryOffset": 701,
                                "SpeedLimit": {
                                    "MaxSpeed": 60.000003814697266
                                }
                            },
                            {
                                "GeometryOffset": 726,
                                "SpeedLimit": {
                                    "MaxSpeed": 80
                                }
                            },
                            {
                                "GeometryOffset": 805,
                                "SpeedLimit": {
                                    "MaxSpeed": 60.000003814697266
                                }
                            },
                            {
                                "GeometryOffset": 839,
                                "SpeedLimit": {
                                    "MaxSpeed": 80
                                }
                            },
                            {
                                "GeometryOffset": 1384,
                                "SpeedLimit": {
                                    "MaxSpeed": 60.000003814697266
                                }
                            },
                            {
                                "GeometryOffset": 1393,
                                "SpeedLimit": {
                                    "MaxSpeed": 50
                                }
                            },
                            {
                                "GeometryOffset": 1443,
                                "SpeedLimit": {
                                    "MaxSpeed": 30.000001907348633
                                }
                            },
                            {
                                "GeometryOffset": 1454,
                                "SpeedLimit": {
                                    "MaxSpeed": 50
                                }
                            },
                            {
                                "GeometryOffset": 1504,
                                "SpeedLimit": {
                                    "MaxSpeed": 60.000003814697266
                                }
                            },
                            {
                                "GeometryOffset": 1513,
                                "SpeedLimit": {
                                    "MaxSpeed": 80
                                }
                            },
                            {
                                "GeometryOffset": 1516,
                                "SpeedLimit": {
                                    "MaxSpeed": 60.000003814697266
                                }
                            },
                            {
                                "GeometryOffset": 1555,
                                "SpeedLimit": {
                                    "MaxSpeed": 80
                                }
                            },
                            {
                                "GeometryOffset": 1748,
                                "SpeedLimit": {
                                    "MaxSpeed": 120.00000762939453
                                }
                            },
                            {
                                "GeometryOffset": 1904,
                                "SpeedLimit": {
                                    "MaxSpeed": 100
                                }
                            },
                            {
                                "GeometryOffset": 1945,
                                "SpeedLimit": {
                                    "Unlimited": true
                                }
                            },
                            {
                                "GeometryOffset": 2006,
                                "SpeedLimit": {
                                    "MaxSpeed": 70
                                }
                            },
                            {
                                "GeometryOffset": 2017,
                                "SpeedLimit": {
                                    "MaxSpeed": 50
                                }
                            },
                            {
                                "GeometryOffset": 2033,
                                "SpeedLimit": {
                                    "MaxSpeed": 30.000001907348633
                                }
                            }
                        ],
                        "Tolls": [],
                        "TollSystems": [],
                        "TravelSteps": [
                            {
                                "Distance": 9099,
                                "Duration": 262,
                                "ExitNumber": [],
                                "GeometryOffset": 0,
                                "Type": "Depart"
                            },
                            {
                                "Distance": 18849,
                                "Duration": 800,
                                "ExitNumber": [],
                                "GeometryOffset": 162,
                                "KeepStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "Keep"
                            },
                            {
                                "Distance": 4290,
                                "Duration": 212,
                                "ExitNumber": [],
                                "ExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "GeometryOffset": 701,
                                "Type": "Exit"
                            },
                            {
                                "Distance": 14418,
                                "Duration": 651,
                                "ExitNumber": [],
                                "GeometryOffset": 828,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 1255,
                                "Duration": 62,
                                "ExitNumber": [],
                                "ExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "GeometryOffset": 1359,
                                "Type": "Exit"
                            },
                            {
                                "Distance": 1607,
                                "Duration": 139,
                                "ExitNumber": [],
                                "GeometryOffset": 1393,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 934,
                                "Duration": 92,
                                "ExitNumber": [],
                                "GeometryOffset": 1442,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 320,
                                "Duration": 27,
                                "ExitNumber": [],
                                "GeometryOffset": 1473,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 320,
                                "Duration": 33,
                                "ExitNumber": [],
                                "GeometryOffset": 1491,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 17863,
                                "Duration": 680,
                                "ExitNumber": [],
                                "GeometryOffset": 1504,
                                "RampStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "Ramp"
                            },
                            {
                                "Distance": 2888,
                                "Duration": 95,
                                "ExitNumber": [],
                                "GeometryOffset": 1917,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 321,
                                "Duration": 28,
                                "ExitNumber": [],
                                "ExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "GeometryOffset": 1977,
                                "Type": "Exit"
                            },
                            {
                                "Distance": 549,
                                "Duration": 41,
                                "ExitNumber": [],
                                "GeometryOffset": 2006,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 386,
                                "Duration": 51,
                                "ExitNumber": [],
                                "GeometryOffset": 2023,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 98,
                                "Duration": 15,
                                "ExitNumber": [],
                                "GeometryOffset": 2033,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 0,
                                "Duration": 0,
                                "ExitNumber": [],
                                "GeometryOffset": 2036,
                                "Type": "Arrive"
                            }
                        ],
                        "TruckRoadTypes": [],
                        "Zones": []
                    }
                }
            ],
            "MajorRoadLabels": [
                {
                    "RouteNumber": {
                        "Language": "de",
                        "Value": "A111"
                    }
                },
                {
                    "RouteNumber": {
                        "Language": "de",
                        "Value": "A113"
                    }
                }
            ]
        }
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/routes?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "Origin": [
    13.055211,
    52.704802
  ],
  "Destination": [
    13.551910,
    52.282705
  ],
  "TravelMode": "Car",
  "SpanAdditionalFeatures": ["SpeedLimit"]
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-routes --key ${YourKey} \
--origin 13.055211 52.704802 \
--destination 13.551910 52.282705 \
--travel-mode "Car" \
--span-additional-features "SpeedLimit"
```

------

# Cómo encontrar rutas alternativas
<a name="calculate-routes-alternate"></a>

La API de CalculateRoutes le ayuda a encontrar las mejores rutas entre el origen y el destino, así como las mejores oportunidades para que los conductores descansen. Admite modos de viaje como coche, camión, peatón y moto. También admite hasta 25 puntos de referencia (escalas), incluidos el origen y el destino, con solo algunas restricciones.

## Casos de uso potenciales
<a name="potential-use-cases"></a>
+ **Identifique rutas alternativas:** sea capaz de elegir la ruta que mejor se adapte a las necesidades de su empresa.

## Ejemplos
<a name="calculate-routes-alternate-examples"></a>

### Búsqueda de rutas alternativas en coche como TravelMode
<a name="calculate-routes-alternate"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        13.055211,
        52.704802
    ],
    "Destination": [
        13.551910,
        52.282705
    ],
    "TravelMode": "Car",
    "MaxAlternatives": 2
}
```

------
#### [ Sample response ]

```
{
    "LegGeometryFormat": "FlexiblePolyline",
    "Notices": [],
    "Routes": [
        {
            "Legs": [
                {
                    "Geometry": {
                        "Polyline": "Redacted"
                    },
                    "TravelMode": "Car",
                    "Type": "Vehicle",
                    "VehicleLegDetails": {
                        "AfterTravelSteps": [],
                        "Arrival": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    13.55191,
                                    52.282705
                                ],
                                "Position": [
                                    13.5507836,
                                    52.2859121
                                ]
                            }
                        },
                        "Departure": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    13.055211,
                                    52.704802
                                ],
                                "Position": [
                                    13.0555036,
                                    52.7056073
                                ]
                            }
                        },
                        "Incidents": [],
                        "Notices": [],
                        "PassThroughWaypoints": [],
                        "Spans": [],
                        "Tolls": [],
                        "TollSystems": [],
                        "TravelSteps": [
                            {
                                "Distance": 9099,
                                "Duration": 262,
                                "ExitNumber": [],
                                "GeometryOffset": 0,
                                "Type": "Depart"
                            },
                            {
                                "Distance": 18849,
                                "Duration": 800,
                                "ExitNumber": [],
                                "GeometryOffset": 162,
                                "KeepStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "Keep"
                            },
                            {
                                "Distance": 4290,
                                "Duration": 212,
                                "ExitNumber": [],
                                "ExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "GeometryOffset": 701,
                                "Type": "Exit"
                            },
                            {
                                "Distance": 14418,
                                "Duration": 651,
                                "ExitNumber": [],
                                "GeometryOffset": 828,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 1255,
                                "Duration": 62,
                                "ExitNumber": [],
                                "ExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "GeometryOffset": 1359,
                                "Type": "Exit"
                            },
                            {
                                "Distance": 1607,
                                "Duration": 139,
                                "ExitNumber": [],
                                "GeometryOffset": 1393,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 934,
                                "Duration": 92,
                                "ExitNumber": [],
                                "GeometryOffset": 1442,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 320,
                                "Duration": 27,
                                "ExitNumber": [],
                                "GeometryOffset": 1473,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 320,
                                "Duration": 33,
                                "ExitNumber": [],
                                "GeometryOffset": 1491,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 17863,
                                "Duration": 680,
                                "ExitNumber": [],
                                "GeometryOffset": 1504,
                                "RampStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "Ramp"
                            },
                            {
                                "Distance": 2888,
                                "Duration": 95,
                                "ExitNumber": [],
                                "GeometryOffset": 1917,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 321,
                                "Duration": 28,
                                "ExitNumber": [],
                                "ExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "GeometryOffset": 1977,
                                "Type": "Exit"
                            },
                            {
                                "Distance": 549,
                                "Duration": 41,
                                "ExitNumber": [],
                                "GeometryOffset": 2006,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 386,
                                "Duration": 51,
                                "ExitNumber": [],
                                "GeometryOffset": 2023,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 98,
                                "Duration": 15,
                                "ExitNumber": [],
                                "GeometryOffset": 2033,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 0,
                                "Duration": 0,
                                "ExitNumber": [],
                                "GeometryOffset": 2036,
                                "Type": "Arrive"
                            }
                        ],
                        "TruckRoadTypes": [],
                        "Zones": []
                    }
                }
            ],
            "MajorRoadLabels": [
                {
                    "RouteNumber": {
                        "Language": "de",
                        "Value": "A111"
                    }
                },
                {
                    "RouteNumber": {
                        "Language": "de",
                        "Value": "A113"
                    }
                }
            ]
        },
        {
            "Legs": [
                {
                    "Geometry": {
                        "Polyline": "Redacted"
                    },
                    "TravelMode": "Car",
                    "Type": "Vehicle",
                    "VehicleLegDetails": {
                        "AfterTravelSteps": [],
                        "Arrival": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    13.55191,
                                    52.282705
                                ],
                                "Position": [
                                    13.5507836,
                                    52.2859121
                                ]
                            }
                        },
                        "Departure": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    13.055211,
                                    52.704802
                                ],
                                "Position": [
                                    13.0555036,
                                    52.7056073
                                ]
                            }
                        },
                        "Incidents": [],
                        "Notices": [],
                        "PassThroughWaypoints": [],
                        "Spans": [],
                        "Tolls": [],
                        "TollSystems": [],
                        "TravelSteps": [
                            {
                                "Distance": 91047,
                                "Duration": 2880,
                                "ExitNumber": [],
                                "GeometryOffset": 0,
                                "Type": "Depart"
                            },
                            {
                                "Distance": 3496,
                                "Duration": 119,
                                "ExitNumber": [],
                                "ExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "GeometryOffset": 1473,
                                "Type": "Exit"
                            },
                            {
                                "Distance": 321,
                                "Duration": 28,
                                "ExitNumber": [],
                                "ExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "GeometryOffset": 1565,
                                "Type": "Exit"
                            },
                            {
                                "Distance": 549,
                                "Duration": 41,
                                "ExitNumber": [],
                                "GeometryOffset": 1594,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 386,
                                "Duration": 51,
                                "ExitNumber": [],
                                "GeometryOffset": 1611,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 98,
                                "Duration": 15,
                                "ExitNumber": [],
                                "GeometryOffset": 1621,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 0,
                                "Duration": 0,
                                "ExitNumber": [],
                                "GeometryOffset": 1624,
                                "Type": "Arrive"
                            }
                        ],
                        "TruckRoadTypes": [],
                        "Zones": []
                    }
                }
            ],
            "MajorRoadLabels": [
                {
                    "RouteNumber": {
                        "Language": "de",
                        "Value": "A10"
                    }
                }
            ]
        },
        {
            "Legs": [
                {
                    "Geometry": {
                        "Polyline": "Redacted"
                    },
                    "TravelMode": "Car",
                    "Type": "Vehicle",
                    "VehicleLegDetails": {
                        "AfterTravelSteps": [],
                        "Arrival": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    13.55191,
                                    52.282705
                                ],
                                "Position": [
                                    13.5507836,
                                    52.2859121
                                ]
                            }
                        },
                        "Departure": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    13.055211,
                                    52.704802
                                ],
                                "Position": [
                                    13.0555036,
                                    52.7056073
                                ]
                            }
                        },
                        "Incidents": [],
                        "Notices": [],
                        "PassThroughWaypoints": [],
                        "Spans": [],
                        "Tolls": [],
                        "TollSystems": [],
                        "TravelSteps": [
                            {
                                "Distance": 9099,
                                "Duration": 262,
                                "ExitNumber": [],
                                "GeometryOffset": 0,
                                "Type": "Depart"
                            },
                            {
                                "Distance": 18849,
                                "Duration": 800,
                                "ExitNumber": [],
                                "GeometryOffset": 162,
                                "KeepStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "Keep"
                            },
                            {
                                "Distance": 4290,
                                "Duration": 212,
                                "ExitNumber": [],
                                "ExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "GeometryOffset": 701,
                                "Type": "Exit"
                            },
                            {
                                "Distance": 12258,
                                "Duration": 554,
                                "ExitNumber": [],
                                "GeometryOffset": 828,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 18567,
                                "Duration": 1218,
                                "ExitNumber": [],
                                "ExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "GeometryOffset": 1282,
                                "Type": "Exit"
                            },
                            {
                                "Distance": 250,
                                "Duration": 28,
                                "ExitNumber": [],
                                "GeometryOffset": 1760,
                                "RampStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "Ramp"
                            },
                            {
                                "Distance": 4856,
                                "Duration": 245,
                                "ExitNumber": [],
                                "GeometryOffset": 1793,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 3202,
                                "Duration": 165,
                                "ExitNumber": [],
                                "GeometryOffset": 1970,
                                "RoundaboutExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "RoundaboutExit"
                            },
                            {
                                "Distance": 386,
                                "Duration": 51,
                                "ExitNumber": [],
                                "GeometryOffset": 2072,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 98,
                                "Duration": 15,
                                "ExitNumber": [],
                                "GeometryOffset": 2082,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 0,
                                "Duration": 0,
                                "ExitNumber": [],
                                "GeometryOffset": 2085,
                                "Type": "Arrive"
                            }
                        ],
                        "TruckRoadTypes": [],
                        "Zones": []
                    }
                }
            ],
            "MajorRoadLabels": [
                {
                    "RouteNumber": {
                        "Language": "de",
                        "Value": "A111"
                    }
                },
                {
                    "RouteNumber": {
                        "Language": "de",
                        "Value": "B96"
                    }
                }
            ]
        }
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/routes?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "Origin": [
    13.055211,
    52.704802
  ],
  "Destination": [
    13.551910,
    52.282705
  ],
  "TravelMode": "Car",
  "MaxAlternatives": 2
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-routes --key ${YourKey} \
--origin 13.055211 52.704802 \
--destination 13.551910 52.282705 \
--travel-mode "Car" \
--max-alternatives 2
```

------

# Cómo calcular los peajes de una ruta
<a name="calculate-routes-tolls"></a>

La API de CalculateRoutes le ayuda a encontrar las mejores rutas entre el origen y el destino, así como las mejores oportunidades para que los conductores descansen. Admite modos de viaje como coche, camión, peatón y moto. También admite hasta 25 puntos de referencia (escalas), incluidos el origen y el destino, con solo algunas restricciones.

## Casos de uso potenciales
<a name="potential-use-cases"></a>
+ **Calcule los peajes:** sea capaz de calcular los costos de los peajes durante la planificación de la ruta.
+ **Audite los peajes:** sea capaz de auditar los costos de los peajes después del viaje.

## Ejemplos
<a name="calculate-routes-tolls-examples"></a>

### Cálculo de los peajes para las rutas en coche como TravelMode
<a name="calculate-routes-tolls"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        2.234491,
        48.815704
    ],
    "Destination": [
        5.11412,
        47.260723
    ],
    "TravelMode": "Car",
    "Tolls": {
        "AllTransponders": true,
        "AllVignettes": true
    }
}
```

------
#### [ Sample response ]

```
{
    "LegGeometryFormat": "FlexiblePolyline",
    "Notices": [],
    "Routes": [
        {
            "Legs": [
                {
                    "Geometry": {
                        "Polyline": "Redacted"
                    },
                    "TravelMode": "Car",
                    "Type": "Vehicle",
                    "VehicleLegDetails": {
                        "AfterTravelSteps": [],
                        "Arrival": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    5.11412,
                                    47.2607229
                                ],
                                "Position": [
                                    5.1128203,
                                    47.2596356
                                ]
                            }
                        },
                        "Departure": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    2.234491,
                                    48.8157039
                                ],
                                "Position": [
                                    2.2346482,
                                    48.815674
                                ]
                            }
                        },
                        "Incidents": [],
                        "Notices": [],
                        "PassThroughWaypoints": [],
                        "Spans": [],
                        "Tolls": [
                            {
                                "Country": "FRA",
                                "PaymentSites": [
                                    {
                                        "Name": "FLEURY-EN-BIERE",
                                        "Position": [
                                            2.53988,
                                            48.42578
                                        ]
                                    },
                                    {
                                        "Name": "POUILLY-EN-AUXOIS",
                                        "Position": [
                                            4.56112,
                                            47.25244
                                        ]
                                    }
                                ],
                                "Rates": [
                                    {
                                        "Id": "2d680295-fb0f-45aa-a8ed-79d9f0f9ff9f",
                                        "LocalPrice": {
                                            "Currency": "EUR",
                                            "Estimate": false,
                                            "Range": false,
                                            "Value": 21.700000762939453
                                        },
                                        "Name": "APRR",
                                        "PaymentMethods": [
                                            "Cash",
                                            "BankCard",
                                            "CreditCard",
                                            "Transponder",
                                            "TravelCard"
                                        ],
                                        "Transponders": [
                                            {
                                                "SystemName": "BipandGo"
                                            },
                                            {
                                                "SystemName": "BipandGo"
                                            },
                                            {
                                                "SystemName": "BipandGo IDVROOM carpoorling"
                                            },
                                            {
                                                "SystemName": "Cito30"
                                            },
                                            {
                                                "SystemName": "Easytrip pass"
                                            },
                                            {
                                                "SystemName": "Liane 30"
                                            },
                                            {
                                                "SystemName": "Liber-t"
                                            },
                                            {
                                                "SystemName": "Liber-t mobilitis"
                                            },
                                            {
                                                "SystemName": "Pass Pont-Pont"
                                            },
                                            {
                                                "SystemName": "Progressivi'T Maurienne"
                                            },
                                            {
                                                "SystemName": "TopEurop"
                                            },
                                            {
                                                "SystemName": "Tunnel Pass+"
                                            },
                                            {
                                                "SystemName": "Ulys"
                                            },
                                            {
                                                "SystemName": "Ulys Europe"
                                            },
                                            {
                                                "SystemName": "Viaduc-t 30"
                                            }
                                        ]
                                    }
                                ],
                                "Systems": [
                                    0
                                ]
                            }
                        ],
                        "TollSystems": [
                            {
                                "Name": "APRR"
                            }
                        ],
                        "TravelSteps": [
                            {
                                "Distance": 122,
                                "Duration": 21,
                                "ExitNumber": [],
                                "GeometryOffset": 0,
                                "Type": "Depart"
                            },
                            {
                                "Distance": 32,
                                "Duration": 7,
                                "ExitNumber": [],
                                "GeometryOffset": 7,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 74,
                                "Duration": 14,
                                "ExitNumber": [],
                                "GeometryOffset": 8,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 199,
                                "Duration": 33,
                                "ExitNumber": [],
                                "GeometryOffset": 9,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 21,
                                "Duration": 10,
                                "ExitNumber": [],
                                "GeometryOffset": 17,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 461,
                                "Duration": 63,
                                "ExitNumber": [],
                                "GeometryOffset": 20,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 1557,
                                "Duration": 145,
                                "ExitNumber": [],
                                "GeometryOffset": 41,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 3471,
                                "Duration": 151,
                                "ExitNumber": [],
                                "GeometryOffset": 135,
                                "RoundaboutExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "RoundaboutExit"
                            },
                            {
                                "Distance": 9796,
                                "Duration": 430,
                                "ExitNumber": [],
                                "GeometryOffset": 242,
                                "RampStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "Ramp"
                            },
                            {
                                "Distance": 2473,
                                "Duration": 112,
                                "ExitNumber": [],
                                "ExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "GeometryOffset": 582,
                                "Type": "Exit"
                            },
                            {
                                "Distance": 674,
                                "Duration": 25,
                                "ExitNumber": [],
                                "GeometryOffset": 669,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 253953,
                                "Duration": 7468,
                                "ExitNumber": [],
                                "GeometryOffset": 679,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 37379,
                                "Duration": 1192,
                                "ExitNumber": [],
                                "ExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "GeometryOffset": 5701,
                                "Type": "Exit"
                            },
                            {
                                "Distance": 2021,
                                "Duration": 110,
                                "ExitNumber": [],
                                "GeometryOffset": 6695,
                                "RoundaboutExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "RoundaboutExit"
                            },
                            {
                                "Distance": 7380,
                                "Duration": 316,
                                "ExitNumber": [],
                                "GeometryOffset": 6776,
                                "RoundaboutPassStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "RoundaboutPass"
                            },
                            {
                                "Distance": 4253,
                                "Duration": 156,
                                "ExitNumber": [],
                                "GeometryOffset": 6987,
                                "KeepStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left"
                                },
                                "Type": "Keep"
                            },
                            {
                                "Distance": 813,
                                "Duration": 54,
                                "ExitNumber": [],
                                "GeometryOffset": 7081,
                                "RampStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "Ramp"
                            },
                            {
                                "Distance": 1909,
                                "Duration": 109,
                                "ExitNumber": [],
                                "GeometryOffset": 7133,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Sharp"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 827,
                                "Duration": 47,
                                "ExitNumber": [],
                                "GeometryOffset": 7182,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 680,
                                "Duration": 41,
                                "ExitNumber": [],
                                "GeometryOffset": 7216,
                                "RoundaboutExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "RoundaboutExit"
                            },
                            {
                                "Distance": 224,
                                "Duration": 12,
                                "ExitNumber": [],
                                "GeometryOffset": 7258,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 25,
                                "Duration": 2,
                                "ExitNumber": [],
                                "GeometryOffset": 7265,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 748,
                                "Duration": 51,
                                "ExitNumber": [],
                                "GeometryOffset": 7267,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 656,
                                "Duration": 46,
                                "ExitNumber": [],
                                "GeometryOffset": 7299,
                                "RoundaboutExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "RoundaboutExit"
                            },
                            {
                                "Distance": 1119,
                                "Duration": 78,
                                "ExitNumber": [],
                                "GeometryOffset": 7329,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 432,
                                "Duration": 26,
                                "ExitNumber": [],
                                "GeometryOffset": 7383,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 1864,
                                "Duration": 100,
                                "ExitNumber": [],
                                "GeometryOffset": 7402,
                                "RoundaboutExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "RoundaboutExit"
                            },
                            {
                                "Distance": 1110,
                                "Duration": 93,
                                "ExitNumber": [],
                                "GeometryOffset": 7470,
                                "RoundaboutExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "RoundaboutExit"
                            },
                            {
                                "Distance": 232,
                                "Duration": 10,
                                "ExitNumber": [],
                                "GeometryOffset": 7563,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 642,
                                "Duration": 29,
                                "ExitNumber": [],
                                "GeometryOffset": 7572,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 357,
                                "Duration": 25,
                                "ExitNumber": [],
                                "GeometryOffset": 7580,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 63,
                                "Duration": 10,
                                "ExitNumber": [],
                                "GeometryOffset": 7600,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 2626,
                                "Duration": 411,
                                "ExitNumber": [],
                                "GeometryOffset": 7602,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 234,
                                "Duration": 37,
                                "ExitNumber": [],
                                "GeometryOffset": 7627,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 0,
                                "Duration": 0,
                                "ExitNumber": [],
                                "GeometryOffset": 7632,
                                "Type": "Arrive"
                            }
                        ],
                        "TruckRoadTypes": [],
                        "Zones": []
                    }
                }
            ],
            "MajorRoadLabels": [
                {
                    "RouteNumber": {
                        "Language": "fr",
                        "Value": "A6"
                    }
                }
            ]
        }
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/routes?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "Origin": [
    2.234491,
    48.815704
  ],
  "Destination": [
    5.11412,
    47.260723
  ],
  "TravelMode": "Car",
  "Tolls": {
    "AllTransponders": true,
    "AllVignettes": true
  }
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-routes --key ${YourKey} \
--origin 13.055211 52.704802 \
--destination 13.551910 52.282705 \
--travel-mode "Car" \
--tolls '{"AllTransponders": true, "AllVignettes": true}'
```

------

# Cómo crear rutas con evasión personalizada
<a name="calculate-routes-custom-avoidance-poly"></a>

La API de CalculateRoutes le ayuda a encontrar las mejores rutas entre el origen y el destino, así como las mejores oportunidades para que los conductores descansen. Admite modos de viaje como coche, camión, peatón y moto. También admite hasta 25 puntos de referencia (escalas), incluidos el origen y el destino, con solo algunas restricciones.

## Casos de uso potenciales
<a name="potential-use-cases"></a>
+ **Calcule las rutas con evasión personalizada:** personalice las rutas con evasión para planificar mejor las rutas y los viajes diarios.

## Ejemplos
<a name="calculate-routes-custom-avoidance-examples"></a>

### Use CalculateRoutes con un BoundingBox de evasión para crear rutas personalizadas.
<a name="calculate-routes-custom-avoidance-poly"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        -123.116655,
        49.281538
    ],
    "Destination": [
        -123.01791785749363,
        49.22782762759908
    ],
    "TravelMode": "Car",
    "Avoid": {
        "Areas": [
            {
                "Geometry": {
                    "BoundingBox": [
                        -123.078693,
                        49.238987,
                        -123.054638,
                        49.251694
                    ]
                }
            }
        ]
    }
}
```

------
#### [ Sample response ]

```
{
    "LegGeometryFormat": "FlexiblePolyline",
    "Notices": [],
    "Routes": [
        {
            "Legs": [
                {
                    "Geometry": {
                        "Polyline": "Redacted"
                    },
                    "TravelMode": "Car",
                    "Type": "Vehicle",
                    "VehicleLegDetails": {
                        "AfterTravelSteps": [],
                        "Arrival": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    -123.0179179,
                                    49.2278276
                                ],
                                "Position": [
                                    -123.0229001,
                                    49.22883
                                ]
                            }
                        },
                        "Departure": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    -123.116655,
                                    49.281538
                                ],
                                "Position": [
                                    -123.1166332,
                                    49.2815528
                                ]
                            }
                        },
                        "Incidents": [],
                        "Notices": [],
                        "PassThroughWaypoints": [],
                        "Spans": [],
                        "Tolls": [],
                        "TollSystems": [],
                        "TravelSteps": [
                            {
                                "Distance": 1144,
                                "Duration": 85,
                                "ExitNumber": [],
                                "GeometryOffset": 0,
                                "Type": "Depart"
                            },
                            {
                                "Distance": 262,
                                "Duration": 24,
                                "ExitNumber": [],
                                "GeometryOffset": 35,
                                "RampStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "Ramp"
                            },
                            {
                                "Distance": 433,
                                "Duration": 47,
                                "ExitNumber": [],
                                "GeometryOffset": 40,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 1131,
                                "Duration": 81,
                                "ExitNumber": [],
                                "GeometryOffset": 54,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 54,
                                "Duration": 4,
                                "ExitNumber": [],
                                "GeometryOffset": 79,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 520,
                                "Duration": 39,
                                "ExitNumber": [],
                                "GeometryOffset": 83,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 1123,
                                "Duration": 111,
                                "ExitNumber": [],
                                "GeometryOffset": 101,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 1131,
                                "Duration": 81,
                                "ExitNumber": [],
                                "GeometryOffset": 141,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 2843,
                                "Duration": 209,
                                "ExitNumber": [],
                                "GeometryOffset": 167,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 3219,
                                "Duration": 246,
                                "ExitNumber": [],
                                "GeometryOffset": 255,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 64,
                                "Duration": 23,
                                "ExitNumber": [],
                                "GeometryOffset": 332,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 0,
                                "Duration": 0,
                                "ExitNumber": [],
                                "GeometryOffset": 334,
                                "Type": "Arrive"
                            }
                        ],
                        "TruckRoadTypes": [],
                        "Zones": []
                    }
                }
            ],
            "MajorRoadLabels": [
                {
                    "RoadName": {
                        "Language": "en",
                        "Value": "Boundary Rd"
                    }
                },
                {
                    "RoadName": {
                        "Language": "en",
                        "Value": "Grandview Hwy"
                    }
                }
            ]
        }
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/routes?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "Origin": [
    -123.116655,
    49.281538
  ],
  "Destination": [
    -123.01791785749363,
    49.22782762759908
  ],
  "TravelMode": "Car",
  "Avoid": {
    "Areas": [
      {
        "Geometry": {
          "BoundingBox": [
            -123.078693,
            49.238987,
            -123.054638,
            49.251694
          ]
        }
      }
    ]
  }
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-routes --key ${YourKey} \
--origin -123.13277 49.281538 \
--destination -123.01791785749363 49.22782762759908 \
--travel-mode "Car" \
--avoid '{"Areas":[{"Geometry":{"BoundingBox":[-123.054638,49.238987,-123.054638,49.251694]}}]}'
```

------

### Use CalculateRoutes con un polígono de evasión para crear rutas personalizadas.
<a name="calculate-routes-custom-avoidance-poly-polygon"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        -123.116655,
        49.281538
    ],
    "Destination": [
        -123.01791785749363,
        49.22782762759908
    ],
    "TravelMode": "Car",
    "Avoid": {
        "Areas": [
            {
                "Geometry": {
                    "polygon": [
                        [
                            [
                                -123.06953,
                                49.256419
                            ],
                            [
                                -123.080486,
                                49.242115
                            ],
                            [
                                -123.058573,
                                49.242115
                            ],
                            [
                                -123.06953,
                                49.256419
                            ]
                        ]
                    ]
                }
            }
        ]
    }
}
```

------
#### [ Sample response ]

```
{
    "LegGeometryFormat": "FlexiblePolyline",
    "Notices": [],
    "Routes": [
        {
            "Legs": [
                {
                    "Geometry": {
                        "Polyline": "Redacted"
                    },
                    "TravelMode": "Car",
                    "Type": "Vehicle",
                    "VehicleLegDetails": {
                        "AfterTravelSteps": [],
                        "Arrival": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    -123.0179179,
                                    49.2278276
                                ],
                                "Position": [
                                    -123.0229001,
                                    49.22883
                                ]
                            }
                        },
                        "Departure": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    -123.116655,
                                    49.281538
                                ],
                                "Position": [
                                    -123.1166332,
                                    49.2815528
                                ]
                            }
                        },
                        "Incidents": [],
                        "Notices": [],
                        "PassThroughWaypoints": [],
                        "Spans": [],
                        "Tolls": [],
                        "TollSystems": [],
                        "TravelSteps": [
                            {
                                "Distance": 1144,
                                "Duration": 85,
                                "ExitNumber": [],
                                "GeometryOffset": 0,
                                "Type": "Depart"
                            },
                            {
                                "Distance": 262,
                                "Duration": 24,
                                "ExitNumber": [],
                                "GeometryOffset": 35,
                                "RampStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "Ramp"
                            },
                            {
                                "Distance": 433,
                                "Duration": 47,
                                "ExitNumber": [],
                                "GeometryOffset": 40,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 1131,
                                "Duration": 81,
                                "ExitNumber": [],
                                "GeometryOffset": 54,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 54,
                                "Duration": 4,
                                "ExitNumber": [],
                                "GeometryOffset": 79,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 520,
                                "Duration": 39,
                                "ExitNumber": [],
                                "GeometryOffset": 83,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 1123,
                                "Duration": 111,
                                "ExitNumber": [],
                                "GeometryOffset": 101,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 1131,
                                "Duration": 81,
                                "ExitNumber": [],
                                "GeometryOffset": 141,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 448,
                                "Duration": 34,
                                "ExitNumber": [],
                                "GeometryOffset": 167,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 1797,
                                "Duration": 151,
                                "ExitNumber": [],
                                "GeometryOffset": 182,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 2836,
                                "Duration": 224,
                                "ExitNumber": [],
                                "GeometryOffset": 222,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 339,
                                "Duration": 30,
                                "ExitNumber": [],
                                "GeometryOffset": 326,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 64,
                                "Duration": 23,
                                "ExitNumber": [],
                                "GeometryOffset": 335,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 0,
                                "Duration": 0,
                                "ExitNumber": [],
                                "GeometryOffset": 337,
                                "Type": "Arrive"
                            }
                        ],
                        "TruckRoadTypes": [],
                        "Zones": []
                    }
                }
            ],
            "MajorRoadLabels": [
                {
                    "RouteNumber": {
                        "Language": "en",
                        "Value": "HWY-1A"
                    }
                },
                {
                    "RoadName": {
                        "Language": "en",
                        "Value": "Nanaimo St"
                    }
                }
            ]
        }
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/routes?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "Origin": [
    -123.116655,
    49.281538
  ],
  "Destination": [
    -123.01791785749363,
    49.22782762759908
  ],
  "TravelMode": "Car",
  "Avoid": {
    "Areas": [
      {
        "Geometry": {
          "polygon": [
            [
              [
                -123.06953,
                49.256419
              ],
              [
                -123.080486,
                49.242115
              ],
              [
                -123.058573,
                49.242115
              ],
              [
                -123.06953,
                49.256419
              ]
            ]
          ]
        }
      }
    ]
  }
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-routes --key ${YourKey} \
--origin -123.13277 49.281538 \
--destination -123.01791785749363 49.22782762759908 \
--travel-mode "Car" \
--avoid '{"Areas":[{"Geometry":{"Polygon":[[[-123.06953,49.256419],[-123.05167,49.242115],[-123.02381,49.242115],[-123.06953,49.256419]]]}}]}'
```

------

### Use CalculateRoutes con PolylinePolygon para crear rutas personalizadas.
<a name="calculate-routes-custom-avoidance-poly-polyline"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        -123.116655,
        49.281538
    ],
    "Destination": [
        -123.01791785749363,
        49.22782762759908
    ],
    "TravelMode": "Car",
    "Avoid": {
        "Areas": [
            {
                "Geometry": {
                    "PolylinePolygon": [
                        "BF0s0sJxglvXr5CvkCAgpEs5CvkC"
                    ]
                }
            }
        ]
    }
}
```

------
#### [ Sample response ]

```
{
    "LegGeometryFormat": "FlexiblePolyline",
    "Notices": [],
    "Routes": [
        {
            "Legs": [
                {
                    "Geometry": {
                        "Polyline": "Redacted"
                    },
                    "TravelMode": "Car",
                    "Type": "Vehicle",
                    "VehicleLegDetails": {
                        "AfterTravelSteps": [],
                        "Arrival": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    -123.0179179,
                                    49.2278276
                                ],
                                "Position": [
                                    -123.0229001,
                                    49.22883
                                ]
                            }
                        },
                        "Departure": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    -123.116655,
                                    49.281538
                                ],
                                "Position": [
                                    -123.1166332,
                                    49.2815528
                                ]
                            }
                        },
                        "Incidents": [],
                        "Notices": [],
                        "PassThroughWaypoints": [],
                        "Spans": [],
                        "Tolls": [],
                        "TollSystems": [],
                        "TravelSteps": [
                            {
                                "Distance": 1144,
                                "Duration": 85,
                                "ExitNumber": [],
                                "GeometryOffset": 0,
                                "Type": "Depart"
                            },
                            {
                                "Distance": 262,
                                "Duration": 24,
                                "ExitNumber": [],
                                "GeometryOffset": 35,
                                "RampStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "Ramp"
                            },
                            {
                                "Distance": 433,
                                "Duration": 47,
                                "ExitNumber": [],
                                "GeometryOffset": 40,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 1131,
                                "Duration": 81,
                                "ExitNumber": [],
                                "GeometryOffset": 54,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 54,
                                "Duration": 4,
                                "ExitNumber": [],
                                "GeometryOffset": 79,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 520,
                                "Duration": 39,
                                "ExitNumber": [],
                                "GeometryOffset": 83,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 1123,
                                "Duration": 111,
                                "ExitNumber": [],
                                "GeometryOffset": 101,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 1131,
                                "Duration": 81,
                                "ExitNumber": [],
                                "GeometryOffset": 141,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 448,
                                "Duration": 34,
                                "ExitNumber": [],
                                "GeometryOffset": 167,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 1797,
                                "Duration": 151,
                                "ExitNumber": [],
                                "GeometryOffset": 182,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 2836,
                                "Duration": 224,
                                "ExitNumber": [],
                                "GeometryOffset": 222,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 339,
                                "Duration": 30,
                                "ExitNumber": [],
                                "GeometryOffset": 326,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 64,
                                "Duration": 23,
                                "ExitNumber": [],
                                "GeometryOffset": 335,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 0,
                                "Duration": 0,
                                "ExitNumber": [],
                                "GeometryOffset": 337,
                                "Type": "Arrive"
                            }
                        ],
                        "TruckRoadTypes": [],
                        "Zones": []
                    }
                }
            ],
            "MajorRoadLabels": [
                {
                    "RouteNumber": {
                        "Language": "en",
                        "Value": "HWY-1A"
                    }
                },
                {
                    "RoadName": {
                        "Language": "en",
                        "Value": "Nanaimo St"
                    }
                }
            ]
        }
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/routes?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "Origin": [
    -123.116655,
    49.281538
  ],
  "Destination": [
    -123.01791785749363,
    49.22782762759908
  ],
  "TravelMode": "Car",
  "Avoid": {
    "Areas": [
      {
        "Geometry": {
          "PolylinePolygon": [
            "BF0s0sJxglvXr5CvkCAgpEs5CvkC"
          ]
        }
      }
    ]
  }
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-routes --key ${YourKey} \
--origin -123.13277 49.281538 \
--destination -123.01791785749363 49.22782762759908 \
--travel-mode "Car" \
--avoid '{"Areas":[{"Geometry":{"PolylinePolygon":["BF0s0sJxglvXr5CvkCAgpEs5CvkC"]}}]}'
```

------

### Use CalculateRoutes con un pasillo de evasión para crear rutas personalizadas.
<a name="calculate-routes-custom-avoidance-corridor"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        -123.116655,
        49.281538
    ],
    "Destination": [
        -123.01791785749363,
        49.22782762759908
    ],
    "TravelMode": "Car",
    "Avoid": {
        "Areas": [
            {
                "Geometry": {
                    "PolylineCorridor": {
                        "Polyline": "Redacted",
                        "Radius": 10
                    }
                }
            }
        ]
    }
}
```

------
#### [ Sample response ]

```
{
    "LegGeometryFormat": "FlexiblePolyline",
    "Notices": [],
    "Routes": [
        {
            "Legs": [
                {
                    "Geometry": {
                        "Polyline": "Redacted"
                    },
                    "TravelMode": "Car",
                    "Type": "Vehicle",
                    "VehicleLegDetails": {
                        "AfterTravelSteps": [],
                        "Arrival": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    -123.0179179,
                                    49.2278276
                                ],
                                "Position": [
                                    -123.0229001,
                                    49.22883
                                ]
                            }
                        },
                        "Departure": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    -123.116655,
                                    49.281538
                                ],
                                "Position": [
                                    -123.1166332,
                                    49.2815528
                                ]
                            }
                        },
                        "Incidents": [],
                        "Notices": [],
                        "PassThroughWaypoints": [],
                        "Spans": [],
                        "Tolls": [],
                        "TollSystems": [],
                        "TravelSteps": [
                            {
                                "Distance": 1144,
                                "Duration": 85,
                                "ExitNumber": [],
                                "GeometryOffset": 0,
                                "Type": "Depart"
                            },
                            {
                                "Distance": 262,
                                "Duration": 24,
                                "ExitNumber": [],
                                "GeometryOffset": 35,
                                "RampStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "Ramp"
                            },
                            {
                                "Distance": 1356,
                                "Duration": 134,
                                "ExitNumber": [],
                                "GeometryOffset": 40,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 2468,
                                "Duration": 204,
                                "ExitNumber": [],
                                "GeometryOffset": 90,
                                "KeepStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left"
                                },
                                "Type": "Keep"
                            },
                            {
                                "Distance": 1100,
                                "Duration": 88,
                                "ExitNumber": [],
                                "GeometryOffset": 170,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 1588,
                                "Duration": 133,
                                "ExitNumber": [],
                                "GeometryOffset": 214,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 47,
                                "Duration": 14,
                                "ExitNumber": [],
                                "GeometryOffset": 260,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 2478,
                                "Duration": 196,
                                "ExitNumber": [],
                                "GeometryOffset": 265,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 339,
                                "Duration": 30,
                                "ExitNumber": [],
                                "GeometryOffset": 357,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 64,
                                "Duration": 23,
                                "ExitNumber": [],
                                "GeometryOffset": 366,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 0,
                                "Duration": 0,
                                "ExitNumber": [],
                                "GeometryOffset": 368,
                                "Type": "Arrive"
                            }
                        ],
                        "TruckRoadTypes": [],
                        "Zones": []
                    }
                }
            ],
            "MajorRoadLabels": [
                {
                    "RouteNumber": {
                        "Language": "en",
                        "Value": "HWY-1A"
                    }
                }
            ]
        }
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/routes?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "Origin": [
    -123.116655,
    49.281538
  ],
  "Destination": [
    -123.01791785749363,
    49.22782762759908
  ],
  "TravelMode": "Car",
  "Avoid": {
    "Areas": [
      {
        "Geometry": {
          "PolylineCorridor": {
            "Polyline": "Redacted",
            "Radius": 10
          }
        }
      }
    ]
  }
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-routes --key ${YourKey} \
--origin -123.116655 49.281538 \
--destination -123.01791785749363 49.22782762759908 \
--travel-mode "Car" \
--avoid '{"Areas": [{"Geometry": {"PolylineCorridor": {"Polyline": "BF2mysJnmkvX5ekiC", "Radius": 10}}}]}'
```

------

### Use CalculateRoutes con un PolylineCorridor de evasión para crear rutas personalizadas.
<a name="calculate-routes-custom-avoidance-polyline-corridor"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        -123.116655,
        49.281538
    ],
    "Destination": [
        -123.01791785749363,
        49.22782762759908
    ],
    "TravelMode": "Car",
    "Avoid": {
        "Areas": [
            {
                "Geometry": {
                    "Corridor": {
                        "LineString": [
                            [
                                -123.06532243038754,
                                49.245226301868776
                            ],
                            [
                                -123.0547357660333,
                                49.24030469850804
                            ]
                        ],
                        "Radius": 10
                    }
                }
            }
        ]
    }
}
```

------
#### [ Sample response ]

```
{
    "LegGeometryFormat": "FlexiblePolyline",
    "Notices": [],
    "Routes": [
        {
            "Legs": [
                {
                    "Geometry": {
                        "Polyline": "Redacted"
                    },
                    "TravelMode": "Car",
                    "Type": "Vehicle",
                    "VehicleLegDetails": {
                        "AfterTravelSteps": [],
                        "Arrival": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    -123.0179179,
                                    49.2278276
                                ],
                                "Position": [
                                    -123.0229001,
                                    49.22883
                                ]
                            }
                        },
                        "Departure": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    -123.116655,
                                    49.281538
                                ],
                                "Position": [
                                    -123.1166332,
                                    49.2815528
                                ]
                            }
                        },
                        "Incidents": [],
                        "Notices": [],
                        "PassThroughWaypoints": [],
                        "Spans": [],
                        "Tolls": [],
                        "TollSystems": [],
                        "TravelSteps": [
                            {
                                "Distance": 1144,
                                "Duration": 85,
                                "ExitNumber": [],
                                "GeometryOffset": 0,
                                "Type": "Depart"
                            },
                            {
                                "Distance": 262,
                                "Duration": 24,
                                "ExitNumber": [],
                                "GeometryOffset": 35,
                                "RampStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "Ramp"
                            },
                            {
                                "Distance": 1356,
                                "Duration": 134,
                                "ExitNumber": [],
                                "GeometryOffset": 40,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 2468,
                                "Duration": 204,
                                "ExitNumber": [],
                                "GeometryOffset": 90,
                                "KeepStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left"
                                },
                                "Type": "Keep"
                            },
                            {
                                "Distance": 1100,
                                "Duration": 88,
                                "ExitNumber": [],
                                "GeometryOffset": 170,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 1588,
                                "Duration": 133,
                                "ExitNumber": [],
                                "GeometryOffset": 214,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 47,
                                "Duration": 14,
                                "ExitNumber": [],
                                "GeometryOffset": 260,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 2478,
                                "Duration": 196,
                                "ExitNumber": [],
                                "GeometryOffset": 265,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 339,
                                "Duration": 30,
                                "ExitNumber": [],
                                "GeometryOffset": 357,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 64,
                                "Duration": 23,
                                "ExitNumber": [],
                                "GeometryOffset": 366,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 0,
                                "Duration": 0,
                                "ExitNumber": [],
                                "GeometryOffset": 368,
                                "Type": "Arrive"
                            }
                        ],
                        "TruckRoadTypes": [],
                        "Zones": []
                    }
                }
            ],
            "MajorRoadLabels": [
                {
                    "RouteNumber": {
                        "Language": "en",
                        "Value": "HWY-1A"
                    }
                }
            ]
        }
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/routes?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "Origin": [
    -123.116655,
    49.281538
  ],
  "Destination": [
    -123.01791785749363,
    49.22782762759908
  ],
  "TravelMode": "Car",
  "Avoid": {
    "Areas": [
      {
        "Geometry": {
          "Corridor": {
            "LineString": [
              [
                -123.06532243038754,
                49.245226301868776
              ],
              [
                -123.0547357660333,
                49.24030469850804
              ]
            ],
            "Radius": 10
          }
        }
      }
    ]
  }
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-routes --key ${YourKey} \
--origin -123.13277 49.281538 \
--destination -123.01791785749363 49.22782762759908 \
--travel-mode "Car" \
--avoid '{"Areas":[{"Geometry":{"Corridor":{"LineString":[[-123.06532243038754,49.245226301868776],[-123.0547357660333,49.24030469850804]],"Radius":10}}}]}'
```

------

# Cómo crear rutas con evasión personalizada de varios elementos potenciales
<a name="calculate-routes-custom-avoidance-multiple"></a>

La API de CalculateRoutes le ayuda a encontrar las mejores rutas entre el origen y el destino, así como las mejores oportunidades para que los conductores descansen. Admite modos de viaje como coche, camión, peatón y moto. También admite hasta 25 puntos de referencia (escalas), incluidos el origen y el destino, con solo algunas restricciones.

## Casos de uso potenciales
<a name="potential-use-cases"></a>
+ **Calcule las rutas con evasión personalizada:** personalice las rutas con evasión para planificar mejor las rutas y los viajes diarios.

## Ejemplos
<a name="calculate-routes-examples"></a>

### Use CalculateRoutes con evasión de peajes, cambios de sentido, transbordadores, autopistas, túneles, etc.
<a name="calculate-routes-custom-avoidance-tolls-ferries"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        -123.118105,
        49.282423
    ],
    "Destination": [
        -123.020098,
        49.232872
    ],
    "TravelMode": "Car",
    "Avoid": {
        "TollRoads": true,
        "UTurns": true,
        "Ferries": true,
        "ControlledAccessHighways": true,
        "Tunnels": true
    }
}
```

------
#### [ Sample response ]

```
{
    "LegGeometryFormat": "FlexiblePolyline",
    "Notices": [],
    "Routes": [
        {
            "Legs": [
                {
                    "Geometry": {
                        "Polyline": "Redacted"
                    },
                    "TravelMode": "Car",
                    "Type": "Vehicle",
                    "VehicleLegDetails": {
                        "AfterTravelSteps": [],
                        "Arrival": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    -123.020098,
                                    49.232872
                                ],
                                "Position": [
                                    -123.0203051,
                                    49.2328499
                                ]
                            }
                        },
                        "Departure": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    -123.1181051,
                                    49.282423
                                ],
                                "Position": [
                                    -123.1180883,
                                    49.2824349
                                ]
                            }
                        },
                        "Incidents": [],
                        "Notices": [],
                        "PassThroughWaypoints": [],
                        "Spans": [],
                        "Tolls": [],
                        "TollSystems": [],
                        "TravelSteps": [
                            {
                                "Distance": 1288,
                                "Duration": 102,
                                "ExitNumber": [],
                                "GeometryOffset": 0,
                                "Type": "Depart"
                            },
                            {
                                "Distance": 262,
                                "Duration": 24,
                                "ExitNumber": [],
                                "GeometryOffset": 37,
                                "RampStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "Ramp"
                            },
                            {
                                "Distance": 1356,
                                "Duration": 134,
                                "ExitNumber": [],
                                "GeometryOffset": 42,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 7092,
                                "Duration": 568,
                                "ExitNumber": [],
                                "GeometryOffset": 92,
                                "KeepStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left"
                                },
                                "Type": "Keep"
                            },
                            {
                                "Distance": 65,
                                "Duration": 26,
                                "ExitNumber": [],
                                "GeometryOffset": 337,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 50,
                                "Duration": 18,
                                "ExitNumber": [],
                                "GeometryOffset": 339,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 0,
                                "Duration": 0,
                                "ExitNumber": [],
                                "GeometryOffset": 343,
                                "Type": "Arrive"
                            }
                        ],
                        "TruckRoadTypes": [],
                        "Zones": []
                    }
                }
            ],
            "MajorRoadLabels": [
                {
                    "RouteNumber": {
                        "Language": "en",
                        "Value": "HWY-1A"
                    }
                }
            ]
        }
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/routes?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "Origin": [
    -123.118105,
    49.282423
  ],
  "Destination": [
    -123.020098,
    49.232872
  ],
  "TravelMode": "Car",
  "Avoid": {
    "TollRoads": true,
    "UTurns": true,
    "Ferries": true,
    "ControlledAccessHighways": true,
    "Tunnels": true
  }
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-routes --key ${YourKey} \
--origin -123.118105 49.282423 \
--destination -123.020098 49.232872 \
--travel-mode "Car" \
--avoid '{"TollRoads": true, "UTurns": true, "Ferries": true, "ControlledAccessHighways": true, "Tunnels": true}'
```

------

# Cómo encontrar la ruta más rápida
<a name="calculate-routes-custom-avoidance-fast"></a>

La API de CalculateRoutes le ayuda a encontrar las rutas más rápidas entre el origen y el destino.

## Casos de uso potenciales
<a name="calculate-routes-fast-potential-use"></a>
+ **Optimice las rutas para ahorrar tiempo:** mejore las operaciones de entrega calculando la ruta más rápida. Esto es útil para reducir el tiempo de viaje en los servicios de logística y entrega.

## Ejemplos
<a name="calculate-routes-fast-examples"></a>

### Cálculo de la ruta más rápida
<a name="calculate-routes-fast-car"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        -123.118105,
        49.282423
    ],
    "Destination": [
        -123.020098,
        49.232872
    ],
    "TravelMode": "Car",
    "OptimizeRoutingFor": "FastestRoute"
}
```

------
#### [ Sample response ]

```
{
    "LegGeometryFormat": "FlexiblePolyline",
    "Notices": [],
    "Routes": [
        {
            "Legs": [
                {
                    "Geometry": {
                        "Polyline": "Redacted"
                    },
                    "TravelMode": "Car",
                    "Type": "Vehicle",
                    "VehicleLegDetails": {
                        "AfterTravelSteps": [],
                        "Arrival": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    -123.020098,
                                    49.232872
                                ],
                                "Position": [
                                    -123.0203051,
                                    49.2328499
                                ]
                            }
                        },
                        "Departure": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    -123.1181051,
                                    49.282423
                                ],
                                "Position": [
                                    -123.1180883,
                                    49.2824349
                                ]
                            }
                        },
                        "Incidents": [],
                        "Notices": [],
                        "PassThroughWaypoints": [],
                        "Spans": [],
                        "Tolls": [],
                        "TollSystems": [],
                        "TravelSteps": [
                            {
                                "Distance": 1288,
                                "Duration": 102,
                                "ExitNumber": [],
                                "GeometryOffset": 0,
                                "Type": "Depart"
                            },
                            {
                                "Distance": 262,
                                "Duration": 24,
                                "ExitNumber": [],
                                "GeometryOffset": 37,
                                "RampStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "Ramp"
                            },
                            {
                                "Distance": 1356,
                                "Duration": 134,
                                "ExitNumber": [],
                                "GeometryOffset": 42,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 7092,
                                "Duration": 568,
                                "ExitNumber": [],
                                "GeometryOffset": 92,
                                "KeepStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left"
                                },
                                "Type": "Keep"
                            },
                            {
                                "Distance": 65,
                                "Duration": 26,
                                "ExitNumber": [],
                                "GeometryOffset": 337,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 50,
                                "Duration": 18,
                                "ExitNumber": [],
                                "GeometryOffset": 339,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 0,
                                "Duration": 0,
                                "ExitNumber": [],
                                "GeometryOffset": 343,
                                "Type": "Arrive"
                            }
                        ],
                        "TruckRoadTypes": [],
                        "Zones": []
                    }
                }
            ],
            "MajorRoadLabels": [
                {
                    "RouteNumber": {
                        "Language": "en",
                        "Value": "HWY-1A"
                    }
                }
            ]
        }
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/routes?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "Origin": [
    -123.118105,
    49.282423
  ],
  "Destination": [
    -123.020098,
    49.232872
  ],
  "TravelMode": "Car",
  "OptimizeRoutingFor": "FastestRoute"
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-routes --key ${YourKey} \
--origin -123.118105 49.282423 \
--destination -123.020098 49.232872 \
--travel-mode "Car" \
--optimize-routing-for "FastestRoute"
```

------

# Cómo encontrar las rutas más cortas
<a name="calculate-routes-custom-avoidance-shortest"></a>

La API de CalculateRoutes lo ayuda a encontrar las rutas más cortas entre el origen y el destino.

## Casos de uso potenciales
<a name="calculate-routes-short-potential-use"></a>
+ **Optimice las rutas para ahorrar tiempo:** mejore las operaciones de entrega calculando la ruta más corta. Esto es útil para reducir la distancia de viaje en los servicios de logística y entrega.

## Ejemplos
<a name="calculate-routes-short-examples"></a>

### Utilice CalculateRoutes para encontrar la ruta más corta y ahorrar en la distancia de viaje.
<a name="calculate-routes-shortest"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        -123.118105,
        49.282423
    ],
    "Destination": [
        -123.020098,
        49.232872
    ],
    "TravelMode": "Car",
    "OptimizeRoutingFor": "ShortestRoute"
}
```

------
#### [ Sample response ]

```
{
    "LegGeometryFormat": "FlexiblePolyline",
    "Notices": [],
    "Routes": [
        {
            "Legs": [
                {
                    "Geometry": {
                        "Polyline": "Redacted"
                    },
                    "TravelMode": "Car",
                    "Type": "Vehicle",
                    "VehicleLegDetails": {
                        "AfterTravelSteps": [],
                        "Arrival": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    -123.020098,
                                    49.232872
                                ],
                                "Position": [
                                    -123.0203051,
                                    49.2328499
                                ]
                            }
                        },
                        "Departure": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    -123.1181051,
                                    49.282423
                                ],
                                "Position": [
                                    -123.1180883,
                                    49.2824349
                                ]
                            }
                        },
                        "Incidents": [],
                        "Notices": [],
                        "PassThroughWaypoints": [],
                        "Spans": [],
                        "Tolls": [],
                        "TollSystems": [],
                        "TravelSteps": [
                            {
                                "Distance": 1288,
                                "Duration": 102,
                                "ExitNumber": [],
                                "GeometryOffset": 0,
                                "Type": "Depart"
                            },
                            {
                                "Distance": 262,
                                "Duration": 24,
                                "ExitNumber": [],
                                "GeometryOffset": 37,
                                "RampStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "Ramp"
                            },
                            {
                                "Distance": 1356,
                                "Duration": 134,
                                "ExitNumber": [],
                                "GeometryOffset": 42,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 7092,
                                "Duration": 568,
                                "ExitNumber": [],
                                "GeometryOffset": 92,
                                "KeepStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left"
                                },
                                "Type": "Keep"
                            },
                            {
                                "Distance": 65,
                                "Duration": 26,
                                "ExitNumber": [],
                                "GeometryOffset": 337,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 50,
                                "Duration": 18,
                                "ExitNumber": [],
                                "GeometryOffset": 339,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 0,
                                "Duration": 0,
                                "ExitNumber": [],
                                "GeometryOffset": 343,
                                "Type": "Arrive"
                            }
                        ],
                        "TruckRoadTypes": [],
                        "Zones": []
                    }
                }
            ],
            "MajorRoadLabels": [
                {
                    "RouteNumber": {
                        "Language": "en",
                        "Value": "HWY-1A"
                    }
                }
            ]
        }
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/routes?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "Origin": [
        -123.118105,
        49.282423
    ],
    "Destination": [
        -123.020098,
        49.232872
    ],
    "TravelMode": "Car",
    "OptimizeRoutingFor": "ShortestRoute"
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-routes --key ${YourKey} \
--origin -123.118105 49.282423 \
--destination -123.020098 49.232872 \
--travel-mode "Scooter" \
--optimize-routing-for "ShortestRoute"
```

------

# Obtención de información sobre cómo usar CalculateIsolines
<a name="calculate-isolines-how-to"></a>

En esta sección, aprende como usar `CalculateIsolines` con rangos de tiempo o distancia, así como a establecer las áreas que debe evitar.

**Topics**
+ [Cómo calcular un área de servicio en función de los rangos de tiempo](calculate-service-area-based-on-time.md)
+ [Cómo calcular un área de servicio en función de los rangos de distancia](calculate-service-area-based-on-distance.md)
+ [Cómo calcular un área de servicio en función de la evasión](calculate-service-area-based-on-avoidance.md)

# Cómo calcular un área de servicio en función de los rangos de tiempo
<a name="calculate-service-area-based-on-time"></a>

La API de CalculateIsolines lo permite determinar las áreas de servicio accesibles dentro de rangos de tiempo o distancia específicos, teniendo en cuenta las redes de carreteras y las condiciones del tráfico. Esta capacidad permite a las aplicaciones definir las áreas de servicio para restaurantes, supermercados u otros proveedores de servicios, lo que puede ayudar a planificar la eficiencia del combustible y definir las áreas accesibles para la cobertura del servicio.

## Casos de uso potenciales
<a name="calculate-service-area-time-potential-use"></a>
+ **Planifique las áreas de servicio:** use esta API para planificar áreas accesibles para servicios como restaurantes o supermercados en función del tiempo o la distancia de viaje.

## Ejemplos
<a name="calculate-service-area-time-examples"></a>

### Cálculo de un área de servicio en función de un intervalo de tiempo con el coche como TravelMode
<a name="calculate-service-area-time"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        -123.11679620827039,
        49.28147612192166
    ],
    "DepartureTime": "2024-10-28T21:27:56Z",
    "Thresholds": {
        "Time": [
            500,
            1000,
            1500
        ]
    },
    "TravelMode": "Car"
}
```

------
#### [ Sample response ]

```
{
    "DepartureTime": "2024-10-28T14:27:56-07:00",
    "IsolineGeometryFormat": "FlexiblePolyline",
    "Isolines": [
        {
            "Connections": [],
            "Geometries": [
                {
                    "PolylinePolygon": [
                        "Redacted"
                    ]
                }
            ],
            "TimeThreshold": 500
        },
        {
            "Connections": [],
            "Geometries": [
                {
                    "PolylinePolygon": [
                        "Redacted"
                    ]
                }
            ],
            "TimeThreshold": 1000
        },
        {
            "Connections": [],
            "Geometries": [
                {
                    "PolylinePolygon": [
                        "Redacted"
                    ]
                }
            ],
            "TimeThreshold": 1500
        }
    ],
    "SnappedOrigin": [
        -123.11687,
        49.2813999
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/isolines?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "Origin": [
        -123.11679620827039,
        49.28147612192166
    ],
    "DepartureTime": "2024-10-28T21:27:56Z",
    "Thresholds": {
        "Time": [
            500,
            1000,
            1500
        ]
    },
    "TravelMode": "Car"
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-isolines --key ${YourKey} \
--origin -123.11679620827039 49.28147612192166 \
--departure-time "2024-10-28T21:27:56Z" \
--thresholds '{"Time": [500, 1000, 1500]}' \
--travel-mode "Car"
```

------

# Cómo calcular un área de servicio en función de los rangos de distancia
<a name="calculate-service-area-based-on-distance"></a>

La API de CalculateIsolines lo permite determinar las áreas de servicio accesibles dentro de rangos de tiempo o distancia específicos, teniendo en cuenta las redes de carreteras y las condiciones del tráfico. Esta capacidad permite a las aplicaciones definir las áreas de servicio para restaurantes, supermercados u otros proveedores de servicios, lo que puede ayudar a planificar la eficiencia del combustible y definir las áreas accesibles para la cobertura del servicio.

## Casos de uso potenciales
<a name="calculate-service-area-distance-potential-use"></a>
+ **Planifique las áreas de servicio:** use esta API para planificar áreas accesibles para servicios como restaurantes o supermercados en función del tiempo o la distancia de viaje.

## Ejemplos
<a name="calculate-service-area-distance-examples"></a>

### Cálculo de un área de servicio en función de los rangos de distancia con el coche como TravelMode
<a name="calculate-service-area-distance"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        -123.11679620827039,
        49.28147612192166
    ],
    "DepartureTime": "2024-10-28T21:27:56Z",
    "Thresholds": {
        "Distance": [
            1000,
            2000,
            3000
        ]
    },
    "TravelMode": "Car"
}
```

------
#### [ Sample response ]

```
{
    "DepartureTime": "2024-10-28T14:27:56-07:00",
    "IsolineGeometryFormat": "FlexiblePolyline",
    "Isolines": [
        {
            "Connections": [],
            "DistanceThreshold": 1000,
            "Geometries": [
                {
                    "PolylinePolygon": [
                        "Redacted"
                    ]
                }
            ]
        },
        {
            "Connections": [],
            "DistanceThreshold": 2000,
            "Geometries": [
                {
                    "PolylinePolygon": [
                        "Redacted"
                    ]
                }
            ]
        },
        {
            "Connections": [],
            "DistanceThreshold": 3000,
            "Geometries": [
                {
                    "PolylinePolygon": [
                        "Redacted"
                    ]
                }
            ]
        }
    ],
    "SnappedOrigin": [
        -123.11687,
        49.2813999
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/isolines?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "Origin": [
        -123.11679620827039,
        49.28147612192166
    ],
    "DepartureTime": "2024-10-28T21:27:56Z",
    "Thresholds": {
        "Distance": [
            1000,
            2000,
            3000
        ]
    },
    "TravelMode": "Car"
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-isolines --key ${YourKey} \
--origin -123.11679620827039 49.28147612192166 \
--departure-time "2024-10-28T21:27:56Z" \
--thresholds '{"Distance": [1000, 2000, 3000]}' \
--travel-mode "Car"
```

------

# Cómo calcular un área de servicio en función de la evasión
<a name="calculate-service-area-based-on-avoidance"></a>

La API de CalculateIsolines lo permite determinar las áreas de servicio accesibles dentro de rangos de tiempo o distancia específicos, teniendo en cuenta las redes de carreteras y las condiciones del tráfico que se deben evitar. Esta capacidad permite a las aplicaciones definir las áreas de servicio para restaurantes, supermercados u otros proveedores de servicios, lo que puede ayudar a planificar la eficiencia del combustible y definir las áreas accesibles para la cobertura del servicio.

## Casos de uso potenciales
<a name="calculate-service-area-avoidance-potential-use"></a>
+ **Planifique las áreas de servicio:** use esta API para planificar áreas accesibles para servicios como restaurantes o entrega de comestibles en función de la evasión.

## Ejemplos
<a name="calculate-service-area-avoidance-examples"></a>

### Cálculo de un área de servicio en función de la evasión con el coche como TravelMode
<a name="calculate-service-area-avoidance-car"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        -123.11679620827039,
        49.28147612192166
    ],
    "DepartureTime": "2024-10-28T21:27:56Z",
    "Thresholds": {
        "Distance": [
            4000
        ]
    },
    "Avoid": {
        "TollRoads": true,
        "UTurns": true,
        "ControlledAccessHighways": true,
        "Ferries": true,
        "DirtRoads": true,
        "SeasonalClosure": true,
        "CarShuttleTrains": true,
        "TollTransponders": true,
        "ZoneCategories": [
            {
                "Category": "Environmental"
            }
        ]
    },
    "TravelMode": "Car"
}
```

------
#### [ Sample response ]

```
{
    "DepartureTime": "2024-10-28T14:27:56-07:00",
    "IsolineGeometryFormat": "FlexiblePolyline",
    "Isolines": [
        {
            "Connections": [],
            "DistanceThreshold": 4000,
            "Geometries": [
                {
                    "PolylinePolygon": [
                        "Redacted"
                    ]
                }
            ]
        }
    ],
    "SnappedOrigin": [
        -123.11687,
        49.2813999
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/isolines?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "Origin": [
        -123.11679620827039,
        49.28147612192166
    ],
    "DepartureTime": "2024-10-28T21:27:56Z",
    "Thresholds": {
        "Distance": [
            4000
        ]
    },
    "Avoid": {
        "TollRoads": true,
        "UTurns": true,
        "ControlledAccessHighways": true,
        "Ferries": true,
        "DirtRoads": true,
        "SeasonalClosure": true,
        "CarShuttleTrains": true,
        "TollTransponders": true,
        "ZoneCategories": [
            {
                "Category": "Environmental"
            }
        ]
    },
    "TravelMode": "Car"
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-isolines --key ${YourKey} \
--origin -123.11679620827039 49.28147612192166 \
--departure-time "2024-10-28T21:27:56Z" \
--thresholds '{"Distance": [4000]}' \
--avoid '{"TollRoads": true, "UTurns": true, "ControlledAccessHighways": true, "Ferries": true, "DirtRoads": true, "SeasonalClosure": true, "CarShuttleTrains": true, "TollTransponders": true, "ZoneCategories": [{"Category": "Environmental"}]}' \
--travel-mode "Car"
```

------

### Cálculo de un área de servicio en función de la evasión con el camión como modo de viaje
<a name="calculate-service-area-avoidance-truck"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        -123.11679620827039,
        49.28147612192166
    ],
    "DepartureTime": "2024-10-28T21:27:56Z",
    "Thresholds": {
        "Distance": [
            4000
        ]
    },
    "Avoid": {
        "TollRoads": true,
        "UTurns": true,
        "ControlledAccessHighways": true,
        "Ferries": true,
        "DirtRoads": true,
        "SeasonalClosure": true,
        "CarShuttleTrains": true,
        "TollTransponders": true,
        "ZoneCategories": [
            {
                "Category": "Environmental"
            }
        ]
    },
    "TravelMode": "Truck"
}
```

------
#### [ Sample response ]

```
{
    "DepartureTime": "2024-10-28T14:27:56-07:00",
    "IsolineGeometryFormat": "FlexiblePolyline",
    "Isolines": [
        {
            "Connections": [],
            "DistanceThreshold": 4000,
            "Geometries": [
                {
                    "PolylinePolygon": [
                        "Redacted"
                    ]
                }
            ]
        }
    ],
    "SnappedOrigin": [
        -123.11687,
        49.2813999
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/isolines?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "Origin": [
        -123.11679620827039,
        49.28147612192166
    ],
    "DepartureTime": "2024-10-28T21:27:56Z",
    "Thresholds": {
        "Distance": [
            4000
        ]
    },
    "Avoid": {
        "TollRoads": true,
        "UTurns": true,
        "ControlledAccessHighways": true,
        "Ferries": true,
        "DirtRoads": true,
        "SeasonalClosure": true,
        "CarShuttleTrains": true,
        "TollTransponders": true,
        "ZoneCategories": [
            {
                "Category": "Environmental"
            }
        ]
    },
    "TravelMode": "Truck"
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-isolines --key ${YourKey} \
--origin -123.11679620827039 49.28147612192166 \
--departure-time "2024-10-28T21:27:56Z" \
--thresholds '{"Distance": [4000]}' \
--avoid '{"TollRoads": true, "UTurns": true, "ControlledAccessHighways": true, "Ferries": true, "DirtRoads": true, "SeasonalClosure": true, "CarShuttleTrains": true, "TollTransponders": true, "ZoneCategories": [{"Category": "Environmental"}]}' \
--travel-mode "Truck"
```

------

### Cálculo de un área de servicio en función de la evasión para los peatones
<a name="calculate-service-area-avoidance-truck"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        -123.11679620827039,
        49.28147612192166
    ],
    "DepartureTime": "2024-10-28T21:27:56Z",
    "Thresholds": {
        "Distance": [
            4000
        ]
    },
    "Avoid": {
        "TollRoads": true,
        "ControlledAccessHighways": true,
        "Ferries": true,
        "DirtRoads": true,
        "SeasonalClosure": true,
        "CarShuttleTrains": true,
        "TollTransponders": true,
        "ZoneCategories": [
            {
                "Category": "Environmental"
            }
        ]
    },
    "TravelMode": "Pedestrian"
}
```

------
#### [ Sample response ]

```
{
    "DepartureTime": "2024-10-28T14:27:56-07:00",
    "IsolineGeometryFormat": "FlexiblePolyline",
    "Isolines": [
        {
            "Connections": [],
            "DistanceThreshold": 4000,
            "Geometries": [
                {
                    "PolylinePolygon": [
                        "Redacted"
                    ]
                }
            ]
        }
    ],
    "SnappedOrigin": [
        -123.11687,
        49.2813999
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/isolines?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "Origin": [
        -123.11679620827039,
        49.28147612192166
    ],
    "DepartureTime": "2024-10-28T21:27:56Z",
    "Thresholds": {
        "Distance": [
            4000
        ]
    },
    "Avoid": {
        "TollRoads": true,
        "ControlledAccessHighways": true,
        "Ferries": true,
        "DirtRoads": true,
        "SeasonalClosure": true,
        "CarShuttleTrains": true,
        "TollTransponders": true,
        "ZoneCategories": [
            {
                "Category": "Environmental"
            }
        ]
    },
    "TravelMode": "Pedestrian"
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-isolines --key ${YourKey} \
--origin -123.11679620827039 49.28147612192166 \
--departure-time "2024-10-28T21:27:56Z" \
--thresholds '{"Distance": [4000]}' \
--avoid '{"TollRoads": true, "ControlledAccessHighways": true, "Ferries": true, "DirtRoads": true, "SeasonalClosure": true, "CarShuttleTrains": true, "TollTransponders": true, "ZoneCategories": [{"Category": "Environmental"}]}' \
--travel-mode "Pedestrian"
```

------

### Cálculo de un área de servicio en función de la evasión con la moto como modo de viaje
<a name="calculate-service-area-avoidance-scooter"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        -123.11679620827039,
        49.28147612192166
    ],
    "DepartureTime": "2024-10-28T21:27:56Z",
    "Thresholds": {
        "Distance": [
            4000
        ]
    },
    "Avoid": {
        "TollRoads": true,
        "ControlledAccessHighways": true,
        "DifficultTurns": false,
        "Ferries": true,
        "DirtRoads": true,
        "SeasonalClosure": true,
        "CarShuttleTrains": true,
        "TollTransponders": true,
        "ZoneCategories": [
            {
                "Category": "Environmental"
            }
        ]
    },
    "TravelMode": "Scooter"
}
```

------
#### [ Sample response ]

```
{
    "DepartureTime": "2024-10-28T14:27:56-07:00",
    "IsolineGeometryFormat": "FlexiblePolyline",
    "Isolines": [
        {
            "Connections": [],
            "DistanceThreshold": 4000,
            "Geometries": [
                {
                    "PolylinePolygon": [
                        "Redacted"
                    ]
                }
            ]
        }
    ],
    "SnappedOrigin": [
        -123.11687,
        49.2813999
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/isolines?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "Origin": [
        -123.11679620827039,
        49.28147612192166
    ],
    "DepartureTime": "2024-10-28T21:27:56Z",
    "Thresholds": {
        "Distance": [
            4000
        ]
    },
    "Avoid": {
        "TollRoads": true,
        "ControlledAccessHighways": true,
        "Ferries": true,
        "DirtRoads": true,
        "SeasonalClosure": true,
        "CarShuttleTrains": true,
        "TollTransponders": true,
        "ZoneCategories": [
            {
                "Category": "Environmental"
            }
        ]
    },
    "TravelMode": "Scooter"
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-isolines --key ${YourKey} \
--origin -123.11679620827039 49.28147612192166 \
--departure-time "2024-10-28T21:27:56Z" \
--thresholds '{"Distance": [4000]}' \
--avoid '{"TollRoads": true, "ControlledAccessHighways": true, "Ferries": true, "DirtRoads": true, "SeasonalClosure": true, "CarShuttleTrains": true, "TollTransponders": true, "ZoneCategories": [{"Category": "Environmental"}]}' \
--travel-mode "Scooter"
```

------

# Obtención de información sobre cómo usar CalculateRouteMatrix
<a name="calculate-route-matrix-how-to"></a>

En esta sección, obtendrá información sobre cómo usar `CalculateRouteMatrix` para encontrar rutas eficientes para múltiples orígenes y destinos.

**Topics**
+ [Cómo calcular una matriz de ruta de distancia y tiempo para múltiples orígenes y destinos](calculate-route-matrix-distance.md)
+ [Cómo calcular la matriz de rutas con evasión](calculate-route-matrix-with-avoidance.md)

# Cómo calcular una matriz de ruta de distancia y tiempo para múltiples orígenes y destinos
<a name="calculate-route-matrix-distance"></a>

La CalculateRouteMatrix API calcula las rutas y proporciona el tiempo y la distancia de viaje para cada combinación de orígenes y destinos. Esta capacidad es útil para aplicaciones que requieren la planificación y optimización de rutas en varias ubicaciones.

La respuesta se incluye `Distance` en metros y `Duration` en segundos para cada par origen-destino.

## Casos de uso potenciales
<a name="calculate-route-matrix-potential-use"></a>
+ **Optimice la planificación de rutas:** utilice la matriz de rutas como entrada para el software de optimización de rutas a fin de mejorar la eficiencia del servicio y reducir el tiempo de viaje.

## Ejemplos
<a name="calculate-route-matrix-examples"></a>

### CalculateRouteMatrix con un límite de enrutamiento ilimitado
<a name="calculate-route-matrix-unbounded"></a>

------
#### [ Sample request ]

```
{
    "Origins": [
        {
            "Position": [-123.11679620827039, 49.28147612192166]
        },
        {
            "Position": [-123.11179620827039, 49.3014761219]
        }
    ],
    "Destinations": [
        {
            "Position": [-123.112317039, 49.28897192166]
        }
    ],
    "DepartureTime": "2024-05-28T21:27:56Z",
    "RoutingBoundary": {
        "Unbounded": true
    }
}
```

------
#### [ Sample response ]

```
{
    "ErrorCount": 0,
    "RouteMatrix": [
        [
            {
                "Distance": 1907,
                "Duration": 343
            }
        ],
        [
            {
                "Distance": 5629,
                "Duration": 954
            }
        ]
    ],
    "RoutingBoundary": {
        "Unbounded": true
    }
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/route-matrix?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "Origins": [
        {
            "Position": [-123.11679620827039, 49.28147612192166]
        },
        {
            "Position": [-123.11179620827039, 49.3014761219]
        }
    ],
    "Destinations": [
        {
            "Position": [-123.112317039, 49.28897192166]
        }
    ],
    "DepartureTime": "2024-05-28T21:27:56Z",
    "RoutingBoundary": {
        "Unbounded": true
    }
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-route-matrix --key ${YourKey} \
--origins '[{"Position": [-123.11679620827039, 49.28147612192166]}, {"Position": [-123.11179620827039, 49.3014761219]}]' \
--destinations '[{"Position": [-123.11179620827039, 49.28897192166]}]' \
--departure-time "2024-05-28T21:27:56Z" \
--routing-boundary '{"Unbounded": true}'
```

------

### CalculateRouteMatrix con un límite de enrutamiento basado en la geometría
<a name="calculate-route-matrix-geometry"></a>

------
#### [ Sample request ]

```
{
    "Origins": [
        {
            "Position": [-123.11679620827039, 49.28147612192166]
        },
        {
            "Position": [-123.11179620827039, 49.3014761219]
        }
    ],
    "Destinations": [
        {
            "Position": [-123.112317039, 49.28897192166]
        }
    ],
    "DepartureTime": "2024-05-28T21:27:56Z",
    "RoutingBoundary": {
        "Geometry": {
            "AutoCircle": {
                "Margin": 10000,
                "MaxRadius": 30000
            }
        }
    }
}
```

------
#### [ Sample response ]

```
{
    "ErrorCount": 0,
    "RouteMatrix": [
        [
            {
                "Distance": 1907,
                "Duration": 344
            }
        ],
        [
            {
                "Distance": 5629,
                "Duration": 950
            }
        ]
    ],
    "RoutingBoundary": {
        "Geometry": {
            "Circle": {
                "Center": [
                    -123.1142962082704,
                    49.29147612191083
                ],
                "Radius": 11127
            }
        },
        "Unbounded": false
    }
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/route-matrix?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "Origins": [
        {
            "Position": [-123.11679620827039, 49.28147612192166]
        },
        {
            "Position": [-123.11179620827039, 49.3014761219]
        }
    ],
    "Destinations": [
        {
            "Position": [-123.112317039, 49.28897192166]
        }
    ],
    "DepartureTime": "2024-05-28T21:27:56Z",
    "RoutingBoundary": {
        "Geometry": {
            "AutoCircle": {
                "Margin": 10000,
                "MaxRadius": 30000
            }
        }
    }
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-route-matrix --key ${YourKey} \
--origins '[{"Position": [-123.11679620827039, 49.28147612192166]}, {"Position": [-123.11179620827039, 49.3014761219]}]' \
--destinations '[{"Position": [-123.11179620827039, 49.28897192166]}]' \
--departure-time "2024-05-28T21:27:56Z" \
--routing-boundary '{"Geometry": {"AutoCircle": {"Margin": 10000, "MaxRadius": 30000}}}'
```

------

# Cómo calcular la matriz de rutas con evasión
<a name="calculate-route-matrix-with-avoidance"></a>

La CalculateRouteMatrix API calcula las rutas y devuelve el tiempo y la distancia de viaje desde cada origen hasta cada destino de las listas especificadas. La respuesta se incluye `Distance` en metros y `Duration` en segundos. La API se puede usar para establecer opciones de evasión para áreas o características de la carretera específicas, lo que garantiza que las rutas eviten zonas o condiciones específicas. Si no es posible utilizar una ruta alternativa, se puede omitir la preferencia de evasión.

## Casos de uso potenciales
<a name="calculate-route-matrix-potential-use"></a>
+ **Planificación y optimización de rutas:** utilice la matriz de rutas como entrada para un software que requiera rutas de viaje optimizadas y, al mismo tiempo, evite determinadas áreas o características de la carretera.

## Ejemplos
<a name="calculate-route-matrix-examples"></a>

### CalculateRouteMatrix con una zona de evitación
<a name="calculate-route-matrix-avoidance-area"></a>

------
#### [ Sample request ]

```
{
    "Origins": [
        {
            "Position": [-123.11679620827039, 49.28147612192166]
        }
    ],
    "Destinations": [
        {
            "Position": [-123.112317039, 49.28897192166]
        }
    ],
    "Avoid": {
        "Areas": [
            {
                "Geometry": {
                    "BoundingBox": [
                         -123.116561,
                         49.281517,
                         -123.110165,
                         49.285689
                    ]
                }
            }
        ]
    },
    "RoutingBoundary": {
        "Unbounded": true
    }
}
```

------
#### [ Sample response ]

```
{
    "ErrorCount": 0,
    "RouteMatrix": [
        [
            {
                "Distance": 1855,
                "Duration": 295
            }
        ]
    ],
    "RoutingBoundary": {
        "Unbounded": true
    }
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/route-matrix?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "Origins": [
        {
            "Position": [-123.11679620827039, 49.28147612192166]
        }
    ],
    "Destinations": [
        {
            "Position": [-123.112317039, 49.28897192166]
        }
    ],
    "Avoid": {
        "Areas": [
            {
                "Geometry": {
                    "BoundingBox": [
                         -123.116561,
                         49.281517,
                         -123.110165,
                         49.285689
                    ]
                }
            }
        ]
    },
    "RoutingBoundary": {
        "Unbounded": true
    }
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-route-matrix --key ${YourKey} \
--origins '[{"Position": [-123.11679620827039, 49.28147612192166]}]' \
--destinations '[{"Position": [-123.112317039, 49.28897192166]}]' \
--avoid '{"Areas": [{"Geometry": {"BoundingBox": [-123.116561, 49.281517, -123.110165, 49.285689]}}]}' \
--routing-boundary '{"Unbounded": true}'
```

------

### CalculateRouteMatrix evitando carreteras de peaje, autopistas y transbordadores
<a name="calculate-route-matrix-avoidance-features"></a>

------
#### [ Sample request ]

```
{
    "Origins": [
        {
            "Position": [-123.11679620827039, 49.28147612192166]
        }
    ],
    "Destinations": [
        {
            "Position": [-123.112317039, 49.28897192166]
        }
    ],
    "Avoid": {
        "TollRoads": true,
        "ControlledAccessHighways": true,
        "Ferries": true    
    },
    "RoutingBoundary": {
        "Unbounded": true
    }
}
```

------
#### [ Sample response ]

```
{
    "ErrorCount": 0,
    "RouteMatrix": [
        [
            {
                "Distance": 1855,
                "Duration": 295
            }
        ]
    ],
    "RoutingBoundary": {
        "Unbounded": true
    }
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/route-matrix?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "Origins": [
        {
            "Position": [-123.11679620827039, 49.28147612192166]
        }
    ],
    "Destinations": [
        {
            "Position": [-123.112317039, 49.28897192166]
        }
    ],
    "Avoid": {
        "TollRoads": true,
        "ControlledAccessHighways": true,
        "Ferries": true    
    },
    "RoutingBoundary": {
        "Unbounded": true
    }
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-route-matrix --key ${YourKey} \
--origins '[{"Position": [-123.11679620827039, 49.28147612192166]}]' \
--destinations '[{"Position": [-123.112317039, 49.28897192166]}]' \
--avoid '{"TollRoads": true, "ControlledAccessHighways": true, "Ferries": true}' \
--routing-boundary '{"Unbounded": true}'
```

------

# Aprenda a usar OptimizeWaypoints
<a name="optimize-waypoints-how-to"></a>

Obtenga información sobe cómo usar `OptimizeWaypoints` para encontrar las mejores rutas para minimizar el tiempo o la distancia de viaje.

**Topics**
+ [Cómo optimizar las paradas para una ruta](optimize-waypoints.md)
+ [Cómo optimizar las paradas de una ruta teniendo en cuenta el tráfico](optimize-waypoints-traffic-awareness.md)
+ [Cómo optimizar las paradas de una ruta teniendo en cuenta las horas de acceso](optimize-waypoints-access-hours.md)

# Cómo optimizar las paradas para una ruta
<a name="optimize-waypoints"></a>

La API OptimizeWaypoints también calcula la ruta óptima entre un conjunto de paradas, lo que minimiza el tiempo de viaje o la distancia total. Esta API resuelve el problema del viajante al tener en cuenta las redes de carreteras y las condiciones del tráfico para determinar la ruta óptima.

## Casos de uso potenciales
<a name="optimize-waypoints-potential-use"></a>
+ **Analice los patrones de las áreas de servicio:** utilice la optimización de paradas para tomar decisiones fundamentadas sobre las áreas de servicio empresarial y mejorar la eficiencia logística.

## Ejemplos
<a name="optimize-waypoints-examples"></a>

### Optimización de las paradas con el coche como TravelMode
<a name="optimize-waypoints-car"></a>

------
#### [ Sample Request ]

```
{
    "Origin": [
        -123.095740,
        49.274426
    ],
    "Waypoints": [
        {
            "Position": [
                -123.115193,
                49.280596
            ]
        },
        {
            "Position": [
                -123.089557,
                49.271774
            ]
        }
    ],
    "DepartureTime": "2024-10-25T18:13:42Z",
    "Destination": [
        -123.095185,
        49.263728
    ],
    "TravelMode": "Car"
}
```

------
#### [ Sample Response ]

```
{
    "Connections": [
        {
            "Distance": 1989,
            "From": "Origin",
            "RestDuration": 0,
            "To": "Waypoint0",
            "TravelDuration": 258,
            "WaitDuration": 0
        },
        {
            "Distance": 3010,
            "From": "Waypoint0",
            "RestDuration": 0,
            "To": "Waypoint1",
            "TravelDuration": 298,
            "WaitDuration": 0
        },
        {
            "Distance": 2371,
            "From": "Waypoint1",
            "RestDuration": 0,
            "To": "Destination",
            "TravelDuration": 311,
            "WaitDuration": 0
        }
    ],
    "Distance": 7370,
    "Duration": 867,
    "ImpedingWaypoints": [],
    "OptimizedWaypoints": [
        {
            "DepartureTime": "2024-10-25T18:13:42Z",
            "Id": "Origin",
            "Position": [
                -123.09574,
                49.274426
            ]
        },
        {
            "DepartureTime": "2024-10-25T18:18:00Z",
            "Id": "Waypoint0",
            "Position": [
                -123.115193,
                49.280596
            ]
        },
        {
            "DepartureTime": "2024-10-25T18:22:58Z",
            "Id": "Waypoint1",
            "Position": [
                -123.089557,
                49.271774
            ]
        },
        {
            "ArrivalTime": "2024-10-25T18:28:09Z",
            "Id": "Destination",
            "Position": [
                -123.095185,
                49.263728
            ]
        }
    ],
    "TimeBreakdown": {
        "RestDuration": 0,
        "ServiceDuration": 0,
        "TravelDuration": 867,
        "WaitDuration": 0
    }
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/optimize-waypoints?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "Origin": [
        -123.095740,
        49.274426
    ],
    "Waypoints": [
        {
            "Position": [
                -123.115193,
                49.280596
            ]
        },
        {
            "Position": [
                -123.089557,
                49.271774
            ]
        }
    ],
    "DepartureTime": "2024-10-25T18:13:42Z",
    "Destination": [
        -123.095185,
        49.263728
    ],
    "TravelMode": "Car"
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes optimize-waypoints --key ${YourKey} \
--origin -123.095740 49.274426 \
--waypoints '[{"Position": [-123.115193 , 49.280596]}, {"Position": [-123.089557 , 49.271774]}]' \
--destination -123.095185 49.263728 \
--departure-time "2024-10-25T18:13:42Z" \
--travel-mode "Car"
```

------

# Cómo optimizar las paradas de una ruta teniendo en cuenta el tráfico
<a name="optimize-waypoints-traffic-awareness"></a>

La OptimizeWaypoints API calcula la ruta óptima entre varios puntos de referencia para minimizar el tiempo de viaje o la distancia total. Utiliza algoritmos avanzados para resolver el problema del viajante, lo que determina la ruta más eficiente teniendo en cuenta factores como las redes de carreteras y las condiciones del tráfico en tiempo real.

## Casos de uso potenciales
<a name="optimize-waypoints-potential-use"></a>
+ **Optimice las rutas con varias paradas para lograr una entrega eficiente:** mejore las operaciones de entrega calculando la ruta más corta o más rápida entre varias paradas. Esto es útil para reducir los costos operativos, el consumo de combustible y el tiempo de viaje en los servicios de logística y entrega.

## Ejemplos
<a name="optimize-waypoints-examples"></a>

### Optimice los puntos de referencia con el conocimiento del tráfico utilizando el automóvil TravelMode
<a name="optimize-waypoints-traffic-car"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        -123.095740,
        49.274426
    ],
    "Waypoints": [
        {
            "Position": [
                -123.115193,
                49.280596
            ]
        },
        {
            "Position": [
                -123.089557,
                49.271774
            ]
        }
    ],
    "DepartureTime": "2024-10-25T18:13:42Z",
    "Destination": [
        -123.095185,
        49.263728
    ],
    "TravelMode": "Car",
    "Traffic": {
        "Usage": "UseTrafficData"
    }
}
```

------
#### [ Sample response ]

```
{
    "Connections": [
        {
            "Distance": 1989,
            "From": "Origin",
            "RestDuration": 0,
            "To": "Waypoint0",
            "TravelDuration": 324,
            "WaitDuration": 0
        },
        {
            "Distance": 2692,
            "From": "Waypoint0",
            "RestDuration": 0,
            "To": "Waypoint1",
            "TravelDuration": 338,
            "WaitDuration": 0
        },
        {
            "Distance": 2371,
            "From": "Waypoint1",
            "RestDuration": 0,
            "To": "Destination",
            "TravelDuration": 395,
            "WaitDuration": 0
        }
    ],
    "Distance": 7052,
    "Duration": 1057,
    "ImpedingWaypoints": [],
    "OptimizedWaypoints": [
        {
            "DepartureTime": "2024-10-25T18:13:42Z",
            "Id": "Origin",
            "Position": [
                -123.09574,
                49.274426
            ]
        },
        {
            "ArrivalTime": "2024-10-25T18:19:06Z",
            "DepartureTime": "2024-10-25T18:19:06Z",
            "Id": "Waypoint0",
            "Position": [
                -123.115193,
                49.280596
            ]
        },
        {
            "ArrivalTime": "2024-10-25T18:24:44Z",
            "DepartureTime": "2024-10-25T18:24:44Z",
            "Id": "Waypoint1",
            "Position": [
                -123.089557,
                49.271774
            ]
        },
        {
            "ArrivalTime": "2024-10-25T18:31:19Z",
            "Id": "Destination",
            "Position": [
                -123.095185,
                49.263728
            ]
        }
    ],
    "TimeBreakdown": {
        "RestDuration": 0,
        "ServiceDuration": 0,
        "TravelDuration": 1057,
        "WaitDuration": 0
    }
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/optimize-waypoints?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "Origin": [
        -123.095740,
        49.274426
    ],
    "Waypoints": [
        {
            "Position": [
                -123.115193,
                49.280596
            ]
        },
        {
            "Position": [
                -123.089557,
                49.271774
            ]
        }
    ],
    "DepartureTime": "2024-10-25T18:13:42Z",
    "Destination": [
        -123.095185,
        49.263728
    ],
    "TravelMode": "Car",
    "Traffic": {
        "Usage": "UseTrafficData"
    }
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes optimize-waypoints --key ${YourKey} \
--origin -123.095740 49.274426 \
--waypoints '[{"Position": [-123.115193 , 49.280596]}, {"Position": [-123.089557 , 49.271774]}]' \
--destination -123.095185 49.263728 \
--departure-time "2024-10-25T18:13:42Z" \
--travel-mode "Car" \
--traffic '{"Usage": "UseTrafficData"}'
```

------

# Cómo optimizar las paradas de una ruta teniendo en cuenta las horas de acceso
<a name="optimize-waypoints-access-hours"></a>

La API OptimizeWaypoints también calcula la ruta óptima entre un conjunto de paradas, con el objetivo de minimizar el tiempo de viaje o la distancia total recorrida. Resuelve el problema del viajante de determinar la ruta más eficiente, teniendo en cuenta factores como la red de carreteras y las condiciones del tráfico.

## Casos de uso potenciales
<a name="optimize-waypoints-access-hours-potential-use"></a>
+ **Analice las horas de acceso de los clientes:** planifique la eficiencia en torno a las horas de acceso de los clientes.

## Ejemplos
<a name="optimize-waypoints-examples"></a>

### Optimización de las paradas con el conocimiento de las horas de acceso mediante el coche como TravelMode
<a name="optimize-waypoints-car"></a>

------
#### [ Sample Request ]

```
{
    "Origin": [
        -123.095740,
        49.274426
    ],
    "Waypoints": [
        {
            "Position": [
                -123.115193,
                49.280596
            ],
            "SideOfStreet": {
                "Position": [
                    -123.089557,
                    49.271774
                ],
                "UseWith": "AnyStreet"
            },
            "AccessHours": {
                "From": {
                    "DayOfWeek": "Saturday",
                    "TimeOfDay": "00:02:42Z"
                },
                "To": {
                    "DayOfWeek": "Friday",
                    "TimeOfDay": "1:33:36+02:50"
                }
            },
            "Heading": "250",
            "ServiceDuration": "200"
        },
        {
            "Position": [
                -123.089557,
                49.271774
            ],
            "AccessHours": {
                "From": {
                    "DayOfWeek": "Monday",
                    "TimeOfDay": "00:02:42Z"
                },
                "To": {
                    "DayOfWeek": "Tuesday",
                    "TimeOfDay": "1:33:36+02:50"
                }
            },
            "ServiceDuration": "200"
        }
    ],
    "DepartureTime": "2024-10-25T18:13:42Z",
    "Destination": [
        -123.095185,
        49.263728
    ],
    "TravelMode": "Car"
}
```

------
#### [ Sample Response ]

```
{
    "Connections": [
        {
            "Distance": 1989,
            "From": "Origin",
            "RestDuration": 0,
            "To": "Waypoint0",
            "TravelDuration": 258,
            "WaitDuration": 20682
        },
        {
            "Distance": 3360,
            "From": "Waypoint0",
            "RestDuration": 0,
            "To": "Waypoint1",
            "TravelDuration": 378,
            "WaitDuration": 172222
        },
        {
            "Distance": 2371,
            "From": "Waypoint1",
            "RestDuration": 0,
            "To": "Destination",
            "TravelDuration": 311,
            "WaitDuration": 0
        }
    ],
    "Distance": 7720,
    "Duration": 194251,
    "ImpedingWaypoints": [],
    "OptimizedWaypoints": [
        {
            "DepartureTime": "2024-10-25T18:13:42Z",
            "Id": "Origin",
            "Position": [
                -123.09574,
                49.274426
            ]
        },
        {
            "ArrivalTime": "2024-10-25T18:18:00Z",
            "DepartureTime": "2024-10-26T00:06:02Z",
            "Id": "Waypoint0",
            "Position": [
                -123.115193,
                49.280596
            ]
        },
        {
            "ArrivalTime": "2024-10-26T00:12:20Z",
            "DepartureTime": "2024-10-28T00:06:02Z",
            "Id": "Waypoint1",
            "Position": [
                -123.089557,
                49.271774
            ]
        },
        {
            "ArrivalTime": "2024-10-28T00:11:13Z",
            "Id": "Destination",
            "Position": [
                -123.095185,
                49.263728
            ]
        }
    ],
    "TimeBreakdown": {
        "RestDuration": 0,
        "ServiceDuration": 400,
        "TravelDuration": 947,
        "WaitDuration": 192904
    }
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/optimize-waypoints?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "Origin": [
        -123.095740,
        49.274426
    ],
    "Waypoints": [
        {
            "Position": [
                -123.115193,
                49.280596
            ],
            "SideOfStreet": {
                "Position": [
                    -123.089557,
                    49.271774
                ],
                "UseWith": "AnyStreet"
            },
            "AccessHours": {
                "From": {
                    "DayOfWeek": "Saturday",
                    "TimeOfDay": "00:02:42Z"
                },
                "To": {
                    "DayOfWeek": "Friday",
                    "TimeOfDay": "1:33:36+02:50"
                }
            },
            "Heading": "250",
            "ServiceDuration": "200"
        },
        {
            "Position": [
                -123.089557,
                49.271774
            ],
            "AccessHours": {
                "From": {
                    "DayOfWeek": "Monday",
                    "TimeOfDay": "00:02:42Z"
                },
                "To": {
                    "DayOfWeek": "Tuesday",
                    "TimeOfDay": "1:33:36+02:50"
                }
            },
            "ServiceDuration": "200"
        }
    ],
    "DepartureTime": "2024-10-25T18:13:42Z",
    "Destination": [
        -123.095185,
        49.263728
    ],
    "TravelMode": "Car"
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes optimize-waypoints --key ${YourKey} \
--origin -123.095740 49.274426 \
--waypoints '[{"Position": [-123.115193 , 49.280596], "SideOfStreet": {"Position": [-123.089557, 49.271774], "UseWith": "AnyStreet"}, "AccessHours": {"From": {"DayOfWeek": "Saturday", "TimeOfDay": "00:02:42Z"}, "To": {"DayOfWeek": "Friday", "TimeOfDay": "1:33:36+02:50"}}, "Heading": 250, "ServiceDuration": 200}, {"Position": [-123.089557, 49.271774], "AccessHours": {"From": {"DayOfWeek": "Monday", "TimeOfDay": "00:02:42Z"}, "To": {"DayOfWeek": "Tuesday", "TimeOfDay": "1:33:36+02:50"}}, "ServiceDuration": 200}]' \
--destination -123.095185 49.263728 \
--departure-time "2024-10-25T18:13:42Z" \
--travel-mode "Car"
```

------

# Obtención de información sobre cómo usar SnapToRoads
<a name="snap-to-roads-how-to"></a>

 En este tema se explica cómo usar `SnapToRoads` para alinear los trazados del GPS con las redes de carreteras, lo que mejora la precisión posicional en las aplicaciones de navegación y administración de flotas. Esta API corrige la desviación del GPS y la pérdida de señal al ajustar las coordenadas a los segmentos de carretera más cercanos y, al mismo tiempo, respeta las restricciones de los modos de viaje. Los ejemplos ilustran usos prácticos, como superponer los trazados del GPS, cubrir los vacíos de datos y reducir el ruido para una visualización más clara de las rutas.

**Topics**
+ [Cómo hacer coincidir los trazados del GPS con una red de carreteras](how-to-match-gps-traces.md)

# Cómo hacer coincidir los trazados del GPS con una red de carreteras
<a name="how-to-match-gps-traces"></a>

La API de SnapToRoads le permite hacer coincidir los trazados del GPS con la red de carreteras. Un trazado del GPS incluye posiciones y metadatos, como la marca de tiempo, la velocidad y el rumbo, que se registran con un dispositivo GPS. Estos trazados suelen tener un margen de error, lo que dificulta su uso directo para el análisis y la visualización.

SnapToRoads tiene en cuenta las restricciones legales y de tiempo para el modo de viaje especificado al comparar los trazados. Si el trazado sugiere claramente una infracción de la restricción, se mantiene la ruta real tomada.

## Casos de uso potenciales
<a name="potential-use"></a>
+ **Superponga los trazados del GPS en las carreteras con más probabilidades de circulación:** esta característica ayuda a alinear los datos del GPS con la ruta más precisa de la red de carreteras, lo que permite una visualización de datos más clara.
+ **Interpole los huecos en los trazados del GPS:** SnapToRoads puede rellenar los huecos al ajustar las coordenadas a los segmentos de la carretera, lo que crea un conjunto de datos más continuo y útil para las aplicaciones.
+ **Filtre el ruido y los valores atípicos:** al seleccionar la carretera más cercana, esta API puede ayudar a eliminar los valores atípicos y reducir el ruido del GPS, lo que mejora la fiabilidad de los datos para el análisis.

## Ejemplos
<a name="examples"></a>

### Coincidencia del trazado del GPS con el modo coche
<a name="match-gps-car-mode"></a>

------
#### [ Sample request ]

```
{
  "TracePoints": [
    {
      "Position": [8.53404,50.16364],
      "Timestamp": "2024-05-22T18:13:42Z"
    },
    {
      "Position": [8.53379056,50.16352417],
      "Speed": 20,
      "Timestamp": "2024-05-22T18:13:59Z"
    }
  ],
  "TravelMode": "Car"
}
```

------
#### [ Sample response ]

```
{
    "Notices": [],
    "SnappedGeometry": {
        "Polyline": "Redacted"
    },
    "SnappedGeometryFormat": "FlexiblePolyline",
    "SnappedTracePoints": [
        {
            "Confidence": 1,
            "OriginalPosition": [8.53404, 50.16364],
            "SnappedPosition": [8.53402, 50.16367]
        },
        {
            "Confidence": 0.86,
            "OriginalPosition": [8.53379056, 50.16352417],
            "SnappedPosition": [8.53375, 50.16356]
        }
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/snap-to-roads?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "TracePoints": [
    {
      "Position": [8.53404,50.16364],
      "Timestamp": "2024-05-22T18:13:42Z"
    },
    {
      "Position": [8.53379056,50.16352417],
      "Speed": 20,
      "Timestamp": "2024-05-22T18:13:59Z"
    }
  ],
  "TravelMode": "Car"
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes snap-to-roads --key ${YourKey} \
--trace-points '[{"Position": [8.53404, 50.16364], "Timestamp": "2024-05-22T18:13:42Z"}, {"Position": [8.53379056, 50.16352417], "Speed": 20, "Timestamp": "2024-05-22T18:13:59Z"}]' \
--travel-mode "Car"
```

------

### Coincidencia del trazado del GPS con el modo camión con opciones
<a name="match-gps-truck-mode-options"></a>

------
#### [ Sample request ]

```
{
  "TracePoints": [
    {
      "Position": [8.53404,50.16364],
      "Timestamp": "2024-05-22T18:13:42Z"
    },
    {
      "Position": [8.53379056,50.16352417],
      "Speed": 20,
      "Timestamp": "2024-05-22T18:13:59Z"
    }
  ],
  "TravelMode": "Truck",
  "TravelModeOptions": {
    "Truck": {
      "GrossWeight": 10000
    }
  }
}
```

------
#### [ Sample response ]

```
{
    "Notices": [],
    "SnappedGeometry": {
        "Polyline": "Redacted"
    },
    "SnappedGeometryFormat": "FlexiblePolyline",
    "SnappedTracePoints": [
        {
            "Confidence": 1,
            "OriginalPosition": [8.53404, 50.16364],
            "SnappedPosition": [8.53402, 50.16367]
        },
        {
            "Confidence": 0.86,
            "OriginalPosition": [8.53379056, 50.16352417],
            "SnappedPosition": [8.53375, 50.16356]
        }
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/snap-to-roads?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "TracePoints": [
    {
      "Position": [8.53404,50.16364],
      "Timestamp": "2024-05-22T18:13:42Z"
    },
    {
      "Position": [8.53379056,50.16352417],
      "Speed": 20,
      "Timestamp": "2024-05-22T18:13:59Z"
    }
  ],
  "TravelMode": "Truck",
  "TravelModeOptions": {
    "Truck": {
      "GrossWeight": 10000
    }
  }
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes snap-to-roads --key ${YourKey} \
--trace-points '[{"Position": [8.53404, 50.16364], "Timestamp": "2024-05-22T18:13:42Z"}, {"Position": [8.53379056, 50.16352417], "Speed": 20, "Timestamp": "2024-05-22T18:13:59Z"}]' \
--travel-mode "Truck" \
--travel-mode-options '{"Truck": {"GrossWeight": 10000}}'
```

------

# Administración de costos y uso
<a name="routes-whats-next"></a>

A medida que siga obteniendo información sobre las rutas de Amazon Location, es importante que sepa cómo administrar la capacidad del servicio, asegurarse de cumplir con los límites de uso y obtener los mejores resultados mediante las optimizaciones de cuotas y API. Al aplicar las prácticas recomendadas para garantizar el rendimiento y la precisión, puede personalizar la aplicación para gestionar las consultas relacionadas con el lugar de forma eficiente y maximizar las solicitudes de la API.

**Topics**
+ [Prácticas recomendadas](routes-best-practices.md)
+ [Precios de rutas](routes-pricing.md)
+ [Cuota y uso de rutas](routes-quota-usage.md)

# Prácticas recomendadas
<a name="routes-best-practices"></a>

En esta sección, se describen las prácticas recomendadas para usar la compresión y elegir entre los formatos Simple (GeoJSON) y FlexiblePolyline al interactuar con la API, y se proporciona orientación sobre cómo optimizar el rendimiento, el ancho de banda y el manejo de datos.

## Compresión
<a name="compression"></a>

Para mejorar el rendimiento y la eficiencia de las aplicaciones al interactuar con nuestra API, se recomienda habilitar la compresión de las respuestas, especialmente cuando se trata de grandes cargas útiles basadas en texto. Para activar la compresión, incluya el encabezado `Accept-Encoding` en las solicitudes de API y especifique el método de compresión preferido. Apoyamos `gzip` y `deflate` para sus capacidades de compresión, con `gzip` que suele ofrecer mejores índices de compresión.

### Cuándo habilitar la compresión
<a name="when-to-enable-compression"></a>

**Respuestas grandes**  
Habilite la compresión para obtener respuestas de gran tamaño basadas en texto para reducir el uso del ancho de banda y mejorar los tiempos de carga.

**Restricciones de red**  
Si la aplicación funciona con un ancho de banda limitado o redes de alta latencia, la compresión puede mejorar la eficiencia de la transferencia de datos.

### Cómo utilizar la compresión de forma eficaz
<a name="how-to-use-compression-effectively"></a>

**Configuración del encabezado Accept-Encoding**  
Incluya `Accept-Encoding: gzip, deflate` en las solicitudes HTTP para informar a nuestra API de que admite estos métodos de compresión. El método para habilitar y gestionar la compresión varía según el [AWS SDK](https://docs.aws.amazon.com/sdkref/latest/guide/overview.html) y el lenguaje de programación. Por ejemplo, el [AWS SDK para Java v1](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/ClientConfiguration.html#withGzip-boolean-) usa el método `withGzip` de la clase `ClientConfiguration` para habilitar gzip, mientras que AWS SDK para Go requiere agregar un middleware específico para la gestión de la compresión. Para otros SDK, consulte la [Guía de referencia de AWS SDK](https://docs.aws.amazon.com/sdkref/latest/guide/overview.html) para obtener instrucciones detalladas.

**Manejo de la descompresión de forma adecuada**  
Asegúrese de que la aplicación de cliente pueda descomprimir correctamente las respuestas en función del encabezado `Content-Encoding` devuelto por nuestra API.

**Prueba y supervisión**  
Evalúe periódicamente el impacto de la compresión en el rendimiento de la aplicación, equilibrando los beneficios de reducir el tamaño de la carga útil con cualquier sobrecarga adicional de la CPU derivada de los procesos de descompresión.

## Polilínea
<a name="polyline"></a>

Prácticas recomendadas para elegir entre los formatos Simple (GeoJSON) y FlexiblePolyline al interactuar con nuestra API, a fin de optimizar el rendimiento y la usabilidad de los datos geoespaciales.

### Utilice el formato Simple (GeoJSON)
<a name="use-simple-format"></a>

**Legibilidad y estandarización**  
Úselo cuando necesite un formato ampliamente reconocido y legible por humanos para facilitar la depuración y la interoperabilidad con diversas herramientas geoespaciales.

**Precisión**  
Elija el formato Simple cuando la aplicación necesite una alta precisión para las coordenadas, ya que GeoJSON mantiene una precisión decimal total sin pérdidas.

**Conjuntos de datos más pequeños**  
El formato Simple es ideal cuando se trabaja con conjuntos de datos de coordenadas más pequeños donde los beneficios de reducción de tamaño de la compresión son mínimos.

### Uso del formato FlexiblePolyline
<a name="use-flexiblepolyline-format"></a>

**Reducción del tamaño de los datos**  
FlexiblePolyline es ideal cuando se necesita minimizar la cantidad de datos transmitidos, especialmente en el caso de listas de coordenadas grandes, mediante el uso de técnicas de compresión con pérdidas.

**Seguridad de URL**  
FlexiblePolyline proporciona una cadena compacta y segura para URL que se puede usar directamente en los parámetros de consulta sin necesidad de codificación adicional.

**Optimización del desempeño**  
FlexiblePolyline ayuda a reducir el tamaño de la carga útil, lo que permite una transferencia de datos más rápida y un menor uso del ancho de banda, por lo que es fundamental para las aplicaciones de alto rendimiento o para las que funcionan en redes restringidas.

# Precios de rutas
<a name="routes-pricing"></a>

Consulte, a continuación, los buckets de precios de cada API:

## Cálculo de las rutas
<a name="calculate-routes-price"></a>

Este precio se basa en la cantidad de solicitudes de API. `CalculateRoutes` tiene tres buckets de precios: básico, avanzado y prémium.

**Core**  
Este bucket de precios admite los modos de viaje coche, camión y peatonal, sin calcular el costo del peaje.

**Avanzado**  
Este bucket de precios admite modos de viaje alternativos, como la moto, sin calcular el costo del peaje.

**Prémium**  
Este bucket de precios permite calcular los costos de los peajes. Se le cobrará el precio prémium cuando solicite el cálculo del costo de los peajes mediante la configuración de los parámetros de la solicitud `LegAdditionalFeatures["Tolls"]` o `SpanAdditionalFeatures["TollSystems"]`, independientemente del modo de viaje.

## Cálculo de matriz de rutas
<a name="calculate-route-matri-price"></a>

Este precio se basa en el número de rutas calculado. El número de rutas calculado en cada solicitud es igual al número de orígenes multiplicado por el número de destinos, `Number of Routes = Number of origins x Number of Destinations`. Por ejemplo, si se utiliza un tamaño de matriz de 300 orígenes por 100 destinos, el número total de rutas calculado es de 30 000 (300 x 100 = 30 000).

**nota**  
Los cálculos de ruta se facturan para cada par de origen y destino. Si utiliza una matriz grande de orígenes y destinos, los costos aumentarán en consecuencia.

`CalculateRouteMatrix` tiene 2 buckets de precios: básico y avanzado.

**Core**  
Este bucket de precios admite los modos de viaje coche, camión y peatonal.

**Avanzado**  
Este bucket de precios admite modos de viaje alternativos, como la moto.

## Optimización de paradas
<a name="optimize-waypoint-price"></a>

Este precio se basa en la cantidad de solicitudes de API. `OptimizeWaypoint` tiene 2 buckets de precios: avanzado y prémium.

**Avanzado**  
 Este bucket de precios admite hasta 30 puntos de referencia en una sola solicitud; modos de viaje para coches, camiones y peatones, con el recuadro delimitador de los puntos de entrada en un radio de 200 km y sin parámetros opcionales como `Avoid`, `Clustering`, `Driver`, `Exclude.Countries`, `TravelModeOptions.Truck.HazardousCargos`, `TravelModeOptions.Truck.TunnelRestrictionCode` y sin puntos de referencia adicionales o restricciones de destino como `AccessHours`, `AppointmentTime`, `Before`, `Heading`, `ServiceDuration` y `SideOfStreet`.  
La agrupación automática en clústeres puede producirse cuando los puntos de referencia están muy cerca, pero sigue considerándose un bucket de precios avanzado.

**Prémium**  
 Este bucket de precios admite hasta 50 puntos de referencia en una sola solicitud, sin restricciones en cuanto a los modos de viaje, con un recuadro delimitador de los puntos de entrada en 500 km y con parámetros opcionales como `Avoid`, `Clustering`, `Driver`, `Exclude.Countries`, `TravelModeOptions.Truck.HazardousCargos` y `TravelModeOptions.Truck.TunnelRestrictionCode`. Además, este bucket de precios admite restricciones opcionales de puntos de referencia y destino, como `AccessHours`, `AppointmentTime`, `Before`, `Heading`, `ServiceDuration`, `SideOfStreet`.   
Una sola solicitud solo puede admitir hasta 20 puntos de referencia si se aplica alguna de las restricciones opcionales de punto de referencia y destino.

## S nap-to-road
<a name="snap-to-road-price"></a>

Este precio se basa en la cantidad de solicitudes de API. `SnaptoRoad` tiene 2 buckets de precios: avanzado y prémium.

**Avanzado**  
Este bucket de precios admite los modos de viaje en coche, camión y peatón, con un número de `TracePoints` de hasta 200 y con una distancia máxima de vuelo entre `TracePoints` de 100 kilómetros.

**Prémium**  
Este bucket de precios no tiene restricciones en cuanto a los modos de viaje, hasta 5000 puntos `TracePoints`.

## Cálculo de isolíneas
<a name="calculate-isoline-price"></a>

Este precio se basa en la cantidad de isolíneas calculadas en la respuesta. `CalculateIsolines` tiene 2 buckets de precios: avanzado y prémium.

**Avanzado**  
Este bucket de precios admite los modos de viaje en coche, camión y como peatón, con valores `Thresholds.Time` de hasta 60 minutos o valores `Thresholds.Distance` de hasta 100 kilómetros.

**Prémium**  
Este bucket de precios no tiene restricciones en cuanto a los modos de viaje, con valores `Thresholds.Time` de hasta 180 minutos o valores `Thresholds.Distance` de hasta 300 km.

# Cuota y uso de rutas
<a name="routes-quota-usage"></a>

## Cuota de servicio
<a name="service-quota"></a>

Amazon Location Service APIs tiene cuotas predeterminadas. Puede aumentar cuotas mediante la [consola de Service Quotas](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas). Si los límites superan el doble del valor predeterminado, solicítelos a través de la consola de autoservicio o póngase en contacto con el servicio de asistencia.


**Límites de Service Quota**  

| Nombre de API | Predeterminado | Límite ajustable máximo | Más que el límite máximo ajustable | 
| --- | --- | --- | --- | 
| [Cálculo de las rutas](calculate-routes.md) | 20 | 40 | Solicitud en la [consola de cuotas de servicio](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) o contacto con el equipo de soporte | 
| [Cálculo de isolíneas](calculate-isolines.md) | 20 | 40 | Solicitud en la [consola de cuotas de servicio](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) o contacto con el equipo de soporte | 
| [Ajustar a carreteras](snap-to-roads.md) | 20 | 40 | Solicitud en la [consola de cuotas de servicio](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) o contacto con el equipo de soporte | 
| [Cálculo de matriz de rutas](calculate-route-matrix.md) | 5 | 10 | Solicitud en la [consola de cuotas de servicio](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) o contacto con el equipo de soporte | 
| [Optimización de paradas](actions-optimize-waypoints.md) | 5 | 10 | Solicitud en la [consola de cuotas de servicio](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) o contacto con el equipo de soporte | 

## Otros límites de uso
<a name="other-usage-limits"></a>

Además de Service Quotas, se aplican los siguientes límites de uso de la API:


**Otros límites de uso**  

| Nombre de API | Límite | Valor | 
| --- | --- | --- | 
| [Ajustar a carreteras](snap-to-roads.md) | Suma de la distancia geodésica entre todos TracePoints | 500 KM | 
| [Optimización de paradas](actions-optimize-waypoints.md) | Suma de la distancia geodésica entre el origen, los puntos de referencia en el pedido proporcionado y el destino | 100 KM | 
| [Optimización de paradas](actions-optimize-waypoints.md) | Perímetro del recuadro delimitador que rodea el origen, los puntos de referencia y el destino | 500 KM | 
| [Cálculo de matriz de rutas](calculate-route-matrix.md) | Distancia máxima entre los orígenes y los destinos para rutas ilimitadas (si se utiliza Avoid o TravelModeOptions .Truck) | 60 KM | 
| [Cálculo de matriz de rutas](calculate-route-matrix.md) | Distancia máxima entre orígenes y destinos para rutas ilimitadas | 10 000 KM | 
| [Cálculo de las rutas](calculate-routes.md) | Tamaño de la carga útil de respuesta después de la compresión | 6 MB | 
| [Cálculo de matriz de rutas](calculate-route-matrix.md) | Tamaño de la carga útil de respuesta después de la compresión | 6 MB | 
| [Cálculo de isolíneas](calculate-isolines.md) | Tamaño de la carga útil de respuesta después de la compresión | 6 MB | 
| [Optimización de paradas](actions-optimize-waypoints.md) | Tamaño de la carga útil de respuesta después de la compresión | 6 MB | 
| [Ajustar a carreteras](snap-to-roads.md) | Tamaño de la carga útil de respuesta después de la compresión | 6 MB | 

## Siguientes pasos
<a name="next-steps"></a>

Compruebe lo siguiente para obtener más información:
+ [Atribución](https://docs.aws.amazon.com/location/latest/developerguide/data-attribution.html): información sobre los requisitos de atribución de datos para Amazon Location Service.
+ [SLA](https://aws.amazon.com/location/sla/): el acuerdo de nivel de servicio de Amazon Location Service, que incluye los compromisos de tiempo de actividad y los tiempos de respuesta.
+ [Condiciones del servicio](https://aws.amazon.com/service-terms/): condiciones que rigen el uso de Amazon Location Service, incluidas las restricciones y limitaciones.