Rapport des zones de fréquentation en fonction de la distance (Business Analyst)—ArcMap

Disponible avec une licence Business Analyst.

Résumé
Utilisation
Syntaxe
Exemple de code
Environnements
Informations de licence

Résumé

Calcule le taux de pénétration de différents polygones isochrones ou avec anneaux autour de vos points de vente.

Utilisation

Lorsque vous définissez la méthode de calcul du potentiel de marché, l'option Calculer à l'aide du niveau géographique vous permet de choisir n'importe quelle couche surfacique qui a été définie à l'aide de l'utilitaire de configuration des couches d'analyse.
Le paramètre Champ de potentiel de marché est disponible si l'option Utiliser la table attributaire de la couche est sélectionnée dans le paramètre Méthode de calcul du potentiel de marché.
En principe, les zones de chalandise dont la fréquentation est fonction de la distance ne sont pas différentes d'une simple zone pondérée. La fonctionnalité Mesure de la fréquentation en fonction de la distance de Business Analyst permet de créer ces zones en fonction du principe géographique de la fréquentation en fonction de la distance. La propension à se rendre dans un point de vente décroît à mesure que la distance qui sépare le consommateur du point de vente augmente.
La zone de fréquentation en fonction de la distance calcule le taux de pénétration de différents polygones isochrones ou avec anneaux autour de vos points de vente.
Le rapport de fréquentation en fonction de la distance indique la distance que vos clients sont prêts à parcourir pour se rendre dans un point de vente, par rapport à une valeur de base (la population, par exemple).
Vous devez posséder des couches de points de vente et de clients, avec des attributions de clients déjà générées.

Syntaxe

arcpy.ba.DistanceDecayReport(InputFeatureLayer, IDField, All_Or_Single_Or_Selected, RingsType, RingsCollection, {MeasureUnits}, CustomerLayer, MarketPenetrationTMCType, ReportTitle, MarketPenetrationReportDirectory, {ByID_Or_ByName}, {Single_Site}, {Donut}, {RemoveOverlap}, {BorderShape}, IN_MP_STORE_ID, {UseSelectedCustomers}, {CustomerWeightField}, {IN_CL_STORE_ID}, MarketPenetrationTMCField, InputGeographyLevel, MarketPenetrationTMCSummarization, {ReportFormats}, {CreateReport}, {BarrierFeatureClasses})

