S’il s’exécute avec succès, le service renvoie le meilleur itinéraire entre l’incident et la ressource choisie ainsi que la feuille de route correspondante, et affiche le statut indiquant si l’analyse a réussi à l’aide des paramètres en sortie suivants :
output_facilities et output_closest_facilities
Ce paramètre permet d’accéder aux ressources en sortie à partir d’une analyse de la ressource la plus proche.
Le paramètre output_closest_facilities inclut seulement les ressources issues du jeu de ressources en entrée qui étaient les plus proches d’au moins un incident. À l’inverse, le type de données output_facilities inclut toutes les ressources de l’analyse, notamment les ressources qui n’ont pas pu être atteintes depuis un incident. Vous pouvez utiliser le champ Status du type de données output_facilities pour déterminer la raison pour laquelle une ressource n’a pas été utilisée au cours de l’analyse.
La table suivante répertorie les champs renvoyés pour les ressources en sortie :
Nom du champ | Description |
---|---|
Name | Nom de la ressource. Les valeurs de ce champ sont copiées à partir du champ Name sur les ressources en entrée. |
SourceID | Identifiant numérique de la classe d’entités source du jeu de données réseau sur lequel se trouve le point en entrée. |
SourceOID | ObjectID de l’entité dans la source dans laquelle se trouve le point en entrée. |
PosAlong | Position le long du sens de numérisation de l’entité linéaire source. Cette valeur est stockée sous forme d’un ratio. Ce champ est nul si la localisation de réseau fait référence à une jonction. |
SideOfEdge | Côté du tronçon par rapport au sens de numérisation de l’entité linéaire. Ce champ est limité à un domaine de deux valeurs : Côté droit (1) et Côté gauche (2). |
CurbApproach | Direction dans laquelle un véhicule peut atteindre et quitter la ressource. Les valeurs de ce champ sont copiées à partir du champ CurbApproach sur les ressources en entrée. |
Status | Indique le statut du point par rapport à son emplacement sur le réseau et au résultat de l’analyse. Les valeurs possibles sont les suivantes :
|
SnapX | Coordonnée x de la position du jeu de données réseau où se trouvait le point, dans le système de coordonnées du jeu de données réseau. |
SnapY | Coordonnée y de la position du jeu de données réseau où se trouvait le point, dans le système de coordonnées du jeu de données réseau. |
SnapZ | Coordonnée z de la position du jeu de données réseau où se trouvait le point, dans le système de coordonnées du jeu de données réseau. Le champ SnapZ est égal à 0 si le réseau est en deux dimensions. |
DistanceToNetworkInMeters | Distance, exprimée en mètres, entre l’emplacement géographique du point et la position ou il se trouvait dans le réseau. |
AdditionalTime | Temps ajouté au temps total de l’itinéraire lors d’une visite de cette ressource. Les valeurs de ce champ sont copiées à partir du champ AdditionalTime sur les ressources en entrée. |
AdditionalDistance | Distance ajoutée à la distance totale de l’itinéraire lors d’une visite de cette ressource. Les valeurs de ce champ sont copiées à partir du champ AdditionalDistance sur les ressources en entrée. |
AdditionalCost | Coût ajouté à la distance totale de l’itinéraire lors d’une visite de cette ressource. Les valeurs de ce champ sont copiées à partir du champ AdditionalCost sur les ressources en entrée. Ce champ est inclus uniquement lorsque le mode de déplacement utilisé pour l’analyse possède un attribut d’impédance qui n’est basé ni sur le temps, ni sur la distance. |
Cutoff | Valeur d’impédance à laquelle l’analyse cesse de rechercher des ressources à partir d’un incident donné. Les valeurs de ce champ sont copiées à partir du champ Cutoff sur les ressources en entrée. |
ID | Identifiant unique de la ressource. Les valeurs de ce champ sont copiées à partir du champ ID sur les ressources en entrée. |
ORIG_FID FacilityOID | Valeur ObjectID de la ressource en entrée. Ce champ est souvent utilisé pour joindre des informations à partir des ressources en entrée. La sortie ClosestFacilities inclut le champ ORIG_FID, et la sortie Facilities inclut le champ FacilityOID. |
Bearing | Les valeurs de ce champ sont copiées à partir du champ Bearing sur les ressources en entrée. |
BearingTol | Les valeurs de ce champ sont copiées à partir du champ BearingTol sur les ressources en entrée. |
NavLatency | Les valeurs de ce champ sont copiées à partir du champ NavLatency sur les ressources en entrée. |
output_routes
Ce paramètre donne accès à l’itinéraire ou aux itinéraires reliant les ressources aux incidents.
Les paramètres route_shape et route_line_simplification_tolerance ont une influence sur la forme des itinéraires en sortie.
Nom du champ | Description |
---|---|
Name | 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 le paramètre travel_direction a pour valeur Facility to Incident. 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 valeur du paramètre travel_direction, le nom de l’incident apparaît en premier. Par exemple, Incident 3 — Facility 5. |
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. |
FacilityID | ID unique de la ressource visitée par l'itinéraire. Les valeurs de ce champ sont copiées à partir du champ ID vers les ressources en entrée. |
FacilityOID | Valeur ObjectID 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. |
IncidentID | ID unique de l'incident visité par l'itinéraire. Les valeurs de ce champ sont copiées à partir du champ ID vers les incidents en entrée. |
IncidentOID | Valeur ObjectID 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. |
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. |
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. |
StartTime | L’heure de début de l’itinéraire, indiquée pour le fuseau horaire dans lequel se trouve le premier arrêt. |
EndTime | L’heure de fin de l’itinéraire, indiquée pour le fuseau horaire dans lequel se trouve le 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). |
Total_Minutes | Temps de trajet cumulé de l’itinéraire, exprimé en minutes, entre la ressource et l’incident. Ce paramètre inclut toute valeur AdditionalTime si cette dernière est spécifiée pour la ressource visitée et l’incident. Remarque :Un champ supplémentaire, Total_[TimeUnits], est inclus si le paramètre measurement_units est lié au temps et si sa valeur n’est pas Minutes. Les valeurs des champs sont exprimées dans les unités spécifiées par le paramètre measurement_units. Remarque :Des champs supplémentaires Total_[AccumulateAttributeName]_[TimeUnits] sont inclus pour chaque attribut de coût de type temporel cumulé au cours de l’analyse. |
Total_Miles | Distance à parcourir cumulée de l’itinéraire, exprimé en miles, entre la ressource et l’incident. Ce paramètre inclut toute valeur AdditionalDistance si cette dernière est spécifiée pour la ressource visitée et l’incident. Remarque :Un champ supplémentaire, Total_[DistanceUnits], est inclus si le paramètre measurement_units est lié à une distance et si sa valeur n’est pas Miles ou Kilometers. Les valeurs des champs sont exprimées dans les unités spécifiées par le paramètre measurement_units. Remarque :Des champs supplémentaires, Total_[AccumulateAttributeName]_[DistanceUnits], sont inclus pour chaque attribut de coût de distance, cumulé au cours de l’analyse. |
Total_Kilometers | Distance à parcourir cumulée en kilomètres de l’itinéraire entre la ressource et l’incident. Ce paramètre inclut toute valeur AdditionalDistance si cette dernière est spécifiée pour la ressource visitée et l’incident. Remarque :Un champ supplémentaire, Total_[DistanceUnits], est inclus si le paramètre measurement_units est lié à une distance et si sa valeur n’est pas Miles ou Kilometers. Les valeurs des champs sont exprimées dans les unités spécifiées par le paramètre measurement_units. Remarque :Des champs supplémentaires, Total_[AccumulateAttributeName]_[DistanceUnits], sont inclus pour chaque attribut de coût de distance, cumulé au cours de l’analyse. |
Total_Other | Le coût de déplacement cumulé est exprimé en unités inconnues de l’itinéraire reliant la ressource et l’incident. Ce paramètre inclut toute valeur AdditionalCost si cette dernière est spécifiée pour la ressource visitée et l’incident. Ce champ est inclus uniquement lorsque le mode de déplacement utilisé pour l’analyse possède un attribut d’impédance qui n’est basé ni sur le temps, ni sur la distance. Remarque :Des champs supplémentaires Total_[AccumulateAttributeName]_Other sont inclus pour chaque attribut de coût qui n’est relatif ni à une distance ni à un temps cumulé au cours de l’analyse. |
output_incidents
Ce paramètre donne accès aux emplacements utilisés en tant que points de départ ou d’arrivée dans une analyse de la ressource la plus proche.
La table suivante répertorie les champs renvoyés pour les incidents en sortie :
Champ | Description |
---|---|
Name | Nom de l’incident. Les valeurs de ce champ sont copiées à partir du champ Name sur les incidents en entrée. |
TargetFacilityCount | Le nombre de ressources à rechercher pour l’incident en question. Les valeurs de ce champ sont copiées à partir du champ TargetFacilityCount sur l’incident en entrée. |
SourceID | Identifiant numérique de la classe d’entités source du jeu de données réseau sur lequel se trouve le point en entrée. |
SourceOID | ObjectID de l’entité dans la source dans laquelle se trouve le point en entrée. |
PosAlong | Position le long du sens de numérisation de l’entité linéaire source. Cette valeur est stockée sous forme d’un ratio. Ce champ est nul si la localisation de réseau fait référence à une jonction. |
SideOfEdge | Côté du tronçon par rapport au sens de numérisation de l’entité linéaire. Ce champ est limité à un domaine de deux valeurs : Côté droit (1) et Côté gauche (2). |
CurbApproach | Direction dans laquelle un véhicule peut atteindre et quitter le lieu de l’incident. Les valeurs de ce champ sont copiées à partir du champ CurbApproach sur l’incident en entrée. |
Status | Indique le statut du point par rapport à son emplacement sur le réseau et au résultat de l’analyse. Les valeurs possibles sont les suivantes :
|
SnapX | Coordonnée x de la position du jeu de données réseau où se trouvait le point, dans le système de coordonnées du jeu de données réseau. |
SnapY | Coordonnée y de la position du jeu de données réseau où se trouvait le point, dans le système de coordonnées du jeu de données réseau. |
SnapZ | Coordonnée z de la position du jeu de données réseau où se trouvait le point, dans le système de coordonnées du jeu de données réseau. Le champ SnapZ est égal à 0 si le réseau est en deux dimensions. |
DistanceToNetworkInMeters | Distance, exprimée en mètres, entre l’emplacement géographique du point et la position ou il se trouvait dans le réseau. |
AdditonalTime | Temps ajouté au temps total de l’itinéraire lors d’une visite de cet incident. Les valeurs de ce champ sont copiées à partir du champ AdditionalTime sur l’incident en entrée. |
AdditionalDistance | Distance ajoutée à la distance totale de l’itinéraire lors d’une visite de cet incident. Les valeurs de ce champ sont copiées à partir du champ AdditionalDistance sur l’incident en entrée. |
AdditionalCost | Coût ajouté à la distance totale de l’itinéraire lors d’une visite de cet incident. Les valeurs de ce champ sont copiées à partir du champ AdditionalCost sur l’incident en entrée. Ce champ est inclus uniquement lorsque le mode de déplacement utilisé pour l’analyse possède un attribut d’impédance qui n’est basé ni sur le temps, ni sur la distance. |
Cutoff | Valeur d’impédance à laquelle l’analyse cesse de rechercher des incidents à partir d’une ressource donnée. Les valeurs de ce champ sont copiées à partir du champ Cutoff sur l’incident en entrée. |
IncidentOID | Valeur ObjectID de l’incident en entrée. Ce champ est souvent utilisé pour joindre des informations à partir des ressources en entrée. |
Bearing | Les valeurs de ce champ sont copiées à partir du champ Bearing sur les ressources en entrée. |
BearingTol | Les valeurs de ce champ sont copiées à partir du champ BearingTol sur les ressources en entrée. |
NavLatency | Les valeurs de ce champ sont copiées à partir du champ NavLatency sur les ressources en entrée. |
output_directions
Ce paramètre permet d’accéder à la feuille de route détaillée de chaque itinéraire obtenu.
La forme de l’entité de feuille de route est fonction des rues sous-jacentes incluses dans l’itinéraire.
Les paramètres Directions Language (Langue de la feuille de route), Directions Distance Units (Unités de distance de la feuille de route) et Directions Style Name (Nom de style de la feuille de route) affectent la feuille de route. Le paramètre renvoie des entités vides si le paramètre Populate Directions (Charger les feuilles de route) est défini sur False (Faux).
La table suivante répertorie les champs renvoyés pour les feuilles de route en sortie :
Champ | Description |
---|---|
RouteName | Nom de l’itinéraire auquel l’action de conduite s’applique. Cette valeur est identique à celle du champ Name des itinéraires en sortie. |
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 | Type de manœuvre que l’entité de feuille de route représente ou 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, vérifiez la valeur du champ SubItemType. Type peut être utilisé, par exemple, pour attribuer une icône à un texte de feuille de route en fonction du type de manœuvre. Il peut également 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 votre application. La valeur Type est un entier des listes 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.
|
Text | Texte descriptif de la feuille de route. |
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 Directions_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. |
output_direction_points
Spécifie la feuille de route étape par étape en sortie pour les itinéraires calculés dans l’analyse, représentée sous forme d’emplacements ponctuels le long des itinéraires pour lesquels des événements spécifiques ou des manœuvres ont lieu.
Nom du champ | Description |
---|---|
RouteID | Paramètre ObjectID de l’entité output_routes en sortie à laquelle est associé ce point de direction. |
Sequence | Séquence des points de direction pour l’itinéraire, en commençant par 1. |
DirectionPointType | Type d’événement de feuille de route ou de manœuvre décrit par le point, désigné par une des valeurs ci-dessous.
|
StopID | Paramètre ObjectID de l’arrêt auquel est associé ce point de direction, le cas échéant. Si le point ne représente pas un passage à un arrêt, la valeur est nulle. |
DisplayText | Texte de feuille de route à afficher dans l’application consommatrice. |
ArrivalTime | Heure à laquelle l’événement de feuille de route se produit, en temps universel coordonné (UTC). |
ArrivalUTCOffset | Différence (en minutes) entre l’heure locale à l’emplacement de la manœuvre et l’heure UTC affichée dans le champ ArrivalTime. |
Name | Nom du point de feuille de route. |
ExitName | Nom de la sortie d’autoroute qui apparaît sur la feuille de route. |
AlternateName | Nom de la source alternative qui apparaît sur la feuille de route. |
IntersectingName | Nom de la rue à l’intersection ou au croisement qui apparaît sur la feuille de route. |
BranchName | Nom du panneau qui apparaît sur la feuille de route. |
TowardName | Nom du panneau vers la destination qui apparaît sur la feuille de route. |
Level | Niveau du bâtiment auquel l’événement de feuille de route se produit. Cette valeur correspond à la propriété Level définie dans le jeu de données réseau utilisé pour l’analyse. En savoir plus sur la configuration de la feuille de route d’un jeu de données réseau |
ShortVoiceInstruction | Texte court à utiliser comme texte de guidage vocal dans l’application consommatrice. |
VoiceInstruction | Texte de remplissage, y compris avec les abréviations développées et les pluriels, à utiliser comme texte de guidage vocal dans l’application consommatrice. |
Azimuth | Relèvement en degrés du véhicule partant de ce point. Zéro correspond au nord. |
output_direction_lines
Spécifie les lignes d’itinéraire en sortie calculées dans l’analyse, sous forme de tranches afin de représenter chaque segment d’itinéraire entre l’événement DirectionPoints ou les emplacements de manœuvre.
Nom du champ | Description |
---|---|
DirectionPointID | Paramètre ObjectID de l’entité de la table output_direction_points à laquelle est associée cette ligne. |
RouteID | Paramètre ObjectID de l’entité output_routes en sortie à laquelle est associée cette ligne de direction. |
DirectionLineType | Type de situation de feuille de route décrit par cette ligne, désigné par une des valeurs ci-dessous.
|
Meters | Longueur du segment de ligne, en mètres. |
Minutes | Temps de trajet le long du segment de ligne, en minutes. |
FromLevel | Niveau du bâtiment auquel l’événement de feuille de route débute. Cette valeur correspond à la propriété Level définie dans le jeu de données réseau utilisé pour l’analyse. En savoir plus sur la configuration de la feuille de route d’un jeu de données réseau |
ToLevel | Niveau du bâtiment auquel l’événement de feuille de route se termine. Cette valeur correspond à la propriété Level définie dans le jeu de données réseau utilisé pour l’analyse. |
solve_succeeded
Utilisez ce paramètre pour déterminer si l’analyse a réussi.
output_route_data
Utilisez ce paramètre pour accéder à un fichier .zip contenant une géodatabase fichier qui renferme les entrées et sorties de l’analyse dans un format qui peut servir à partager les couches d’itinéraires avec ArcGIS Online ou Portal for ArcGIS. La valeur du paramètre n’est renseignée que si le paramètre Save Route Data (Enregistrer les données d’itinéraires) est défini sur True (Vrai).
Le fichier est téléchargé dans un répertoire temporaire sur votre machine. Dans ArcGIS Pro, il est possible de déterminer l’emplacement du fichier téléchargé en affichant la valeur du paramètre Données d’itinéraires en sortie dans l’entrée correspondant à l’exécution de l’outil dans l’historique de géotraitement de votre projet. Dans ArcMap, l’emplacement du fichier peut être déterminé via l'option Copier l'emplacement dans le menu contextuel du paramètre Données d'itinéraires en sortie de l’entrée correspondant à l’exécution de l’outil dans la fenêtre Résultats du géotraitement.
output_result_file
Utilisez ce paramètre pour accéder aux résultats issus de l’analyse figurant dans un fichier .zip qui renferme un ou plusieurs fichiers pour chaque sortie. Le format d’un fichier est spécifié par le paramètre Output Format (Format en sortie). La valeur du paramètre n’est pas renseignée si le paramètre Output Format (Format en sortie) est défini sur Feature Set (Jeu d’entités).
Lorsqu’un format en sortie basé sur un fichier, tel que Fichier JSON ou Fichier GeoJSON est spécifié, aucune sortie n’est ajoutée à l’affichage étant donné que l’application (comme ArcMap ou ArcGIS Pro) n’affiche pas le contenu du fichier de résultats. À la place, le fichier est téléchargé dans un répertoire temporaire sur votre machine. Dans ArcGIS Pro, il est possible de déterminer l’emplacement du fichier téléchargé en affichant la valeur du paramètre Fichier de résultats en sortie dans l’entrée correspondant à l’exécution de l’outil dans l’historique de géotraitement de votre projet. Dans ArcMap, l’emplacement du fichier peut être déterminé via l’option Copier l’emplacement dans le menu contextuel du paramètre Fichier de résultats en sortie de l’entrée correspondant à l’exécution de l’outil dans la fenêtre Résultats du géotraitement.
output_network_analysis_layer
Utilisez ce paramètre pour accéder au fichier de couche d’analyse de réseau qui stocke les paramètres d’analyse et les entrées et les sorties utilisées pour l’analyse. La valeur du paramètre n’est renseignée que si le paramètre Save Output Network Analysis Layer (Enregistrer la couche d’analyse de réseau en sortie) est défini sur True (Vrai).
Le fichier est téléchargé dans un répertoire temporaire sur votre machine. Dans ArcGIS Pro, il est possible de déterminer l’emplacement du fichier téléchargé en affichant la valeur du paramètre Couche d’analyse de réseau de résultats en sortie dans l’entrée correspondant à l’exécution de l’outil dans l’historique de géotraitement de votre projet. Dans ArcMap, l’emplacement du fichier peut être déterminé via l’option Copy Location (Copier l’emplacement) dans le menu contextuel du paramètre Output Network Analysis Layer (Couche d’analyse de réseau en sortie) de l’entrée correspondant à l’exécution de l’outil dans la fenêtre Geoprocessing Results (Résultats du géotraitement).
Remarque :
Vous ne pouvez pas utiliser ce fichier directement, même lorsque vous ouvrez le fichier dans une application ArcGIS Desktop telle qu’ArcMap, puisque sa source de données n’est pas valide. Le fichier doit être envoyé au support technique Esri qui évaluera la qualité des résultats renvoyés par l’outil.
Vous avez un commentaire à formuler concernant cette rubrique ?