ArcGIS for Desktop

  • Documentation
  • Pricing
  • Support

  • My Profile
  • Help
  • Sign Out
ArcGIS for Desktop

ArcGIS Online

The mapping platform for your organization

ArcGIS for Desktop

A complete professional GIS

ArcGIS for Server

GIS in your enterprise

ArcGIS for Developers

Tools to build location-aware apps

ArcGIS Solutions

Free template maps and apps for your industry

ArcGIS Marketplace

Get apps and data for your organization

  • Documentation
  • Pricing
  • Support
Esri
  • Sign In
user
  • My Profile
  • Sign Out

Help

  • Home
  • Get Started
  • Map
  • Analyze
  • Manage Data
  • Tools
  • More...

Average Drive-Time Report

  • Summary
  • Usage
  • Syntax
  • Code Sample
  • Environments
  • Licensing Information

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
  • XLSV
  • 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("C:\Program Files (x86)\ArcGIS\Desktop10.3\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"
  Output = "C:/My Output Data/Projects/Default Project/Reports"
  Report = "Average Drive Time Report"
 
# Create Average Drive Time report
  arcpy.AverageDTReports_ba(Input, Id, AreaDesc, "Minutes", "Output false", "#", "#", sReport)
 
# Release extension license 
  arcpy.CheckInExtension("Business")
 
except:
  print arcpy.GetMessages(2)

Environments

This tool does not use any geoprocessing environments

Licensing Information

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

Related Topics

  • An overview of the Business Analyst Reports toolset
Feedback on this topic?

ArcGIS for Desktop

  • Home
  • Documentation
  • Pricing
  • Support

ArcGIS Platform

  • ArcGIS Online
  • ArcGIS for Desktop
  • ArcGIS for Server
  • ArcGIS for Developers
  • ArcGIS Solutions
  • ArcGIS Marketplace

About Esri

  • About Us
  • Careers
  • Insiders Blog
  • User Conference
  • Developer Summit
Esri
© Copyright 2016 Environmental Systems Research Institute, Inc. | Privacy | Legal