Paramètre	Explication	Type de données
InputFeatureLayer	Classe d'entités en entrée contenant les points centraux du rapport. Dans la plupart des cas, il s'agit de la couche de points de vente Business Analyst.	Feature Layer
IDField	Champ ID unique dans la couche de points de vente.	Field
All_Or_Single_Or_Selected	Crée des zones de chalandise pour les points dans la couche d'entités en entrée. ALL —Des zones de chalandise sont créées pour tous les points. SINGLE —Des zones de chalandise sont créées pour un seul point. SELECTED —Des zones de chalandise sont créées pour les points sélectionnés dans ArcMap.	String
RingsType	Détermine la façon dont les zones de chalandise générées sont déterminées. Simple Ring Areas —Génère un ou plusieurs anneaux statiques en fonction des points centraux de la couche de points de vente. Drive Time Areas —Génère un ou plusieurs polygones isochrones en fonction des points centraux de la couche de points de vente.	String
RingsCollection [RingsCollection,...]	Distances, par taille croissante, utilisées pour créer des zones de chalandise autour des entités en entrée.	Double
MeasureUnits (Facultatif)	Unités utilisées avec les valeurs de distance. Par défaut, les unités définies dans les préférences de Business Analyst seront sélectionnées. Decimal Degrees Feet Kilometers Meters Miles —Il s'agit de l'option par défaut. Nautical Miles Yards	String
CustomerLayer	Classe d'entités en entrée contenant les points pour la répartition des clients. Dans la plupart des cas, il s'agit d'une couche de clients Business Analyst.	Feature Layer
MarketPenetrationTMCType	Détermine l'emplacement à partir duquel le calcul du total de marchés sera déterminé. In the layer attribute table —Calcule le taux de pénétration en fonction de la géographie non standard. Calculate using Geography Level —Calcule le taux de pénétration en fonction d'une couche géographique standard. Calculate Using Business Analyst Online Data —Calcule le taux de pénétration en fonction des données Business Analyst en ligne.	String
ReportTitle	Titre du rapport.	String
MarketPenetrationReportDirectory	Répertoire en sortie dans lequel le rapport sera enregistré.	Folder
ByID_Or_ByName (Facultatif)	Champ utilisé pour sélectionner un seul point. ID —Sélectionne un seul point à l'aide du champ d'ID de point de vente. Name —Sélectionne un seul point à l'aide du champ de nom de point de vente.	String
Single_Site (Facultatif)	ID ou nom du point de vente à utiliser comme point unique.	String
Donut (Facultatif)	Crée des anneaux concentriques non superposés ou des bandes en donut. True —Des anneaux concentriques sont créés. Il s'agit de l'option par défaut. False —Crée des polygones en sortie qui constituent des anneaux en donut. Par exemple, si trois rayons (1, 2 et 3 miles) sont saisis, trois bandes en sortie sont alors créées avec des anneaux de 0 à 1 mile, de 1 à 3 miles et de 3 à 5 miles.	Boolean
RemoveOverlap (Facultatif)	Supprime la superposition à l'aide de la méthode de Thiessen en dessinant des lignes d'égale distance entre deux polygones adjacents. True —Supprime la superposition entre des zones de chalandise. False —Ne supprime pas la superposition entre des zones de chalandise. Il s'agit de l'option par défaut.	Boolean
BorderShape (Facultatif)	Crée une bordure détaillée en ignorant les zones non accessibles. True —Génère des bordures détaillées autour des zones de chalandise. False —Ne génère pas de bordures détaillées autour des zones de chalandise. Il s'agit de l'option par défaut.	Boolean
IN_MP_STORE_ID	Champ ID unique reposant sur la couche qui permet de calculer le taux de pénétration. Cet ID unique est un champ de la couche Taux de pénétration.	Field
UseSelectedCustomers (Facultatif)	Utilise les entités sélectionnées pour générer un rapport des zones de fréquentation en fonction de la distance. True —Génère un rapport des zones de fréquentation en fonction de la distance sur les entités sélectionnées. False —Génère le rapport des zones de fréquentation en fonction de la distance sur toutes les entités. Il s'agit du paramètre par défaut.	Boolean
CustomerWeightField (Facultatif)	Définit l'attribut de la couche de clients qui sera utilisé pour pondérer les zones de chalandise.	Field
IN_CL_STORE_ID (Facultatif)	Champ ID point de vente qui permettra d'identifier les clients associés à chaque point de vente. Cet ID point de vente est un champ de la couche Taux de pénétration.	Field
MarketPenetrationTMCField	Champ qui contient le nombre de base total de marchés issu de la couche du taux de pénétration utilisée dans le calcul du taux de pénétration.	String
InputGeographyLevel	Sélectionne le niveau géographique qui contiendra le nombre total de marchés.	Feature Layer
MarketPenetrationTMCSummarization	Champ attributaire contenant la variable utilisée pour le nombre total de marchés sélectionné dans le niveau géographique.	String
ReportFormats [ReportFormats,...] (Facultatif)	Sélectionnez le format souhaité pour le rapport en sortie. Simple XML PDF HTML CSV ZIP XLSX Stripped XLSX	String
CreateReport (Facultatif)	Génère un rapport. True —Un rapport d'agrégation des points sera généré. Il s'agit de l'option par défaut. False —Aucun rapport d'agrégation des points ne sera généré.	Boolean
BarrierFeatureClasses [BarrierFeatureClasses,...] (Facultatif)	Interruptions ponctuelles, linéaires ou surfaciques à utiliser lorsque le temps de trajet ou la distance à parcourir sert à calculer des distances.	Feature Layer

Exemple de code

Exemple d'utilisation du script DistanceDecayReport (script autonome)

# Name: DistanceDecayReport.py
# Description: Calculates the market penetration in San Francisco based on a series of simple ring trade areas comparing the sales in each ring to the total population.
# Author: Esri

# Import system modules
import arcview
import arcpy

arcpy.ImportToolbox(r"C:\Program Files (x86)\ArcGIS\Desktop10.8\Business Analyst\ArcToolbox\Toolboxes\Business Analyst Tools.tbx")
 
try:
# Acquire extension license 
  arcpy.CheckOutExtension("Business")
     
# Define input and output parameters for the Distance Decay Report tool
  Store = "C:/temp/sf_stores.shp"
  Cust = "C:/temp/sf_cust.shp"
  Id = "STORE_ID"
  MarketPen = "C:/Temp/Decay/MpLayer.shp"
  Method = "Calculate using Geography Level"
  Weight = "SALES"
  Data = "C:/ArcGIS/Business Analyst/US_2022/Data/Demographic Data/BlockGroups_bg.bds"
  Var = "TOTPOP_CY"
  Output = "C:/temp/DecayReport2"
 
# Create Distance Decay reports
  arcpy.DistanceDecayReport_ba(Store, Id, "ALL", 'Simple Ring Areas', "1;2;3", "Miles", Cust, Method, Weight, Data, Var, "Ring Penetration", Output, "#", "#", "false", "false","false", "#", "false", "#", "#",sMarketPen)
 
# Release extension license 
arcpy.CheckInExtension("Business")

Environnements

Cet outil n'utilise pas d’environnement de géotraitement.

Informations de licence

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

Rubriques connexes

Vue d’ensemble du jeu d’outils Rapports de Business Analyst