Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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

![\[Vue d'ensemble des itinéraires d'Amazon Location Service.\]](http://docs.aws.amazon.com/fr_fr/location/latest/developerguide/images/routesV2/route-banner.png)


Avec Amazon Location Service Routes, vous pouvez calculer le temps de trajet et la distance entre plusieurs points de départ et d'arrivée, visualiser les traces GPS des véhicules alignées sur les routes et mieux comprendre les zones desservies. Cela permet de réduire les coûts d'exploitation et d'améliorer l'expérience client.

## Fonctionnalités
<a name="routes-features"></a>

**Planifier un itinéraire**  
Calculez les itinéraires entre deux sites ou plus, en tenant compte de divers facteurs tels que la distance, le temps et l'état des routes. Vous pouvez également voir des itinéraires alternatifs pour le même ensemble de destinations.

**Optimisation des itinéraires**  
Optimisez les itinéraires en fonction du temps ou de la distance, en choisissant l'itinéraire le plus rapide ou le plus court. Vous pouvez également séquencer les points de cheminement pour optimiser le problème des vendeurs itinérants.

**Analyse des itinéraires**  
Analysez les indicateurs de performance tels que le temps de trajet, la distance ou le nombre d'arrêts pour vous assurer que l'itinéraire répond aux objectifs souhaités.

**Zone de service**  
Définit la zone géographique qui peut être desservie à partir d'un lieu donné en fonction de la distance ou des limites de temps.

**Coûts de péage**  
Calculez les coûts associés à l'infrastructure de péage sur votre itinéraire.

**Évitement**  
Limitez le calcul de votre itinéraire en évitant les autoroutes, les tunnels, les ferries et les routes à péage.

**Limites de vitesse**  
Trouvez les limites de vitesse pour chaque segment d'un itinéraire, en veillant à ce que les conducteurs respectent les réglementations locales.

![\[Une application utilisant les fonctionnalités d'itinéraire d'Amazon Location Service.\]](http://docs.aws.amazon.com/fr_fr/location/latest/developerguide/images/routesV2/route-demo.png)


## Cas d’utilisation
<a name="routes-usecases"></a>

**Fournir des itinéraires et des turn-by-turn directions efficaces**  
Planifiez des itinéraires à partir de n'importe quel point de départ (adresse, point d'intérêt ou coordonnées GPS) et calculez le meilleur itinéraire vers plusieurs destinations, en tenant compte des dimensions du véhicule et des restrictions.  
Pour de plus amples informations, veuillez consulter [Calculez les itinéraires](calculate-routes.md).

**Optimisez les itinéraires de livraison**  
Utilisez le séquençage des points de cheminement pour résoudre le problème des vendeurs itinérants et calculer l'itinéraire optimal vers plusieurs destinations, en minimisant le temps et la distance.  
Pour de plus amples informations, veuillez consulter [Optimisez les points de cheminement](actions-optimize-waypoints.md).

**Assurez-vous que les livraisons sont effectuées depuis l'entrepôt le plus proche**  
Utilisez le routage matriciel et le séquençage des points de cheminement pour identifier l'itinéraire le plus rapide entre vos entrepôts et chaque client, en maximisant l'efficacité et en minimisant les coûts.  
Pour plus d’informations, consultez [Calculez les itinéraires](calculate-routes.md) et [Calculer la matrice d'itinéraires](calculate-route-matrix.md).

**Améliorez la répartition des taxis et du covoiturage**  
Utilisez le routage matriciel pour identifier le véhicule disponible le plus proche et calculer les itinéraires optimaux en fonction du trafic en temps réel. Cela garantit que le véhicule le plus proche atteint efficacement le client, ce qui améliore à la fois la satisfaction du client et la productivité de l'entreprise. Effectuez plus de trajets, économisez sur les frais de carburant et offrez une expérience de service supérieure.  
Pour plus d’informations, consultez [Calculez les itinéraires](calculate-routes.md), [Calculer la matrice d'itinéraires](calculate-route-matrix.md) et [Calculer les isolignes](calculate-isolines.md).

**Trouvez les zones de service**  
Utilisez les itinéraires Isoline pour déterminer la portée géographique de votre entreprise, en fonction des contraintes de temps ou de distance. Cela permet à l'entreprise d'identifier des clients potentiels et d'établir des plans d'expédition. Les prestataires de soins à domicile peuvent s'assurer qu'ils disposent de suffisamment de personnel et de ressources pour atteindre tous les patients dans les 15 minutes. Isoline aide à optimiser les zones de service, à garantir des livraisons en temps opportun et à localiser de nouvelles installations.  
Pour de plus amples informations, veuillez consulter [Calculer les isolignes](calculate-isolines.md).

**Tracez le GPS sur les routes**  
Alignez les traces GPS sur les routes et visualisez les mouvements des véhicules, afin de garantir le respect des itinéraires et la conformité réglementaire. Les gestionnaires de flotte peuvent voir si les véhicules suivent les itinéraires prévus et identifier les écarts. Vérifiez que les conducteurs suivent les directives, repérez les inefficiences et garantissez le respect des réglementations. Corrige les inexactitudes et les variations du GPS et présente une vue réaliste de l'activité du véhicule. Améliorez la prise de décisions concernant l'optimisation des itinéraires, le comportement des conducteurs et la gestion de flotte.  
Pour de plus amples informations, veuillez consulter [Snap to Roads](snap-to-roads.md).

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

Ce tableau fournit un aperçu des principaux services Amazon Location Service APIs pour la planification d'itinéraires et le traitement des données basé sur la localisation. Chaque API offre des fonctionnalités uniques, telles que le calcul d'itinéraires, l'optimisation des points de cheminement et l'enregistrement de traces GPS sur les routes pour un suivi précis.


**APIs**  

| Nom d'API | Description | En savoir plus | 
| --- | --- | --- | 
| Calculer les itinéraires | Calculez la distance, le temps de trajet et les turn-by-turn directions entre un point de départ et plusieurs destinations en tenant compte des restrictions relatives aux véhicules et du trafic en temps réel. | [Calculez les itinéraires](calculate-routes.md) | 
| Calculer la matrice d'itinéraires | Calculez la distance et le temps entre un ensemble de points de départ et un ensemble de destinations, en tenant compte du trafic en temps réel. | [Calculer la matrice d'itinéraires](calculate-route-matrix.md) | 
| Calculer les isolignes | Identifiez la zone géographique qui peut être atteinte dans un délai ou une distance spécifiés en fonction de vos modes de déplacement. | [Calculer les isolignes](calculate-isolines.md) | 
| Optimisez les waypoints | Trouvez la commande efficace pour voyager vers plusieurs destinations, en réduisant le temps de trajet et la distance tout en tenant compte de facteurs tels que le trafic et les contraintes liées aux véhicules. | [Comment optimiser les points de cheminement d'un itinéraire](optimize-waypoints.md) | 
| Snap to Roads | Associez les traces GPS au segment de route le plus proche, afin d'améliorer la précision du suivi des véhicules et de visualiser les itinéraires. | [Snap to Roads](snap-to-roads.md) | 

# Concepts d'itinéraires
<a name="routes-concepts"></a>

Les concepts d'itinéraires d'Amazon Location Service fournissent un cadre robuste pour planifier et optimiser les trajets, qu'il s'agisse d'une navigation simple ou d'une logistique complexe. Les itinéraires comprennent divers éléments, tels que les points de cheminement, les étapes, les marches et les travées, chacun contribuant à la granularité et à la flexibilité des calculs d'itinéraires. Grâce à l'API Routes, vous pouvez calculer les distances parcourues, estimer les temps de trajet et optimiser les trajets à arrêts multiples. De plus, des fonctionnalités telles que la géométrie des itinéraires, la surveillance du trafic, les limites de vitesse, les coûts de péage et le codage polyligne flexible améliorent les capacités de visualisation, d'analyse et d'efficacité opérationnelle. Cette section couvre la terminologie, les meilleures pratiques et les modèles d'utilisation détaillés, et vous guide dans la mise en œuvre de solutions d'itinéraires efficaces pour la navigation, la livraison, les services sur le terrain, etc.

**Topics**
+ [Terminologie des itinéraires](routes-terminology.md)
+ [Où (origine, destination, point de cheminement et traces)](concepts-where.md)
+ [Quand (départ et arrivée)](concepts-when.md)
+ [Comment (mode de déplacement, évitement et exclusion)](concepts-how.md)
+ [Sensibilisation au trafic](concepts-traffic-awareness.md)
+ [Optimisez l'itinéraire et la séquence des points de cheminement](optimize-route-waypoint.md)
+ [Horaires et avis destinés aux conducteurs](driver-schedule-notices.md)

# Terminologie des itinéraires
<a name="routes-terminology"></a>

**Acheminement**  
Un itinéraire fournit des informations sur le trajet entre un point de départ et une destination en passant par des points de cheminement. Il inclut la distance parcourue, le temps de trajet, la géométrie de l'itinéraire, les limites de vitesse, les portées et d'autres attributs.

**Matrice d'itinéraires**  
Matrice représentant la distance et le temps de trajet entre un ensemble d'origines et un ensemble de destinations. Il est utile comme entrée pour les applications de planification ou d'optimisation d'itinéraires.

**Waypoint**  
Les waypoints sont des arrêts intermédiaires le long d'un trajet entre le point de départ et la destination. L'itinéraire suit l'ordre des escales tel que spécifié dans la demande.

**Jambe**  
Une étape représente le trajet entre deux positions consécutives sur un itinéraire. Si les positions sont hors route, elles sont déplacées vers la route la plus proche. Un itinéraire sans point de passage se compose d'une seule étape. Les itinéraires comportant un ou plusieurs points de cheminement comportent plusieurs étapes, chaque étape représentant le trajet d'un point de cheminement à l'autre. Certaines étapes, comme celles impliquant des ferries, contiennent des informations spécifiques relatives à ce type d'étape.

**Étape**  
Une étape est un segment à l'intérieur d'une étape qui fournit des détails récapitulatifs pour cette partie du voyage. Les types d'étapes incluent :  
+ **Étapes par défaut** : étapes de base avec des instructions lisibles par l'homme, adaptées aux applications Web qui affichent une vue d'ensemble de l'itinéraire.
+ **Turn-by-Turn Étapes** — Étapes détaillées adaptées aux turn-by-turn applications, fournissant des instructions détaillées.
+ **Étapes avant le voyage** — Étapes à suivre avant de commencer le voyage. Exemple : embarquer sur un ferry.
+ **Étapes après le voyage** : étapes à effectuer après avoir atteint la fin d'un voyage. Exemple : débarquer d'un ferry.

**Span**  
Une travée représente un tronçon continu d'une route qui partage un ensemble cohérent d'attributs. De nouvelles travées sont créées le long d'un itinéraire chaque fois que l'un des attributs demandés change.

**Segment**  
Un segment est une partie navigable d'une route, généralement représentée sous la forme d'un tronçon linéaire.

**Géométrie de l'itinéraire**  
La géométrie de l'itinéraire décrit le tracé d'un itinéraire à des fins de visualisation, d'analyse ou d'autres utilisations. La géométrie de chaque tronçon de route peut être représentée sous la forme d'une polyligne codée compressée ou d'une simple chaîne de lignes.

**Polyligne flexible**  
Format de polyligne compact et codé pour représenter la géométrie. Recommandé pour limiter la taille de réponse et optimisé pour le décodage côté client.

**Chaîne linéaire simple**  
 LineString Format GeoJSON représentant la géométrie. Ce format produit une charge utile de réponse plus importante et constitue un tableau ordonné de coordonnées qui peut être utilisé pour tracer des itinéraires sur une carte.

# Où (origine, destination, point de cheminement et traces)
<a name="concepts-where"></a>

Spécifie l'emplacement pour le calcul de l'itinéraire, y compris le début, la fin et les arrêts intermédiaires (ou les lieux à traverser).


**Spécifie l'endroit où le calcul de l'itinéraire doit être effectué**  

| Paramètre | Description | Routes | Matrice des itinéraires | Isoline | Optimisez le point de cheminement | Snap to Road | 
| --- | --- | --- | --- | --- | --- | --- | 
| Origine (s) | Position de départ de l'itinéraire. | Oui, avec options | Oui, avec options | Oui, avec options | Oui, avec options | Non | 
| Waypoint | Positions intermédiaires à inclure le long du parcours. | Oui, avec options | Oui, avec options | Oui, avec options | Oui, avec options | Non | 
| Destination (s) | Position finale de l'itinéraire. | Oui, avec options | Oui, avec options | Oui, avec options | Oui, avec options | Non | 
| Points de traçage | Tracé GPS qui inclut les informations de position historiques émises par un mode de déplacement. Ces positions incluent des inexactitudes et des lacunes typiques du GPS lorsque l'appareil ne pouvait pas émettre ou enregistrer ces informations. | Non | Non | Non | Non | Oui, avec options | 

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

Fournit des options permettant de personnaliser le comportement de routage pour les points de cheminement, les origines et les destinations.

**Options de points de cheminement**


| Paramètre | Description | Routes | Matrice des itinéraires | Isoline | Optimisez le point de cheminement | Snap To Road | 
| --- | --- | --- | --- | --- | --- | --- | 
| AvoidActionsForDistance | Évite les actions correspondant à la distance indiquée. Généralement utilisé pour s'assurer que les conducteurs ont suffisamment de temps pour prendre des décisions à proximité des points de cheminement. | Oui | Non | Non | Non | Non | 
| Éviter UTurns | Spécifie si les demi-tours sont autorisés au point de cheminement. | Oui | Non | Non | Non | Non | 
| Titre | Cap sur le GPS à la position du point de cheminement. | Oui | Non | Non | Oui | Non | 
| Correspondance | Options pour configurer l'adaptation de la position fournie au réseau routier. | Oui, avec options | Non | Non | Non | Non | 
| SideOfStreet | Spécifie le côté de la rue correspondant à la position du point de cheminement. | Oui, avec options | Non | Non | Oui, avec options | Non | 
| StopDuration | Durée de l'arrêt à la position du point de cheminement. | Oui | Non | Non | Non | Non | 
| Position | Longitude et latitude du point de cheminement. | Oui | Non | Non | Oui | Non | 
| PassThrough | Détermine si le point de cheminement doit être traité comme un arrêt ou être franchi. | Oui | Non | Non | Non | Non | 
| Id | Chaîne d'identification du point de cheminement. | Non | Non | Non | Oui | Non | 
| AccessHours | Spécifie les heures d'accès pour visiter la destination. | Non | Non | Non | Oui | Non | 
| AppointmentTime | Heure de rendez-vous prévue au point de passage. | Non | Non | Non | Oui | Non | 
| ServiceDuration | Temps de service au point de passage, tel que la durée d'un rendez-vous. | Non | Non | Non | Oui | Non | 
| Avant | Définit quels points de cheminement doivent être visités après celui-ci. | Non | Non | Non | Oui | Non | 

**Options d'origine**


| Paramètre | Description | Routes | Matrice des itinéraires | Isoline | Optimisez le point de cheminement | Snap To Road | 
| --- | --- | --- | --- | --- | --- | --- | 
| AvoidActionsForDistance | Évite les actions correspondant à la distance indiquée. | Oui | Oui | Oui | Non | Non | 
| Éviter UTurns | Spécifie si les demi-tours sont autorisés à l'origine. | Oui | Non | Non | Non | Non | 
| Titre | Cap GPS à la position d'origine. | Oui | Oui | Oui | Non | Non | 
| Correspondance | Options permettant de faire correspondre la position d'origine au réseau routier. | Oui, avec options | Oui, avec options | Oui, avec options | Non | Non | 
| SideOfStreet | Spécifie le côté de la rue correspondant à la position d'origine. | Oui, avec options | Oui, avec options | Oui, avec options | Non | Non | 
| Id | Chaîne d'identification de l'origine. | Non | Non | Oui | Non | Non | 

**Options de destination**


| Paramètre | Description | Routes | Matrice des itinéraires | Isoline | Optimisez le point de cheminement | Snap To Road | 
| --- | --- | --- | --- | --- | --- | --- | 
| AvoidActionsForDistance | Évite les actions pour la distance indiquée à destination. | Oui | Oui | Oui | Non | Non | 
| Éviter UTurns | Spécifie si les demi-tours sont autorisés à destination. | Oui | Non | Non | Non | Non | 
| Titre | Orientation GPS vers la position de destination. | Oui | Oui | Oui | Oui | Non | 
| Correspondance | Options permettant de faire correspondre la position de destination au réseau routier. | Oui, avec options | Oui, avec options | Oui, avec options | Non | Non | 
| SideOfStreet | Spécifie le côté de la rue correspondant à la position de destination. | Oui, avec options | Oui, avec options | Oui, avec options | Oui, avec options | Non | 
| StopDuration | Durée de l'escale à destination. | Oui | Non | Non | Non | Non | 
| Id | Chaîne d'identification de la destination. | Non | Non | Oui | Non | Non | 
| AccessHours | Spécifie les heures d'accès pour visiter la destination. | Non | Non | Oui | Non | Non | 
| AppointmentTime | Heure de rendez-vous prévue à destination. | Non | Non | Oui | Non | Non | 
| ServiceDuration | Temps de service à destination, tel que la durée d'un rendez-vous. | Non | Non | Oui | Non | Non | 

# Quand (départ et arrivée)
<a name="concepts-when"></a>

Spécifie l'heure de calcul de l'itinéraire. L'heure détermine non seulement les horodatages de départ et d'arrivée, mais influence également les données de trafic à utiliser.


| Paramètre | Description | Routes | Matrice des itinéraires | Isoline | Optimisez le point de cheminement | Snap To Road | 
| --- | --- | --- | --- | --- | --- | --- | 
| Heure de départ | Heure de départ de l'Origin. Si ni l'heure d'arrivée ni l'heure de départ ne sont fournies, les informations dynamiques sur le trafic ne sont pas utilisées et seules les vitesses de libre circulation basées sur l'historique du trafic sont appliquées. | Oui | Oui | Oui | Oui | Non | 
| Partez maintenant | Utilise l'heure actuelle comme heure de départ de l'origine. | Oui | Oui | Oui | Non | Non | 
| Heure d'arrivée | Heure d'arrivée à destination. Si ni l'heure d'arrivée ni l'heure de départ ne sont fournies, les informations dynamiques sur le trafic ne sont pas utilisées et seules les vitesses de libre circulation basées sur l'historique du trafic sont appliquées. | Oui | Non | Oui | Non | Non | 

# Comment (mode de déplacement, évitement et exclusion)
<a name="concepts-how"></a>

Utilisez les options suivantes pour spécifier le mode de déplacement et les fonctionnalités associées à utiliser pour le calcul de l'itinéraire.

**Options du mode de voyage**

Spécifie le mode de transport lors du calcul d'un itinéraire. Ce paramètre influence la vitesse de déplacement estimée, la compatibilité routière et l'utilisation potentielle des ferries en cas de besoin.


| Paramètre | Description | Routes | Matrice des itinéraires | Isoline | Optimisez le point de cheminement | Snap To Road | 
| --- | --- | --- | --- | --- | --- | --- | 
| Car | Mode de déplacement en voiture. | Oui, avec options | Oui, avec options | Oui, avec options | Oui | Oui | 
| Scooter | Mode de déplacement en scooter. | Oui, avec options | Oui | Oui, avec options | Oui | Oui | 
| Piéton | Mode de voyage à pied. | Oui, avec options | Oui | Oui | Oui, avec options | Oui | 
| Camion | Mode de déplacement en camion. | Oui, avec options | Oui, avec options | Oui, avec options | Oui, avec options | Oui, avec options | 

**Options d'évitement, d'exclusion et d'autorisation**

Détermine si un ensemble spécifique de fonctionnalités doit être inclus, exclu ou évité lors du calcul de l'itinéraire.


| Paramètre | Description | Routes | Matrice des itinéraires | Isoline | Optimisez le point de cheminement | Snap To Road | 
| --- | --- | --- | --- | --- | --- | --- | 
| Évitement | Fonctionnalités qui sont évitées dans le meilleur des cas. Si le routeur ne trouve pas d'itinéraire valide, l'évitement sera ignoré et un avis indiquera que l'évitement n'a pas pu être respecté. | Oui, avec options | Oui, avec options | Oui, avec options | Oui, avec options | Non | 
| Exclusion | Fonctionnalités strictement exclues. Si le routeur ne trouve pas de route valide avec les options d'exclusion, aucune route n'est renvoyée. | Oui, avec options | Oui, avec options | Non | Non | Non | 
| Autorisation | Fonctionnalités qui doivent être explicitement activées. | Oui, avec options | Oui, avec options | Oui, avec options | Oui, avec options | Non | 

**Liste des évitement**

Répertorie les fonctionnalités qui sont évitées dans le meilleur des cas. Si le routeur ne trouve pas d'itinéraire valide, l'évitement sera ignoré et un avis indiquera que l'évitement n'a pas pu être respecté.


| Paramètre | Description | Routes | Matrice des itinéraires | Isoline | Optimisez le point de cheminement | Snap To Road | 
| --- | --- | --- | --- | --- | --- | --- | 
| Zones | Zones à éviter, sauf exception. | Oui, avec options | Oui, avec options | Oui, avec options | Oui, avec options | Non | 
| Autoroutes à accès contrôlé | Routes à grande vitesse avec points d'entrée limités. | Oui | Oui | Oui | Oui | Non | 
| Trains-navettes | Trains transportant des véhicules dans des tunnels. | Oui | Oui | Oui | Non | Non | 
| Chemins de terre | Routes non pavées avec surfaces naturelles. | Oui | Oui | Oui | Oui | Non | 
| Ferries | Bateaux transportant des véhicules sur des plans d'eau | Oui | Oui | Oui | Non | Non | 
| Bateaux-ferries | Ferries transportant des véhicules sur les voies ferrées. | Non | Non | Oui | Oui | Non | 
| Ferries ferroviaires | Ferries transportant des véhicules sur les voies ferrées. | Non | Non | Oui | Oui | Non | 
| Fermeture saisonnière | Les routes sont fermées pendant certaines saisons. | Oui | Non | Oui | Non | Non | 
| Tunnels | Passages souterrains pour la circulation automobile. | Oui | Oui | Oui | Oui | Non | 
| Route à péage | Routes payantes pour y accéder. | Oui | Oui | Oui | Oui | Non | 
| Transpondeurs de péage | Évite les routes où les transpondeurs de péage sont les seuls moyens de paiement. | Oui | Non | Oui | Non | Non | 
| Virages en U | Points permettant aux véhicules de tourner en sens inverse. | Oui | Oui | Oui | Oui | Non | 
| Catégories de zones | Catégories de zones à éviter. | Oui | Oui | Oui | Non | Non | 

**Liste des exclusions**

Répertorie les fonctionnalités strictement exclues. Si le routeur ne trouve pas de route valide avec les options d'exclusion, aucune route n'est renvoyée.


| Paramètre | Description | Routes | Matrice des itinéraires | Isoline | Optimisez le point de cheminement | Snap To Road | 
| --- | --- | --- | --- | --- | --- | --- | 
| Pays | Code de pays 2 ou 3 pour les pays qui doivent être strictement exclus du calcul de l'itinéraire. | Oui | Oui | Non | Oui | Non | 

**Liste des autorisations**

Répertorie les fonctionnalités qui doivent être explicitement activées pour le calcul de l'itinéraire.


| Paramètre | Description | Routes | Matrice des itinéraires | Isoline | Optimisez le point de cheminement | Snap To Road | 
| --- | --- | --- | --- | --- | --- | --- | 
| VOM | Permettre l'utilisation des voies réservées aux véhicules à forte fréquentation pour le calcul de l'itinéraire. | Oui | Oui | Oui | Non | Non | 
| CHAUD | Permettre l'utilisation des voies à péage très fréquentées pour le calcul de l'itinéraire. | Oui | Oui | Oui | Non | Non | 

# Sensibilisation au trafic
<a name="concepts-traffic-awareness"></a>

Détermine le type d'informations relatives au trafic utilisées lors du calcul de l'itinéraire. Le trafic de flux représente la congestion, à l'exclusion de la congestion à long terme liée à un incident. La précision des données relatives aux flux de trafic diminue au fil du temps, ce qui rend les données de trafic historiques plus fiables pour les événements passés.


| Paramètre | Description | Routes | Matrice des itinéraires | Isoline | Optimisez le point de cheminement | Snap To Road | 
| --- | --- | --- | --- | --- | --- | --- | 
| Utilisation | Activez ou désactivez les données de trafic lors du calcul de l'itinéraire. Lorsqu'elles sont activées, qu'`DepartNow`elles soient fournies ou non, seules les fermetures à long terme seront prises en compte. `DepartureTime` `ArrivalTime` Dans le cas contraire, si une heure est indiquée, toutes les données relatives au trafic sont prises en compte. | Oui | Oui | Oui | Oui | Non | 
| FlowEventThresholdOverride | Durée en secondes pendant laquelle un événement de trafic de flux est considéré comme valide. Bien qu'elles soient valides, les données de trafic de flux seront utilisées par rapport aux données de trafic historiques. | Oui | Oui | Oui | Non | Non | 

# Optimisez l'itinéraire et la séquence des points de cheminement
<a name="optimize-route-waypoint"></a>

## Optimisez le routage
<a name="optimize-routing"></a>

Critères d'optimisation pour le calcul d'un itinéraire. Il peut s'agir de l'itinéraire le plus rapide mesuré par le temps ou de l'itinéraire le plus court mesuré par la distance.


| Option | Description | Mesure | 
| --- | --- | --- | 
| Itinéraire le plus rapide | Calculez l'itinéraire le plus rapide en vous concentrant sur la réduction du temps de trajet. Cela prend en compte les conditions de circulation, les limites de vitesse sur les routes et d'autres facteurs. | Heure | 
| Itinéraire le plus court | Calculez l'itinéraire le plus court en minimisant la distance parcourue. Ceci est souvent utilisé lorsque la distance est le facteur clé, comme la réduction des coûts de carburant ou des émissions. | Distance | 

## Optimisez le point de cheminement
<a name="optimize-waypoint"></a>

Critères d'optimisation pour le séquençage des points de cheminement sur un itinéraire. 

# Horaires et avis destinés aux conducteurs
<a name="driver-schedule-notices"></a>

## Horaire des chauffeurs
<a name="driver-schedule"></a>

Paramètres du conducteur pour définir les horaires de travail et de repos. Cela est obligatoire pour de nombreuses juridictions.


| Paramètre | Description | Routes | Matrice des itinéraires | Isoline | Optimisez le Waypoint | Snap To Road | 
| --- | --- | --- | --- | --- | --- | --- | 
| Cycles de repos personnalisés | Cycles de repos définis par la durée du trajet, suivis d'une durée de repos. Un nombre quelconque de cycles de ce type peut être fourni. | Oui, avec options | Non | Non | Non | Non | 
| Cycle de repos long et cycle de repos court | Cycles de repos définis par cycle court et cycle long. Une courte durée de conduite est suivie d'une courte durée de repos. Les trajets courts peuvent être répétés jusqu'à ce qu'une longue durée de trajet soit atteinte, date à laquelle la longue durée de repos est appliquée. | Non | Non | Non | Oui, avec options | Non | 

## Avis, avertissements et restrictions
<a name="notices-warnings-constraints"></a>

Informations supplémentaires qui donnent un aperçu des décisions prises lors du calcul de l'itinéraire.


| Paramètre | Description | Routes | Matrice des itinéraires | Isoline | Optimisez le Waypoint | Snap To Road | 
| --- | --- | --- | --- | --- | --- | --- | 
| Notifications | Avis concernant le calcul de l'itinéraire. Cela peut également avoir un impact sur l'avis indiquant si les résultats du calcul de l'itinéraire peuvent être utilisés tels quels ou devront être inspectés manuellement avant utilisation. | Oui, avec des détails | Non | Non | Non | Oui | 
| FailedConstraints | Contraintes fournies dans la demande qui n'ont pas pu être satisfaites, ce qui a entraîné l'échec du problème d'optimisation. | Non | Non | Non | Oui, avec des détails | Non | 

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

Les itinéraires fournissent des fonctionnalités permettant de calculer des chemins optimisés entre les sites. Ces fonctionnalités prennent en charge les applications nécessitant une planification logistique, des calculs de distance et une optimisation des itinéraires. Les utilisateurs peuvent également fixer des points de position sur les routes pour une meilleure précision. Pour plus d'informations, voir[Routes Amazon Location Service](routes.md).
+ **CalculateIsolines**: Génère des isolignes en fonction du temps ou de la distance parcourus, utiles pour définir les zones de service ou les zones d'accessibilité. Pour plus d'informations, voir[Calculer les isolignes](calculate-isolines.md).
+ **CalculateRouteMatrix**: Fournit une matrice des distances et des temps de trajet entre plusieurs points de départ et de destination, facilitant la logistique et la planification des voyages. Pour plus d'informations, voir[Calculer la matrice d'itinéraires](calculate-route-matrix.md).
+ **CalculateRoutes**: calcule les itinéraires optimisés pour la navigation à arrêts multiples point-to-point ou la navigation à arrêts multiples, y compris les préférences d'itinéraire personnalisables. Pour plus d'informations, voir[Calculez les itinéraires](calculate-routes.md).
+ **OptimizeWaypoints**: Optimise l'ordre des points de cheminement pour l'itinéraire le plus efficace, en minimisant la distance ou le temps. Pour plus d'informations, voir[Optimisez les points de cheminement](actions-optimize-waypoints.md).
+ **SnapToRoads**: Aligne les coordonnées sur les trajectoires routières les plus proches, améliorant ainsi la précision du GPS en repérant des points sur des routes connues. Pour plus d'informations, voir[Snap to Roads](snap-to-roads.md).

Le tableau suivant présente un certain nombre de cas d'utilisation commerciale qu'il est préférable de résoudre avec Routes APIs.


| **Besoins commerciaux** | **API utile** | **Exemples** | 
| --- | --- | --- | 
| **Calculez la distance et le temps de trajet pour un point de départ et une destination**Prend en charge : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` |  | 
| **Trouver une polyligne d'itinéraire pour une origine et une destination**Prend en charge : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` |  | 
| **Trouvez des itinéraires étape par étape pour un point de départ et une destination**Prend en charge : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` |  | 
| **Trouvez un itinéraire en partant dès maintenant**Prend en charge : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` |  | 
| **Trouvez un itinéraire si vous partez à une heure précise**Prend en charge : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` |  | 
| **Trouvez un itinéraire si vous devez arriver à une heure précise**Prend en charge : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` |  | 
| **Trouvez les itinéraires les plus courts**Prend en charge : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` |  | 
| **Trouvez les itinéraires les plus rapides**Prend en charge : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` |  | 
| **Trouvez des itinéraires alternatifs**Prend en charge : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` |  | 
| **Trouvez des itinéraires sensibles au trafic**Prend en charge : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` |  | 
| **Trouvez des itinéraires évitables tels que le péage, le demi-tour, le ferry, l'autoroute, le tunnel, etc.**Prend en charge : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` |  | 
| **Trouvez des itinéraires avec un évitement personnalisé en passant par une polyligne ou un polygone**Prend en charge : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` |  | 
| **Calculer le coût du péage**Prend en charge : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` | [Calculer le coût du péage](calculate-toll-cost.md) | 
| **Trouver la limite de vitesse d'une section de route sur un itinéraire**Prend en charge : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` |  | 
| **Tracez un itinéraire sur une carte**Supporte le marquage des points de cheminement. | `GetTile`et `GetStyleDescriptor` avec le moteur de rendu (MapLibre) avec Calculer l'itinéraire  |  | 
| **Calculer la matrice d'itinéraires en fonction de la distance et du temps pour plusieurs origines et destinations**Prend en charge :[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/location/latest/developerguide/choose-routes-apis.html) | `CalculateRouteMatrix` | [Comment calculer une matrice d'itinéraires de distance et de temps pour plusieurs origines et destinations](calculate-route-matrix-distance.md) | 
| **Calculer la matrice d'itinéraires avec évitement**Prend en charge :[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/location/latest/developerguide/choose-routes-apis.html) | `CalculateRouteMatrix` | [Comment calculer la matrice d'itinéraires avec évitement](calculate-route-matrix-with-avoidance.md) | 
| **Calculer une zone de desserte en fonction du temps (isochrones)**Supporte les modes de déplacement tels que le camion, le piéton, la voiture et le scooter.  | `CalculateIsolines` | [Comment calculer une zone de desserte en fonction de plages temporelles](calculate-service-area-based-on-time.md) | 
| **Calculer une zone de desserte en fonction de la distance (isodistance)**Supporte les modes de déplacement tels que le camion, le piéton, la voiture et le scooter.  | `CalculateIsolines` |  | 
| **Calculez une zone de service avec évitement**Supporte les modes de déplacement tels que le camion, le piéton, la voiture et le scooter.  | `CalculateIsolines` |  | 
|  **Calculer une zone de desserte en sens inverse** Supporte les modes de déplacement tels que le camion, le piéton, la voiture et le scooter.  | `CalculateIsolines` |  | 
|  **Calculer la zone de desserte pour plusieurs plages de temps ou de distance** Supporte les modes de déplacement tels que le camion, le piéton, la voiture et le scooter.  | `CalculateIsolines` |  | 
| **Optimisation des points de cheminement pour les itinéraires (problème de vendeur itinérant)** Supporte les modes de déplacement tels que le camion, le piéton, la voiture et le scooter.  | `OptimizeWaypoint` | [Comment optimiser les points de cheminement d'un itinéraire](optimize-waypoints.md) | 
| **Optimisez les points de cheminement pour un itinéraire en tenant compte du trafic** Supporte les modes de déplacement tels que le camion, le piéton, la voiture et le scooter.  | `OptimizeWaypoint` |  | 
| **Optimisez les points de cheminement pour un itinéraire en connaissant les heures d'accès** Supporte les modes de déplacement tels que le camion, le piéton, la voiture et le scooter. | `OptimizeWaypoint` |  | 
| **Associer les traces GPS au réseau routier**Supporte les modes de déplacement tels que le camion, le piéton, la voiture et le scooter. | Prenez rapidement la route  | [Comment associer les traces GPS à un réseau routier](how-to-match-gps-traces.md) | 
| **Visualisez les traces GPS correspondantes sur une carte**Supporte les modes de déplacement tels que le camion, le piéton, la voiture et le scooter. | `GetStyleDescriptor`avec moteur de rendu (MapLibre) avec Snap to road  |  | 

# Calculez les itinéraires
<a name="calculate-routes"></a>

L'API Routes calcule les itinéraires entre deux ou plusieurs destinations avec ou sans évitement pour différents modes de déplacement tels que la voiture, le camion, le scooter et le piéton. Avec cette API, vous pouvez personnaliser les options de routage et demander des informations supplémentaires relatives à l'itinéraire pour répondre à des besoins spécifiques. Cette API prend en charge turn-by-turn la navigation et personnalise le calcul des itinéraires en appliquant des paramètres tels que l'évitement des routes à péage, des autoroutes ou des ferries. L'API indique également les limites de vitesse et les frais de péage.

Pour plus d'informations, consultez [CalculateRoutes](https://docs.aws.amazon.com/location/latest/APIReference/API_CalculateRoutes.html)le manuel *Amazon Location Service API Reference*.

Pour des exemples de requêtes, de réponses, de cURL et de commandes CLI pour cette API, consultez [Comment utiliser Calculate](https://docs.aws.amazon.com/location/latest/developerguide/calculate-routes-how-to.html) routes.

![\[Vue d'ensemble des itinéraires d'Amazon Location Service.\]](http://docs.aws.amazon.com/fr_fr/location/latest/developerguide/images/routesV2/P2P-Turn-by-turn-navigation.gif)


## Cas d’utilisation
<a name="use-cases"></a>
+ **Afficher les détails géographiques sur une carte routière :** utilisez les fonctionnalités de cartographie avancées pour visualiser des itinéraires détaillés avec des informations géographiques riches, notamment des points de repère, le terrain et les infrastructures urbaines. Améliorez la prise de décision en permettant aux utilisateurs de visualiser des itinéraires clairs entre leur point de départ et leur destination. Cette fonctionnalité peut prendre en charge la navigation, la planification et divers scénarios logistiques, et afficher les itinéraires pour les modes de transport tels que les voitures, les camions, les scooters et les piétons. Personnalisez les itinéraires en ajoutant des éléments tels que les évitements ou le calcul des péages.
+ **Afficher la turn-by-turn navigation : offrez** un support de navigation fluide sur le Web et les appareils mobiles. Les utilisateurs peuvent accéder aux turn-by-turn itinéraires, ce qui garantit des déplacements efficaces. Les deux plateformes peuvent exploiter les instructions de navigation pour proposer des itinéraires pour les déplacements personnels ou professionnels, y compris les limites de vitesse.
+ **Calculez les coûts de péage le long des itinéraires :** intégrez le calcul des coûts de péage à la planification des itinéraires afin de fournir des estimations de prix précises pour les itinéraires comprenant des routes à péage, des ponts ou des tunnels. Affichez les coûts de péage à l'avance pour aider les conducteurs et les planificateurs à prendre des décisions rentables et à éviter les péages lorsque cela est nécessaire.
+ **Garantir le respect des limites de vitesse :** intégrez les données relatives aux limites de vitesse pour aider les conducteurs à respecter les limites légales, en réduisant le risque d'amendes et en promouvant une conduite plus sûre et économe en carburant. La logistique et la gestion de flotte peuvent également bénéficier du suivi du respect des délais en temps réel.
+ **Contribuer aux solutions d'acheminement du fret et des véhicules :** Simplifiez les opérations d'acheminement du fret et des véhicules en intégrant les itinéraires, la navigation et les fonctionnalités de suivi dans les portails logistiques. Planifiez efficacement les itinéraires pour plusieurs livraisons, suivez les envois en temps réel et gérez les coûts de carburant grâce à un meilleur acheminement.

## Comprendre la demande
<a name="understanding-request"></a>

**Note**  
 Pour les clients inscrits dans `ap-southeast-1` et`ap-southeast-5`, les champs de demande et de réponse pris en charge peuvent différer. Reportez-vous à la [référence de CalculateRoutes l'API](https://docs.aws.amazon.com/location/latest/APIReference/API_CalculateRoutes.html) pour plus de détails. 

La demande nécessite `Origin` des `Destination` paramètres, tandis que des paramètres facultatifs tels que `Allow``Avoid`, et `Traffic` personnalisent l'itinéraire pour répondre à des besoins et à des contraintes spécifiques.

**Origin**  
Position de départ de l'itinéraire en longitude et en latitude.

**Destination**  
Position finale de l'itinéraire.

**Points de cheminement**  
Positions intermédiaires à inclure le long d'un itinéraire entre les positions de départ et d'arrivée.

**OptimizeRoutingFor**  
Critères d'optimisation de l'itinéraire, tels que le plus rapide ou le plus court.

**LegGeometryFormat**  
Format de la géométrie renvoyée pour chaque étape du parcours.

**Éviter**  
Caractéristiques à éviter lors du calcul de l'itinéraire, ignorées si aucun itinéraire alternatif n'est trouvé.

**Trafic**  
Options liées au trafic affectant le calcul de l'itinéraire.

**Péages**  
Les options liées au péage ont une incidence sur le calcul des itinéraires et les coûts des péages.

**LegAdditionalFeatures**  
Fonctionnalités qui peuvent être activées dans le cadre de la réponse pour chaque étape du trajet.

**SpanAdditionalFeatures**  
Fonctionnalités Span qui peuvent être activées dans le cadre de la réponse pour chaque étape du trajet.

## Comprendre la réponse
<a name="understanding-response"></a>

La réponse fournit des informations détaillées sur l'itinéraire, telles que les étapes du trajet, des informations relatives au calcul de l'itinéraire et des informations récapitulatives, notamment la distance et la durée.

**Itinéraires**  
Tableau d'itinéraires contenant des tronçons et les propriétés associées.

**Avis**  
Avertissements ou messages d'information concernant l'itinéraire.

**LegGeometryFormat**  
Spécifie le format de la géométrie de l'itinéraire.

### Détails des jambes
<a name="leg-details"></a>

Chaque étape d'un voyage peut être de type ferry, piéton ou véhicule selon le mode de transport. Bien que chaque étape contienne des propriétés indépendantes du mode de transport, des propriétés spécifiques peuvent être trouvées ci-dessous :

**FerryLegDetails**  
Propriétés spécifiques au ferry pour la jambe.

**VehicleLegDetails**  
Propriétés spécifiques au véhicule pour la jambe.

**PedestrianLegDetails**  
Propriétés spécifiques aux piétons pour la jambe.

### Étapes
<a name="steps"></a>

Chaque étape d'un trajet est divisée en étapes qui décrivent les actions à effectuer pour certaines parties de l'itinéraire. Une étape peut être soit par défaut, adaptée aux applications de base TurnByTurn, soit adaptée à turn-by-turn la navigation. Chaque étape contient des propriétés indépendantes du type d'étape, telles que la durée et la distance, ainsi que d'autres propriétés spécifiques ExitStepDetails, qui s'appliquent uniquement aux étapes de sortie.

**BeforeTravelSteps**  
Étapes à suivre avant de commencer le voyage.

**TravelSteps**  
Étapes à suivre pendant le trajet.

**AfterTravelSteps**  
Étapes à suivre une fois le voyage terminé.

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

Chaque étape d'un voyage peut être divisée en plusieurs étapes. Une travée est une partie de la jambe dont les valeurs sont identiques à celles de l'ensemble demandé`SpanAdditionalFeatures`. Les travées sont divisées par des propriétés routières telles que `SpeedLimit` les noms des routes ou les régions. Les travées renvoyées peuvent être utilisées pour visualiser les attributs des routes et les informations relatives à l'accès.

# Calculer le coût du péage
<a name="calculate-toll-cost"></a>

Cette rubrique fournit une vue d'ensemble des champs et des définitions associés au calcul des coûts de péage. À l'aide de ces champs, vous pouvez définir des paramètres tels que les modes de paiement, la devise et les caractéristiques du véhicule afin de personnaliser le calcul des coûts de péage.


| Nom de champ | Routes | 
| --- | --- | 
| Transpondeurs | Oui, avec options | 
| Vignettes | Oui, avec options | 
| Devise | Oui, avec options | 
| EmissionType | Oui, avec options | 
| VehicleCategory | Oui, avec options | 

## Définitions
<a name="definitions"></a>

Cette section fournit de brèves définitions pour chaque champ utilisé dans le calcul des coûts de péage.

****Transpondeurs****  
Les transpondeurs sont un mode de paiement des péages, ce qui peut entraîner un prix différent par rapport aux autres modes de paiement.

****Vignettes****  
La vignette est une forme de tarification routière. Lorsqu'un utilisateur possède la vignette requise, aucun paiement de péage supplémentaire n'est nécessaire.

****Devise****  
Devise dans laquelle les frais de péage sont déclarés. Outre la devise locale, une devise convertie est incluse, ce qui a également une incidence sur la devise utilisée dans le récapitulatif des péages inclus dans la réponse.

****EmissionType****  
Type d'émission du véhicule, utilisé pour calculer les coûts de péage en fonction des émissions du véhicule.

****VehicleCategory****  
Sous-catégorie de véhicules utilisée pour le calcul du coût du péage.

# Comprendre les étapes de l'itinéraire
<a name="understanding-route-steps"></a>

Cette section définit les différentes actions et étapes à suivre pour terminer une étape d'un voyage. Les étapes de l'itinéraire varient selon le mode de déplacement et fournissent des conseils à la fois pour les applications de présentation générale et pour turn-by-turn la navigation détaillée.

## Aperçu des étapes de l'itinéraire
<a name="route-steps-overview"></a>

Les types d'étapes d'itinéraire suivants définissent les actions nécessaires pour effectuer une étape, en fonction du mode de déplacement et de l'étape du trajet.


| **Type d'étape** | **Description** | 
| --- | --- | 
| Default steps | Étapes de base fournissant des instructions lisibles par l'homme, souvent utilisées dans les applications Web pour offrir une vue d'ensemble de l'itinéraire. | 
| Turn by turn steps | Étapes détaillées pour créer une application de turn-by-turn navigation proposant des instructions plus détaillées. | 
| Before travel steps | Étapes à suivre avant de commencer la section voyage, telles que monter à bord d'un ferry. | 
| After travel steps | Étapes à suivre une fois la section voyage terminée, comme débarquer d'un ferry. | 

## Répartition des étapes par mode de déplacement
<a name="route-step-types"></a>


| **Rubrique** | **Step (Étape)** | **Avant le voyage** | **Voyage** | **Après le voyage** | 
| --- | --- | --- | --- | --- | 
| Véhicule | Arriver | Non | Oui | Non | 
| Véhicule | Continuer | Non | Oui | Non | 
| Véhicule | ContinueHighway | Non | Oui | Non | 
| Véhicule | Départ | Non | Oui | Non | 
| Véhicule | Quitter | Non | Oui | Non | 
| Piéton | Arriver | Non | Oui | Non | 
| Piéton | Opération payante | Non | Oui | Non | 
| Ferry | Attente | Non | Non | Oui | 
| Ferry | Planche | Oui | Non | Non | 
| Ferry | Débarquer | Non | Non | Oui | 

# Calculer la matrice d'itinéraires
<a name="calculate-route-matrix"></a>

Le service Matrix Routing calcule les matrices de routage, fournissant les temps de trajet ou les distances entre plusieurs origines et destinations. Ce service propose des options de personnalisation flexibles, vous permettant de spécifier les modes de déplacement, les conditions de circulation et d'autres paramètres d'itinéraire. Les calculs matriciels peuvent varier en taille et en forme, prendre en charge des matrices carrées et non carrées, et prendre en compte des données de trafic dynamiques ou à flux libre.

Pour plus d'informations, consultez [CalculateRouteMatrix](https://docs.aws.amazon.com/location/latest/APIReference/API_CalculateRouteMatrix.html)le manuel *Amazon Location Service API Reference*.

Pour des exemples de requêtes, de réponses, de cURL et de commandes CLI pour cette API, consultez [Comment utiliser Calculate route matrix](https://docs.aws.amazon.com/location/latest/developerguide/calculate-route-matrix-how-to.html).

## Cas d’utilisation
<a name="route-matrix-use-cases"></a>
+ **Optimisez les itinéraires de livraison pour la logistique et le commerce électronique :** calculez efficacement le temps de trajet et la distance entre plusieurs points de collecte et de livraison afin d'optimiser les itinéraires. Les entreprises de logistique peuvent utiliser cette fonctionnalité pour minimiser les coûts et les délais de livraison en planifiant des trajets efficaces à travers les villes. Il est idéal pour définir des fenêtres de livraison optimisées pour les services le jour même ou le jour suivant et pour planifier des itinéraires de livraison à plusieurs escales.
+ **Associez les conducteurs et les passagers dans les applications de covoiturage :** utilisez les calculs d'itinéraires pour associer les conducteurs aux passagers les plus proches en trouvant l'itinéraire le plus rapide entre les destinations. Les applications de covoiturage peuvent améliorer l'expérience utilisateur en fournissant des estimations d'arrivée des chauffeurs en temps réel, garantissant ainsi un ramassage et un dépôt rapides. Supporte différents modes de transport tels que les voitures, les vélos et les scooters.
+ **Planifiez et optimisez les itinéraires pour la gestion de flottes :** gérez de grandes flottes en optimisant les itinéraires afin de réduire la consommation de carburant et le temps de trajet. Les gestionnaires de flotte peuvent attribuer les itinéraires les plus efficaces aux véhicules pour plusieurs arrêts, augmentant ainsi l'efficacité opérationnelle globale. Les cas d'utilisation incluent les flottes de services, les entreprises de transport et les services publics où une planification d'itinéraire optimale est essentielle pour les visites sur site.

## Comprendre la demande
<a name="route-matrix-request"></a>

**Note**  
 Pour les clients inscrits dans `ap-southeast-1` et`ap-southeast-5`, les champs de demande et de réponse pris en charge peuvent différer. Reportez-vous à la [référence de CalculateRouteMatrix l'API](https://docs.aws.amazon.com/location/latest/APIReference/API_CalculateRouteMatrix.html) pour plus de détails. 

La demande inclut les **origines** et les **destinations** pour le calcul des itinéraires, avec des paramètres facultatifs pour adapter la matrice en fonction des préférences et des contraintes. Pour plus de détails, reportez-vous à la référence d'API pour l'API Calculate Route Matrix.
+ `Origins`: Liste des coordonnées d'origine en longitude et en latitude.
+ `Destinations`: Liste des coordonnées de destination.
+ `OptimizeRoutingFor`: critères d'optimisation tels que l'itinéraire « le plus rapide » ou « le plus court ».
+ `RoutingBoundary`: définit les limites pour le calcul, soit comme « illimitées », soit limitées à une géométrie spécifique.
+ `Avoid`: Caractéristiques à éviter lors du calcul de l'itinéraire. Ignoré si aucun itinéraire viable n'est trouvé.
+ `Traffic`: Les options liées au trafic ont une incidence sur le calcul des itinéraires.

## Comprendre la réponse
<a name="route-matrix-response"></a>

La réponse inclut une matrice d'itinéraires calculés entre les origines et les destinations, avec des détails tels que la distance et la durée. Les erreurs et les limites des itinéraires sont également fournies, le cas échéant. Reportez-vous à la référence de l'API pour plus de détails sur l'API Calculate Route Matrix.
+ `RouteMatrix`: Matrice contenant les distances de trajet (en mètres) et les durées (en secondes) entre les origines et les destinations.
+ `ErrorCount`: nombre d'erreurs rencontrées lors du calcul de l'itinéraire.
+ `RoutingBoundary`: limite à l'intérieur de laquelle la matrice est calculée.

# Calculer les isolignes
<a name="calculate-isolines"></a>

L'API Calculate Isolines vous permet de déterminer les zones accessibles dans des limites de temps ou de distance spécifiées. En tenant compte de facteurs tels que les restrictions routières, les conditions de circulation et le mode de déplacement, il génère des isolignes qui délimitent les zones accessibles, soutenant ainsi les applications de planification urbaine, de logistique et d'accessibilité des services. Cette API peut être utilisée pour la planification urbaine, l'analyse immobilière et les études d'accessibilité en visualisant la portée des services, les options de transport ou les ressources dans un délai ou une limite de distance définis. En affichant ces isolignes sur une carte, les utilisateurs peuvent évaluer la portée des déplacements en fonction de contraintes spécifiques, ce qui améliore la prise de décision en matière de sélection du site, de couverture des services et d'allocation des ressources.

Pour plus d'informations, consultez [CalculateIsolines](https://docs.aws.amazon.com/location/latest/APIReference/API_CalculateIsolines.html)le manuel *Amazon Location Service API Reference*.

Pour des exemples de requêtes, de réponses, de cURL et de commandes CLI pour cette API, consultez [Comment utiliser Calculate](https://docs.aws.amazon.com/location/latest/developerguide/calculate-isolines-how-to.html) isolignes.

## Cas d’utilisation
<a name="use-cases"></a>
+ **Évaluez l'accessibilité des soins de santé à l'aide d'isolines du temps de trajet :** générez des isolines pour évaluer l'accès aux établissements de santé de différents quartiers en fonction des temps de trajet. Les établissements de santé peuvent utiliser cette fonctionnalité pour identifier les zones mal desservies et prendre des décisions éclairées concernant l'emplacement des cliniques ou les services de santé mobiles, améliorant ainsi l'accès aux soins de santé communautaires.
+ **Analysez la portée du marché pour développer le commerce de détail à l'aide d'isolignes de temps de trajet :** créez des isolignes pour représenter l'accès des clients aux points de vente en fonction des temps de trajet. Les entreprises de vente au détail peuvent évaluer l'emplacement de nouveaux magasins et comprendre la démographie des clients, en utilisant ces visualisations pour développer et optimiser leur potentiel de vente de manière stratégique.
+ **Optimisez la logistique et les zones de livraison avec des isolignes :** générez des isolignes pour définir les zones de livraison en fonction des exigences logistiques urgentes. Les entreprises de logistique peuvent visualiser les zones accessibles dans des délais spécifiques depuis les centres de distribution, améliorant ainsi la planification des itinéraires, l'efficacité opérationnelle et les livraisons en temps opportun.
+ **Planifiez l'accès au tourisme et aux loisirs à l'aide d'isolignes :** visualisez les temps de trajet entre les attractions touristiques et les hébergements situés à proximité. Les offices du tourisme peuvent aider les voyageurs à trouver des options d'hébergement pratiques, à promouvoir les entreprises locales et à améliorer l'expérience de voyage en affichant ces isolignes sur une carte.
+ **Améliorez la planification des interventions d'urgence grâce à des isolignes :** générez des isolignes pour évaluer les temps de réponse entre les sites des services d'urgence et les différentes zones d'une communauté. Les équipes de gestion des urgences peuvent identifier les régions dans les délais de réponse critiques, en optimisant l'allocation des ressources pour améliorer la réponse lors d'incidents.
+ **Analysez les modèles de déplacements pour planifier les effectifs à l'aide d'isolignes :** générez des isolignes pour visualiser les temps de trajet et identifier les zones où les temps de trajet sont élevés. Les entreprises peuvent utiliser ces informations pour définir des politiques de télétravail ou des relocalisations de bureaux, afin d'améliorer la satisfaction et la productivité des employés.

## Comprendre la demande
<a name="understanding-request"></a>

La demande accepte des paramètres tels que `Origin``Destination`, et `Thresholds` pour définir des isolignes. Les paramètres facultatifs, tels que `Allow``Avoid`, et`TravelModeOptions`, permettent de personnaliser les contraintes d'isoligne. Pour de plus amples informations, veuillez consulter .

**Origin**  
Point de départ pour le calcul des isolignes en longitude et en latitude.

**Seuils**  
Limites de temps ou de distance utilisées pour définir la limite de l'isoligne.

**TravelMode**  
Le mode de transport, tel que la voiture, le piéton ou le camion.

**OptimizeIsolineFor**  
Critères d'optimisation, tels que calcul précis, équilibré ou rapide.

**DepartureTime**  
Heure de départ, si spécifiée, pour le calcul des isolignes en fonction du temps.

**ArrivalTime**  
Heure d'arrivée, si spécifiée, pour le calcul des isolignes en fonction du temps.

**IsolineGranularity**  
Le nombre maximum de points et la résolution de la limite de l'isoligne.

## Comprendre la réponse
<a name="understanding-response"></a>

La réponse inclut des isolignes avec des propriétés telles que`IsolineGeometryFormat`, décrivant la zone accessible en fonction des paramètres de la demande.

**Isolines**  
Des isolignes calculées avec des propriétés associées, notamment des géométries et des connexions.

**Géométries**  
Liste des géométries décrivant les limites des isolignes calculées.

**Connexions**  
Connexions entre les géométries d'isolignes, y compris la géométrie de chaque connexion.

# Optimisez les points de cheminement
<a name="actions-optimize-waypoints"></a>

L'API Optimize Waypoints calcule la séquence la plus efficace pour visiter plusieurs points de cheminement le long d'un itinéraire. À l'aide d'algorithmes avancés, cette API minimise le temps et la distance de trajet tout en tenant compte de facteurs tels que les conditions de circulation, les évitements et les spécifications du véhicule. L'intégration de l'API Optimize Waypoints aide les entreprises à rationaliser leurs opérations, à réduire la consommation de carburant, à améliorer l'efficacité des livraisons et à améliorer la satisfaction des clients. L'API fournit des itinéraires optimisés, permettant une meilleure prise de décision et une meilleure allocation des ressources dans les scénarios de voyage à arrêts multiples.

Pour plus d'informations, consultez [OptimizeWaypoints](https://docs.aws.amazon.com/location/latest/APIReference/API_OptimizeWaypoints.html)le manuel *Amazon Location Service API Reference*.

Pour des exemples de requêtes, de réponses, de cURL et de commandes CLI pour cette API, consultez [Comment utiliser Optimize waypoints](https://docs.aws.amazon.com/location/latest/developerguide/optimize-waypoints-how-to.html).

## Cas d’utilisation
<a name="use-cases"></a>
+ **Améliorez l'efficacité des livraisons à arrêts multiples :** optimisez efficacement la séquence des multiples arrêts de livraison afin de réduire le temps de trajet et les coûts. Les services de livraison peuvent rationaliser les opérations en calculant l'itinéraire le plus efficace pour les chauffeurs, en minimisant les dépenses en carburant et en garantissant des livraisons dans les délais, ce qui améliore la satisfaction des clients et l'efficacité opérationnelle.
+ **Rationalisez les opérations de service sur le terrain :** optimisez la séquence des visites sur plusieurs sites de travail en une seule journée, réduisant ainsi le temps de déplacement des techniciens de service sur le terrain. Cela permet aux entreprises d'effectuer un plus grand nombre de tâches par jour, ce qui améliore la productivité et la prestation de services.
+ **Planifiez des itinéraires touristiques efficaces pour les agences de voyages :** optimisez les itinéraires comprenant plusieurs attractions afin de maximiser les visites touristiques tout en minimisant le temps de trajet. Les agences de voyages peuvent utiliser cette fonctionnalité pour créer des plans optimaux pour les visites guidées, améliorant ainsi l'expérience touristique globale en utilisant mieux le temps disponible.
+ **Améliorez l'efficacité des conducteurs de covoiturage :** optimisez les séquences de prise en charge et de dépose pour plusieurs passagers, en réduisant les temps d'attente et en améliorant l'expérience des passagers. Les services de covoiturage peuvent maximiser les revenus des conducteurs et garantir un service rapide aux passagers en optimisant les points de cheminement.
+ **Optimisez les itinéraires pour les services de collecte des déchets :** planifiez les itinéraires de collecte des déchets afin de minimiser la distance et le temps de trajet, ce qui aide les entreprises de gestion des déchets à rationaliser leurs opérations et à garantir une collecte en temps opportun, en réalisant des économies de coûts et en réduisant l'impact environnemental.
+ **Coordonner la logistique des événements et des conférences :** Gérez la logistique du transport pour la livraison d'équipements et de fournitures sur plusieurs sites, en optimisant les itinéraires de chargement et de déchargement. Cela permet aux organisateurs d'événements de rationaliser le transport, de réduire les retards et de garantir l'arrivée du matériel en temps opportun pour les événements.
+ **Améliorez les itinéraires d'intervention d'urgence :** planifiez les itinéraires les plus rapides vers plusieurs urgences, en optimisant les temps de réponse dans les situations critiques. Les services d'urgence peuvent améliorer l'efficacité des interventions et potentiellement sauver des vies en utilisant des points de cheminement optimisés.
+ **Facilitez la planification des itinéraires de vente pour les représentants sur le terrain :** optimisez les itinéraires pour les représentants commerciaux qui visitent plusieurs clients par jour, en minimisant le temps de trajet et en maximisant les visites des clients. Cela aide les entreprises à accroître leur productivité et à tirer parti de nouvelles opportunités de vente.

## Comprendre la demande
<a name="understanding-request"></a>

La demande nécessite des paramètres tels que `Origin` et `Waypoints` pour calculer une séquence optimisée. Des paramètres facultatifs tels que `Avoid``Traffic`, et `Driver` permettent une personnalisation supplémentaire.

**Points de cheminement**  
Une liste de points de cheminement à optimiser en séquence.

**Origin**  
Position de départ de l'itinéraire à optimiser.

**Destination (Destination)**  
Position finale facultative de l'itinéraire à des fins d'optimisation.

**OptimizeSequencingFor**  
Critères d'optimisation du séquençage, tels que l'itinéraire le plus rapide ou le plus court.

**Trafic**  
Options liées au trafic affectant le calcul de l'itinéraire.

**Pilote**  
Cycles de travail et de repos du conducteur pour garantir le respect des réglementations routières régionales.

**Regroupement**  
Le clustering vous permet de spécifier comment les points de cheminement situés à proximité peuvent être regroupés afin d'améliorer la séquence optimisée.

Chaque point de cheminement peut également spécifier des contraintes qui doivent être satisfaites, telles que `AppointmentTime``AccessHours`, et des contraintes de commande comme `Before` un autre point de cheminement.

## Comprendre la réponse
<a name="understanding-response"></a>

La réponse fournit des détails sur la séquence de points de cheminement optimisée, y compris `OptimizedWaypoints` l'ensemble `Distance` et `Duration` pour le trajet. 

**OptimizedWaypoints**  
Une liste de points de cheminement dans leur ordre optimisé.

**ImpedingWaypoints**  
Points de cheminement qui empêchent une séquence optimisée, y compris les contraintes défaillantes qui n'ont pas été respectées.

**Connexions**  
Informations sur les déplacements entre les points de passage, y compris la distance et la durée.

**TimeBreakdown**  
Répartition du total`Travel`, `Rest``Service`, et des `Wait` durées de l'itinéraire.

**ClusterIndex**  
Index du cluster auquel le waypoint est associé. L'index est inclus dans la réponse uniquement si le clustering a été effectué pendant le traitement de la demande.

# Snap to Roads
<a name="snap-to-roads"></a>

L'API Snap to Road améliore la précision du positionnement géographique en alignant les coordonnées GPS sur les segments de route les plus proches sur une carte numérique. Cette API prend des données brutes de longitude et de latitude, souvent collectées à partir d'appareils mobiles ou de véhicules, et « capture » ces points sur le réseau routier correspondant, corrigeant ainsi les inexactitudes causées par la dérive du GPS ou la perte de signal. En intégrant l'API Snap to Road, vous pouvez vous assurer que vos applications fournissent des données fiables et précises, favorisant ainsi une meilleure prise de décision et une meilleure efficacité opérationnelle dans différents scénarios.

Pour plus d'informations, consultez [SnapToRoads](https://docs.aws.amazon.com/location/latest/APIReference/API_SnapToRoads.html)le manuel *Amazon Location Service API Reference*.

Pour des exemples de requêtes, de réponses, de cURL et de commandes CLI pour cette API, consultez [Comment utiliser Snap to Roads](https://docs.aws.amazon.com/location/latest/developerguide/snap-to-roads-how-to.html).

## Cas d’utilisation
<a name="use-cases"></a>
+ **Améliorez la précision de la navigation en accédant au réseau routier :** alignez efficacement les coordonnées GPS sur les tronçons de route les plus proches pour améliorer la précision de la navigation. Cette fonctionnalité est utile pour les services de cartographie et de navigation, car elle fournit aux utilisateurs des indications précises et des mises à jour de localisation en temps réel, améliorant ainsi l'expérience de navigation.
+ **Améliorez la précision des données pour les applications de gestion de flotte :** corrigez les positions signalées des véhicules en enregistrant leurs coordonnées GPS par rapport aux routes les plus proches. Dans les systèmes de gestion de flotte, cette fonctionnalité garantit un suivi précis des véhicules, permettant une logistique optimisée et une meilleure efficacité opérationnelle.

## Comprendre la demande
<a name="understanding-request"></a>

La demande doit correspondre `TracePoints` aux routes, avec des paramètres facultatifs tels que `SnappedGeometryFormat` et `SnapRadius` pour contrôler le format de la géométrie et le rayon de capture.

**TracePoints**  
Une liste de coordonnées à transmettre au réseau routier.

**SnappedGeometryFormat**  
Format de la géométrie renvoyée, tel que « FlexiblePolyline » ou « Simple ».

**SnapRadius**  
Rayon autour des points de traçage à l'intérieur duquel les cassures de route sont prises en compte.

## Comprendre la réponse
<a name="understanding-response"></a>

La réponse contient une géométrie corrigée et des points de trace capturés, avec des propriétés telles que `SnappedGeometry` et `SnappedTracePoints` pour indiquer la précision et la fiabilité de la capture.

**SnappedGeometry**  
Géométrie corrigée de l'itinéraire capturé.

**SnappedTracePoints**  
Les coordonnées ajustées des points de trace ont été capturées sur les routes.

**Avis**  
Avertissements ou messages d'information concernant le processus de capture.

# Procédures
<a name="routes-how-to"></a>

Cette section fournit des guides pour tirer parti des itinéraires pour APIs résoudre les problèmes de routage et de navigation. Ces didacticiels abordent les tâches essentielles pour intégrer les fonctionnalités de routage dans vos applications. Chaque rubrique se concentre sur un cas d'utilisation spécifique, vous permettant de mettre en œuvre efficacement des fonctionnalités de routage avancées adaptées aux besoins de votre entreprise.

**Topics**
+ [Apprenez à utiliser CalculateRoutes](calculate-routes-how-to.md)
+ [Apprenez à utiliser CalculateIsolines](calculate-isolines-how-to.md)
+ [Apprenez à utiliser CalculateRouteMatrix](calculate-route-matrix-how-to.md)
+ [Apprenez à utiliser OptimizeWaypoints](optimize-waypoints-how-to.md)
+ [Apprenez à utiliser SnapToRoads](snap-to-roads-how-to.md)

# Apprenez à utiliser CalculateRoutes
<a name="calculate-routes-how-to"></a>

Cette section fournit des step-by-step instructions d'utilisation`CalculateRoutes`. Cette rubrique fournit des conseils sur la recherche d'itinéraires dotés de configurations spécifiques, telles que l'intégration de la turn-by-turn navigation, la définition des modes de déplacement et l'ajout de points de cheminement.

**Topics**
+ [Comment trouver un itinéraire pour un point de départ et une destination](calculate-routes-origin-destination-waypoints.md)
+ [Comment trouver des itinéraires avec des turn-by-turn indications](how-to-find-turn-by-turn-route.md)
+ [Comment trouver une limite de vitesse pour un tronçon de route](calculate-routes-speed-limit-road.md)
+ [Comment trouver des itinéraires alternatifs](calculate-routes-alternate.md)
+ [Comment calculer les péages pour un itinéraire](calculate-routes-tolls.md)
+ [Comment créer des itinéraires avec évitement personnalisé](calculate-routes-custom-avoidance-poly.md)
+ [Comment créer des itinéraires en évitant de manière personnalisée plusieurs éléments potentiels](calculate-routes-custom-avoidance-multiple.md)
+ [Comment trouver l'itinéraire le plus rapide](calculate-routes-custom-avoidance-fast.md)
+ [Comment trouver les itinéraires les plus courts](calculate-routes-custom-avoidance-shortest.md)

# Comment trouver un itinéraire pour un point de départ et une destination
<a name="calculate-routes-origin-destination-waypoints"></a>

L' CalculateRoutes API vous aide à trouver les meilleurs itinéraires entre le point de départ et la destination, ainsi que les meilleures opportunités pour le repos des conducteurs. Il prend en charge les modes de déplacement tels que le camion, le piéton, la voiture et le scooter. Il prend également en charge jusqu'à 25 points de passage (escales), y compris l'origine et la destination, avec seulement quelques contraintes.

## Cas d'utilisation potentiels
<a name="potential-use-cases"></a>
+ **Trouver des point-to-point itinéraires :** déterminez le meilleur itinéraire entre deux destinations en fonction des différents modes de transport et des options supplémentaires.

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

### Calculez les itinéraires du point d'origine à la destination avec Car 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
```

------

# Comment trouver des itinéraires avec des turn-by-turn indications
<a name="how-to-find-turn-by-turn-route"></a>

L' CalculateRoutes API vous aide à trouver les meilleurs itinéraires entre le point de départ et la destination, ainsi que les meilleures opportunités pour le repos des conducteurs. Il prend en charge les modes de déplacement tels que la voiture, le camion, le piéton et le scooter. Il prend également en charge jusqu'à 25 points de passage (escales), y compris l'origine et la destination, avec seulement quelques contraintes.

## Cas d'utilisation potentiels
<a name="potential-use-cases-turn-by-turn"></a>
+ **Créez une application mobile de navigation :** utilisez l'API pour obtenir des instructions turn-by-turn de navigation.
+ **Afficher les itinéraires sur une plateforme Web :** affichez des indications routières détaillées pour les applications Web afin de vous aider à naviguer.

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

### Calculer des itinéraires en voiture 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"
```

------

# Comment trouver une limite de vitesse pour un tronçon de route
<a name="calculate-routes-speed-limit-road"></a>

L' CalculateRoutes API vous aide à trouver les meilleurs itinéraires entre le point de départ et la destination, ainsi que les meilleures opportunités pour le repos des conducteurs. Il prend en charge les modes de déplacement tels que la voiture, le camion, le piéton et le scooter. Il prend également en charge jusqu'à 25 points de passage (escales), y compris l'origine et la destination, avec seulement quelques contraintes.

## Cas d'utilisation potentiels
<a name="potential-use-cases"></a>
+ **Vérifiez le respect des limites de vitesse :** restez au courant des limites de vitesse et du respect de celles-ci.
+ **Informer le conducteur de la limite de vitesse :** avertit le conducteur de la limite de vitesse lorsqu'il risque de ne pas être clair dans le cas contraire.

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

### Trouvez les limites de vitesse dans Car 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"
```

------

# Comment trouver des itinéraires alternatifs
<a name="calculate-routes-alternate"></a>

L' CalculateRoutes API vous aide à trouver les meilleurs itinéraires entre le point de départ et la destination, ainsi que les meilleures opportunités pour le repos des conducteurs. Il prend en charge les modes de déplacement tels que la voiture, le camion, le piéton et le scooter. Il prend également en charge jusqu'à 25 points de passage (escales), y compris l'origine et la destination, avec seulement quelques contraintes.

## Cas d'utilisation potentiels
<a name="potential-use-cases"></a>
+ **Identifiez des itinéraires alternatifs :** soyez en mesure de choisir le meilleur itinéraire en fonction des besoins de votre entreprise.

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

### Trouvez des itinéraires alternatifs en voiture 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
```

------

# Comment calculer les péages pour un itinéraire
<a name="calculate-routes-tolls"></a>

L' CalculateRoutes API vous aide à trouver les meilleurs itinéraires entre le point de départ et la destination, ainsi que les meilleures opportunités pour le repos des conducteurs. Il prend en charge les modes de déplacement tels que la voiture, le camion, le piéton et le scooter. Il prend également en charge jusqu'à 25 points de passage (escales), y compris l'origine et la destination, avec seulement quelques contraintes.

## Cas d'utilisation potentiels
<a name="potential-use-cases"></a>
+ **Calculez les péages :** soyez en mesure de calculer les coûts des péages lors de la planification de l'itinéraire.
+ **Audit des péages :** être en mesure de vérifier les coûts des péages après un voyage.

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

### Calculez les péages pour vos trajets en voiture 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}'
```

------

# Comment créer des itinéraires avec évitement personnalisé
<a name="calculate-routes-custom-avoidance-poly"></a>

L' CalculateRoutes API vous aide à trouver les meilleurs itinéraires entre le point de départ et la destination, ainsi que les meilleures opportunités pour le repos des conducteurs. Il prend en charge les modes de déplacement tels que la voiture, le camion, le piéton et le scooter. Il prend également en charge jusqu'à 25 points de passage (escales), y compris l'origine et la destination, avec seulement quelques contraintes.

## Cas d'utilisation potentiels
<a name="potential-use-cases"></a>
+ **Calculez les itinéraires avec évitement personnalisé :** personnalisez les itinéraires avec évitement pour de meilleurs itinéraires et une meilleure planification des trajets domicile-travail.

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

### CalculateRoutes À utiliser avec un évitement BoundingBox pour créer des itinéraires personnalisés.
<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]}}]}'
```

------

### Utilisez-le CalculateRoutes avec un polygone d'évitement pour créer des itinéraires personnalisés.
<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]]]}}]}'
```

------

### Utilisez CalculateRoutes with PolylinePolygon pour créer des itinéraires personnalisés.
<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"]}}]}'
```

------

### CalculateRoutes À utiliser avec avoid Corridor pour créer des itinéraires personnalisés.
<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}}}]}'
```

------

### CalculateRoutes À utiliser avec un évitement PolylineCorridor pour créer des itinéraires personnalisés.
<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}}}]}'
```

