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

Disponible avec une licence Business Analyst.

Synthèse

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 Valeurs de seuil fournies pour la valeur du paramètre Variable de seuil du jeu de données Business Analyst.

  • Le paramètre Variable de seuil n’accepte que des variables de type Count. MedianImpossible d’utiliser Average, Percent ou Index.

  • 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 Champ d’ID identifie de manière unique l’emplacement de point autour duquel les polygones de temps de trajet seront créés.

Paramètres

ÉtiquetteExplicationType de données
Entités en entrée

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

Feature Layer
Classe d’entités en sortie

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

Feature Class
Variable de seuil

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

Les variables de seuil doivent être numériques. Aucun autre type de statistiques n’est pris en charge.

String
Valeurs de seuil

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
Type de distance

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

String
Unités de distance
(Facultatif)

Unités de distance utilisées avec les valeurs de seuil.

String
Champ d’ID
(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
Sens de déplacement
(Facultatif)

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

  • Vers les points de venteLe déplacement va des clients vers les points de vente. Il s’agit de l’option par défaut.
  • Depuis les points de venteLe déplacement va des points de vente vers les clients.
String
Heure du jour
(Facultatif)

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

Date
Fuseau horaire
(Facultatif)

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

  • Fuseau horaire de la localisationLe 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
Tolérance de recherche
(Facultatif)

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

La valeur par défaut est de 5 000 mètres.

Linear Unit
Détail du polygone
(Facultatif)

Spécifie le niveau de détail 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.
  • GénéraliséDes polygones généralisés sont créés à l’aide de la hiérarchie présente dans la source de données de réseau afin de générer des résultats rapides.
  • ElevéeDes 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
Limite d’itérations
(Facultatif)

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

Long
Pas minimal
(Facultatif)

Distance minimale entre un candidat de zone seuil et le suivant lorsque le modèle approche la valeur de seuil pour prévenir les itérations infinies.

Double
Différence du seuil en pourcentage
(Facultatif)

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

Double
Méthode en entrée
(Facultatif)

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

  • ValeursUne valeur constante sera utilisée (toutes les zones de chalandise seront de même taille). Il s’agit de l’option par défaut.
  • ExpressionLes valeurs d’un champ ou d’une expression sont utilisées (les zones de chalandise peuvent être de différentes tailles).
String
Expression
(Facultatif)

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

SQL Expression

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})
NomExplicationType 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.

Les variables de seuil doivent être numériques. Aucun autre type de statistiques n’est pris en charge.

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 utilisée pour la création des polygones en sortie.

String
units
(Facultatif)

Unités de distance utilisées 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 utilisé 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 utilisé pour le paramètre 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 de 5 000 mètres.

Linear Unit
polygon_detail
(Facultatif)

Spécifie le niveau de détail 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 de 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 pouvant être utilisés pour identifier le seuil optimal.

Long
minimum_step
(Facultatif)

Distance minimale entre un candidat de zone seuil et le suivant lorsque le modèle approche la valeur de seuil pour prévenir les itérations infinies.

Double
target_percent_diff
(Facultatif)

Différence maximale en pourcentage entre la valeur cible et la valeur seuil qui sera utilisée 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 seront de même taille). Il s’agit de l’option par défaut.
  • EXPRESSIONLes valeurs d’un champ ou d’une expression sont utilisées (les zones de chalandise peuvent être de différentes tailles).
String
expression
(Facultatif)

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

SQL Expression

Exemple de code

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

Le script suivant pour la fenêtre Python 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: Nécessite Business Analyst
  • Standard: Nécessite Business Analyst
  • Advanced: Nécessite Business Analyst

Rubriques connexes