Aide

Rechercher les ressources les plus proches

Disponible avec une licence Network Analyst.

Récapitulatif

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.

Utilisation

Syntaxe

FindClosestFacilities_na (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})
ParamètreExplicationType 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, jusqu'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 par 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 trois 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 à maîtriser 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 par 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) :

  • 0 (Peu importe le côté) - Le véhicule peut atteindre et quitter le lieu de l'incident dans les deux directions, donc le demi-tour est autorisé. Ce paramètre peut être sélectionné s'il est possible et pratique pour votre véhicule de revenir en arrière sur le lieu de l'incident. Cette décision peut dépendre de la largeur de la route et de la densité du trafic ou de la présence d'un parking sur le lieu de l'incident où les véhicules peuvent faire demi-tour.
  • 1 (Côté droit du véhicule) - L'incident doit se trouver du côté droit du véhicule lorsque celui-ci s'en approche ou s'en éloigne. Le demi-tour est interdit. Cette option est généralement utilisée avec des véhicules tels que des bus qui doivent arriver à l'arrêt de bus par la droite.
  • 2 (Côté gauche du véhicule) - Lorsque le véhicule atteint et quitte le lieu de l'incident, le bord du trottoir doit être du côté gauche du véhicule. Le demi-tour est interdit. Cette option est généralement utilisée avec des véhicules tels que des bus qui doivent arriver à l'arrêt de bus par la gauche.
  • 3 (Pas de demi-tour) - Lorsque le véhicule s'approche du lieu de l'incident, le bord du trottoir peut être d'un côté quelconque du véhicule ; en revanche, le véhicule doit partir sans revenir en arrière.

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 Etats-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 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, jusqu'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 par 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 à la ressource, qui s'ajoute à la distance totale de l'itinéraire. Les unités de cette valeur attributaire sont spécifiées par 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 le lieu où se trouve effectivement la ressource 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 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) :

  • 0 (Peu importe le côté) - Le véhicule peut atteindre et quitter la ressource dans les deux directions, donc le demi-tour est autorisé. Ce paramètre peut être sélectionné s'il est possible et pratique pour votre véhicule de revenir en arrière à la ressource. Cette décision peut dépendre de la largeur de la route et de la densité du trafic ou de la présence d'un parking sur le site de la ressource où les véhicules peuvent faire demi-tour.
  • 1 (Côté droit du véhicule) - La ressource doit se trouver du côté droit du véhicule lorsqu'il s'en approche ou s'en éloigne. Le demi-tour est interdit. Cette option est généralement utilisée avec des véhicules tels que des bus qui doivent arriver à l'arrêt de bus par la droite.
  • 2 (Côté gauche du véhicule) - Lorsque le véhicule atteint et quitte la ressource, le bord du trottoir doit être du côté gauche du véhicule. Le demi-tour est interdit. Cette option est généralement utilisée avec des véhicules tels que des bus qui doivent arriver à l'arrêt de bus par la gauche.
  • 3 (Pas de demi-tour) - Lorsque le véhicule s'approche de la ressource, le bord du trottoir peut être d'un côté quelconque du véhicule ; en revanche, le véhicule doit partir sans revenir en arrière.