------

# Comment créer des itinéraires en évitant de manière personnalisée plusieurs éléments potentiels
<a name="calculate-routes-custom-avoidance-multiple"></a>

L' CalculateRoutes API vous aide à trouver les meilleurs itinéraires entre le point de départ et la destination, ainsi que les meilleures opportunités pour le repos des conducteurs. Il prend en charge les modes de déplacement tels que la voiture, le camion, le piéton et le scooter. Il prend également en charge jusqu'à 25 points de passage (escales), y compris l'origine et la destination, avec seulement quelques contraintes.

## Cas d'utilisation potentiels
<a name="potential-use-cases"></a>
+ **Calculez les itinéraires avec évitement personnalisé :** personnalisez les itinéraires avec évitement pour de meilleurs itinéraires et une meilleure planification des trajets domicile-travail.

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

### CalculateRoutes À utiliser en évitant les péages, les demi-tours, les ferries, les autoroutes, les tunnels, 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}'
```

------

# Comment trouver l'itinéraire le plus rapide
<a name="calculate-routes-custom-avoidance-fast"></a>

L' CalculateRoutes API vous aide à trouver les itinéraires les plus rapides entre l'origine et la destination.

## Cas d'utilisation potentiels
<a name="calculate-routes-fast-potential-use"></a>
+ **Optimisez les itinéraires pour gagner du temps :** améliorez les opérations de livraison en calculant l'itinéraire le plus rapide. Cela est utile pour réduire le temps de trajet dans les services de logistique et de livraison.

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

### Calculez l'itinéraire le plus rapide
<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"
```

