S'il s'exécute avec succès, le service renvoie le meilleur itinéraire et la feuille de route la plus appropriée entre l'incident et la ressource choisie, ainsi que le statut indiquant si l'analyse a réussi à l'aide des paramètres en sortie suivants :
output_closest_facilities
Ce paramètre en sortie permet d'accéder aux ressources les plus proches des incidents. Il fournit l'emplacement des ressources et les informations attributaires des ressources en entrée correspondantes.
Voici une description des champs renvoyés pour chaque itinéraire :
Nom du champ | Description |
---|---|
OID | Identifiant unique de l'itinéraire. Cet identifiant est généré automatiquement par le service. |
FacilityOID | Valeur IdObjet de la ressource en entrée représentée par la ressource en sortie. Ce champ est souvent utilisé pour joindre des informations à partir des ressources en entrée. |
output_routes
Utilisez ce paramètre pour accéder aux itinéraires obtenus entre les ressources et les incidents. Les paramètres route_shape et route_line_simplification_tolerance ont une grande influence sur la forme des itinéraires en sortie. Les géométries des itinéraires sont renvoyées dans la référence spatiale spécifiée en tant que paramètre env:outSR.
Voici une description des champs renvoyés pour chaque itinéraire :
Nom du champ | Description |
---|---|
OID | Identifiant unique de l'itinéraire. Cet identifiant est généré automatiquement par le service. |
Nom | Le nom de l'itinéraire de la ressource la plus proche est basé sur les noms de la ressource et de l'incident associés. Le nom de la ressource apparaît en premier si Facility to Incident est spécifié comme paramètre travel_direction. Par exemple, Facility 5—Incident 3 indique que l'itinéraire part de Facility 5 pour atteindre Incident 3. Si Incident to Facility est spécifié comme paramètre travel_direction, le nom de l'incident apparaît en premier. Par exemple, Incident 3—Facility 5. |
FacilityID | ID unique de la ressource visitée par l'itinéraire. Si l'attribut ID est inclus lorsque vous spécifiez le paramètre facilities, la valeur FacilityID est identique à la valeur de l'attribut ID. Sinon, FacilityID contient un identifiant généré automatiquement. |
FacilityOID | Valeur IdObjet de la ressource en entrée utilisée pour générer l'itinéraire. Ce champ est souvent utilisé pour joindre des informations à partir des ressources vers des itinéraires. |
FacilityRank | Rang de la ressource parmi toutes les ressources trouvées pour l'incident associé ; la ressource la plus proche a un rang de 1. |
FacilityCurbApproach | Décrit le côté du véhicule sur lequel se trouve la ressource lors de l'arrivée à ou du départ de la ressource. La valeur 1 indique le côté droit du véhicule, la valeur 2 le côté gauche. |
IncidentID | ID unique de l'incident visité par l'itinéraire. Si l'attribut ID est inclus lorsque vous spécifiez le paramètre incidents, la valeur IncidentID est identique à la valeur de l'attribut ID. Sinon, IncidentID contient un identifiant généré automatiquement. |
IncidentOID | Valeur IdObjet de l'incident en entrée utilisé pour générer l'itinéraire. Ce champ est souvent utilisé pour joindre des informations à partir des incidents vers des itinéraires. |
IncidentCurbApproach | Décrit le côté du véhicule sur lequel se trouve l'incident lors de l'arrivée à ou du départ de l'incident. Une valeur de 1 indique le côté droit du véhicule ; une valeur de 2 le gauche. |
Shape_Length | Longueur de l'itinéraire exprimée dans les unités de la référence spatiale spécifiée pour la géométrie d'itinéraire. Par défaut, la longueur est signalée en degrés décimaux si le paramètre env:outSR n'est pas spécifié. |
Total_Minutes | Temps de trajet cumulé en minutes de l'itinéraire entre la ressource et l'incident. |
Total_Miles | Distance à parcourir cumulée en miles de l'itinéraire entre la ressource et l'incident. |
Total_Kilometers | Distance à parcourir cumulée en kilomètres de l'itinéraire entre la ressource et l'incident. |
StartTime | L'heure de début de l'itinéraire, signalée en heure locale au premier arrêt. |
EndTime | L'heure de fin de l'itinéraire, signalée en heure locale au dernier arrêt. |
StartTimeUTC | L'heure de départ de l'itinéraire en temps universel coordonné (UTC). |
EndTimeUTC | L'heure de fin de l'itinéraire en temps universel coordonné (UTC). |
output_directions
Utilisez ce paramètre pour accéder à la feuille de route détaillée de chaque itinéraire obtenu entre les ressources et les incidents. Le paramètre inclut la feuille de route, ainsi que la géométrie de l'entité de feuille de route correspondant au texte. La forme de l'entité de feuille de route est fonction des rues sous-jacentes incluses dans l'itinéraire. Les géométries des entités sont renvoyées dans la référence spatiale spécifiée en tant que paramètre env:outSR. Les entités sont vides si le paramètre populate_directions est false. Les paramètres directions_language, directions_distance_units et directions_style_name ont une grande influence sur la feuille de route.
Voici une description des champs renvoyés pour chaque entité de feuille de route :
Nom du champ | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
IdObjet | Identifiant unique de l'entité de feuille de route. Cet identifiant est généré automatiquement par le service. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
RouteName | Nom de l'itinéraire auquel l'action de conduite s'applique. Cette valeur est identique à l'attribut Nom du paramètre output_routes. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ArriveTime | Heure de la journée à laquelle commence une action de conduite donnée. Si l'itinéraire couvre plusieurs jours, la date et l'heure du jour sont affichées. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Type | Indique le type de manœuvre que l'entité de feuille de route représente ou le type du texte de la feuille de route. Pour déterminer si Type se rapporte à un type de manœuvre ou à un type de chaîne de feuille de route, vous devez vérifier la valeur de SubItemType. Type peut être utilisé, par exemple, pour attribuer une icône différente à un texte de feuille de route en fonction du type de manœuvre ou pour utiliser un style de mise en forme spécial en fonction du type de chaîne de feuille de route lorsque vous affichez les feuilles de route dans vos applications La valeur Type est un entier des tables Types de manœuvres ou Types de chaînes de feuilles de route ci-dessous. Types de manœuvres
Types de chaînes de feuilles de route
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
SubItemType | Indique si le champ Type se rapporte à un entier de la table Types de chaînes de feuilles de route ou de la table Types de manœuvres.
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Texte | Texte descriptif du trajet. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ElaspsedTime | Temps écoulé en minutes entre le début du trajet actuel et le suivant ou entre le début du trajet actuel et la fin de l'itinéraire pour le dernier trajet. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
DriveDistance | Distance entre le début du trajet actuel et le suivant ou entre le début du trajet actuel et la fin de l'itinéraire pour le dernier trajet. La valeur est exprimée dans les unités spécifiées par le paramètre distance_units. Cette valeur est nulle pour les trajets qui commencent au même emplacement que le suivant. Par exemple, la valeur DriveDistance est égale à 0 pour le texte de la feuille de route au début de l'itinéraire. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Shape_Length | Longueur de l'entité de feuille de route dans les unités de la référence spatiale spécifiée pour les itinéraires. Par défaut, la longueur est signalée en degrés décimaux si le paramètre env:outSR n'est pas spécifié. |
solve_succeeded
Utilisez ce paramètre pour déterminer si le service a réussi à générer les itinéraires. Les messages d'erreur de l'échec peuvent s'obtenir en émettant une requête visant à obtenir le statut de la tâche.