La propriété CurbApproach a été conçue pour fonctionner avec les deux types de normes de conduite nationales : circulation à droite (Etats-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 :

  • Meters
  • Kilometers
  • Feet
  • Yards
  • Miles
  • NauticalMiles
  • Seconds
  • Minutes
  • Hours
  • Days

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.

  • TRAVEL_FROM —Le sens de déplacement va des ressources aux incidents. Les services des pompiers utilisent en général ce paramètre, car ils s'intéressent à la durée du trajet entre la caserne (ressource) et le site d'intervention (incident).
  • TRAVEL_TO —Le sens de déplacement va des incidents aux ressources. Les points de vente de détail utilisent couramment ce paramètre, car ils s'intéressent au temps nécessaire aux acheteurs (incidents) pour atteindre le magasin (ressource).

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 :

  • Tous les incidents doivent se situer dans le même fuseau horaire en cas de :

    • spécification d'une heure de début et déplacement d'un incident à une ressource,
    • spécification d'une heure de fin et déplacement d'une ressource à un incident.

  • Toutes les ressources doivent se situer dans le même fuseau horaire en cas de :

    • spécification d'une heure de début et déplacement d'une ressource à un incident,
    • spécification d'une heure de fin et déplacement d'un incident à une ressource.

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.

  • START_TIME — Lorsque cette option est sélectionnée, l'outil recherche le meilleur itinéraire en utilisant la valeur du paramètre Heure du jour comme l'heure de départ de la ressource ou de l'incident.
  • END_TIME — Lorsque cette option est sélectionnée, l'outil utilise la valeur du paramètre Heure du jour comme l'heure d'arrivée à la ressource ou à l'incident. Cette option est utile si vous souhaitez savoir à quelle heure partir d'un emplacement afin d'arriver à destination au moment spécifié dans le paramètre d'heure du jour.
  • NOT_USED —Lorsque cette option est sélectionnée, l'outil n'utilise pas Heure du jour lors du calcul des ressources les plus proches. Les données de trafic réel et historique ne seront pas utilisées.
String
Time_Zone_for_Time_of_Day
(Facultatif)

Spécifie le fuseau horaire du paramètre Heure du jour.

  • GEO_LOCAL —Le paramètre Time_of_Day se rapporte au fuseau horaire dans lequel se trouvent les ressources ou les incidents.
    • Si Time_of_Day_Usage est défini sur START_TIME et si Travel_Direction est défini sur TRAVEL_FROM, il s'agit du fuseau horaire des ressources.
    • Si Time_of_Day_Usage est défini sur START_TIME et si Travel_Direction est défini sur TRAVEL_TO, il s'agit du fuseau horaire des incidents.
    • Si Time_of_Day_Usage est défini sur END_TIME et si Travel_Direction est défini sur TRAVEL_FROM, il s'agit du fuseau horaire des incidents.
    • Si Time_of_Day_Usage est défini sur END_TIME et si Travel_Direction est défini sur TRAVEL_TO, il s'agit du fuseau horaire des ressources.
  • UTC —Le paramètre Time_of_Day est exprimé en UTC (Temps Universel Coordonné). Choisissez cette option si vous souhaitez rechercher la ressource la plus proche, à une heure donnée (maintenant, par exemple), sans toutefois connaître avec certitude le fuseau horaire dans lequel se trouvent les ressources ou pendant lequel se sont produits les incidents.

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 :

  • Tous les incidents doivent se situer dans le même fuseau horaire en cas de :

    • spécification d'une heure de début et déplacement d'un incident à une ressource,
    • spécification d'une heure de fin et déplacement d'une ressource à un incident.

  • Toutes les ressources doivent se situer dans le même fuseau horaire en cas de :

    • spécification d'une heure de début et déplacement d'une ressource à un incident,
    • spécification d'une heure de fin et déplacement d'un incident à une ressource.

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.

  • ALLOW_UTURNS —Les demi-tours sont autorisés aux jonctions comportant un nombre quelconque de tronçons connectés. Il s'agit de la valeur par défaut.
  • NO_UTURNS —Les demi-tours sont interdits à toutes les jonctions, indépendamment de la valence de jonction. Notez toutefois que les demi-tours restent autorisés aux emplacements réseau même lorsque ce paramètre est sélectionné ; en revanche, vous pouvez configurer la propriété CurbApproach des emplacements réseau individuels pour y interdire les demi-tours également.
  • ALLOW_DEAD_ENDS_ONLY —Les demi-tours sont interdits au niveau de toutes les jonctions, sauf celles ayant un seul tronçon adjacent (voie sans issue).
  • ALLOW_DEAD_ENDS_AND_INTERSECTIONS_ONLY —Les demi-tours sont interdits aux jonctions où deux tronçons adjacents se rencontrent, mais sont autorisés aux intersections (jonctions avec au moins trois tronçons adjacents) et aux voies sans issue (jonctions avec exactement un tronçon adjacent). Souvent, les réseaux comportent des jonctions superflues au milieu de segments de route. Cette option empêche des véhicules de faire des demi-tours à ces emplacements.

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 :

  • Restriction (0) : interdit le passage à travers l'interruption. Il s'agit de la valeur par défaut.
  • Coût ajouté (2) : lorsque l'interruption est traversée, le coût du réseau augmente de la valeur spécifiée dans les champs Additional_Time et Additional_Distance.

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 :

  • Restriction (0) - Interdit le parcours à travers toute partie de la barrière. Il s'agit de la valeur par défaut.
  • Coût proportionné (1) - Proportionne l'impédance des tronçons sous-jacents en les multipliant par la valeur de la propriété ScaledCostFactor. Si les tronçons sont partiellement couverts par la barrière, l'impédance est répartie et multipliée.

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.

  • True — Recherche des itinéraires en utilisant une hiérarchie. Lorsque vous utilisez une hiérarchie, l'outil préfère les rues d'ordre supérieur (comme les autoroutes) aux rues d'ordre inférieur (comme les routes locales) ; il permet de simuler la préférence du conducteur de circuler sur des autoroutes plutôt que des routes locales, même si cela implique un trajet plus long. Cela est particulièrement vrai lorsque vous recherchez un itinéraire vers une ressource éloignée. En effet, pour les longs trajets, les conducteurs préfèrent généralement emprunter des autoroutes qui leur permettent d'éviter les arrêts, les intersections et les tournants. La recherche hiérarchique est plus rapide, surtout pour les itinéraires longue distance, car l'outil doit sélectionner le meilleur itinéraire à partir d'un sous-ensemble de rues relativement plus restreint.
  • False — Recherche des itinéraires sans utiliser de hiérarchie. Si vous n'utilisez pas de hiérarchie, l'outil tient compte de toutes les rues pour trouver le meilleur itinéraire. Aucune préférence n'est accordée aux rues d'ordre supérieur. Cette valeur sert généralement à trouver des itinéraires courts dans une ville.

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 ArcGIS 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 :

  • TRUE_LINES_WITH_MEASURES — Renvoie la forme exacte de l'itinéraire obtenu basé sur les rues sous-jacentes. En outre, ce paramètre construit des mesures de sorte que la forme puisse être utilisée lors du référencement linéaire.
  • TRUE_LINES_WITHOUT_MEASURES — Renvoie la forme exacte de l'itinéraire obtenu basé sur les rues sous-jacentes.
  • STRAIGHT_LINES — Renvoie une ligne droite entre l'incident et la ressource.
  • NO_LINES — Aucune forme d'itinéraire n'est renvoyée. Utilisez cette valeur lorsque vous souhaitez uniquement déterminer la durée ou la distance totale du trajet entre la ressource la plus proche et l'incident.

Lorsque le paramètre Forme d'itinéraire est défini sur Géométrie réelle, vous pouvez contrôler la généralisation de la forme d'itinéraire en utilisant les valeurs appropriées pour les paramètres Tolérance de simplification des lignes d'itinéraires.

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.

  • Checked (True) —Indique que les feuilles de route seront générées et configurées en fonction des valeurs des paramètres Langue des directions, Nom de style des directions et Unités de distance des feuilles de route.
  • Unchecked (False) —Les feuilles de route ne sont pas générées et l'outil renvoie une couche Directions vide.
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 vrai.

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 Populate Directions est activé ou défini sur True.

  • Miles
  • Kilometers
  • Meters
  • Feet
  • Yards
  • NauticalMiles
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 est activé ou défini sur True. Le paramètre peut être spécifié avec les valeurs suivantes :

  • NA Desktop — Génère des feuilles de route tournant par tournant adaptées à l'impression.
  • NA Navigation — Génère une feuille de route conçue pour un dispositif de navigation dans un véhicule.
  • NA Campus —Génère une feuille de route adaptée aux réseaux piétons, notamment les trottoirs et l'intérieur des bâtiments.
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)
  • NO_SAVE_OUTPUT_LAYER —Aucune couche d’analyse de réseau n'est incluse dans la sortie.
  • SAVE_OUTPUT_LAYER —La sortie inclut une couche d'analyse de réseau des résultats.

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 ArcGIS Network Analyst dans l'environnement ArcGIS for Desktop. Le processus de débogage peut en être grandement facilité.

Dans ArcGIS for 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 :

  • UTurn_Policy

  • Time_Attribute

  • Time_Attribute_Units

  • Distance_Attribute

  • Distance_Attribute_Units

  • Use_Hierarchy_in_Analysis

  • Restrictions

  • Attribute_Parameter_Values

  • Route_Line_Simplification_Tolerance

  • CUSTOM —Définissez le mode de déplacement qui répond à vos besoins. Lorsque CUSTOM est sélectionné, l'outil ne remplace pas les paramètres du mode de déplacement répertoriés ci-dessus. Il s'agit de la valeur par défaut.
String

Exemple de code

Exemple 1 d'utilisation de l'outil FindClosestFacilities

Exécutez l'outil 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 Python 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

Thèmes connexes

Vous avez un commentaire à formuler concernant cette rubrique ?