------

# Comment trouver les itinéraires les plus courts
<a name="calculate-routes-custom-avoidance-shortest"></a>

L' CalculateRoutes API vous aide à trouver les itinéraires les plus courts entre l'origine et la destination.

## Cas d'utilisation potentiels
<a name="calculate-routes-short-potential-use"></a>
+ **Optimisez les itinéraires pour gagner du temps :** améliorez les opérations de livraison en calculant l'itinéraire le plus court. Cela est utile pour réduire la distance parcourue dans les services de logistique et de livraison.

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

### Utilisez-le CalculateRoutes pour trouver l'itinéraire le plus court et économiser sur la distance à parcourir.
<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"
```

------

# Apprenez à utiliser CalculateIsolines
<a name="calculate-isolines-how-to"></a>

Dans cette section, vous apprendrez à utiliser `CalculateIsolines` des plages de temps ou de distance, ainsi qu'à définir les zones à éviter.

**Topics**
+ [Comment calculer une zone de desserte en fonction de plages temporelles](calculate-service-area-based-on-time.md)
+ [Comment calculer une zone de desserte en fonction des plages de distance](calculate-service-area-based-on-distance.md)
+ [Comment calculer une zone de service en fonction de l'évitement](calculate-service-area-based-on-avoidance.md)

# Comment calculer une zone de desserte en fonction de plages temporelles
<a name="calculate-service-area-based-on-time"></a>

L' CalculateIsolines API vous permet de déterminer les zones de service accessibles dans des plages de temps ou de distance spécifiées, en tenant compte des réseaux routiers et des conditions de circulation. Cette fonctionnalité permet aux applications de définir des zones de service pour les restaurants, les épiceries ou d'autres fournisseurs de services, ce qui peut aider à planifier l'efficacité énergétique et à définir les zones accessibles pour la couverture des services.

## Cas d'utilisation potentiels
<a name="calculate-service-area-time-potential-use"></a>
+ **Planifiez les zones de service :** utilisez cette API pour planifier les zones accessibles pour des services tels que les restaurants ou la livraison de courses en fonction du temps de trajet ou de la distance.

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

### Calculez une zone de desserte en fonction d'une plage de temps avec Car 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"
```

