Résumé
Détermine les zones de desserte de réseau autour des ressources. Une zone de desserte de réseau est une région qui englobe toutes les rues auxquelles il est possible d'accéder selon une distance ou un temps de trajet donnés à partir d'une ou de plusieurs ressources. Par exemple, la zone de desserte de 10 minutes d'une ressource inclut toutes les rues qui peuvent être atteintes en moins de 10 minutes à partir de cette ressource.
Les zones de desserte servent généralement à visualiser et mesurer l'accessibilité. Par exemple, un polygone de temps de conduite de trois minutes autour d'une épicerie permet de déterminer les résidents susceptibles de rejoindre le magasin en trois minutes et donc d'y faire leurs courses.
Pour en savoir plus sur la sortie de l'outil GenerateServiceAreas
Illustration
Utilisation
L'outil crée des zones isochrones si la valeur du paramètre Unités des bornes est définie sur une unité temporelle. De même, l'outil crée des zones de distance de trajet si le paramètre Unités des bornes utilise des unités de distance.
Vous devez spécifier au moins une ressource pour exécuter l'outil. Vous pouvez charger jusqu’à 1 000 ressources.
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 précise.
Que le paramètre Utiliser la hiérarchie soit activé (True) ou non, la hiérarchie est toujours utilisée lorsque la valeur de borne maximale dépasse 240 minutes ou 240 miles (386,24 kilomètres). Lorsque les zones de desserte en sortie ne se chevauchent pas et ne sont pas généralisées, cette limite est réduite à 15 minutes et 15 miles (24,14 kilomètres).
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.
Les durées de trajet ne peuvent pas dépasser 9 heures (540 minutes) en marchant ou 5 heures (300 minutes) pour tous les autres modes de déplacement.
Les distances de trajet ne peuvent pas dépasser 27 miles (43,45 kilomètres) en marchant ou 300 miles (482,80 kilomètres) pour tous les autres modes de déplacement.
En marchant, la durée de trajet maximale lors de la génération de polygones détaillés ne peut dépasse 5 heures (300 minutes). Pour tous les autres modes de déplacement, la durée de trajet maximale ne peut dépasser 15 minutes.
Pour tous les autres modes de déplacement, dont la marche, la distance de trajet maximale lors de la génération de polygones détaillés ne peut dépasser 15 miles (24,14 kilomètres).
En marchant, la durée de trajet maximale lors de la génération des lignes de zone de desserte ne peut dépasser 5 heures (300 minutes). Pour tous les autres modes de déplacement, la durée de trajet maximale ne peut dépasser 15 minutes.
Pour tous les autres modes de déplacement, dont la marche, la distance de trajet maximale lors de la génération des lignes de zone de desserte ne peut dépasser 15 miles (24,14 kilomètres).
La distance de troncage des polygones ne peut dépasser 500 mètres.
Cet outil est conçu pour s’exécuter dans ArcGIS Pro, ArcMap, ArcGlobe et ArcScene, mais pas dans ArcCatalog.
L’utilisation de ce service consomme des crédits. Pour plus d'informations, reportez-vous à Présentation des crédits de service.
Syntaxe
arcpy.naagol.GenerateServiceAreas(Facilities, Break_Values, Break_Units, {Analysis_Region}, {Travel_Direction}, {Time_of_Day}, Use_Hierarchy, {UTurn_at_Junctions}, {Polygons_for_Multiple_Facilities}, {Polygon_Overlap_Type}, {Detailed_Polygons}, {Polygon_Trim_Distance}, Polygon_Simplification_Tolerance, {Point_Barriers}, {Line_Barriers}, {Polygon_Barriers}, {Restrictions}, {Attribute_Parameter_Values}, {Time_Zone_for_Time_of_Day}, {Travel_Mode}, {Impedance}, {Save_Output_Network_Analysis_Layer}, {Overrides}, {Time_Impedance}, {Distance_Impedance}, {Polygon_Detail}, {Output_Type}, {Output_Format}, {Ignore_Invalid_Locations})| Paramètre | Explication | Type de données |
Facilities |
Emplacements en entrée autour desquelles les zones de desserte sont générées. Vous pouvez charger jusqu’à 1 000 ressources. Le jeu d'entités des ressources est associé à une table attributaire. Les champs de la table attributaire sont décrits ci-dessous. ObjectID Champ d'ID géré par le système. Name Nom de la ressource. Si le nom n'est pas spécifié, un nom est automatiquement généré pendant le processus de calcul. Tous les champs des ressources en entrée sont inclus dans les polygones en sortie lorsque le paramètre Polygones pour les ressources multiples est défini sur Superposition ou Pas de superposition. Le champ ObjectID dans les ressources en entrée est transféré vers le champ FacilityOID dans les polygones en sortie. Breaks Spécifiez l’étendue de la zone de desserte à calculer en fonction d’une ressource. Cet attribut permet de spécifier une valeur de borne de zone de desserte différente pour chaque ressource. Par exemple, dans le cas de deux ressources, vous pouvez générer des polygones de zone de desserte de 5 et 10 minutes pour une ressource, et de 6, 9 et 12 minutes pour l’autre ressource. Veillez à séparer les différentes valeurs de pause par un espace et à indiquer les valeurs numériques en utilisant le point comme séparateur décimal, même si un autre séparateur décimal est défini dans les paramètres régionaux de l’ordinateur. Par exemple, la valeur 5.5 10 15.5 définit trois valeurs de borne autour d’une ressource. AdditionalTime Temps passé à la ressource qui réduit l’étendue de la zone de desserte calculée pour la ressource en question. La valeur par défaut est 0. Par exemple, lors du calcul de zones de desserte représentant les temps de réaction de casernes de pompiers, le champ AdditionalTime peut stocker le temps de mise en route, à savoir le temps nécessaire à une équipe pour revêtir les équipements de protection appropriés et quitter la caserne, pour chaque caserne de pompiers. Supposons que la caserne 1 ait un temps de mise en route de 1 minute et la caserne 2 un temps de mise en route de 3 minutes. Lors du calcul d’une zone de desserte de 5 minutes pour ces deux casernes, la zone de desserte réelle de la caserne 1 représente une zone de desserte de 4 minutes (dans la mesure où 1 des 5 minutes est consacrée à la mise en route). De même, la caserne 2 présente une zone de desserte de 2 minutes seulement à partir de la caserne de pompiers. AdditionalDistance Distance supplémentaire parcourue pour atteindre la ressource avant de procéder au calcul du service. Cet attribut réduit l’étendue de la zone de desserte calculée pour la ressource en question. La valeur par défaut est 0. En règle générale, le lieu d’une ressource, un point de vente par exemple, ne donne pas directement sur la rue : il est un peu en retrait de la route. Cette valeur attributaire peut être utilisée pour modéliser la distance entre le lieu réel de la ressource et sa localisation sur la rue s’il est important d’inclure cette distance dans le calcul des zones de desserte de la ressource. AdditionalCost Coût supplémentaire dépensé sur le lieu de la ressource qui réduit l’étendue de la zone de desserte calculée pour une ressource donnée. La valeur par défaut est 0. Utilisez cette valeur attributaire lorsque le mode de déplacement pour l’analyse fait appel à 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 comme des unités inconnues. 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 fonctionner avec les deux types de normes de conduite nationales : circulation à droite (comme en France et aux États-Unis) et circulation à gauche (Royaume-Uni). Tout d'abord, imaginons une ressource qui se trouve du côté gauche d'un véhicule. Il se situe toujours sur la gauche, que le véhicule circule du côté gauche ou du côté droit de la route. Avec les normes de conduite nationales, ce qui peut changer est votre décision d’aborder la ressource du côté droit ou du côté gauche du véhicule. Par exemple, si vous souhaitez atteindre une ressource sans laisser 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 |
Break_Values | Spécifie la taille et le nombre de polygones de zones de desserte à générer pour chaque ressource. Les unités sont déterminées par la valeurs Unités des bornes. Plusieurs bornes de polygones peuvent être configurées pour créer des zones de desserte concentriques par ressource. Par exemple, pour rechercher des zones de desserte à 2, 3 et 5 miles pour chaque ressource, entrez 2 3 5 en séparant les valeurs par un espace, puis définissez Unités des bornes sur Miles. Il n'y a aucune limite au nombre de valeurs de bornes que vous pouvez spécifier. La taille de la valeur de borne maximale ne peut pas dépasser l’équivalent de 300 minutes ou 300 miles (482,80 kilomètres). Lors de la génération de polygones détaillés, la taille de la zone de desserte maximale est limitée à 15 minutes et 15 miles (24,14 kilomètres). | String |
Break_Units | Précise les unités du paramètre Break Values (Valeurs des bornes). Les unités que vous choisissez pour ce paramètre déterminent si l'outil crée les zones de desserte en mesurant la distance à parcourir ou le temps de trajet. 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 sont les suivants :
| String |
Analysis_Region (Facultatif) | Région dans laquelle l’analyse doit être effectuée. 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 :
| String |
Travel_Direction (Facultatif) | Indique si le trajet utilisé pour générer les polygones de la zone de desserte s'effectue depuis ou vers les ressources.
La direction du trajet peut changer la forme des polygones si les impédances sur les côtés opposés des rues diffèrent ou en présence de rues à sens unique. La direction à sélectionner dépend de la nature de votre analyse des zones de desserte. La zone de desserte d'un vendeur de pizzas, par exemple, doit être créée depuis la ressource, alors que la zone de desserte d'un hôpital doit être créée vers la ressource. | String |
Time_of_Day (Facultatif) | Heure de départ ou d'arrivée aux ressources. L'interprétation de cette valeur varie selon que le trajet se rapproche ou s'éloigne des ressources.
Vous pouvez utiliser le paramètre Time Zone for Time of Day (Fuseau horaire de l’heure de la journée) pour spécifier si cette heure et cette date correspondent à l’heure UTC ou au fuseau horaire dans lequel la ressource se trouve. En répétant la même analyse avec des valeurs différentes du paramètre Heure du jour, vous pouvez voir l’évolution de la portée d’une ressource en fonction de l’heure. Par exemple, la zone de desserte de 5 minutes autour d'une caserne de pompiers peut être grande tôt le matin, diminuer aux heures de pointe matinales, augmenter en fin de matinée, et ainsi de suite tout au long de la journée. | Date |
Use_Hierarchy | Indique si vous souhaitez utiliser une hiérarchie lorsque vous recherchez le meilleur itinéraire entre la ressource et l'incident.
Que le paramètre Utiliser la hiérarchie soit activé (True) ou non, la hiérarchie est toujours utilisée lorsque la valeur de borne maximale dépasse 240 minutes ou 240 miles (386,24 kilomètres). | Boolean |
UTurn_at_Junctions (Facultatif) | Précise s’il convient d’empêcher ou d’autoriser la zone de desserte à réaliser des demi-tours aux jonctions. La terminologie suivante permet de mieux comprendre les valeurs des paramètres : une jonction est un point où un segment de rue se termine et se connecte potentiellement à un ou plusieurs autres segments. Une pseudo-jonction est un point où exactement deux rues se connectent. Une intersection est un point où trois rues ou plus se connectent. Une voie sans issue est un endroit où un segment de rue se termine sans se connecter à aucun autre.
| String |
Polygons_for_Multiple_Facilities (Facultatif) | Indique comment les polygones de zone de desserte sont générés lorsque plusieurs ressources sont présentes dans l’analyse.
Avec Superposition ou Pas de superposition, tous les champs des ressources en entrée sont inclus dans les polygones en sortie, mais les valeurs du champ ObjectID en entrée sont transférées vers le champ FacilityOID des polygones en sortie. Le champ FacilityOID a la valeur nulle en cas de combinaison des polygones par borne et les champs en entrée ne font pas partie de la sortie. | String |
Polygon_Overlap_Type (Facultatif) | Précise si des polygones de la zone de desserte concentrique seront créés comme disques ou anneaux. Cette option s'applique uniquement lorsque plusieurs valeurs de bornes sont spécifiées pour les ressources.
| String |
Detailed_Polygons (Facultatif) | Permet de créer des polygones généralisés ou détaillés.
L’outil prend en charge la génération de polygones détaillés uniquement si la valeur la plus importante spécifiée dans le paramètre Valeurs des bornes est inférieure ou égale à 15 minutes ou à 15 miles (24,14 kilomètres) lors de la génération de zones de desserte temporelles ou basées sur la distance, respectivement. | Boolean |
Polygon_Trim_Distance (Facultatif) | Spécifie la distance au sein de laquelle les polygones de zone de desserte sont tronqués. Cette option s'avère utile pour rechercher des zones de dessertes dans des endroits où le réseau de transport est clairsemé et que vous ne voulez pas que la zone de desserte couvre de larges surfaces sur lesquelles il n'y a aucune entité rue. La valeur par défaut est 100 mètres. Si ce paramètre est défini par la valeur 0 si aucune valeur n’est spécifiée, les polygones de la zone de desserte ne seront pas tronqués. La valeur de ce paramètre est ignorée lors de l'utilisation de la hiérarchie. | Linear Unit |
Polygon_Simplification_Tolerance | Le niveau de simplification de la géométrie des polygones. La simplification conserve les sommets critiques d'un polygone pour définir sa forme globale et supprime d'autres sommets. La distance de simplification que vous spécifiez est le décalage maximal par rapport auquel les limites du polygone simplifié peuvent dévier des limites du polygone d'origine. La simplification d'un polygone diminue le nombre de sommets et tend à réduire la durée d'affichage. | Linear Unit |
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é si le paramètre Unités de mesure est temporel. 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é si le paramètre Unités de mesure est basé sur la distance. La valeur du 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. AdditionalCost Coût ajouté lorsque l’interruption est franchie. Ce champ est actif uniquement pour les interruptions à coût ajouté si le paramètre Unités de mesure n’est ni temporel ni basé 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 fonctionne avec les deux types de normes de conduite nationales : circulation à droite (comme en France et aux États-Unis) et circulation à gauche (Royaume-Uni). Tout d'abord, imaginons une ressource qui se trouve du côté gauche d'un véhicule. Il se situe toujours sur la gauche, que le véhicule circule du côté gauche ou du côté droit de la route. Avec les normes de conduite nationales, ce qui peut changer est votre décision d'aborder la ressource du côté droit ou du côté gauche du véhicule. Par exemple, pour atteindre une ressource sans qu’il y ait de voie de circulation entre le véhicule et la ressource, 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épasser500. 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 [Restrictions,...] (Facultatif) | Restrictions qui doivent être respectées par l’outil lorsque vous déterminez les zones de desserte. 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. L'outil prend en charge les restrictions suivantes :
| 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. 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 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 Valeurs des paramètres d’attributs, chaque restriction (affichée sous la forme AttributeName) se voit attribuer une valeur de champ ParameterName, 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 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 |
Time_Zone_for_Time_of_Day (Facultatif) | Spécifie les fuseaux horaires du paramètre Time of Day (Heure du jour).
Quel que soit le paramètre Fuseau horaire de l’heure de la journée, toutes les ressources doivent se trouver dans le même fuseau horaire quand Heure du jour a une valeur non nulle et que le paramètre Polygones pour les ressources multiples est défini de sorte à créer des polygones fusionnés ou qui ne se superposent pas. | 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 la table 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 la valeur du 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. | 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.)
Si vous choisissez une impédance temporelle, telle que TravelTime, TruckTravelTime, Minutes, TruckMinutes ou WalkTime, le paramètre Unités des bornes doit être défini sur une valeur temporelle. En revanche, si vous choisissez une impédance de distance comme Miles ou Kilometers, Unités des bornes doit faire référence à une 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 d’Esri une liste des paramètres de remplacement pris en charge, ainsi que leurs valeurs acceptables, pour chaque solveur. | String |
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.
| 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.
| String |
Polygon_Detail (Facultatif) | Spécifie le niveau de détail des polygones en sortie.
Si votre analyse couvre une zone urbaine avec un réseau de transport de type grille, la différence entre les polygones généralisés et les polygones standard est minime. Cependant, les polygones standard et détaillés peuvent afficher des résultats beaucoup plus précis que les polygones généralisés pour les routes de montagne et de campagne. L’outil prend en charge la génération de polygones haute précision uniquement si la valeur la plus importante spécifiée dans le paramètre Valeurs des bornes est inférieure ou égale à 15 minutes ou à 15 miles (24,14 kilomètres) lors de la génération de zones de desserte temporelles ou basées sur la distance, respectivement. | String |
Output_Type (Facultatif) | Spécifie le type de sortie à générer. La sortie des zones de desserte peut être constituée d’entités linéaires représentant les routes atteignables avant que les valeurs limites ne soient dépassées ou les entités surfaciques comprenant ces lignes (représentant la zone atteignable).
| 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 Fichier JSON ou 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 Fichier de résultats en sortie dans l’entrée correspondant à l’exécution de l’outil dans l’historique de géotraitement de votre projet. Dans ArcMap, l’emplacement du fichier peut être déterminé via l’option Copier l’emplacement dans le menu contextuel du paramètre Fichier de résultats en sortie de l’entrée correspondant à l’exécution de l’outil dans la fenêtre Résultats du géotraitement. | String |
Ignore_Invalid_Locations (Facultatif) | Détermine si les emplacements en entrée non valides sont ignorés.
| Boolean |
Sortie dérivée
| Nom | Explication | Type de données |
| Service_Areas | Ce paramètre permet d’accéder aux entités surfaciques représentant les zones accessibles depuis les emplacements en entrée selon un temps, une distance ou un coût de déplacement donné. | Feature Set |
| Solve_Succeeded | Indique si l’analyse de la zone de desserte a abouti. | Boolean |
| 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. | File |
| Output_Facilities | Ce paramètre permet d’accéder aux attributs des ressources utilisées dans l’analyse de la zone de desserte. Vous pouvez utiliser les attributs à partir de ce type de données, tel que le champ Status, pour déterminer pourquoi une ressource n’a pas été utilisée dans l’analyse. | Feature Set |
| Output_Service_Area_Lines | Ce paramètre stocke les zones de desserte sous forme d’entités linéaires et couvre les rues, ou les tronçons de réseau, auxquelles il est possible d’accéder dans la limite de temps, de distance ou de coût de déplacement donnée. Les lignes sont une représentation plus réelle d'une zone de desserte que les polygones, puisque les analyses de la zone de desserte sont basées sur les mesures le long des lignes de réseau. | Feature Set |
| 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). | File |
| Output_Network_Analysis_Layer_Package | Paquetage de couche contenant une couche d’analyse de réseau avec les données et les paramètres utilisés dans l’analyse. | File |
Exemple de code
Exemple d’utilisation de l’outil GenerateServiceAreas (script autonome)
Le script Python ci-dessous illustre l’utilisation de l’outil GenerateServiceAreas dans un script.
"""This example shows how to generate 5, 10, 15 minute drive time areas around facilities."""
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>"
sa_service = "https://logistics.arcgis.com/arcgis/services;World/ServiceAreas;{0};{1}".format(username, password)
# Add the geoprocessing service as a toolbox.
# Check https://pro.arcgis.com/en/pro-app/arcpy/functions/importtoolbox.htm for
# other ways in which you can specify credentials to connect to a geoprocessing service.
arcpy.ImportToolbox(sa_service)
# Set the variables to call the tool
facilities = "C:/data/Inputs.gdb/Stores"
output_service_areas = "C:/data/Results.gdb/StoreServiceAreas"
# Call the tool
result = arcpy.GenerateServiceAreas_ServiceAreas(facilities, "5 10 15", "Minutes")
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))
# Store the output drive time polygons to a geodatabase
result.getOutput(0).save(output_service_areas)
Environnements
Cet outil n'utilise pas d’environnement de géotraitement.