Sortie de l’outil Rechercher les ressources les plus proches

S’il s’exécute avec succès, le service renvoie le meilleur itinéraire entre l’incident et la ressource choisie et la feuille de route correspondante, ainsi que 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 installation 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 mode d’évaluation de la ressource au cours de l’analyse. Les valeurs possibles sont les suivantes : 0 (OK) : la ressource a été située sur le réseau de transport et analysée. 1 (Non situé) : la ressource n’a pas été incluse dans l’analyse car aucune route traversable n’a été trouvée dans la distance de recherche maximale à partir de la ressource. 3 (Éléments non traversables) : l’élément de réseau où se trouve la ressource n’est pas traversable. Cette situation peut se produire lorsque l'élément de réseau est restreint par un attribut de restriction. 4 (Valeurs de champs non valides) : les valeurs de champs se trouvent en dehors d’une plage ou d’un domaine de valeurs précodées. Par exemple, un nombre négatif peut se trouver à l'endroit où des nombres positifs sont requis. 5 (Non atteint) : la ressource n’a pas pu être atteinte en raison des contraintes. Par exemple, une approche du trottoir est définie de sorte qu’un véhicule doive se déplacer dans le mauvais sens dans une rue à sens unique pour atteindre la ressource. 7 (Non situé sur le plus proche) : la localisation de réseau la plus proche de la ressource n’est pas traversable en raison d’une restriction ou d’une interruption. La ressource a par conséquent été positionnée sur l’entité de réseau traversable la plus proche.
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 sur 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 sur 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 :

Terrain	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 mode d’évaluation de l’incident au cours de l’analyse. Les valeurs possibles sont les suivantes : 0 (OK) : l’incident a été localisé sur le réseau de transport et analysé. 1 (Non situé) : l’incident n’a pas été inclus dans l’analyse car aucune route traversable n’a été trouvée dans la distance de recherche maximale à partir de l’incident. 3 (Élément non traversable) : l’élément de réseau où se trouve l’incident n’est pas traversable. Cette situation peut se produire lorsque l’élément est restreint par un attribut de restriction. 4 (Valeurs de champs non valides) : les valeurs de champs se trouvent en dehors d’une plage ou d’un domaine de valeurs précodées. Par exemple, un nombre négatif peut se trouver à l'endroit où des nombres positifs sont requis. 5 (Non atteint) : l’incident n’a pas pu être atteint en raison des contraintes. Par exemple, une approche du trottoir est définie de sorte qu’un véhicule doive se déplacer dans le mauvais sens dans une rue à sens unique pour atteindre l’incident. 7 (Non situé sur le plus proche) : la localisation de réseau la plus proche de l’incident n’est pas traversable en raison d’une restriction ou d’une interruption. L’incident a par conséquent été positionné sur l’entité de réseau traversable la plus proche.
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 :

Terrain	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 0 : Inconnu 1 : Arrivée à l’arrêt 2 : Aller tout droit 3 : Prendre à gauche 4 : Prendre à droite 5 : Tourner à gauche 6 : Tourner à droite 7 : Serrer à gauche 8 : Serrer à droite 9 : Faire demi-tour 10 : Prendre le ferry 11 : Prendre le rond-point 12 : Rejoindre l’autoroute 13 : Quitter l’autoroute 14 : Accéder à une autre autoroute 15 : Au carrefour, rester au centre 16 : Au carrefour, rester à gauche 17 : Au carrefour, rester à droite 18 : Quitter l’arrêt 19 : Élément de planification du trajet 20 : Fin du ferry 21 : Bretelle droite 22 : Bretelle gauche 23 : Prendre à gauche et immédiatement à droite 24 : Prendre à droite et immédiatement à gauche 25 : Prendre à droite et immédiatement à droite 26 : Prendre à gauche et immédiatement à gauche Types de chaînes de feuilles de route 0 : Type de chaîne de feuille de route générale 1 : Type de chaîne de feuille de route de départ 2 : Type de chaîne de feuille de route d’arrivée 3 : Type de chaîne de feuille de route de longueur 4 : Type de chaîne de feuille de route de temps 5 : Type de chaîne de feuille de route de résumé temporel 6 : Type de chaîne de feuille de route de fenêtre horaire 7 : Type de chaîne de feuille de route de violation horaire 8 : Type de chaîne de feuille de route de temps d’attente 9 : Type de chaîne de feuille de route d’heure du service 10 : Type de chaîne de feuille de route d’heure d’arrivée estimée 11 : Type de chaîne de feuille de route de longueur cumulée 12 : Type de chaîne de feuille de route de nom de rue 13 : Type de chaîne de feuille de route de nom de rue secondaire 14 : Type de chaîne de feuille de route de panneau d’informations de domaine 15 : Type de chaîne de feuille de route de panneau d’informations de direction 16 : Type de chaîne de feuille de route de nom de rue perpendiculaire 17 : Type de chaîne de feuille de route de panneau de numéro de sortie
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. Si la valeur SubItemType est égale à 1, la valeur Type fait référence aux valeurs de la table Types de manœuvres. Si la valeur SubItemType est égale à 2, la valeur Type fait référence aux valeurs de la table Types de chaînes de feuilles de route.
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.

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 Output Route Data (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 JSON File (Fichier JSON) ou GeoJSON File (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 Output Result File (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 Copy Location (Copier l’emplacement) dans le menu contextuel du paramètre Output Result File (Fichier de résultats en sortie) de l’entrée correspondant à l’exécution de l’outil dans la fenêtre Geoprocessing Results (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 Output Network Analysis Layer (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.