------

# Comment calculer une zone de desserte en fonction des plages de distance
<a name="calculate-service-area-based-on-distance"></a>

L' CalculateIsolines API vous permet de déterminer les zones de service accessibles dans des plages de temps ou de distance spécifiées, en tenant compte des réseaux routiers et des conditions de circulation. Cette fonctionnalité permet aux applications de définir des zones de service pour les restaurants, les épiceries ou d'autres fournisseurs de services, ce qui peut aider à planifier l'efficacité énergétique et à définir les zones accessibles pour la couverture des services.

## Cas d'utilisation potentiels
<a name="calculate-service-area-distance-potential-use"></a>
+ **Planifiez les zones de service :** utilisez cette API pour planifier les zones accessibles pour des services tels que les restaurants ou la livraison de courses en fonction du temps de trajet ou de la distance.

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

### Calculez une zone de desserte en fonction des plages de distance avec Car 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"
```

------

# Comment calculer une zone de service en fonction de l'évitement
<a name="calculate-service-area-based-on-avoidance"></a>

L' CalculateIsolines API vous permet de déterminer les zones de service accessibles dans des plages de temps ou de distance spécifiées, en tenant compte des réseaux routiers et des conditions de circulation à éviter. Cette fonctionnalité permet aux applications de définir des zones de service pour les restaurants, les épiceries ou d'autres fournisseurs de services, ce qui peut aider à planifier l'efficacité énergétique et à définir les zones accessibles pour la couverture des services.

## Cas d'utilisation potentiels
<a name="calculate-service-area-avoidance-potential-use"></a>
+ **Planifiez les zones de service :** utilisez cette API pour planifier les zones accessibles pour des services tels que les restaurants ou la livraison de courses en fonction de l'évitement.

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

### Calculez une zone de service en fonction de l'évitement avec Car 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"
```

