en sortie
La sortie de GetTravelCostMatrix contient un nombre de séquences d'itinéraire, contenant chacun les points de départ et d'arrivée pour les candidats utilisés dans l'itinéraire de la matrice, ainsi que la durée et la distance pour chaque itinéraire calculé. La sortie peut contenir tous les itinéraires de la matrice ou uniquement l'itinéraire optimal entre chaque point de départ et d'arrivée, en fonction de la configuration de l'option OptimizeBy.
Si GetTravelCostMatrix ne parvient pas à trouver un itinéraire entre un point de départ et d'arrivée dans la matrice, une erreur sera enregistrée dans le journal du serveur mais les itinéraires qui ont pu être déterminés seront renvoyés. Par exemple, si vous disposez du point de départ A et des points d'arrivée 1 et 2, et que GetTravelCostMatrix trouve un itinéraire de A à 1 mais pas de A à 2, GetTravelCostMatrix renverra l'itinéraire de A à 1 et enregistrera une erreur indiquant qu'il n'a pas pu déterminer l'itinéraire de A à 2.
La sortie de GetTravelCostMatrix se présente soit au format de liste, soit au format d'objet, en fonction de la configuration de l'option ReturnRouteCostMatrix. Il est impossible d'interagir directement avec la sortie objet.
Élément de réponse |
Format |
Description |
---|---|---|
Distance | Chaîne |
La distance du point de départ au point d'arrivée. La valeur est exprimée dans les unités indiquées dans l'élément DistanceUnits |
DistanceUnits | Chaîne |
L'unité de mesure pour les distances. L'un des éléments suivants :
|
EndPointRef | Chaîne |
Un identifiant de référence qui correspond à l'ordre dans lequel les points d'arrivée ont été définis dans l'entrée. Le premier point d'arrivée défini possède l'identifiant de référence 1, le second possède l'identifiant de référence 2, et ainsi de suite. Vous devez développer votre propre processus pour associer les coordonnées de latitude et de longitude de l'entrée à l'identifiant de référence renvoyé par Get Travel Cost Matrix. |
EndPointID | Chaîne |
Un identifiant associé au point d'arrivée correspondant dans le champ Identifiant du stage d'entrée. Par exemple, le premier point d'arrivée pourrait avoir la valeur N pour le champ EndPointID, le deuxième pourrait avoir la valeur O, et ainsi de suite. Remarque : Ce champ est actif uniquement lorsque la valeur du champ Format de matrice du coût de l'itinéraire est « Hiérarchie ».
|
StartPointRef | Chaîne |
Un identifiant de référence qui correspond à l'ordre dans lequel les points de départ ont été définis dans l'entrée. Le premier point de départ défini possède l'identifiant de référence 1, le second possède l'identifiant de référence 2, et ainsi de suite. Vous devez développer votre propre processus pour associer les coordonnées de latitude et de longitude de l'entrée à l'identifiant de référence renvoyé par Get Travel Cost Matrix. |
StartPointID | Chaîne |
Un identifiant associé au point de départ correspondant dans le champ Identifiant du stage d'entrée. Par exemple, le premier point de départ pourrait avoir la valeur A pour le champ StartPointID, le deuxième point pourrait avoir la valeur B pour StartPointID et ainsi de suite. Remarque : Ce champ est actif uniquement lorsque la valeur du champ Format de matrice du coût de l'itinéraire est « Hiérarchie ».
|
Time | Chaîne |
La durée totale de l'itinéraire du point de départ au point d'arrivée. La valeur est exprimée dans les unités indiquées dans l'élément TimeUnits |
TimeUnits | Chaîne |
L'unité de mesure pour le temps. L'un des éléments suivants :
|
Status |
Chaîne [1] |
Signale la réussite ou l'échec de la correspondance.
|
Status.Code |
Chaîne [100] |
Raison de l'échec, le cas échéant. |
Status.Description |
Chaîne |
Description de l'échec indiqué par Status.Code. |