Résumé
Recherche une ou plusieurs ressources les plus proches d'un incident d'après le temps de trajet, la distance et autres coûts, et génère en sortie le meilleur itinéraire, la ressource choisie et les directions entre l'incident et la ressource. Vous pouvez, par exemple, utiliser cet outil pour rechercher l'hôpital le plus proche d'un accident, des voitures de police les plus proches du lieu d'un crime ou le point de vente le plus proche de l'adresse d'un client.
Lorsque vous recherchez les ressources les plus proches, vous pouvez spécifier le nombre de ressources à rechercher ainsi que le sens de déplacement vers ou depuis ces ressources. Si votre jeu de données réseau prend en charge la circulation, vous pouvez même spécifier l'heure du jour afin de tenir compte des temps de trajet pour cette heure et cette date. Par exemple, vous pouvez utiliser cet outil pour rechercher les hôpitaux situés à moins de 15 minutes en voiture du site d'un accident à une heure donnée de la journée. Tous les hôpitaux situés à plus de 15 minutes d'après les conditions de circulation ne seront pas inclus dans les résultats.
En savoir plus sur la sortie de l'outil Rechercher les ressources les plus proches
Utilisation
La boîte de dialogue de cet outil regroupe divers paramètres facultatifs dans les six catégories suivantes pour vous permettre de mieux les gérer :
- Analyse avancée
- Interruptions
- Mode de déplacement personnalisé
- Jeu de données réseau
- Localisations du réseau
- Sortie
- Fonctionnalités de service
Syntaxe
arcpy.na.FindClosestFacilities(Incidents, Facilities, Measurement_Units, Network_Dataset, Output_Geodatabase, Output_Routes_Name, Output_Directions_Name, Output_Closest_Facilities_Name, {Number_of_Facilities_to_Find}, {Default_Cutoff}, {Travel_Direction}, {Time_of_Day}, {Time_of_Day_Usage}, {Time_Zone_for_Time_of_Day}, {UTurn_Policy}, {Point_Barriers}, {Line_Barriers}, {Polygon_Barriers}, {Time_Attribute}, {Time_Attribute_Units}, {Distance_Attribute}, {Distance_Attribute_Units}, {Use_Hierarchy_in_Analysis}, {Restrictions}, {Attribute_Parameter_Values}, {Accumulate_Attributes}, {Maximum_Snap_Tolerance}, {Feature_Locator_WHERE_Clause}, {Route_Shape}, {Route_Line_Simplification_Tolerance}, {Populate_Directions}, {Directions_Language}, {Directions_Distance_Units}, {Directions_Style_Name}, {Maximum_Features_Affected_by_Point_Barriers}, {Maximum_Features_Affected_by_Line_Barriers}, {Maximum_Features_Affected_by_Polygon_Barriers}, {Maximum_Facilities}, {Maximum_Facilities_to_Find}, {Maximum_Incidents}, {Force_Hierarchy_Beyond_Distance}, {Save_Output_Network_Analysis_Layer}, {Travel_Mode}, {Overrides}, {Save_Route_Data})
Paramètre | Explication | Type de données |
Incidents | Cet outil détermine les ressources les plus proches d'incidents ; ce paramètre spécifie ces incidents. Au moins un incident est nécessaire pour calculer une analyse. Vous pouvez définir les propriétés des incidents que vous spécifiez, comme leur nom ou le temps de service, en utilisant des attributs. Il s'agit des attributs suivants : OBJECTID - Champ d'ID géré par le système. SHAPE - Champ de géométrie qui indique l'emplacement géographique de l'incident. Name : nom de l’incident. Le nom est utilisé dans les trajets. Si le nom n'est pas spécifié, un nom unique accompagné du préfixe Location est automatiquement généré dans les itinéraires et trajets en sortie. ID : identifiant unique de l’incident. L’identifiant est inclus dans les itinéraires en sortie (comme le champ IncidentID) et peut servir à joindre des informations supplémentaires à partir des itinéraires en sortie, telles que la durée totale du trajet ou la distance totale, aux attributs de vos incidents, ou vice-versa. Si l’ID n’est pas spécifié, le service autogénère un identifiant unique pour chaque incident. AdditionalTime : durée de l’incident qui s’ajoute à la durée totale de l’itinéraire. Les unités de cette valeur attributaire sont spécifiées dans le paramètre Unités de mesure. La valeur attributaire est incluse dans l'analyse uniquement lorsque les unités de mesure sont temporelles. La valeur par défaut est 0. Si vous recherchez les casernes de pompiers les plus proches d’un incendie pour estimer les temps de réponse, l’attribut AdditionalTime peut stocker le temps nécessaire aux pompiers pour installer leur équipement sur le lieu de l’incident avant de commencer à combattre l’incendie. AdditionalDistance : distance supplémentaire parcourue sur le lieu de l’incident, qui s’ajoute à la distance totale de l’itinéraire. Les unités de cette valeur attributaire sont spécifiées dans le paramètre Unités de mesure. La valeur attributaire est incluse dans l'analyse uniquement lorsque les unités de mesure sont basées sur la distance. La valeur par défaut est 0. En règle générale, le lieu où se produit l'incident, chez soi par exemple, ne donne pas directement sur une rue : il est un peu en retrait de la route. La valeur attributaire peut être utilisée pour modéliser la distance entre le lieu où s'est effectivement produit l'incident et sa localisation sur la rue, s'il est important d'inclure cette distance dans la distance totale de trajet. CurbApproach : spécifie la direction selon laquelle un véhicule peut atteindre et quitter le lieu de l’incident. Le champ peut prendre l'une des valeurs entières suivantes (utilisez le code numérique, pas le nom de l'option fourni entre parenthèses) :
La propriété CurbApproach est conçue pour fonctionner avec les deux types de normes de conduite nationales : circulation à droite (comme en France et aux États-Unis) et circulation à gauche (Royaume-Uni). Tout d'abord, imaginons un incident qui s'est produit du côté gauche d'un véhicule. Il se situe toujours sur la gauche, que le véhicule circule du côté gauche ou du côté droit de la route. Avec les normes de conduite nationales, ce qui peut changer est votre décision d'aborder l'incident du côté droit ou du côté gauche du véhicule. Par exemple, si vous souhaitez atteindre le lieu de l'incident sans laisser une voie de circulation entre le véhicule et l'incident, vous choisissez Côté droit du véhicule (1) en France et aux Etats-Unis, mais Côté gauche du véhicule (2) au Royaume-Uni. | Feature Set |
Facilities | Cet outil recherche les ressources les plus proches d'incidents ; ce paramètre spécifie ces ressources. Au moins une ressource est nécessaire pour calculer une analyse. Vous pouvez définir les propriétés des ressources que vous spécifiez, comme leur nom ou le temps de service, en utilisant des attributs. Il s'agit des attributs suivants : Name : nom de la ressource. Le nom est utilisé dans les trajets. Si le nom n'est pas spécifié, un nom unique accompagné du préfixe Location est automatiquement généré dans les itinéraires et trajets en sortie. ID : Identifiant unique de la ressource. L’identifiant est inclus dans les itinéraires en sortie (en tant que champ FacilityID) et dans les ressources les plus proches en sortie (en tant que champs FacilityID). Le champ FacilityID peut servir à joindre des informations supplémentaires à partir des itinéraires en sortie, telles que la durée totale du trajet ou la distance totale, aux attributs de vos ressources, ou vice-versa. Si l’ID n’est pas spécifié, le service autogénère un identifiant unique pour chaque ressource. AdditionalTime : temps passé à la ressource, qui s’ajoute à la durée totale de l’itinéraire. Les unités de cette valeur attributaire sont spécifiées dans le paramètre Unités de mesure. La valeur attributaire est incluse dans l'analyse uniquement lorsque les unités de mesure sont temporelles. La valeur par défaut est 0. Si vous recherchez les casernes de pompiers les plus proches des incendies, AdditionalTime peut stocker le temps généralement nécessaire à une équipe pour distribuer les équipements de protection appropriés et quitter la caserne. AdditionalDistance : distance supplémentaire parcourue sur le lieu de la ressource, qui s’ajoute à la distance totale de l’itinéraire. Les unités de cette valeur attributaire sont spécifiées dans le paramètre Unités de mesure. La valeur attributaire est incluse dans l'analyse uniquement lorsque les unités de mesure sont basées sur la distance. La valeur par défaut est 0. En règle générale, une ressource, telle qu’une caserne de pompiers, ne se trouve pas directement sur une rue : elle est un peu en retrait de la route. AdditionalDistance peut modéliser la distance entre la ressource réelle et son emplacement sur la rue, s’il est important d’inclure cette distance dans la distance de trajet totale. CurbApproach : spécifie la direction selon laquelle un véhicule peut atteindre et quitter la ressource. Le champ peut prendre l'une des valeurs entières suivantes (utilisez le code numérique, pas le nom de l'option fourni entre parenthèses) :
La propriété CurbApproach est conçue pour fonctionner avec les deux types de normes de conduite nationales : circulation à droite (comme en France et aux États-Unis) et circulation à gauche (Royaume-Uni). Tout d'abord, imaginons une ressource qui se trouve du côté gauche d'un véhicule. Il se situe toujours sur la gauche, que le véhicule circule du côté gauche ou du côté droit de la route. Avec les normes de conduite nationales, ce qui peut changer est votre décision d'aborder la ressource du côté droit ou du côté gauche du véhicule. Par exemple, si vous souhaitez atteindre une ressource sans laisser une voie de circulation entre le véhicule et la ressource, vous choisissez Côté droit du véhicule (1) en France et aux Etats-Unis, mais Côté gauche du véhicule (2) au Royaume-Uni. | Feature Set |
Measurement_Units | Précisez les unités que vous souhaitez utiliser pour mesurer et afficher la durée ou la distance totale du trajet pour les itinéraires en sortie. L'outil recherche la ressource la plus proche en mesurant la durée ou la distance de trajet dans les rues. Les unités que vous choisissez pour ce paramètre déterminent si l’outil mesure la distance à parcourir ou la durée du trajet pour identifier la ressource la plus proche. Choisissez une unité de temps pour mesurer la durée du trajet. Pour mesurer la distance à parcourir, choisissez une unité de distance. Votre choix détermine également les unités utilisées par l'outil pour signaler la distance totale à parcourir ou la distance dans les résultats. Les choix suivants sont disponibles :
L'outil choisit d'utiliser l'attribut de coût de réseau spécifié dans le paramètre Attribut de temps ou Attribut de distance selon que les unités de mesure sélectionnées sont des unités basées sur le temps ou sur la distance. L'outil effectue la conversion d'unités nécessaire lorsque la valeur Unités de mesure diffère des unités de l'attribut de coût de temps ou de distance correspondant. | String |
Network_Dataset | Jeu de données réseau qui fait l'objet d'une analyse. Les jeux de données réseau représentent le plus souvent des réseaux de transport, mais aussi d'autres types de réseaux. Le jeu de données réseau doit présenter au moins un attribut de coût basé sur le temps et un autre basé sur la distance. | Network Dataset Layer |
Output_Geodatabase | Espace de travail en sortie. Cet espace de travail doit déjà exister. L’espace de travail en sortie par défaut est in_memory. | Workspace |
Output_Routes_Name | Nom du champ de la classe d'entités en sortie contenant des itinéraires ou les lignes reliant des incidents aux ressources les plus proches. Cette classe d'entités contient également, en tant qu'attribut, le coût total du trajet entre les incidents et les ressources les plus proches. La rubrique d'aide Sortie de l'outil Rechercher les ressources les plus proches décrit la structure de cette classe d'entités en sortie. | String |
Output_Directions_Name | Nom du champ de la classe d'entités en sortie contenant les directions. La rubrique d'aide Sortie de l'outil Rechercher les ressources les plus proches décrit la structure de cette classe d'entités en sortie. | String |
Output_Closest_Facilities_Name | Nom du champ de la classe d'entités en sortie contenant les ressources les plus proches. La rubrique d'aide Sortie de l'outil Rechercher les ressources les plus proches décrit la structure de cette classe d'entités en sortie. | String |
Number_of_Facilities_to_Find (Facultatif) | Spécifiez le nombre de ressources les plus proches à rechercher par incident. Cela s'avère utile dans des situations telles qu'un incendie où plusieurs pompes à incendie peuvent être requises auprès de différentes casernes de pompiers. Par exemple, vous pouvez rechercher les trois casernes de pompiers les plus proches d'un incendie. Si vous configurez un service à partir de cet outil et que vous souhaitez limiter l'utilisation des ressources, par exemple le temps de traitement sur votre serveur, utilisez le paramètre Nombre maximal de ressources à rechercher pour restreindre le nombre maximal de ressources qu'un utilisateur peut saisir dans la zone Nombre de ressources à rechercher. | Long |
Default_Cutoff (Facultatif) | Spécifiez la durée ou la distance totale du trajet à laquelle arrêter la recherche de ressources pour un incident donné. Par exemple, en recherchant les hôpitaux les plus proches du lieu d'un accident, une valeur limite de 15 minutes signifie que l'outil recherche l'hôpital le plus proche situé à moins de 15 minutes de l'incident. Si l'hôpital le plus proche est situé à 17 minutes, la recherche ne renvoie aucun itinéraire. Une valeur limite s'avère particulièrement utile lors de la recherche de plusieurs ressources. Les unités de ce paramètre sont spécifiées par le paramètre Unités de mesure. | Double |
Travel_Direction (Facultatif) | Spécifiez si vous souhaitez rechercher la ressource la plus proche en effectuant la mesure de l'incident vers la ressource ou de la ressource vers l'incident.
La recherche peut renvoyer différentes ressources selon la valeur de paramètre sélectionnée, car la durée du trajet dans certaines rues varie en fonction du sens de déplacement et des restrictions de sens unique. Par exemple, une ressource peut être située à 10 minutes en voiture de l'incident si le trajet est effectué de l'incident vers la ressource, mais à 15 minutes si le trajet est effectué de la ressource vers l'incident car la durée du trajet est plus longue dans ce sens. Si vous définissez une valeur Heure du jour, les résultats renvoyés par les options Ressource vers incident et Incident vers ressource peuvent être différents selon la densité du trafic. | String |
Time_of_Day (Facultatif) | Spécifie l'heure et la date auxquelles les itinéraires doivent commencer ou se terminer. La valeur détermine l'heure de début ou de fin de l'itinéraire selon la valeur du paramètre Utilisation de l'heure du jour. Si vous sélectionnez la date et l'heure actuelles pour ce paramètre, l'outil utilise les conditions de trafic réel pour trouver les ressources les plus proches ; la durée totale du trajet dépendra des conditions de circulation. Si votre jeu de données réseau contient des données de trafic réel ou historique, le fait de spécifier une heure permet une estimation plus précise de la durée du trajet entre l'incident et la ressource, car elle tient compte des conditions de circulation applicables à la date et à l'heure spécifiées. Le paramètre Fuseau horaire de l'heure de la journée spécifie si cette heure et cette date correspondent à l'heure UTC ou au fuseau horaire dans lequel la ressource se trouve et pendant lequel l'incident s'est produit. Quel que soit le paramètre Fuseau horaire de l'heure de la journée, si vos ressources et incidents sont dans plusieurs fuseaux horaires, l'outil applique les règles suivantes :
| Date |
Time_of_Day_Usage (Facultatif) | Indique si la valeur du paramètre Heure du jour représente l'heure de départ ou l'heure d'arrivée.
| String |
Time_Zone_for_Time_of_Day (Facultatif) | Spécifie le fuseau horaire du paramètre Heure du jour.
Quel que soit le paramètre Fuseau horaire de l'heure de la journée, si vos ressources et incidents sont dans plusieurs fuseaux horaires, l'outil applique les règles suivantes :
| String |
UTurn_Policy (Facultatif) | Règle de demi-tour aux jonctions. L'autorisation des demi-tours implique que le solveur puisse faire demi-tour au niveau d'une jonction et revenir en arrière par la même rue. Dans la mesure où les jonctions représentent des intersections de rues et des voies sans issue, différents véhicules peuvent faire demi-tour à certaines jonctions mais pas à d'autres, selon que la jonction représente une intersection ou une voie sans issue. Pour en tenir compte, le paramètre de règle de demi-tour est spécifié implicitement par le nombre de tronçons connectés à la jonction, également connu sous le nom de "valence de jonction". Les valeurs acceptables pour ce paramètre sont répertoriées ci-dessous ; chacune est suivie d'une description de sa signification en termes de valence de jonction.
La valeur de ce paramètre est remplacée lorsque le paramètre Mode de déplacement (Travel_Mode dans Python) est défini sur une valeur autre que Personnalisé. | String |
Point_Barriers (Facultatif) | Spécifie les interruptions ponctuelles qui sont divisées en deux types : les interruptions ponctuelles de restriction et les interruptions ponctuelles à coût ajouté. Elles restreignent temporairement la traversée de points sur le réseau ou leur ajoutent une impédance. Les interruptions ponctuelles sont définies par un jeu d'entités, et les valeurs attributaires que vous spécifiez pour les entités ponctuelles déterminent s'il s'agit d'interruptions de restriction ou d'interruptions à coût ajouté. Les champs de la table attributaire sont répertoriés et décrits ci-dessous. ObjectID: Champ d'ID géré par le système. Shape: Champ de géométrie qui indique l'emplacement géographique de l'objet d'analyse de réseau. Name: Nom de l'interruption. BarrierType : Spécifie si l'interruption restreint entièrement le trajet ou ajoute un coût de parcours correspondant. Deux options sont disponibles :
Utilisez la valeur 0 pour l'option Restriction et 2 pour Coût ajouté. Additional_Time: Indique le temps de trajet ajouté lorsque l'interruption est franchie. Ce champ est actif uniquement pour les interruptions à coût ajouté et uniquement si les unités de mesure sont temporelles. Cette valeur de champ doit être supérieure ou égale à zéro et ses unités identiques à celles spécifiées dans le paramètre Unités de mesure. Additional_Distance: Indique la distance ajoutée lorsque l'interruption est franchie. Ce champ est actif uniquement pour les interruptions à coût ajouté et uniquement si les unités de mesure sont basées sur la distance. La valeur de champ doit être supérieure ou égale à zéro et ses unités identiques à celles spécifiées dans le paramètre Unités de mesure. | Feature Set |
Line_Barriers (Facultatif) | Spécifie les interruptions linéaires qui restreignent temporairement leur passage. Les interruptions linéaires sont définies par un jeu d'entités. Les champs de la table attributaire sont répertoriés et décrits ci-dessous. ObjectID: Champ d'ID géré par le système. Shape: Champ de géométrie qui indique l'emplacement géographique de l'objet d'analyse de réseau. Name: Nom de l'interruption. | Feature Set |
Polygon_Barriers (Facultatif) | Spécifie les interruptions polygonales qui sont divisées en deux types : les interruptions polygonales de restriction et les interruptions polygonales à coût proportionné. Elles restreignent temporairement la traversée des parties du réseau qu'elles couvrent ou proportionnent leur impédance. Les interruptions polygonales sont définies par un jeu d'entités, et les valeurs attributaires que vous spécifiez pour les entités surfaciques déterminent s'il s'agit d'interruptions de restriction ou d'interruptions à coût proportionné. Les champs de la table attributaire sont répertoriés et décrits ci-dessous. ObjectID: Champ d'ID géré par le système. Shape: Champ de géométrie qui indique l'emplacement géographique de l'objet d'analyse de réseau. Name: Nom de l'interruption. BarrierType : Spécifie si la barrière restreint entièrement le trajet ou proportionne son coût de parcours correspondant. Deux options sont disponibles :
Utilisez la valeur 0 pour l'option Restriction et 1 pour Coût proportionné. ScaledTimeFactor: Il s'agit du facteur de multiplication du temps de trajet des rues intersectées par l'interruption. Ce champ est actif uniquement pour les interruptions à coût proportionné et uniquement si les unités de mesure sont temporelles. La valeur du champ doit être supérieure à zéro. ScaledDistanceFactor: Il s'agit du facteur de multiplication de la distance des rues intersectées par l'interruption. Cet attribut est actif uniquement pour les interruptions à coût proportionné et uniquement si les unités de mesure sont basées sur la distance. La valeur de l'attribut doit être supérieure à zéro. | Feature Set |
Time_Attribute (Facultatif) | Définit l’attribut de coût de réseau à utiliser lorsque la valeur des unités de mesure est une unité de temps. L'outil effectue la conversion des unités de temps nécessaire lorsque la valeur des unités de mesure diffère des unités de l'attribut de coût défini ici. En d'autres termes, les unités de temps de l'attribut de coût de réseau et de la limite par défaut ne doivent pas nécessairement être identiques. La valeur de ce paramètre est remplacée lorsque le paramètre Mode de déplacement (Travel_Mode dans Python) est défini sur une valeur autre que Personnalisé. | String |
Time_Attribute_Units (Facultatif) | Unités de l'attribut de temps. Vous pouvez explicitement définir les unités des attributs de temps, mais il est recommandé de ne rien transmettre ou de transmettre "#" et de laisser le solveur déterminer les unités. La valeur de ce paramètre est remplacée lorsque le paramètre Travel_Mode est défini sur une valeur autre que CUSTOM. | String |
Distance_Attribute (Facultatif) | Définit l'attribut de coût de réseau à utiliser lorsque la valeur des unités de mesure est une unité de distance. L'outil effectue la conversion des unités de distance nécessaire lorsque la valeur des unités de mesure diffère des unités de l'attribut de coût défini ici. En d’autres termes, les unités de mesure et les unités de distance de l’attribut de coût de réseau ne doivent pas nécessairement être identiques. La valeur de ce paramètre est remplacée lorsque le paramètre Mode de déplacement (Travel_Mode dans Python) est défini sur une valeur autre que Personnalisé. | String |
Distance_Attribute_Units (Facultatif) | Unités de l'attribut de distance. Vous pouvez explicitement définir les unités des attributs de distance, mais il est recommandé de ne rien transmettre ou de transmettre "#" et de laisser le solveur déterminer les unités. La valeur de ce paramètre est remplacée lorsque le paramètre Travel_Mode est défini sur une valeur autre que CUSTOM. | String |
Use_Hierarchy_in_Analysis (Facultatif) | Indiquez si vous souhaitez utiliser une hiérarchie lorsque vous recherchez les itinéraires les plus courts entre les points.
Le paramètre n'est pas utilisé si aucun attribut de hiérarchie n'est défini dans le jeu de données réseau utilisé pour effectuer l'analyse. Dans ces cas, utilisez "#" comme valeur de paramètre. Vous pouvez utiliser le paramètre Force_Hierarchy_Beyond_Distance pour contraindre le solveur à utiliser la hiérarchie même si l'option Use_Hierarchy_in_Analysis est définie sur False. Ce paramètre est ignoré sauf si le paramètre Travel_Mode est défini sur CUSTOM. Lorsque vous modélisez un mode de marche à pied personnalisé, il est recommandé de désactiver la hiérarchie, car elle est conçue pour les véhicules motorisés. | Boolean |
Restrictions [restriction,...] (Facultatif) | Indique quels attributs de restriction réseau sont respectés lors de l'analyse. La valeur de ce paramètre est remplacée lorsque le paramètre Mode de déplacement (Travel_Mode dans Python) est défini sur une valeur autre que Personnalisé. | String |
Attribute_Parameter_Values (Facultatif) | Spécifie les valeurs de paramètre des attributs de réseau possédant des paramètres. Le jeu d’enregistrements comporte deux colonnes qui permettent d’identifier les paramètres de manière unique et une autre colonne qui spécifie la valeur du paramètre. La valeur de ce paramètre est remplacée lorsque le paramètre Mode de déplacement (Travel_Mode dans Python) est défini sur une valeur autre que Personnalisé. Le jeu d'enregistrements des valeurs de paramètre est associé à des attributs. Les champs de la table attributaire sont répertoriés et décrits ci-dessous. ObjectID: Champ d'ID géré par le système. AttributeName : Nom de l'attribut de réseau dont le paramètre d'attribut est défini par la ligne de table. ParameterName : Nom du paramètre d'attribut dont la valeur est définie par la ligne de table. (Les paramètres de type Objet ne peuvent pas être mis à jour à l’aide de cet outil.) ParameterValue : Valeur à utiliser pour le paramètre d'attribut. Si aucune valeur n'est spécifiée, le paramètre d'attribut est défini comme étant Null. | Record Set |
Accumulate_Attributes [attribute,...] (Facultatif) | Liste des attributs de coût à cumuler lors de l'analyse. Ces attributs d'accumulation sont fournis à titre de référence uniquement. Le solveur utilise uniquement l'attribut de coût spécifié par le paramètre Attribut de temps (Time_Attribute dans Python) ou Attribut de distance (Distance_Attribute dans Python) pour calculer les plus courts chemins. Pour chaque attribut de coût accumulé, un champ Total_[attribut] est ajouté aux itinéraires générés en sortie par le solveur. | String |
Maximum_Snap_Tolerance (Facultatif) | La tolérance de capture maximale spécifie la distance maximale recherchée par Network Analyst pour placer ou replacer un point sur le réseau. Network Analyst recherche des tronçons ou jonctions appropriés et capture le point sur l'élément le plus proche. Si aucun emplacement approprié n'est trouvé dans la tolérance de capture maximale, l'objet est marqué comme étant non localisé. | Linear Unit |
Feature_Locator_WHERE_Clause (Facultatif) | Expression SQL utilisée pour sélectionner un sous-ensemble d'entités source qui limite les éléments de réseau sur lesquels les ressources peuvent être placées. La syntaxe de ce paramètre comprend deux parties : la première est le nom de la classe d'entités source (suivi d'un espace) et la seconde est l'expression SQL. Pour écrire une expression SQL pour deux classes d'entités source ou plus, séparez-les par un point-virgule. Pour éviter que les ressources ne soient placées sur des autoroutes à accès limité, par exemple, écrivez une expression SQL telle que la suivant pour exclure ces entités source : "Streets" "FUNC_CLASS not in('1', '2')". A noter que les interruptions ignorent la clause WHERE du localisateur d'entités lors du chargement. | String |
Route_Shape (Facultatif) | Spécifiez le type des entités itinéraires générées par l'outil. Le paramètre peut être spécifié avec une des valeurs suivantes :
Lorsque le paramètre Forme d'itinéraire est défini sur Géométrie réelle, vous pouvez contrôler davantage la généralisation de la forme d'itinéraire en utilisant les valeurs appropriées pour le paramètre Tolérance de simplification des lignes de tournées. Quelle que soit la valeur que vous choisissez pour le paramètre Forme d'itinéraire, le meilleur itinéraire est toujours déterminé en minimisant le temps ou la distance du trajet, sans jamais utiliser la distance en ligne droite entre les incidents et les ressources. Cela signifie que seules les formes d'itinéraire sont différentes, pas les rues sous-jacentes dans lesquelles effectuer la recherche d'itinéraire. | String |
Route_Line_Simplification_Tolerance (Facultatif) | Indique dans quelle proportion vous souhaitez simplifier la géométrie de l'itinéraire. L'outil ignore ce paramètre si le paramètre Route_Shape n'est pas défini sur TRUE_LINES_WITH_MEASURES ou TRUE_LINES_WITHOUT_MEASURES. La simplification conserve les points critiques sur un itinéraire, comme les virages dans les intersections, pour définir la forme globale de l'itinéraire et supprimer d'autres points. La distance de simplification que vous spécifiez est le décalage maximal autorisé de la ligne simplifiée par rapport à la ligne d'origine. La simplification d'une ligne diminue le nombre de sommets qui appartiennent à la géométrie de l'itinéraire. Cette opération améliore le temps d'exécution de l'outil. La valeur de ce paramètre est remplacée lorsque le paramètre Mode de déplacement (Travel_Mode dans Python) est défini sur une valeur autre que Personnalisé. | Linear Unit |
Populate_Directions (Facultatif) | Spécifiez si l'outil doit générer des feuilles de route pour chaque itinéraire.
| Boolean |
Directions_Language (Facultatif) | Spécifiez la langue à utiliser lors de la génération des feuilles de route. Ce paramètre est utilisé uniquement lorsque le paramètre Charger les feuilles de route est activé ou défini sur True. Les langues de directions disponibles dépendent des modules linguistiques d'ArcGIS installés sur votre ordinateur. Les valeurs sont saisies sous la forme de codes de langue à deux ou cinq caractères, par exemple, en pour l'anglais ou zh-CN pour le chinois simplifié. Si un code de langue non pris en charge est spécifié, l'outil renvoie la feuille de route dans la langue par défaut, à savoir l'anglais. | String |
Directions_Distance_Units (Facultatif) | Spécifiez les unités dans lesquelles afficher la distance de trajet dans les feuilles de route. Ce paramètre est utilisé uniquement lorsque le paramètre Charger les feuilles de route est activé ou défini sur True.
| String |
Directions_Style_Name (Facultatif) | Spécifiez le nom du style de mise en forme pour la feuille de route. Ce paramètre est utilisé uniquement lorsque le paramètre Populate Directions (Charger les feuilles de route) est activé ou défini sur True. Le paramètre peut être spécifié avec les valeurs suivantes :
| String |
Maximum_Features_Affected_by_Point_Barriers (Facultatif) | Limite le nombre d'entités pouvant être affectées par des interruptions ponctuelles. Ce paramètre permet de contrôler la charge de traitement lors de l'analyse. Par exemple, vous pouvez attribuer une valeur faible à ce paramètre pour une version gratuite du service que vous créez et utiliser une valeur plus élevée pour une version payante du service. Une valeur Null indique qu'il n'existe pas de limite. | Long |
Maximum_Features_Affected_by_Line_Barriers (Facultatif) | Limite le nombre d'entités pouvant être affectées par des interruptions linéaires. Ce paramètre permet de contrôler la charge de traitement lors de l'analyse. Par exemple, vous pouvez attribuer une valeur faible à ce paramètre pour une version gratuite du service que vous créez et utiliser une valeur plus élevée pour une version payante du service. Une valeur Null indique qu'il n'existe pas de limite. | Long |
Maximum_Features_Affected_by_Polygon_Barriers (Facultatif) | Limite le nombre d'entités pouvant être affectées par des interruptions polygonales. Ce paramètre permet de contrôler la charge de traitement lors de l'analyse. Par exemple, vous pouvez attribuer une valeur faible à ce paramètre pour une version gratuite du service que vous créez et utiliser une valeur plus élevée pour une version payante du service. Une valeur Null indique qu'il n'existe pas de limite. | Long |
Maximum_Facilities (Facultatif) | Limite le nombre de ressources pouvant être ajoutées à l'analyse de la ressource la plus proche. Ce paramètre permet de contrôler la charge de traitement lors de l'analyse. Par exemple, vous pouvez attribuer une valeur faible à ce paramètre pour une version gratuite du service que vous créez et utiliser une valeur plus élevée pour une version payante du service. Une valeur Null indique qu'il n'existe pas de limite. | Long |
Maximum_Facilities_to_Find (Facultatif) | Limite le nombre de ressources que l'utilisateur peut demander au service de trouver. Ce paramètre permet de contrôler la charge de traitement lors de l'analyse. Par exemple, vous pouvez attribuer une valeur faible à ce paramètre pour une version gratuite du service que vous créez et utiliser une valeur plus élevée pour une version payante du service. Une valeur Null indique qu'il n'existe pas de limite. | Long |
Maximum_Incidents (Facultatif) | Limite le nombre d'incidents pouvant être ajoutés à l'analyse de la ressource la plus proche. Ce paramètre permet de contrôler la charge de traitement lors de l'analyse. Par exemple, vous pouvez attribuer une valeur faible à ce paramètre pour une version gratuite du service que vous créez et utiliser une valeur plus élevée pour une version payante du service. Une valeur Null indique qu'il n'existe pas de limite. | Long |
Force_Hierarchy_Beyond_Distance (Facultatif) | Indique la valeur de distance au-delà de laquelle le solveur forcera la hiérarchie, même si celle-ci n'est pas activée, lors de la recherche des ressources les plus proches. Les unités de ce paramètre sont les mêmes que celles affichées dans le paramètre Unités des attributs de distance. La recherche des ressources les plus proches qui sont éloignées lors de l'utilisation de la hiérarchie du réseau entraîne généralement moins de traitement que la recherche des mêmes ressources les plus proches sans la hiérarchie. Ce paramètre permet de contrôler la charge de traitement lors de l'analyse. Une valeur Null indique que la hiérarchie ne sera jamais activée ; la valeur du paramètre Utiliser la hiérarchie lors de l’analyse sera toujours respectée. Si le jeu de données réseau en entrée ne prend pas la hiérarchie en charge, une erreur se produit lorsque vous spécifiez une valeur pour ce paramètre. Dans ce cas, vous devez utiliser une valeur Null. | Double |
Save_Output_Network_Analysis_Layer (Facultatif) |
Dans tous les cas, des classes d'entités comportant des itinéraires et des feuilles de route sont renvoyées. Cependant, un administrateur de serveur peut choisir de générer également une couche d'analyse de réseau pour que la configuration et les résultats de l'outil puissent être débogués à l'aide des commandes de Network Analyst dans l'environnement ArcGIS Desktop. Le processus de débogage peut en être grandement facilité. Dans ArcGIS Desktop, l'emplacement en sortie par défaut de la couche d'analyse de réseau se trouve dans le dossier temporaire. Vous pouvez déterminer l'emplacement du dossier temporaire en évaluant la valeur de l'environnement de géotraitement arcpy.env.scratchFolder. La couche d'analyse de réseau en sortie est stockée en tant que fichier LYR dont le nom commence par _ags_gpna et est suivi d'un GUID alphanumérique. | Boolean |
Travel_Mode (Facultatif) | Choisissez le mode de transport pour l’analyse. CUSTOM est toujours proposé. Pour que les autres modes de déplacement apparaissent, ils doivent être présents dans le jeu de données réseau spécifié dans le paramètre Network_Dataset. (La fonction arcpy.na.GetTravelModes fournit un dictionnaire des objets du mode de déplacement qui sont configurés sur un jeu de données réseau et la propriété name renvoie le nom d’un objet du mode de déplacement.) Un mode de déplacement est défini sur un jeu de données réseau et offre des valeurs de remplacement des paramètres qui, ensemble, modélisent la voiture, le camion, le piéton et d’autres modes de déplacement. En choisissant ici un mode de déplacement, vous n'avez pas besoin de fournir des valeurs pour les paramètres suivants, qui sont remplacés par les valeurs spécifiées dans le jeu de données réseau :
| String |
Overrides (Facultatif) | Spécifiez des paramètres supplémentaires pouvant influencer le comportement du solveur lorsque vous recherchez des solutions pour résoudre les problèmes d'analyse du réseau. La valeur de ce paramètre doit être spécifiée au format JSON (JavaScript Object Notation). Une valeur valide, par exemple, a le format suivant : {"overrideSetting1" : "value1", "overrideSetting2" : "value2"}. Le nom du paramètre de remplacement est toujours spécifié entre des guillemets doubles. Les valeurs peuvent être un nombre, une valeur booléenne ou une chaîne. Par défaut, aucune valeur ne doit être spécifiée pour ce paramètre, ce qui signifie qu'il est déconseillé de remplacer les paramètres du solveur. Les valeurs de remplacement sont des paramètres avancés qui ne doivent être utilisés qu'après une analyse approfondie des résultats obtenus avant et après leur application. Vous pouvez obtenir auprès du support technique d'Esri une liste des paramètres de remplacement pris en charge, ainsi que leurs valeurs acceptables, pour chaque solveur. | String |
Save_Route_Data (Facultatif) | Indiquez si la sortie inclut 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 le portail. Dans ArcGIS Desktop, l'emplacement en sortie par défaut de ce fichier en sortie se trouve dans le dossier temporaire. Vous pouvez déterminer l'emplacement du dossier temporaire en évaluant la valeur de l'environnement de géotraitement arcpy.env.scratchFolder.
| Boolean |
Sortie dérivée
Nom | Explication | Type de données |
Output_Routes | Itinéraires obtenus entre les ressources et les incidents. | Jeu d'entités |
Output_Directions | Feuille de route détaillée de chaque itinéraire obtenu entre les ressources et les incidents. | Jeu d'entités |
Solve_Succeeded | Indique si la résolution de l’analyse de la ressource la plus proche a réussi. | Booléen |
Output_Closest_Facilities | Ressources les plus proches des incidents. | Jeu d'entités |
Output_Network_Analysis_layer | Couche d’analyse de réseau avec des propriétés dont la configuration correspond à celle des paramètres d’outil, pouvant être utilisée pour réaliser d’autres analyses ou des opérations de débogage sur la carte. | Fichier |
Output_Route_Data | Fichier zip contenant toutes les informations sur un itinéraire donné. | Fichier |
Exemple de code
Exemple 1 d'utilisation de l'outil FindClosestFacilities (fenêtre Python)
Exécutez l'outil FindClosestFacilities avec les paramètres requis.
import arcpy
incidents = arcpy.FeatureSet()
incidents.load("Stores")
facilities = arcpy.FeatureSet()
facilities.load("Warehouses")
arcpy.na.FindClosestFacilities(incidents, facilities, "Minutes",
"Streets_ND", "in_memory", "Routes",
"Directions", "CLosestFacilities",
Number_of_Facilities_to_Find=1)
Exemple 2 d'utilisation de l'outil FindClosestFacilities (script autonome)
Le script Python autonome suivant illustre l'utilisation de l'outil FindClosestFacilities afin de déterminer les points de vente les plus proches d'un entrepôt. Vous pouvez modifier le script pour qu'il utilise d'autres entrées afin de trouver l'ambulance la plus proche d'un accident, l'équipe d'intervention la plus proche d'une ligne électrique endommagée, etc.
# Name: FindClosestFacilities_Workflow.py
# Description: For each store, find the closest warehouse. The output will show
# the routes between stores and warehouses, driving directions,
# and the subset of warehouses that were closest to stores.
# Requirements: Network Analyst Extension
#Import system modules
import arcpy
from arcpy import env
try:
#Check out the Network Analyst extension license
arcpy.CheckOutExtension("Network")
#Set environment settings
env.workspace = r'C:\arcgis\ArcTutor\Network Analyst\Tutorial\Paris.gdb'
env.overwriteOutput = True
#Set local variables
inNetworkDataset = r'Transportation\ParisMultimodal_ND'
inIncidents = r'Analysis\Stores'
inFacilities = r'Analysis\Warehouses'
outGeodatabase = r'C:\arcgis\ArcTutor\Network Analyst\Tutorial\Output.gdb'
outRoutes = "Routes"
outDirections = "Directions"
outClosestFacilities = "ClosestFacilities"
measurement_units = "Minutes"
# Run FindClosestFacilities. Choose to find only the closest facility.
arcpy.na.FindClosestFacilities(inIncidents, inFacilities, measurement_units,
inNetworkDataset, outGeodatabase, outRoutes,
outDirections, outClosestFacilities,
Number_of_Facilities_to_Find=1)
print "Script completed successfully"
except Exception as e:
# If an error occurred, print line number and error message
import traceback, sys
tb = sys.exc_info()[2]
print "An error occured on line %i" % tb.tb_lineno
print str(e)
Environnements
Informations de licence
- Basic: Requiert Network Analyst
- Standard: Requiert Network Analyst
- Advanced: Requiert Network Analyst