------

### Calculez une zone de service en fonction de l'évitement avec Truck TravelMode
<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"
```

------

### Calculez une zone de service en fonction de l'évitement pour les piétons
<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"
```

------

### Calculez une zone de service en fonction de l'évitement avec Scooter TravelMode
<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"
```

------

# Apprenez à utiliser CalculateRouteMatrix
<a name="calculate-route-matrix-how-to"></a>

Dans cette section, vous apprendrez comment trouver des `CalculateRouteMatrix` itinéraires efficaces pour de multiples points de départ et de destination.

**Topics**
+ [Comment calculer une matrice d'itinéraires de distance et de temps pour plusieurs origines et destinations](calculate-route-matrix-distance.md)
+ [Comment calculer la matrice d'itinéraires avec évitement](calculate-route-matrix-with-avoidance.md)

# Comment calculer une matrice d'itinéraires de distance et de temps pour plusieurs origines et destinations
<a name="calculate-route-matrix-distance"></a>

L' CalculateRouteMatrix API calcule les itinéraires et fournit le temps et la distance parcourus pour chaque combinaison d'origines et de destinations. Cette fonctionnalité est utile pour les applications nécessitant la planification et l'optimisation d'itinéraires sur plusieurs sites.

La réponse est exprimée `Distance` en mètres et `Duration` en secondes pour chaque paire origine-destination.

## Cas d'utilisation potentiels
<a name="calculate-route-matrix-potential-use"></a>
+ **Optimisation de la planification des itinéraires :** utilisez la matrice d'itinéraires comme entrée pour le logiciel d'optimisation des itinéraires afin d'améliorer l'efficacité du service et de réduire le temps de trajet.

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

### CalculateRouteMatrix avec une limite de routage illimitée
<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 avec une limite de routage basée sur la géométrie
<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}}}'
```

