Calcul d'une matrice d'itinéraires Restrictions de position Exemple de réponse

Planification d'itinéraires à l'aide d'une matrice d'itinéraires

Vous pouvez utiliser Amazon Location Service pour créer des entrées pour votre logiciel de planification et d'optimisation d'itinéraires. Vous pouvez créer des résultats d'itinéraire, y compris le temps de trajet et la distance parcourue, pour des itinéraires entre un ensemble de positions de départ et un ensemble de positions de destination.

Par exemple, compte tenu des positions de départ A et B et des positions de destination X et Y, Amazon Location Service indiquera le temps de trajet et la distance parcourue pour les itinéraires allant de A à X, A à Y, B à X et B à Y.

Vous pouvez calculer les itinéraires en fonction des différents modes de transport, des évitements et des conditions de circulation. Par exemple, vous pouvez spécifier que le véhicule est un camion de 35 pieds de long, et l'itinéraire calculé utilisera ces restrictions pour déterminer le temps et la distance parcourus.

Le nombre de résultats renvoyés (et d'itinéraires calculés) est le nombre de positions de départ multiplié par le nombre de positions de destination. Vous êtes facturé pour chaque itinéraire calculé, et non pour chaque demande adressée au service. Ainsi, une matrice d'itinéraires comportant 10 départs et 10 destinations sera facturée comme 100 itinéraires.

Calcul d'une matrice d'itinéraires

Vous pouvez calculer une matrice d'itinéraires entre un ensemble de positions de départ et un ensemble de positions de destination. Les résultats de l'itinéraire incluront le temps de trajet et la distance parcourue.

Prérequis

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 plus d’informations, consultez Prérequis.

Soumettez une demande en utilisant l'CalculateRouteMatrixopération. Une demande minimale contient les champs obligatoires suivants :

DeparturePositions— Ensemble de positions de départ pour lesquelles calculer les itinéraires. Défini comme un tableau de [longitude, latitude]
DestinationPositions— Ensemble de positions finales pour lesquelles calculer les itinéraires. Défini comme un tableau de[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 une heure de départ et un mode de voyage dans votre demande.

Vous pouvez utiliser les AWS CLI ou les API Amazon Location.

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-matrix
Content-type: application/json
{
   "DeparturePositions": [
       [-122.7565,49.0021],
       [-122.2014,47.6101]
   ],
   "DestinationPositions": [
       [-122.3394, 47.6159],
       [-122.4813,48.7511]
   ],
   "DistanceUnit": "Miles"
}

Restrictions relatives aux positions de départ et de destination

Lors du calcul d'une matrice d'itinéraires, les positions de départ et de destination sont soumises à des restrictions. Ces restrictions varient en fonction du fournisseur utilisé par la RouteCalculator ressource.

Limitation	Esri	Saisir	ICI
Nombre de positions	Jusqu'à 10 positions de départ et 10 positions de destination.	Jusqu'à 350 positions de départ et 350 positions de destination.	Jusqu'à 350 positions de départ et 350 positions de destination. Pour les trajets plus longs, des restrictions supplémentaires s'appliquent. Consultez la section.
Distance entre les positions	Toutes les deux positions de départ et de destination doivent être situées à moins de 400 km l'une de l'autre (40 km pour les itinéraires de randonnée).		Toutes les positions de départ et de destination doivent se situer dans un cercle de 180 km de diamètre. Pour les trajets plus longs, des restrictions supplémentaires s'appliquent. Consultez la section.
Longueur de l'itinéraire	Les itinéraires ne seront pas terminés si la durée totale du trajet est supérieure à 400 minutes.		Les itinéraires qui s'écartent de plus de 10 km en dehors d'un cercle autour des points de départ et de destination ne seront pas calculés. Pour les trajets plus longs, des restrictions supplémentaires s'appliquent. Consultez la section.
Régions	Le calcul d'une matrice d'itinéraires n'est pas pris en charge en Corée.	Disponible en Asie du Sud-Est. Pour obtenir la liste des pays/régions pris en charge et pour plus d'informations, consultez. Pays/régions et zone couverts	Aucune restriction supplémentaire.

Planification d'itinéraires à plus long terme

Le calcul d'une matrice des résultats d'itinéraires est utile pour une planification efficace des itinéraires, mais le calcul peut prendre un certain temps. Tous les fournisseurs de données Amazon Location Service limitent le nombre d'itinéraires ou la distance des itinéraires pouvant être calculés. Par exemple, HERE permet de créer des itinéraires entre 350 positions de départ et de destination, mais ces positions doivent se situer dans un cercle de 180 km. Et si vous souhaitez planifier des trajets plus longs ?

Vous pouvez calculer une matrice d'itinéraires avec des longueurs illimitées pour un plus petit nombre d'itinéraires, en utilisant RouteCalculator HERE comme fournisseur de données. Cela ne change pas la façon dont vous appelez l'CalculateRouteMatrixAPI, Amazon Location autorise simplement les itinéraires plus longs lorsque vous répondez aux exigences.

Les exigences pour le calcul d'itinéraires de plus grande longueur sont les suivantes :

Ils RouteCalculator doivent utiliser le fournisseur de données HERE.
Le nombre de positions de départ ne doit pas être supérieur à 15.
Le nombre total d'itinéraires à calculer ne doit pas être supérieur à 100.
L'itinéraire longue distance n'est pas autorisé pour les itinéraires de camions avec évitement de péage lorsque les itinéraires sont supérieurs à 1 000 km. Cette combinaison est plus lente à calculer et peut entraîner l'expiration de l'appel. Vous pouvez calculer ces itinéraires individuellement avec l'CalculateRouteopération.

Si votre appel ne répond pas à ces exigences (par exemple, si vous demandez 150 calculs d'itinéraire en un seul appel), vous CalculateRouteMatrix reviendrez à autoriser uniquement les règles relatives aux itinéraires les plus courts. Vous pouvez ensuite calculer les itinéraires, à condition que les positions se situent dans un cercle de 180 km.

Lorsque vous calculez des itinéraires plus longs, tenez compte des points suivants :

Le calcul des itinéraires plus longs peut prendre plus de temps, même plus que le délai maximum pour les API Amazon Location. Si les délais d'attente sont fréquents pour des itinéraires spécifiques, vous pouvez essayer un plus petit nombre d'itinéraires pour chaque appel versCalculateRouteMatrix.
Si vous ajoutez d'autres positions de destination ou de départ à votre CalculateRouteMatrix demande, l'opération peut passer en mode plus restreint, et vous pouvez obtenir une erreur pour un itinéraire qui peut être calculé sans problème lorsqu'il y a moins d'itinéraires à créer. Dans ce cas, réduisez le nombre de positions de destination ou de départ et faites plusieurs demandes pour obtenir l'ensemble complet des calculs d'itinéraire dont vous avez besoin.

Exemple de réponse

Voici un exemple de demande avec la réponse correspondante lorsque vous appelez l'CalculateRouteMatrixopération depuis l'API Amazon Location Routes.

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Calculer l'itinéraire

Positions non situées sur une route