ArcMap

Average Drive-Time Report

Available with Business Analyst license.

Summary

Calculates the average drive time within trade areas.

Learn more about Average Drive-Time Report

Usage

  • It is recommended that the average drive-time report be run using customer-derived trade areas.

  • Drive times are calculated for each trade area selected.

  • It is recommended that the units selected for the average drive time be either minutes or miles.

  • As a default, this tool uses the geographic center of the trade areas for the average drive-time calculation. You can alternately choose the actual store center point.

  • If your trade area has extreme points in it, this may skew the results. This tool uses an average calculation to determine the average drive time, and extremes in this calculation may shift the average time to be higher or lower depending on the extremes.

  • Once you have determined your average drive time, you can use this value to seek new markets by generating drive times around potential new store sites and evaluating the demographics in that area to see if they match the demographics of a successful store.

Syntax

AverageDTReports_ba (InputFeatureLayer, StoreIDField, AreaDescriptionField, MeasureUnits, OutputFolder, {UseSelectedFeatures}, {StoreLayer}, {AssocStoreID}, {ReportTitle}, {ReportFormats})
ParameterExplanationData Type
InputFeatureLayer

The input feature class that defines the extent of the drive-time analysis.

Feature Layer
StoreIDField

Unique ID field in the trade area center (store) layer.

Field
AreaDescriptionField

Field used to describe or name each feature in the trade area layer.

Field
MeasureUnits

The units used with the distance values. By default, the units defined in the Business Analyst preferences will be selected.

  • Decimal Degrees
  • Feet
  • Kilometers
  • Meters
  • Miles
  • Nautical Miles
  • Yards
String
OutputFolder

The report is created in this output directory.

Folder
UseSelectedFeatures
(Optional)

Uses selected features to calculate the average drive times.

  • True —Uses selected features to calculate the average drive times.
  • False —Calculates the average drive times on all features.
Boolean
StoreLayer
(Optional)

The input feature class containing center points for the report. In most cases, this will be a Business Analyst store layer. The average drive-time report will use the points in this layer as the starting point for calculating the average drive time.

Feature Layer
AssocStoreID
(Optional)

Unique ID field that defines the (store) layer.

Field
ReportTitle
(Optional)

Names the report for use/access in the Business Analyst reports wizard.

String
ReportFormats
(Optional)

Select the desired report output format

  • Simple XML
  • PDF
  • HTML
  • CSV
  • ZIP
  • XLSX
  • Stripped XLSX
String

Code sample

AverageDTReports example (stand-alone script)

# Name: AverageDTReports.py
# Description:  Calculates the average drive time of a customer derived trade area output from Business Analyst.
# Author: Esri

# Import system modules
import arcview
import arcpy

arcpy.ImportToolbox(r"C:\Program Files (x86)\ArcGIS\Desktop10.6\Business Analyst\ArcToolbox\Toolboxes\Business Analyst Tools.tbx")
 
try:
# Acquire extension license 
  arcpy.CheckOutExtension("Business")
     
# Define input and output parameters for the Average Drive Time Report tool

  Input = "C:/My Output Data/Projects/Default Project/TradeAreas/Customer Derived Areas/TradeArea.shp"
  Id = "STORE_ID"
  AreaDesc = "AREA_DESC"
  Units = "Minutes"
  Output = "C:/My Output Data/Projects/Default Project/Reports"
 
# Create Average Drive Time report
  arcpy.AverageDTReports_ba(Input,
	  Id,
	  AreaDesc,
	  Units,
	  Output)
 
# Release extension license 
  arcpy.CheckInExtension("Business")
 
except:
  print arcpy.GetMessages(2)

Environments

This tool does not use any geoprocessing environments.

Licensing information

  • ArcGIS Desktop Basic: Requires Business Analyst
  • ArcGIS Desktop Standard: Requires Business Analyst
  • ArcGIS Desktop Advanced: Requires Business Analyst

Related topics