------

# Comment calculer la matrice d'itinéraires avec évitement
<a name="calculate-route-matrix-with-avoidance"></a>

L' CalculateRouteMatrix API calcule les itinéraires et renvoie le temps et la distance du trajet entre chaque point d'origine et chaque destination dans les listes spécifiées. La réponse est `Distance` exprimée en mètres et `Duration` en secondes. L'API peut être utilisée pour définir des options d'évitement pour des zones ou des caractéristiques routières spécifiques, afin de garantir que les itinéraires évitent des zones ou des conditions spécifiques. Si un autre itinéraire n'est pas réalisable, la préférence d'évitement peut être contournée.

## Cas d'utilisation potentiels
<a name="calculate-route-matrix-potential-use"></a>
+ **Planification et optimisation des itinéraires :** utilisez la matrice d'itinéraires comme entrée pour les logiciels qui nécessitent des itinéraires optimisés tout en évitant certaines zones ou certaines caractéristiques routières.

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

### CalculateRouteMatrix avec une zone d'évitement
<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 éviter les routes à péage, les autoroutes et les ferries
<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}'
```

------

# Apprenez à utiliser OptimizeWaypoints
<a name="optimize-waypoints-how-to"></a>

Découvrez comment l'utiliser pour `OptimizeWaypoints` trouver les meilleurs itinéraires afin de minimiser le temps ou la distance à parcourir.

**Topics**
+ [Comment optimiser les points de cheminement d'un itinéraire](optimize-waypoints.md)
+ [Comment optimiser les points de cheminement d'un itinéraire en tenant compte du trafic](optimize-waypoints-traffic-awareness.md)
+ [Comment optimiser les points de cheminement d'un itinéraire en tenant compte des heures d'accès](optimize-waypoints-access-hours.md)

# Comment optimiser les points de cheminement d'un itinéraire
<a name="optimize-waypoints"></a>

L' OptimizeWaypoints API calcule l'itinéraire le plus efficace entre une série de points de cheminement, minimisant ainsi le temps de trajet ou la distance totale. Cette API résout le problème des vendeurs itinérants en tenant compte des réseaux routiers et des conditions de circulation pour déterminer le trajet optimal.

## Cas d'utilisation potentiels
<a name="optimize-waypoints-potential-use"></a>
+ **Analysez les modèles des zones de desserte :** utilisez l'optimisation des points de cheminement pour prendre des décisions éclairées concernant les zones de service commerciales et améliorer l'efficacité logistique.

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

### Optimisez les points de cheminement en utilisant Car 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"
```

