Résumé
Recherche une ou plusieurs ressources les plus proches d’un incident d’après le temps de trajet ou la distance de trajet et génère les meilleurs itinéraires, la feuille de route entre les incidents et les ressources choisies, ainsi qu’une copie des ressources choisies. Vous pouvez, par exemple, utiliser l'outil pour rechercher l'hôpital le plus proche d'un accident, les 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. Vous pouvez même spécifier l'heure du jour afin de tenir compte des temps de trajet en fonction des conditions de trafic réelles ou de prévision pour cette heure et cette date. Par exemple, vous pouvez utiliser l'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.
Attention :
Pour obtenir des informations à jour sur cet outil, consultez la version la plus récente de cette rubrique dans l’aide web. ArcGIS Online effectue régulièrement des mises à jour fonctionnelles de ce type de services. L'aide installée peut par conséquent devenir obsolète.
En savoir plus sur la sortie de l'outil Rechercher les ressources les plus proches
Illustration
Utilisation
Les outils de la boîte d'outils Ready To Use (Prêt à l’emploi) sont des services de géotraitement ArcGIS Online qui utilisent les fonctionnalités d’analyse et les données hébergées de ArcGIS Online.
L’outil recherche les ressources les plus proches en fonction du temps de trajet si la valeur du paramètre Measurement Units (Unités de mesure) est temporelle. De même, l'outil utilise la distance de trajet si les unités de mesure reposent sur la distance.
Vous devez spécifier au moins une ressource et un incident pour exécuter l'outil. Vous pouvez charger un maximum de 5 000 ressources et 5 000 incidents et vous pouvez trouver jusqu'à 100 ressources les plus proches de chaque incident. Ainsi, chaque résolution de l'outil est capable de trouver jusqu'à 100 000 ressources les plus proches.
Vous pouvez ajouter jusqu'à 250 interruptions ponctuelles. Vous pouvez ajouter autant d'interruptions linéaires ou polygonales que vous voulez, mais les interruptions linéaires ne peuvent pas intersecter plus de 500 entités rues et les interruptions polygonales ne peuvent pas intersecter plus de 2 000 entités.
Vous pouvez utiliser la hiérarchie routière lors de la résolution d'un problème afin de générer les résultats plus rapidement, mais la solution risque d'être moins optimale.
Que le paramètre Use Hierarchy (Utiliser la hiérarchie) soit activé (True) ou non, la hiérarchie est toujours utilisée lorsque la distance en ligne droite entre des couples d’entités représentant des incidents ou des ressources est supérieure à 50 miles (80,46 kilomètres).
La distance en ligne droite entre des paires d'entités représentant des incidents ou des ressources ne peut pas être supérieure à 27 miles (43,45 kilomètres) lorsque le Mode de déplacement est défini sur la valeur Marche ou lorsqu'il est défini sur Personnalisé et que la restriction Marche est utilisée.
Si la distance entre un point en entrée et sa rue traversable la plus proche est supérieure à 12.42 miles (20 kilomètres), le point est exclu de l'analyse.
L'utilisation de ce service consomme des crédits. Pour plus d'informations, reportez-vous à Présentation des crédits de service.
Syntaxe
FindClosestFacilities(Incidents, Facilities, Measurement_Units, {Analysis_Region}, {Number_of_Facilities_to_Find}, {Cutoff}, {Travel_Direction}, {Use_Hierarchy}, {Time_of_Day}, {Time_of_Day_Usage}, {UTurn_at_Junctions}, {Point_Barriers}, {Line_Barriers}, {Polygon_Barriers}, {Restrictions}, {Attribute_Parameter_Values}, {Route_Shape}, {Route_Line_Simplification_Tolerance}, {Populate_Directions}, {Directions_Language}, {Directions_Distance_Units}, {Directions_Style_Name}, {Time_Zone_for_Time_of_Day}, {Travel_Mode}, {Impedance}, {Save_Output_Network_Analysis_Layer}, {Overrides}, {Save_Route_Data}, {Time_Impedance}, {Distance_Impedance}, {Output_Format})| Paramètre | Explication | Type de données |
Incidents | Emplacements qui seront utilisés comme points de départ ou d'arrivée dans une analyse de la ressource la plus proche. Vous pouvez spécifier un ou plusieurs incidents (jusqu'à 5 000). Il s'agit des emplacements à partir desquels l'outil recherche des emplacements à proximité. Vous pouvez définir les propriétés des incidents que vous spécifiez, comme leur nom ou le temps de service, à l'aide des attributs suivants : 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 issues 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 génère automatiquement un identifiant unique pour chaque incident. AdditionalTime Durée de l’incident qui s’ajoute à la durée totale de l’itinéraire. La valeur par défaut est 0. 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. Si vous recherchez les casernes de pompiers les plus proches d’un incendie pour estimer les délais de réaction, par exemple, 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. La valeur par défaut est 0. 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. 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 permet de modéliser la distance entre le lieu où s’est produit l’incident et sa localisation sur la rue, s’il est important d’inclure cette distance dans la distance totale de trajet. AdditionalCost Coût supplémentaire dépensé sur le lieu de l’incident, qui s’ajoute au coût total de l’itinéraire. La valeur par défaut est 0. Cette valeur attributaire doit être utilisée lorsque le mode de déplacement de l’analyse utilise un attribut d’impédance qui n’est basé ni sur le temps ni sur la distance. Les unités des valeurs attributaires sont interprétées en unités inconnues. TargetFacilityCount Le nombre de ressources à rechercher pour l’incident en question. Ce champ permet de spécifier un nombre différent de ressources à rechercher pour chaque incident. Par exemple, à l'aide de ce champ, vous pouvez rechercher les trois ressources les plus proches d'un incident et les deux ressources les plus proches d'un autre incident. Cutoff Valeur d’impédance à laquelle la recherche de ressources cesse pour un incident donné. Cet attribut permet de spécifier une valeur de limite différente pour chaque incident. Par exemple, à l’aide de cet attribut, vous pouvez rechercher des ressources dans un rayon de déplacement de cinq minutes d’un incident et rechercher des ressources dans un rayon de déplacement de huit minutes d’un autre incident. CurbApproach Spécifie la direction dans 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) :
L'attribut CurbApproach est conçu pour opérer avec les deux types de normes de conduite nationale : à droite (États-Unis) et à 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 de voie de circulation entre le véhicule et l’incident, vous choisissez 1 (Côté droit du véhicule) en France et aux États-Unis, mais 2 (Côté gauche du véhicule) au Royaume-Uni. Bearing Direction de déplacement d'un point. Les unités sont exprimées en degrés et sont mesurées dans le sens horaire, à partir du nord géographique. Ce champ est utilisé avec le champ BearingTol. En règle générale, les données de relèvement sont automatiquement envoyées à partir d'un périphérique mobile équipé d'un récepteur GPS. Essayez d’inclure des données de relèvement si vous chargez un emplacement en entrée qui se déplace, par exemple un piéton ou un véhicule. L'utilisation de ce champ vous évite d'ajouter des emplacements sur des tronçons incorrects, par exemple lorsqu'un véhicule se rapproche d'une intersection ou d'un passage supérieur. Le relèvement permet également à l'outil de déterminer plus facilement le côté de la rue où se trouve le point. En savoir plus sur le relèvement et la tolérance de relèvement BearingTol La valeur de tolérance de relèvement crée une plage de valeurs de relèvement acceptables lors de la localisation de points qui se déplacent sur un tronçon à l’aide du champ Bearing (Relèvement). Si la valeur du champ Bearing est comprise dans la plage de valeurs acceptables générées à partir de la tolérance de relèvement sur un tronçon, le point peut être ajouté à cet endroit en tant que localisation de réseau. Sinon, le point le plus proche sur le prochain tronçon le plus proche est évalué. Les unités sont exprimées en degrés et la valeur par défaut est 30. Les valeurs doivent être supérieures à zéro et inférieures à 180. Si la valeur est égale à 30, lorsque Network Analyst essaie d’ajouter un emplacement de réseau sur un tronçon, une plage de valeurs de relèvement acceptables est générée à 15 degrés de chaque côté du tronçon (gauche et droite) et dans les deux sens de numérisation du tronçon. En savoir plus sur le relèvement et la tolérance de relèvement NavLatency Ce champ n’est utilisé qu’au cours du processus de calcul si Bearing et BearingTol contiennent également des valeurs ; toutefois, vous n’êtes pas obligé d’entrer une valeur NavLatency, même si Bearing et BearingTol sont renseignés. NavLatency indique le temps censé s’écouler entre le moment où un véhicule se déplaçant envoie des informations GPS à un serveur et le moment où le dispositif de navigation du véhicule reçoit l’itinéraire traité. Les unités temporelles du champ NavLatency sont identiques à celles de la propriété timeUnits de l’objet d’analyse. | Feature Set |
Facilities | Emplacements qui seront utilisés comme points de départ ou d'arrivée dans une analyse de la ressource la plus proche. Vous pouvez spécifier une ou plusieurs ressources (jusqu'à 5 000). Il s'agit des sites dans lesquels effectuer la recherche des emplacements les plus proches. Vous pouvez définir les propriétés des ressources que vous spécifiez, comme leur nom ou le temps de service, à l'aide 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 et dans les ressources les plus proches en sortie, en tant que champs FacilityID. Le champ FacilityID peut servir à joindre des informations supplémentaires issues des itinéraires en sortie, telles que la durée totale du trajet ou la distance totale, aux attributs de vos ressources. Si l’ID n’est pas spécifié, le service génère automatiquement un identifiant unique pour chaque ressource. AdditionalTime Temps passé à la ressource, qui s’ajoute à la durée totale de l’itinéraire. La valeur par défaut est 0. 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. Si vous recherchez les casernes de pompiers les plus proches des incendies, par exemple, AdditionalTime peut stocker le temps nécessaire à une équipe pour distribuer les équipements de protection appropriés et quitter la caserne. AdditionalDistance Distance supplémentaire parcourue à la ressource, qui s’ajoute à la distance totale de l’itinéraire. La valeur par défaut est 0. 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. En règle générale, une ressource, telle qu’une caserne de pompiers, ne se trouve pas directement sur une rue, mais un peu en retrait de la route. AdditionalDistance peut modéliser la distance entre la ressource et son emplacement sur la rue s’il est important d’inclure cette distance dans la distance totale à parcourir. AdditionalCost Coût supplémentaire dépensé sur le lieu de la ressource, qui s’ajoute au coût total de l’itinéraire. La valeur par défaut est 0. Cette valeur attributaire doit être utilisée lorsque le mode de déplacement de l’analyse utilise un attribut d’impédance qui n’est basé ni sur le temps ni sur la distance. Les unités des valeurs attributaires sont interprétées en unités inconnues. Cutoff Valeur d’impédance à laquelle la recherche d’incidents cesse pour une ressource donnée. Cet attribut permet de spécifier une valeur de limite différente pour chaque ressource. Ainsi, avec cet attribut, vous pouvez rechercher les incidents qui se trouvent à cinq minutes d’une ressource et ceux qui se trouvent à huit minutes d’une autre ressource. CurbApproach Spécifie la direction dans 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) :
L'attribut CurbApproach est conçu pour opérer avec les deux types de normes de conduite nationale : à droite (États-Unis) et à 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 de voie de circulation entre le véhicule et la ressource, vous choisissez 1 (Côté droit du véhicule) en France et aux États-Unis, mais 2 (Côté gauche du véhicule) au Royaume-Uni. Bearing Direction de déplacement d'un point. Les unités sont exprimées en degrés et sont mesurées dans le sens horaire, à partir du nord géographique. Ce champ est utilisé avec le champ BearingTol. En règle générale, les données de relèvement sont automatiquement envoyées à partir d'un périphérique mobile équipé d'un récepteur GPS. Essayez d’inclure des données de relèvement si vous chargez un emplacement en entrée qui se déplace, par exemple un piéton ou un véhicule. L'utilisation de ce champ vous évite d'ajouter des emplacements sur des tronçons incorrects, par exemple lorsqu'un véhicule se rapproche d'une intersection ou d'un passage supérieur. Le relèvement permet également à l'outil de déterminer plus facilement le côté de la rue où se trouve le point. En savoir plus sur le relèvement et la tolérance de relèvement BearingTol La valeur de tolérance de relèvement crée une plage de valeurs de relèvement acceptables lors de la localisation de points qui se déplacent sur un tronçon à l’aide du champ Bearing (Relèvement). Si la valeur du champ Bearing est comprise dans la plage de valeurs acceptables générées à partir de la tolérance de relèvement sur un tronçon, le point peut être ajouté à cet endroit en tant que localisation de réseau. Sinon, le point le plus proche sur le prochain tronçon le plus proche est évalué. Les unités sont exprimées en degrés et la valeur par défaut est 30. Les valeurs doivent être supérieures à zéro et inférieures à 180. Si la valeur est égale à 30, lorsque Network Analyst essaie d’ajouter un emplacement de réseau sur un tronçon, une plage de valeurs de relèvement acceptables est générée à 15 degrés de chaque côté du tronçon (gauche et droite) et dans les deux sens de numérisation du tronçon. En savoir plus sur le relèvement et la tolérance de relèvement NavLatency Ce champ n’est utilisé qu’au cours du processus de calcul si Bearing et BearingTol contiennent également des valeurs ; toutefois, vous n’êtes pas obligé d’entrer une valeur NavLatency, même si Bearing et BearingTol sont renseignés. NavLatency indique le temps censé s’écouler entre le moment où un véhicule se déplaçant envoie des informations GPS à un serveur et le moment où le dispositif de navigation du véhicule reçoit l’itinéraire traité. Les unités temporelles du champ NavLatency sont identiques à celles de la propriété timeUnits de l’objet d’analyse. | Feature Set |
Measurement_Units | Précise les unités à 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 de trajet ou la distance à parcourir dans les rues. Les unités spécifiées 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 options sont les suivantes :
| String |
Analysis_Region (Facultatif) | Région dans laquelle effectuer l’analyse. Si aucune valeur n'est spécifiée pour ce paramètre, l'outil calcule automatiquement le nom de la région en fonction de l'emplacement des points en entrée. Il est recommandé de définir le nom de la région seulement si la détection automatique du nom de région n’est pas pertinente pour vos entrées. Pour indiquer une région, utilisez l'une des valeurs suivantes :
Héritage :Les noms des régions suivantes ne sont plus pris en charge et seront retirés dans une version ultérieure. Si vous spécifiez l’un des noms des régions obsolètes, l’outil lui attribue automatiquement un nom de région pris en charge.
| String |
Number_of_Facilities_to_Find (Facultatif) | Nombre de ressources les plus proches à rechercher par incident. Cela peut s'avérer utile dans les cas où plusieurs camions de pompiers de plusieurs casernes peuvent être requis (par exemple, lors d'un incendie). Par exemple, vous pouvez rechercher les trois casernes de pompiers les plus proches d'un incendie. La valeur définie dans ce paramètre peut être remplacée, pour un incident donné, à l’aide du champ TargetFacilityCount dans les incidents en entrée. L'outil peut rechercher jusqu'à 100 ressources à partir de chaque incident. | Long |
Cutoff (Facultatif) | Durée ou distance du trajet à laquelle la recherche de ressources pour un incident donné doit s'arrêter. Par exemple, lors de la recherche des 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. Lorsque le paramètre Travel Direction (Sens de déplacement) est défini sur Facility to Incident (Ressource vers incident), la limite peut être remplacée pour chaque ressource au moyen du champ Cutoff dans les ressources en entrée. Lorsque le paramètre Travel Direction (Sens de déplacement) est défini sur Incident to Facility (Incident vers Ressource), la limite peut être remplacée pour chaque incident au moyen du champ Cutoff dans les incidents en entrée. Les unités de ce paramètre sont spécifiées par le paramètre Measurement Units (Unités de mesure). | Double |
Travel_Direction (Facultatif) | Spécifie le mode de mesure du sens de déplacement pour la recherche de la ressource la plus proche.
La recherche peut renvoyer différentes ressources selon l'option 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 également une valeur pour le paramètre Time of Day (Heure du jour), les résultats renvoyés par les options Facility to Incident (Ressource vers incident) et Incident to Facility (Incident vers ressource) peuvent être différents selon la densité du trafic. Les services des pompiers utilisent en général la valeur de paramètre Facility to Incident (Ressource vers incident), car ils s’intéressent à la durée du trajet entre la caserne (ressource) et le site d’intervention (incident). Les responsables d’un point de vente (ressource) s’intéressent davantage au temps nécessaire aux acheteurs (incidents) pour atteindre le point de vente (ressource) ; par conséquent, les responsables de point de vente utilisent généralement l’option Incident to Facility (Incident vers ressource). | String |
Use_Hierarchy (Facultatif) | Indique si vous souhaitez utiliser une hiérarchie lorsque vous recherchez le meilleur itinéraire entre la ressource et l'incident.
L'outil réutilise automatiquement la hiérarchie si la distance en ligne droite entre les ressources et les incidents est supérieure à 50 milles (80 km), même si ce paramètre est Unchecked (Désactivé) (défini sur False dans Python). | Boolean |
Time_of_Day (Facultatif) | Date et heure auxquelles les itinéraires commencent ou se terminent. La valeur détermine l'heure de début ou de fin de l'itinéraire selon la valeur du paramètre Time of Day Usage (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 rechercher la ressource la plus proche ; la durée totale du trajet dépendra des conditions de trafic. Lorsque vous spécifiez une heure, l'estimation de la durée du trajet entre l'incident et la ressource est plus précise car elle tient compte des conditions de trafic applicables à la date et à l'heure spécifiées. Le paramètre Time Zone for Time of Day (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 ou pendant lequel l’incident s’est produit. | Date |
Time_of_Day_Usage (Facultatif) | Indique si la valeur du paramètre Time of Day (Heure du jour) représente l'heure de départ ou l'heure d'arrivée de l'itinéraire.
| String |
UTurn_at_Junctions (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. Étant donné que les jonctions représentent des intersections de rues et des voies sans issue, différents véhicules peuvent être en mesure de 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.
| String |
Point_Barriers (Facultatif) | Utilisez ce paramètre pour spécifier un ou plusieurs points servant de restrictions temporaires ou représentant un délai ou une distance supplémentaire qui peut être nécessaire pour se déplacer dans les rues sous-jacentes. Par exemple, une interruption ponctuelle peut servir à représenter un arbre tombé dans une rue ou le temps d'attente à un passage à niveau. L’outil impose une limite de 250 points à ajouter comme interruptions. Vous pouvez définir les propriétés des interruptions ponctuelles que vous spécifiez, comme leur nom ou type d’interruption, en utilisant les attributs suivants : Name Nom de l'interruption. BarrierType Spécifie si l’interruption ponctuelle restreint complètement la circulation ou ajoute un délai ou une distance lorsqu’elle est traversée. La valeur de cet attribut peut prendre l'une des valeurs entières suivantes (utilisez le code numérique, pas le nom de l'option fourni entre parenthèses) :
Additional_Time Temps de trajet ajouté lorsque l’interruption est franchie. Ce champ est actif uniquement pour les interruptions à coût ajouté et seulement si le mode de déplacement pour l’analyse fait appel à un attribut d’impédance basé sur le temps. 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 Distance ajoutée lorsque l’interruption est franchie. Ce champ est actif uniquement pour les interruptions à coût ajouté et seulement si le mode de déplacement pour l’analyse fait appel à un attribut d’impédance basé 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. Additional_Cost Coût ajouté lorsque l’interruption est franchie. Ce champ est actif uniquement pour les interruptions à coût ajouté et uniquement si le mode de déplacement utilisé pour l’analyse fait appel à un attribut d’impédance qui n’est basé ni sur le temps, ni sur la distance. FullEdge Spécifie la façon dont les interruptions ponctuelles de restriction sont appliquées aux tronçons au cours de l’analyse. 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) :
CurbApproach Spécifie le sens de circulation affecté par l’interruption. 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) :
Étant donné que les jonctions sont des points et n’ont pas de côté, les interruptions situées sur des jonctions affectent tous les véhicules quelle que soit l’approche du trottoir. L'attribut CurbApproach est conçu pour opérer avec les deux types de normes de conduite nationale : à droite (États-Unis) et à 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 de voie de circulation entre le véhicule et la ressource, vous choisissez 1 (Côté droit du véhicule) en France et aux États-Unis, mais 2 (Côté gauche du véhicule) au Royaume-Uni. Bearing Direction de déplacement d'un point. Les unités sont exprimées en degrés et sont mesurées dans le sens horaire, à partir du nord géographique. Ce champ est utilisé avec le champ BearingTol. En règle générale, les données de relèvement sont automatiquement envoyées à partir d'un périphérique mobile équipé d'un récepteur GPS. Essayez d’inclure des données de relèvement si vous chargez un emplacement en entrée qui se déplace, par exemple un piéton ou un véhicule. L'utilisation de ce champ vous évite d'ajouter des emplacements sur des tronçons incorrects, par exemple lorsqu'un véhicule se rapproche d'une intersection ou d'un passage supérieur. Le relèvement permet également à l'outil de déterminer plus facilement le côté de la rue où se trouve le point. En savoir plus sur le relèvement et la tolérance de relèvement BearingTol La valeur de tolérance de relèvement crée une plage de valeurs de relèvement acceptables lors de la localisation de points qui se déplacent sur un tronçon à l’aide du champ Bearing (Relèvement). Si la valeur du champ Bearing est comprise dans la plage de valeurs acceptables générées à partir de la tolérance de relèvement sur un tronçon, le point peut être ajouté à cet endroit en tant que localisation de réseau. Sinon, le point le plus proche sur le prochain tronçon le plus proche est évalué. Les unités sont exprimées en degrés et la valeur par défaut est 30. Les valeurs doivent être supérieures à zéro et inférieures à 180. Si la valeur est égale à 30, lorsque Network Analyst essaie d’ajouter un emplacement de réseau sur un tronçon, une plage de valeurs de relèvement acceptables est générée à 15 degrés de chaque côté du tronçon (gauche et droite) et dans les deux sens de numérisation du tronçon. En savoir plus sur le relèvement et la tolérance de relèvement NavLatency Ce champ n’est utilisé qu’au cours du processus de calcul si Bearing et BearingTol contiennent également des valeurs ; toutefois, vous n’êtes pas obligé d’entrer une valeur NavLatency, même si Bearing et BearingTol sont renseignés. NavLatency indique le temps censé s’écouler entre le moment où un véhicule se déplaçant envoie des informations GPS à un serveur et le moment où le dispositif de navigation du véhicule reçoit l’itinéraire traité. Les unités temporelles du champ NavLatency sont identiques à celles de la propriété timeUnits de l’objet d’analyse. | Feature Set |
Line_Barriers (Facultatif) | Utilisez ce paramètre pour spécifier une ou plusieurs lignes interdisant la circulation partout où les lignes intersectent les rues. Par exemple, un défilé ou une manifestation qui bloque la circulation sur plusieurs segments de rue peut être modélisé avec une interruption linéaire. Une interruption linéaire peut également délimiter rapidement un périmètre autour de plusieurs routes et filtrer ainsi les itinéraires possibles en évitant les parties indésirables du réseau de transport. L’outil impose une limite au nombre de rues que vous pouvez restreindre à l’aide du paramètre des Line Barriers (Interruptions linéaires). Bien qu’aucune limite ne soit imposée au nombre de lignes que vous pouvez spécifier comme interruptions linéaires, le nombre combiné de rues intersectées par toutes les lignes ne peut pas dépasser 500. Vous pouvez définir des propriétés de nom et de type d’interruption pour les interruptions linéaires que vous spécifiez en utilisant les attributs suivants : Name Nom de l'interruption. | Feature Set |
Polygon_Barriers (Facultatif) | Utilisez ce paramètre pour spécifier les polygones qui restreignent entièrement la circulation ou adaptez proportionnellement le temps ou la distance nécessaire pour se déplacer dans les rues intersectées par les polygones. Le service impose une limite au nombre de rues que vous pouvez restreindre à l’aide du paramètre des Polygon Barriers (Interruptions polygonales). Bien qu’aucune limite ne soit imposée au nombre de polygones que vous pouvez spécifier comme interruptions polygonales, le nombre combiné de rues intersectées par toutes les polygones ne peut pas dépasser 2 000. Vous pouvez définir les propriétés des interruptions polygonales que vous spécifiez, comme leur nom ou type d’interruption, en utilisant les attributs suivants : Name Nom de l'interruption. BarrierType Spécifie si l’interruption restreint complètement la circulation ou proportionne le coût de déplacement (tel que le temps ou la distance) lorsqu’elle est franchie. 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) :
ScaledTimeFactor Il s'agit du facteur de multiplication du temps de trajet des rues intersectées par l'interruption. La valeur du champ doit être supérieure à zéro. Ce champ est actif uniquement pour les interruptions à coût proportionné et uniquement si le mode de déplacement pour l’analyse fait appel à un attribut d’impédance basé sur le temps. ScaledDistanceFactor Il s'agit du facteur de multiplication de la distance des rues intersectées par l'interruption. La valeur du champ doit être supérieure à zéro. Ce champ est actif uniquement pour les interruptions à coût proportionné et uniquement si le mode de déplacement pour l’analyse fait appel à un attribut d’impédance basé sur la distance. ScaledCostFactor Il s’agit du facteur de multiplication du coût des rues intersectées par l’interruption. La valeur du champ doit être supérieure à zéro. Ce champ est actif uniquement pour les interruptions à coût proportionné et uniquement si le mode de déplacement utilisé pour l’analyse fait appel à un attribut d’impédance qui n’est basé ni sur le temps, ni sur la distance. | Feature Set |
Restrictions (Facultatif) | Restrictions qui doivent être respectées par l’outil lorsque vous recherchez les meilleurs itinéraires. Une restriction représente une préférence ou une exigence relative à un trajet. Dans la plupart des cas, les restrictions sont utilisées pour interdire certaines routes. Par exemple, la restriction Éviter les routes à péage permet d’obtenir un itinéraire qui n’inclut les routes à péage que lorsque cela est absolument inévitable pour se rendre sur le lieu d’un incident ou parvenir à une ressource. Restriction de hauteur permet de contourner les dégagements qui sont inférieurs à la hauteur de votre véhicule. Si vous transportez des matières corrosives dans votre véhicule, l’utilisation de la restriction Substances dangereuses interdites empêche le transport de ces matériaux sur les routes qui l’interdisent. Remarque :Les valeurs que vous indiquez pour ce paramètre sont ignorées, sauf si le paramètre Mode de déplacement est défini sur Personnalisé. Remarque :Certaines restrictions nécessitent la spécification d’une valeur supplémentaire. Cette valeur doit être associée au nom de la restriction et à un paramètre précis destiné à fonctionner avec la restriction. Vous pouvez identifier ces restrictions si leurs noms apparaissent dans la colonne AttributeName dans le paramètre Attribute Parameter Values (Valeurs des paramètres d’attributs). Le champ ParameterValue doit être indiqué dans le paramètre Attribute Parameter Values (Valeurs des paramètres d’attributs) pour que la restriction soit correctement utilisée lors de la recherche des routes traversables. Remarque :Certaines restrictions sont uniquement prises en charge dans certains pays. Leur disponibilité est indiquée par région dans la liste ci-dessous. Parmi les restrictions dont la disponibilité est limitée au sein d’une région, vous pouvez déterminer si la restriction est disponible dans un pays en particulier en examinant la table de la section Liste des pays sur la page Web de couverture d’analyse du réseau. Si un pays a la valeur Yes (Oui) dans la colonne des attributs logistiques, la restriction dotée de la disponibilité sélectionnée dans la région est prise en charge dans ce pays. Si vous spécifiez des noms de restrictions qui ne sont pas disponibles dans le pays dans lequel se trouvent vos incidents, le service ignore les restrictions non valides. Le service ignore également les restrictions dont la valeur du paramètre d’attribut Restriction Usage (Utilisation de restriction) est comprise entre 0 et 1 (voir le paramètre Attribute Parameter Values (Valeurs des paramètres d’attributs)). Il interdit toutes les restrictions dont la valeur du paramètre Restriction Usage (Utilisation de restriction) est supérieure à 0. L'outil prend en charge les restrictions suivantes :
Héritage :L’attribut de restriction Conduire un véhicule de livraison n’est plus disponible. Le service ignore cette restriction étant donné qu’elle n’est pas valide. Pour parvenir à des résultats similaires, utilisez l’attribut de restriction Conduire un camion avec l’attribut de restriction Éviter les routes soumises à restrictions pour les camions. | String |
Attribute_Parameter_Values (Facultatif) | Utilisez ce paramètre pour spécifier les valeurs supplémentaires requises par un attribut ou une restriction, par exemple pour indiquer si la restriction interdit, évite ou préfère un déplacement sur des routes soumises à restrictions. Si la restriction consiste à éviter ou à préférer certaines routes, vous pouvez utiliser ce paramètre pour préciser le degré d'évitement ou de préférence. Par exemple, vous pouvez choisir de ne jamais emprunter de routes à péage, de les éviter autant que possible ou même de les préférer. Remarque :Les valeurs que vous indiquez pour ce paramètre sont ignorées, sauf si le paramètre Mode de déplacement est défini sur Personnalisé. Si vous spécifiez le paramètre Attribute Parameter Values (Valeurs des paramètres d’attributs) d’une classe d’entités, les noms de champs sur la classe d’entités doivent correspondre aux champs, comme suit :
Le paramètre Attribute Parameter Values (Valeurs des paramètres d’attributs) dépend du paramètre Restrictions. Le champ ParameterValue s’applique uniquement si le nom de la restriction est spécifié comme valeur du paramètre Restrictions. Dans le paramètre Attribute Parameter Values (Valeurs des paramètres d’attributs), chaque restriction (affichée sous la forme AttributeName) se voit attribuer une valeur de champ ParameterName, Restriction Usage (Utilisation de restriction), qui détermine si la restriction interdit, évite ou préfère la circulation sur les routes associées à la restriction et précise le degré d’évitement ou de préférence des routes. Le champ ParameterName Restriction Usage (Utilisation de restriction) peut se voir attribuer l’une des valeurs de chaîne suivantes ou leurs valeurs numériques équivalentes affichées entre parenthèses :
Dans la plupart des cas, vous pouvez utiliser la valeur PROHIBITED par défaut pour le paramètre Utilisation d’une restriction si la restriction dépend d’une caractéristique du véhicule, telle que sa hauteur. Toutefois, dans certains cas, la valeur du paramètre Utilisation d’une restriction dépend de vos préférences d’itinéraire. Par exemple, pour le paramètre Utilisation d’une restriction, la valeur par défaut de la restriction Éviter les routes à péage est AVOID_MEDIUM. Cela signifie que lorsque cette restriction est utilisée, l'outil essaie de contourner les routes à péage, dans la mesure du possible. AVOID_MEDIUM indique également l'importance d'éviter les routes à péage lorsque vous recherchez le meilleur itinéraire : dans ce cas, la priorité est moyenne. Si vous choisissez AVOID_LOW, il n’est pas important d’éviter les routes à péage ; la sélection de AVOID_HIGH, en revanche, donne une grande importance à ce choix et justifie ainsi la génération par le service d’itinéraires plus longs afin d’éviter les péages. Si vous optez pour PROHIBITED, vous interdisez formellement la circulation sur des routes à péage, ce qui rend impossible la fréquentation d’un tronçon d’une route à péage dans la préparation de l’itinéraire. Gardez à l’esprit que l’évitement ou l’interdiction de routes à péage, et donc l’évitement du paiement de péages, peut constituer un objectif pour certains utilisateurs. En revanche, d’autres utilisateurs préféreront circuler sur des routes à péage, car il est plus important pour eux d’éviter les embouteillages que de faire l’économie des coûts de péage. Dans ce dernier cas, choisissez PREFER_LOW, PREFER_MEDIUM ou PREFER_HIGH comme valeur du paramètre Utilisation d’une restriction. Plus la préférence est élevée, plus l'outil devra dévier de son trajet afin d'autoriser la circulation sur les routes associées à la restriction. | Record Set |
Route_Shape (Facultatif) | Spécifie le type des entités itinéraires générées par l’outil.
Lorsque le paramètre Route Shape (Forme d’itinéraire) est défini sur True Shape (Géométrie réelle) ou True Shape with Measures (Géométrie réelle avec mesures), vous pouvez contrôler la généralisation de la forme d’itinéraire en utilisant la valeur appropriée pour le paramètre Route Line Simplification Tolerance (Tolérance de simplification des lignes d’itinéraires). Quelle que soit la valeur que vous choisissez pour le paramètre Route Shape (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 arrêts. 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) | Distance à utiliser pour simplifier la géométrie des lignes en sortie pour les itinéraires et les feuilles de route. L'outil ignore ce paramètre si le paramètre Forme d'itinéraire n'est pas défini sur Géométrie réelle. 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. | Linear Unit |
Populate_Directions (Facultatif) | Spécifie si l’outil génère des feuilles de route pour chaque itinéraire.
| Boolean |
Directions_Language (Facultatif) | Langue utilisée lors de la génération de la feuille de route. Ce paramètre est utilisé uniquement lorsque le paramètre Populate Directions (Charger les feuilles de route) est activé (True dans Python). La valeur du paramètre peut être spécifiée avec l'un des codes de langue de deux ou cinq caractères suivants :
L’outil recherche tout d’abord une correspondance parfaite pour la langue spécifiée comportant n’importe quelle localisation de langue. S’il n’existe aucune correspondance parfaite, il essaie de faire correspondre la famille de langues. Si une correspondance n’est toujours pas trouvée, l’outil renvoie la feuille de route dans la langue par défaut, à savoir l’anglais. Imaginons, par exemple, que la langue de la feuille de route spécifiée est es-MX (espagnol du Mexique). L’outil renvoie la feuille de route en espagnol car il prend en charge le code de langue es, mais pas le code es-MX. Attention :Si une langue prend en charge la localisation telle que le portugais du Brésil (pt-BR) et le portugais standard (pt-PT), spécifier la famille de langues ainsi que la localisation. Si vous spécifiez uniquement la famille de langues, l’outil ne fait pas correspondre la famille de langue et renvoie la feuille de route dans la langue par défaut, c’est-à-dire en anglais. Ainsi, lorsque la langue de la feuille de route spécifiée pt, l’outil renvoie la feuille de route en anglais étant donné qu’il ne peut pas déterminer si la feuille de route doit être en pt-BR ou pt-PT. | String |
Directions_Distance_Units (Facultatif) | Spécifie les unités dans lesquelles la distance de déplacement s’affiche dans les feuilles de route. Ce paramètre est utilisé uniquement lorsque le paramètre Populate Directions (Charger les feuilles de route) est activé (True dans Python).
| String |
Directions_Style_Name (Facultatif) | Spécifie 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é (True dans Python).
| 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 Time Zone for Time of Day (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 |
Travel_Mode (Facultatif) | Mode de transport à modéliser dans l’analyse. Les modes de déplacement sont gérés dans ArcGIS Online et peuvent être configurés par l’administrateur de votre organisation pour refléter les processus de l’organisation. Vous devez indiquer le nom d’un mode de déplacement pris en charge par votre organisation. Pour obtenir la liste des noms de modes de déplacement pris en charge, utilisez la connexion au serveur SIG que vous avez utilisée pour accéder à cet outil, puis exécutez GetTravelModes dans la boîte à outils Utilitaires. L’outil GetTravelModes ajoute une table nommée Supported Travel Modes (modes de déplacement pris en charge) à l’application. N’importe quelle valeur du champ Travel Mode Name dans la table des modes de déplacement pris en charge peut être spécifiée en entrée. Vous pouvez également indiquer champ Travel Mode Settings en entrée. Cela réduit le temps d’exécution de l’outil, car il n’a pas besoin de rechercher les paramètres en fonction du nom du mode de déplacement. La valeur par défaut, Personnalisé, vous permet de configurer votre propre mode de déplacement à l'aide des paramètres du mode de déplacement personnalisé (Demi-tours aux jonctions, Utiliser la hiérarchie, Restrictions, Valeurs des paramètres d'attributs et Impédance). Les valeurs par défaut des paramètres du mode de trajet personnalisé modélisent les déplacements en voiture. Vous pouvez choisir Custom (Personnalisé) et définir les paramètres du mode de trajet personnalisé répertoriés ci-dessus pour modéliser un piéton qui marche très rapidement ou un camion doté d’une hauteur donnée, d’un poids en particulier et qui transporte des matières dangereuses. Vous pouvez essayer différents paramètres afin d’obtenir les résultats d’analyse qui vous intéressent. Une fois les paramètres d’analyse identifiés, collaborez avec l’administrateur de votre organisation pour enregistrer ces paramètres dans le cadre d’un mode de déplacement nouveau ou existant afin que tous les membres de votre organisation puissent exécuter l’analyse avec les mêmes paramètres. Attention :Lorsque vous choisissez Custom (Personnalisé), les valeurs que vous définissez pour les paramètres du mode de déplacement personnalisé sont incluses dans l’analyse. Si vous spécifiez un autre mode de déplacement (défini par votre organisation), les valeurs que vous définissez pour les paramètres du mode de déplacement personnalisé sont ignorées. L'outil les remplace par les valeurs de votre mode de déplacement spécifié. | String |
Impedance (Facultatif) | Spécifie l’impédance. Il s’agit d’une valeur représentant l’effort ou le coût de déplacement le long des segments de route ou sur d’autres portions du réseau de transport. Le temps de trajet est une impédance : une voiture peut mettre une minute à parcourir un mile (1,6 kilomètre) sur une route déserte. Les temps de trajet peuvent varier selon le mode de déplacement : un piéton peut mettre plus de 20 minutes à parcourir le même mile. Il est par conséquent important de choisir l’impédance appropriée au mode de déplacement que vous modélisez. La distance à parcourir peut également être une impédance ; la longueur d’une route en kilomètres peut être considérée comme une impédance. En ce sens, la distance à parcourir est la même pour tous les modes : un kilomètre pour un piéton est également un kilomètre pour une voiture. (Ce qui peut changer, ce sont les voies d'accès que les différents modes sont autorisés à emprunter. Cela affecte la distance entre les points et est modélisé par les paramètres du mode de déplacement.) Attention :La valeur que vous indiquez pour ce paramètre est ignorée, sauf si le paramètre Mode de déplacement est défini sur Personnalisé, qui est la valeur par défaut. Choisissez une des valeurs d'impédance suivantes :
Si vous choisissez une impédance temporelle telle que TravelTime, TruckTravelTime, Minutes, TruckMinutes ou WalkTime, le paramètre Measurement Units (Unités de mesure) doit être défini sur une valeur basée sur le temps. En revanche, si vous choisissez une impédance de distance comme Miles ou Kilometers (Kilimètres), le paramètre Measurement Units (Unités de mesure) doit faire référence à une distance. Héritage :Les valeurs d’impédance Drive Time (Temps de trajet), Truck Time (Durée du trajet pour camions), Walk Time (Durée du trajet à pied) et Travel Distance (Distance à parcourir) ne sont plus prise en charge et seront retirées dans une version ultérieure. Si vous utilisez l’une de ces valeurs, l’outil utilise la valeur du paramètre Time Impedance (Impédance de temps) pour les valeurs temporelles ou celle du paramètre Distance Impedance (Impédance de distance) pour les valeurs basées sur la distance. | String |
Save_Output_Network_Analysis_Layer (Facultatif) | Précise si les paramètres de l’analyse seront enregistrés comme fichier de couche d’analyse réseau. Vous ne pouvez pas utiliser ce fichier directement, même lorsque vous ouvrez le fichier dans une application ArcGIS Desktop telle que ArcMap. Celui-ci doit être envoyé au support technique Esri, qui évaluera la qualité des résultats renvoyés par l’outil.
| Boolean |
Overrides (Facultatif) | 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 Esri une liste des paramètres de remplacement pris en charge, ainsi que leurs valeurs acceptables, pour chaque solveur. | string |
Save_Route_Data (Facultatif) | Indique si la sortie inclut un fichier .zip contenant une géodatabase fichier avec 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.
| Boolean |
Time_Impedance (Facultatif) | L’impédance basée sur le temps. Il s’agit d’une valeur représentant le temps de déplacement le long des segments de route ou sur d’autres portions du réseau de transport. Remarque :Si l’impédance du mode de déplacement, indiquée par le paramètre Impedance (Impédance), est basé sur le temps, les valeurs pour les paramètres Time Impedance (Impédance de temps) et Impedance (Impédance) doivent être identiques. Sinon, le service renvoie une erreur. | String |
Distance_Impedance (Facultatif) | L’impédance basée sur la distance est une valeur représentant la distance à parcourir le long des segments de route ou sur d’autres portions du réseau de transport. Remarque :Si l’impédance du mode de déplacement, indiquée par le paramètre Impedance (Impédance), est basé sur la distance, les valeurs pour les paramètres Distance Impedance (Impédance de distance) et Impedance (Impédance) doivent être identiques. Sinon, le service renvoie une erreur. | String |
Output_Format (Facultatif) | Spécifie le format dans lequel les entités en sortie sont créées.
Lorsqu’un format de 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 puisque l’application (comme ArcMap ou ArcGIS Pro) ne peuvent pas afficher 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). | String |
Sortie dérivée
| Nom | Explication | Type de données |
| Solve_Succeeded | Indique si la résolution de l’analyse de la ressource la plus proche a réussi. | Booléen |
| Output_Routes | Ce paramètre donne accès à l’itinéraire ou aux itinéraires reliant les ressources aux incidents. | Jeu d'entités |
| Output_Directions | Ce paramètre permet d’accéder à la feuille de route détaillée de chaque itinéraire obtenu. | Jeu d'entités |
| Output_Closest_Facilities | Le paramètre permet d’accéder aux ressources en sortie à partir d’une analyse de la ressource la plus proche. | 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 |
| 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. | Jeu d'entités |
| Output_Facilities | Ressources utilisées dans l’analyse. | Jeu d'entités |
| Output_Result_File | Fichier .zip contenant les résultats de l’analyse, avec un ou plusieurs fichiers pour chacune des sorties. Le format d’un fichier est spécifié par le paramètre Output Format (Format en sortie). | Fichier |
Exemple de code
Le script Python ci-dessous illustre l’utilisation de l’outil Find Closest Facilities dans un script.
"""This example shows how to find three closest stores from each customer location."""
import sys
import time
import arcpy
# Change the username and password applicable to your own ArcGIS Online account
username = "<your user name>"
password = "<your password>"
cf_service = "https://logistics.arcgis.com/arcgis/services;World/ClosestFacility;{0};{1}".format(username, password)
# Add the geoprocessing service as a toolbox.
# Check https://pro.arcgis.com/en/pro-app/2.6/arcpy/functions/importtoolbox.htm for
# other ways in which you can specify credentials to connect to a geoprocessing service.
arcpy.ImportToolbox(cf_service)
# Set the variables to call the tool
facilities = "C:/data/Inputs.gdb/Stores"
incidents = "C:/data/Inputs.gdb/Customers"
output_routes = "C:/data/Results.gdb/Routes"
output_closest_facilities = "C:/data/Results.gdb/ClosestStores"
# Call the tool
result = arcpy.FindClosestFacilities_ClosestFacility(incidents, facilities, "Minutes", "", 3)
arcpy.AddMessage("Running the analysis with result ID: {}".format(result.resultID))
# Check the status of the result object every 1 second until it has a
# value of 4 (succeeded) or greater
while result.status < 4:
time.sleep(1)
# print any warning or error messages returned from the tool
result_severity = result.maxSeverity
if result_severity == 2:
arcpy.AddError("An error occured when running the tool")
arcpy.AddError(result.getMessages(2))
sys.exit(2)
elif result_severity == 1:
arcpy.AddWarning("Warnings were returned when running the tool")
arcpy.AddWarning(result.getMessages(1))
# Save the output routes and the closest facilities to a geodatabase
result.getOutput(0).save(output_routes)
result.getOutput(3).save(output_closest_facilities)L’exemple suivant décrit la procédure d’analyse de la ressource la plus proche pour un mode de déplacement personnalisé.
"""This example shows how to perform a closest facility analysis using a custom travel mode
that models trucks carrying wide load."""
import sys
import time
import json
import arcpy
username = "<your user name>"
password = "<your password>"
cf_service = "https://logistics.arcgis.com/arcgis/services;World/ClosestFacility;{0};{1}".format(username, password)
# Add the geoprocessing service as a toolbox
arcpy.ImportToolbox(cf_service)
# Set the variables to call the tool
facilities = "C:/data/Inputs.gdb/Stores"
incidents = "C:/data/Inputs.gdb/Customers"
output_routes = "C:/data/Results.gdb/Routes"
output_closest_facilities = "C:/data/Results.gdb/ClosestStores"
# Change Vehicle Width attribute parameter value to 4.5 (about 15 feet) for the Trucking Time travel mode
# used for the analysis
portal_url = "https://www.arcgis.com"
arcpy.SignInToPortal(portal_url, username, password)
travel_mode_list = arcpy.na.GetTravelModes(portal_url)
tt = travel_mode_list["Trucking Time"]
tt_json = str(tt)
tt_dict = json.loads(tt_json)
tt_dict["restrictionAttributeNames"].append("Width Restriction")
for attr_param in tt_dict["attributeParameterValues"]:
if attr_param['attributeName'] == 'Width Restriction' and attr_param['parameterName'] == 'Vehicle Width (meters)':
attr_param['value'] = 4.5
travel_mode = json.dumps(tt_dict)
# Call the tool
result = arcpy.FindClosestFacilities_ClosestFacility(incidents, facilities, "Minutes", "", 2,
Travel_Mode=travel_mode)
# Check the status of the result object every 1 second until it has a
# value of 4 (succeeded) or greater
while result.status < 4:
time.sleep(1)
# print any warning or error messages returned from the tool
result_severity = result.maxSeverity
if result_severity == 2:
arcpy.AddError("An error occured when running the tool")
arcpy.AddError(result.getMessages(2))
sys.exit(2)
elif result_severity == 1:
arcpy.AddWarning("Warnings were returned when running the tool")
arcpy.AddWarning(result.getMessages(1))
# Save the output routes and the closest facilities to a geodatabase
result.getOutput(0).save(output_routes)
result.getOutput(3).save(output_closest_facilities)Environnements
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?