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.
Calculez un itinéraire avec Amazon Location
Vous pouvez utiliser Amazon Location Service pour calculer les itinéraires entre une origine et une destination, avec jusqu'à 23 points de cheminement le long de l'itinéraire, pour différents modes de transport, évitements et conditions de circulation.
Note
Vous devez d'abord créer une ressource de calcul d'itinéraire et configurer l'authentification pour vos demandes adressées à Amazon Location. Pour de plus amples informations, veuillez consulter Conditions préalables au calcul des itinéraires à l'aide d'Amazon Location.
Commencez à calculer les itinéraires
Soumettez une demande simple en utilisant l'CalculateRouteopération. Une demande simple contient les champs obligatoires suivants :
-
DeparturePosition— La position de départ à partir de laquelle calculer l'itinéraire. Défini comme[longitude, latitude] -
DestinationPosition— Position finale vers laquelle calculer l'itinéraire. Défini comme[longitude, latitude].
Note
Si vous spécifiez une position de départ ou de destination qui n'est pas située sur une route, Amazon Location déplace la position vers la route la plus proche.
Vous pouvez éventuellement spécifier des points de cheminement, une heure de départ et un mode de voyage dans votre demande.
Vous pouvez utiliser le AWS CLI ou l'Amazon LocationAPIs.
Par défaut, la réponse est renvoyée Distance en kilomètres. Vous pouvez modifier l'unité de mesure en miles à l'aide du paramètre optionnel suivant :
-
DistanceUnit— Spécifie le système d'unités à utiliser pour les résultats de distance.
POST /routes/v0/calculators/ExampleCalculator/calculate/route Content-type: application/json { "DeparturePosition": [-122.7565,49.0021], "DestinationPosition": [-122.3394, 47.6159], "DistanceUnit": "Miles" }
Configuration de points de cheminement
Lorsque vous calculez un itinéraire, vous pouvez spécifier jusqu'à 23 points d'escale intermédiaires entre la position de départ et la position de destination à l'aide des positions des points de cheminement.
-
WaypointPositions— Spécifie une liste ordonnée de positions intermédiaires à inclure le long d'un itinéraire entre la position de départ et la position de destination.Note
Si vous spécifiez une position de point de cheminement qui n'est pas située sur une route, Amazon Location déplace la position vers la route la plus proche.
La CalculateRoute requête suivante calcule un itinéraire avec 2 points de passage :
-
La position de départ est [-122.7565, 49.0021] et la position de destination est [-122.3394, 47.6159].
-
Pour le paramètre de requête
WaypointPositions:-
La première position d'arrêt est [
-122.1884, 48.0936]. -
La deuxième position d'arrêt est [
-122.3493, 47.6205].
-
-
Pour inclure la géométrie de la chaîne linéaire des jambes entre ces deux points de cheminement, définissez le paramètre facultatif suivant sur
true:-
IncludeLegGeometry— Inclut la géométrie de chaque trajectoire entre une paire de positions dans la réponse.
-
POST /routes/v0/calculators/ExampleCalculator/calculate/route Content-type: application/json { "DeparturePosition": [-122.7565,49.0021], "DestinationPosition": [-122.3394, 47.6159], "WaypointPositions":[ [-122.1884,48.0936], [-122.3493,47.6205] ], "IncludeLegGeometry":true}
Exemple de réponse
Voici un exemple de demande avec la réponse correspondante lorsque vous appelez l'CalculateRouteopération depuis Amazon Location Routes API avec le paramètre IncludeLegGeometry défini sur true, qui inclut la géométrie en chaîne linéaire de chaque trajet entre une paire de positions dans la réponse.