------

# Comment optimiser les points de cheminement d'un itinéraire en tenant compte du trafic
<a name="optimize-waypoints-traffic-awareness"></a>

L' OptimizeWaypoints API calcule l'itinéraire optimal entre plusieurs points de cheminement afin de minimiser le temps de trajet ou la distance totale. Il utilise des algorithmes avancés pour résoudre le problème des vendeurs itinérants, en déterminant le chemin le plus efficace tout en tenant compte de facteurs tels que les réseaux routiers et les conditions de circulation en temps réel.

## Cas d'utilisation potentiels
<a name="optimize-waypoints-potential-use"></a>
+ **Optimisez les itinéraires à arrêts multiples pour une livraison efficace :** améliorez les opérations de livraison en calculant l'itinéraire le plus court ou le plus rapide parmi plusieurs arrêts. Cela est utile pour réduire les coûts d'exploitation, la consommation de carburant et le temps de trajet dans les services de logistique et de livraison.

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

### Optimisez les points de cheminement grâce à la surveillance du trafic en voiture 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"}'
```

------

# Comment optimiser les points de cheminement d'un itinéraire en tenant compte des heures d'accès
<a name="optimize-waypoints-access-hours"></a>

L' OptimizeWaypoints API calcule également l'itinéraire optimal entre un ensemble de points de cheminement, dans le but de minimiser le temps de trajet ou la distance totale parcourue. Il résout le problème du vendeur itinérant qui consiste à déterminer le chemin le plus efficace, en tenant compte de facteurs tels que le réseau routier et les conditions de circulation.

## Cas d'utilisation potentiels
<a name="optimize-waypoints-access-hours-potential-use"></a>
+ **Analysez les heures d'accès des clients :** planifiez l'efficacité en fonction des heures d'accès de vos clients.

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

### Optimisez les points de cheminement en connaissant les heures d'accès à l'aide de Car 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"
```

------

# Apprenez à utiliser SnapToRoads
<a name="snap-to-roads-how-to"></a>

 Cette rubrique explique comment aligner les traces GPS sur les réseaux routiers, `SnapToRoads` afin d'améliorer la précision de positionnement pour les applications de navigation et de gestion de flotte. Cette API corrige la dérive du GPS et la perte de signal en enregistrant les coordonnées des tronçons de route les plus proches, tout en respectant les restrictions relatives aux modes de déplacement. Des exemples illustrent des utilisations pratiques, telles que la superposition de traces GPS, le comblement des lacunes dans les données et la réduction du bruit pour une visualisation plus claire des itinéraires.

**Topics**
+ [Comment associer les traces GPS à un réseau routier](how-to-match-gps-traces.md)

# Comment associer les traces GPS à un réseau routier
<a name="how-to-match-gps-traces"></a>

L' SnapToRoads API vous permet de faire correspondre les traces GPS au réseau routier. Un tracé GPS inclut des positions et des métadonnées telles que l'horodatage, la vitesse et le cap enregistrées à l'aide d'un appareil GPS. Ces traces comportent souvent une marge d'erreur, ce qui les rend difficiles à utiliser directement pour l'analyse et la visualisation.

SnapToRoads tient compte des restrictions légales et temporelles pour le mode de voyage spécifié lors de la mise en correspondance des traces. Si le suivi suggère fortement une violation des restrictions, l'itinéraire réellement emprunté est conservé.

## Cas d'utilisation potentiels
<a name="potential-use"></a>
+ **Superposez les traces GPS sur les routes les plus susceptibles d'être parcourues :** cette fonctionnalité permet d'aligner les données GPS sur le trajet le plus précis du réseau routier, ce qui permet une visualisation plus claire des données.
+ **Interpolez les lacunes dans les traces GPS :** SnapToRoads permet de combler les lacunes en adaptant les coordonnées aux segments de route, créant ainsi un ensemble de données plus continu et plus utile pour les applications.
+ **Filtrez le bruit et les valeurs aberrantes :** en se connectant à la route la plus proche, cette API peut aider à éliminer les valeurs aberrantes et à réduire le bruit du GPS, améliorant ainsi la fiabilité des données pour l'analyse.

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

### Associez le tracé GPS en mode voiture
<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"
```

------

### Faites correspondre le tracé GPS en utilisant le mode camion avec options
<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}}'
```

------

# Gérez les coûts et l'utilisation
<a name="routes-whats-next"></a>

Au fur et à mesure que vous vous familiarisez avec Amazon Location Routes, il est important de comprendre comment gérer la capacité des services, vous assurer de respecter les limites d'utilisation et obtenir les meilleurs résultats grâce à l'optimisation des quotas et des API. En appliquant les meilleures pratiques en matière de performances et de précision, vous pouvez adapter votre application pour gérer efficacement les requêtes liées au lieu et optimiser vos demandes d'API.

**Topics**
+ [Bonnes pratiques](routes-best-practices.md)
+ [Tarification des itinéraires](routes-pricing.md)
+ [Quota et utilisation des itinéraires](routes-quota-usage.md)

# Bonnes pratiques
<a name="routes-best-practices"></a>

Cette section décrit les meilleures pratiques relatives à l'utilisation de la compression et au choix entre Simple (GeoJSON) et les FlexiblePolyline formats lors de l'interaction avec l'API, en fournissant des conseils sur l'optimisation des performances, de la bande passante et de la gestion des données.

## Compression
<a name="compression"></a>

