Générer des temps de trajet de seuil (Business Analyst)

Disponible avec une licence Business Analyst.

Résumé

Crée une classe d’entités de zones de chalandise en distance de réseau qui se développent autour d’entités ponctuelles jusqu’à ce que les critères soient atteints.

Utilisation

  • La taille des polygones en sortie dépend des valeurs du paramètre Threshold Values (Valeurs de seuil) fournies pour la valeur du paramètre Threshold Variable (Variable de seuil) issue du jeu de données Business Analyst.

  • Il est possible de créer plusieurs polygones de temps de trajet autour de chaque entrée en saisissant des valeurs individuelles dans des zones de texte distinctes de valeur de seuil.

  • Le paramètre ID Field (Champ ID) identifie de manière unique l’emplacement de point autour duquel les polygones de temps de trajet sont créés.

Syntaxe

arcpy.ba.GenerateThresholdDriveTimeTradeArea(in_features, out_feature_class, threshold_variable, threshold_values, distance_type, {units}, {id_field}, {travel_direction}, {time_of_day}, {time_zone}, {search_tolerance}, {polygon_detail}, {iterations_limit}, {minimum_step}, {target_percent_diff}, {input_method}, {expression})
ParamètreExplicationType de données
in_features

Couche d'entités ponctuelles en entrée.

Feature Layer
out_feature_class

Classe d’entités en sortie contenant les polygones de temps de trajet.

Feature Class
threshold_variable

Variable du jeu de données Business Analyst sélectionnée à laquelle la valeur de seuil sera appliquée.

String
threshold_values
[threshold_values,...]

Valeur de la variable de seuil qui détermine la taille des anneaux en sortie. Les anneaux se développent jusqu’à ce qu’ils contiennent la valeur de seuil de la variable sélectionnée.

Double
distance_type

Méthode de trajet employée pour la création des polygones en sortie.

String
units
(Facultatif)

Unités de distance à utiliser avec les valeurs de seuil.

String
id_field
(Facultatif)

ID qui identifie de manière unique chaque point en entrée et qui est inclus dans la sortie sous forme d’attribut.

Field
travel_direction
(Facultatif)

Spécifie le sens de déplacement pour la création du polygone en sortie.

  • TOWARD_STORESLe déplacement va des clients vers les points de vente. Il s’agit de l’option par défaut.
  • AWAY_FROM_STORESLe déplacement va des points de vente vers les clients.
String
time_of_day
(Facultatif)

Date et heure utilisées pour le calcul de la distance.

Date
time_zone
(Facultatif)

Spécifie le fuseau horaire qui sera utilisé pour le paramètre Time of Day (Heure du jour).

  • TIME_ZONE_AT_LOCATIONLe fuseau horaire dans lequel se trouvent les secteurs est utilisé. Il s’agit de l’option par défaut.
  • UTCLe temps universel coordonné (UTC) est utilisé.
String
search_tolerance
(Facultatif)

Distance maximale des points en entrée par rapport au réseau.

La valeur par défaut est 5000 mètres.

Linear Unit
polygon_detail
(Facultatif)

Spécifie le niveau de détail qui sera utilisé pour les polygones de temps de trajet en sortie.

  • STANDARDDes polygones avec un niveau de détail standard sont créés. Il s’agit de l’option par défaut.
  • GENERALIZEDDes polygones généralisés sont créés à l’aide de la hiérarchie présente dans la source de données du réseau afin de générer des résultats rapides.
  • HIGHDes polygones avec un niveau de détail élevé sont créés pour les applications où il est important d’avoir des résultats précis.
String
iterations_limit
(Facultatif)

Restreint le nombre de temps de trajet utilisés pour identifier le seuil optimal.

Long
minimum_step
(Facultatif)

Distance ou temps incrémentiel minimal (1 mille ou 1 minute, par exemple) utilisé pour incrémenter chaque itération jusqu’à atteindre le seuil.

Double
target_percent_diff
(Facultatif)

Différence maximale entre la valeur cible et la valeur seuil lors de la détermination du temps de trajet de seuil (5 % par exemple). La valeur par défaut est 5.

Double
input_method
(Facultatif)

Spécifie le type de valeur qui sera utilisé pour chaque temps de trajet.

  • VALUESUne valeur constante sera utilisée (toutes les zones de chalandise sont de la même taille). Il s’agit de l’option par défaut.
  • EXPRESSIONLes valeurs d’un champ ou d’une expression sont utilisées (toutes les zones de chalandise sont de la même taille).
String
expression
(Facultatif)

Expression basée sur les champs pour calculer le temps de trajet.

SQL Expression

Exemple de code

Exemple d’utilisation de la fonction GenerateThresholdDriveTimeTradeArea (fenêtre Python)

Le script de fenêtre Python ci-dessous illustre l'utilisation de la fonction GenerateThresholdDriveTimeTradeArea.

import arcpy
arcpy.ba.GenerateThresholdDriveTimeTradeArea("SF_Custs",r"C:\ Project1\Project1.gdb\SF_Custs_GenerateThresholdDriveTimeTradeArea","populationtotals.totpop_cy",[25000, 50000], "Driving Time","MINUTES", "CUST_ID", None,"TOWARD_STORES", None,"TIME_ZONE_AT_LOCATION", None,"STANDARD", 10, None, 5, Values, None)

Informations de licence

  • Basic: Requiert Business Analyst
  • Standard: Requiert Business Analyst
  • Advanced: Requiert Business Analyst

Rubriques connexes