Pour améliorer les performances et l'efficacité de vos applications lors de l'interaction avec notre API, il est recommandé d'activer la compression des réponses, en particulier lorsque vous traitez de grandes charges utiles basées sur du texte. Vous pouvez activer la compression en incluant l'`Accept-Encoding`en-tête dans vos demandes d'API, en spécifiant votre méthode de compression préférée. Nous soutenons `gzip` et `deflate` soutenons leurs capacités de compression, en proposant `gzip` généralement de meilleurs taux de compression.

### Quand activer la compression
<a name="when-to-enable-compression"></a>

**Réponses volumineuses**  
Activez la compression pour les réponses textuelles volumineuses afin de réduire l'utilisation de la bande passante et d'améliorer les temps de chargement.

**Contraintes du réseau**  
Si votre application fonctionne sur une bande passante limitée ou sur des réseaux à latence élevée, la compression peut améliorer l'efficacité du transfert de données.

### Comment utiliser efficacement la compression
<a name="how-to-use-compression-effectively"></a>

**Définissez l'en-tête Accept-Encoding**  
Incluez `Accept-Encoding: gzip, deflate` dans vos requêtes HTTP pour informer notre API que vous acceptez ces méthodes de compression. La méthode d'activation et de gestion de la compression varie en fonction du [SDK AWS](https://docs.aws.amazon.com/sdkref/latest/guide/overview.html) et du langage de programmation. Par exemple, le [SDK AWS pour Java v1 utilise la méthode de `withGzip` la classe pour](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/ClientConfiguration.html#withGzip-boolean-) activer gzip, tandis que `ClientConfiguration` le SDK AWS pour Go nécessite l'ajout d'un intergiciel spécifique pour la gestion de la compression. Pour les autres SDKs, reportez-vous au [guide de référence du SDK AWS](https://docs.aws.amazon.com/sdkref/latest/guide/overview.html) pour obtenir des instructions détaillées.

**Gérez correctement la décompression**  
Assurez-vous que votre application cliente peut correctement décompresser les réponses en fonction de l'`Content-Encoding`en-tête renvoyé par notre API.

**Testez et surveillez**  
Évaluez régulièrement l'impact de la compression sur les performances de votre application, en équilibrant les avantages de la réduction de la charge utile par rapport à la surcharge CPU supplémentaire résultant des processus de décompression.

## Polyline
<a name="polyline"></a>

Les meilleures pratiques pour choisir entre des formats simples (GeoJSON) et des FlexiblePolyline formats lors de l'interaction avec notre API, afin d'optimiser à la fois les performances et la convivialité de vos données géospatiales.

### Utiliser le format simple (GeoJSON)
<a name="use-simple-format"></a>

**Lisibilité et standardisation**  
À utiliser lorsque vous avez besoin d'un format largement reconnu et lisible par l'homme pour faciliter le débogage et l'interopérabilité avec divers outils géospatiaux.

**Précision**  
Choisissez le format simple lorsque votre application a besoin d'une haute précision pour les coordonnées, car GeoJSON conserve une précision décimale complète sans perte.

**Ensembles de données plus petits**  
Le format simple est idéal lorsque vous travaillez avec de petits ensembles de données de coordonnées où les avantages de la compression en termes de réduction de taille sont minimes.

### Utiliser le FlexiblePolyline format
<a name="use-flexiblepolyline-format"></a>

**Réduction de la taille des données**  
FlexiblePolyline est idéal lorsque vous devez minimiser la quantité de données transmises, en particulier pour les grandes listes de coordonnées, en utilisant des techniques de compression avec perte.

**Sécurité des URL**  
FlexiblePolyline fournit une chaîne compacte sécurisée pour les URL qui peut être utilisée directement dans les paramètres de requête sans encodage supplémentaire.

**Optimisation des performances**  
FlexiblePolyline contribue à réduire la taille de la charge utile, ce qui accélère le transfert de données et réduit l'utilisation de la bande passante, ce qui en fait un outil crucial pour les applications à hautes performances ou celles fonctionnant sur des réseaux restreints.

# Tarification des itinéraires
<a name="routes-pricing"></a>

Vous trouverez ci-dessous les catégories de prix pour chaque API :

## Calculer les itinéraires
<a name="calculate-routes-price"></a>

Ce prix est basé sur le nombre de demandes d'API. `CalculateRoutes`propose trois catégories de prix : Core, Advanced et Premium.

**Principal**  
Cette tranche de prix prend en charge les modes de déplacement voiture, camion et piéton, sans calcul du coût du péage.

**Advanced (Avancé)**  
Cette tranche de prix prend en charge d'autres modes de transport tels que le scooter, sans calcul du coût du péage.

**Prime**  
Cette tranche de prix prend en charge le calcul des coûts de péage. Vous serez facturé au tarif premium lorsque vous demanderez le calcul du coût du péage en définissant les paramètres de la demande `LegAdditionalFeatures["Tolls"]` ou`SpanAdditionalFeatures["TollSystems"]`, quel que soit le mode de transport.

## Calculer la matrice d'itinéraires
<a name="calculate-route-matri-price"></a>

Ce prix est basé sur le nombre d'itinéraires calculés. Le nombre d'itinéraires calculé dans chaque demande est égal au nombre d'origines multiplié par le nombre de destinations,`Number of Routes = Number of origins x Number of Destinations`. Par exemple, lorsque vous utilisez une taille de matrice de 300 origines pour 100 destinations, le nombre total d'itinéraires calculé est de 30 000 (300 x 100 = 30 000).

**Note**  
Les calculs d'itinéraire sont facturés pour chaque paire d'origine et de destination. Si vous utilisez une grande matrice d'origines et de destinations, vos coûts augmenteront en conséquence.

`CalculateRouteMatrix`propose 2 catégories de prix : Core et Advanced.

**Principal**  
Cette tranche de prix prend en charge les modes de déplacement voiture, camion et piéton.

**Advanced (Avancé)**  
Cette tranche de prix prend en charge d'autres modes de transport, tels que le scooter.

## Optimisez le point de cheminement
<a name="optimize-waypoint-price"></a>

Ce prix est basé sur le nombre de demandes d'API. `OptimizeWaypoint`propose 2 catégories de prix : Advanced et Premium.

**Advanced (Avancé)**  
 Cette tranche tarifaire prend en charge jusqu'à 30 points de cheminement en une seule demande ; modes de déplacement pour voiture, camion et piéton, avec le cadre délimitant les points d'entrée dans un rayon de 200 km, et sans paramètres optionnels tels que `Avoid` `Clustering` `Driver``Exclude.Countries`,`TravelModeOptions.Truck.HazardousCargos`,`TravelModeOptions.Truck.TunnelRestrictionCode`,,,,,,`AccessHours`,,,,,,`AppointmentTime`,`Before`. `Heading` `ServiceDuration` `SideOfStreet`  
Le clustering automatique peut se produire lorsque les points de cheminement se trouvent à proximité, mais cela reste considéré comme une fourchette de prix avancée.

**Prime**  
 Cette tranche tarifaire prend en charge jusqu'à 50 points de cheminement en une seule demande, sans aucune restriction quant aux modes de déplacement, sans limite des points d'entrée dans un rayon de 500 km et avec des paramètres optionnels tels que`Avoid`,,,, `Clustering``Driver`,`Exclude.Countries`. `TravelModeOptions.Truck.HazardousCargos` `TravelModeOptions.Truck.TunnelRestrictionCode` En outre, cette tranche tarifaire prend en charge les contraintes facultatives relatives aux points de cheminement et aux destinations`AccessHours`, telles que,`AppointmentTime`,`Before`,`Heading`,`ServiceDuration`,`SideOfStreet`.   
Une seule demande ne peut prendre en charge que 20 points de cheminement si l'une des contraintes facultatives de point de cheminement et de destination est appliquée.

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

Ce prix est basé sur le nombre de demandes d'API. `SnaptoRoad`propose 2 catégories de prix : Advanced et Premium.

**Advanced (Avancé)**  
Cette tranche tarifaire prend en charge les modes de transport voiture, camion et piéton, avec un `TracePoints` compte jusqu'à 200 et avec une distance aérienne maximale comprise entre `TracePoints` 100 kilomètres.

**Prime**  
Cette tranche tarifaire ne comporte aucune restriction quant aux modes de voyage, jusqu'à 5 000 `TracePoints` points.

## Calculer l'isoligne
<a name="calculate-isoline-price"></a>

Ce prix est basé sur le nombre d'isolines calculé dans la réponse. `CalculateIsolines`propose 2 catégories de prix : Advanced et Premium.

**Advanced (Avancé)**  
Cette tranche tarifaire prend en charge les modes de transport voiture, camion et piéton, avec `Thresholds.Time` des valeurs allant jusqu'à 60 minutes ou `Thresholds.Distance` des valeurs allant jusqu'à 100 kilomètres.

**Prime**  
Cette tranche tarifaire ne comporte aucune restriction quant aux modes de transport, avec des `Thresholds.Time` valeurs allant jusqu'à 180 minutes ou `Thresholds.Distance` des valeurs allant jusqu'à 300 km.

# Quota et utilisation des itinéraires
<a name="routes-quota-usage"></a>

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

Amazon Location Service APIs dispose de quotas par défaut. Vous pouvez augmenter les quotas à l'aide de la [console des quotas de service](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas). Pour les limites supérieures au double de la valeur par défaut, faites la demande via la console en libre-service ou contactez le support.


**Limites de quotas de service**  

| Nom d'API | Par défaut | Limite maximale ajustable | Plus que la limite maximale ajustable | 
| --- | --- | --- | --- | 
| [Calculez les itinéraires](calculate-routes.md) | 20 | 40 | Demande sur la [console de quotas de service](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) ou contactez l'équipe d'assistance | 
| [Calculer les isolignes](calculate-isolines.md) | 20 | 40 | Demande sur la [console de quotas de service](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) ou contactez l'équipe d'assistance | 
| [Snap to Roads](snap-to-roads.md) | 20 | 40 | Demande sur la [console de quotas de service](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) ou contactez l'équipe d'assistance | 
| [Calculer la matrice d'itinéraires](calculate-route-matrix.md) | 5 | 10  | Demande sur la [console de quotas de service](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) ou contactez l'équipe d'assistance | 
| [Optimisez les points de cheminement](actions-optimize-waypoints.md) | 5 | 10  | Demande sur la [console de quotas de service](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) ou contactez l'équipe d'assistance | 

## Autres limites d'utilisation
<a name="other-usage-limits"></a>

Outre les quotas de service, les limites d'utilisation des API suivantes s'appliquent :


**Autres limites d'utilisation**  

| Nom d'API | Limite | Value | 
| --- | --- | --- | 
| [Snap to Roads](snap-to-roads.md) | Somme de la distance géodésique entre tous TracePoints | 500 KM | 
| [Optimisez les points de cheminement](actions-optimize-waypoints.md) | Somme de la distance géodésique entre l'origine, les points de cheminement dans l'ordre indiqué et la destination | 100 KM | 
| [Optimisez les points de cheminement](actions-optimize-waypoints.md) | Périmètre du cadre entourant l'origine, les points de cheminement et la destination | 500 KM | 
| [Calculer la matrice d'itinéraires](calculate-route-matrix.md) | Distance maximale entre les origines et les destinations pour un itinéraire illimité (si Avoid ou TravelModeOptions .Truck sont utilisés) | 60 KM | 
| [Calculer la matrice d'itinéraires](calculate-route-matrix.md) | Distance maximale entre les origines et les destinations pour un routage illimité | 10 000 KM | 
| [Calculez les itinéraires](calculate-routes.md) | Taille de la charge utile de réponse après compression | 6 Mo | 
| [Calculer la matrice d'itinéraires](calculate-route-matrix.md) | Taille de la charge utile de réponse après compression | 6 Mo | 
| [Calculer les isolignes](calculate-isolines.md) | Taille de la charge utile de réponse après compression | 6 Mo | 
| [Optimisez les points de cheminement](actions-optimize-waypoints.md) | Taille de la charge utile de réponse après compression | 6 Mo | 
| [Snap to Roads](snap-to-roads.md) | Taille de la charge utile de réponse après compression | 6 Mo | 

## Étapes suivantes
<a name="next-steps"></a>

Veuillez consulter les points suivants pour plus de détails :
+ [Attribution](https://docs.aws.amazon.com/location/latest/developerguide/data-attribution.html) : informations sur les exigences d'attribution des données pour Amazon Location Service.
+ [SLA](https://aws.amazon.com/location/sla/) : accord de niveau de service pour Amazon Location Service, y compris les engagements de disponibilité et les temps de réponse.
+ [Conditions du service](https://aws.amazon.com/service-terms/) : conditions régissant l'utilisation d'Amazon Location Service, y compris les restrictions et les limitations.