Generate Drive Time Trade Areas (Business Analyst)

Disponible con licencia de Business Analyst.

Resumen

Creates a feature class of trade areas around point features based on travel time and distance.

Ilustración

Generate Drive Time Trade Areas tool illustration

Uso

  • This tool requires a locally stored dataset or a portal connection, such as ArcGIS Online.

  • You can create drive time rings that don't overlap using various travel modes.

  • The Time of Day parameter is used to model output polygons based on historical traffic data at the specified day and time.

  • The ID Field parameter is used to create an attribute in the output that uniquely identifies each polygon and respective input point.

Parámetros

EtiquetaExplicaciónTipo de datos
Input Features

The input point feature layer.

Feature Layer
Output Feature Class

The output feature class containing the drive time polygons.

Feature Class
Distance Type

The method of travel that will be used for drive time calculation.

String
Distances

The distances that will be used for drive time calculations.

Double
Distance Units
(Opcional)

The units that will be used for the distance values. The default value is miles.

String
ID Field
(Opcional)

A unique ID field for existing facilities.

Field
Dissolve Option
(Opcional)

Specifies whether overlapping or nonoverlapping service areas for a single location will be used when multiple distances are specified.

  • Overlap Each polygon will include the area reachable from the facility up to the distance value. This is the default.
  • Split Each polygon will include only the area between consecutive distance values.
String
Remove Overlap
(Opcional)

Specifies whether overlapping concentric rings will be created or overlap will be removed from multiple locations in relation to one another.

  • Checked—Polygons will be split and the overlap between output features will be removed.
  • Unchecked—Output features will be created with overlap. This is the default.
Boolean
Travel Direction
(Opcional)

Specifies the direction of travel toward or away from stores.

  • Toward stores The direction of travel will be toward stores. This is the default.
  • Away from stores The direction of travel will be away from stores.
String
Time of Day
(Opcional)

The time and date that will be used when calculating distance.

Date
Time Zone
(Opcional)

Specifies the time zone that will be used for the Time of Day parameter.

  • Time Zone at LocationThe time zone in which the territories are located will be used. This is the default.
  • UTCCoordinated universal time (UTC) will be used.
String
Search Tolerance
(Opcional)

The maximum distance that input points can be from the network. Points located beyond the search tolerance will be excluded from processing.

This parameter requires a distance value and units for the tolerance. The default value is 5000 meters.

Linear Unit
Polygon Detail
(Opcional)

Specifies the level of detail that will be used for the output drive time polygons.

  • Standard Polygons with a standard level of detail will be created. This is the default.
  • GeneralizedGeneralized polygons will be created using the hierarchy present in the network data source to produce results quickly.
  • High Polygons with a high level of detail will be created for applications in which precise results are important.
String
Input Method
(Opcional)

Specifies the type of value that will be used for each drive time.

  • ValuesA constant value will be used (all trade areas will be the same size). This is the default.
  • Expression The values from a field or an expression will be used (trade areas can be different sizes).
String
Distance Expression
(Opcional)

A fields-based expression used to calculate drive time.

SQL Expression

arcpy.ba.GenerateDriveTimeTradeArea(in_features, out_feature_class, distance_type, distances, {units}, {id_field}, {dissolve_option}, {remove_overlap}, {travel_direction}, {time_of_day}, {time_zone}, {search_tolerance}, {polygon_detail}, {input_method}, {expression})
NombreExplicaciónTipo de datos
in_features

The input point feature layer.

Feature Layer
out_feature_class

The output feature class containing the drive time polygons.

Feature Class
distance_type

The method of travel that will be used for drive time calculation.

String
distances
[distances,...]

The distances that will be used for drive time calculations.

Double
units
(Opcional)

The units that will be used for the distance values. The default value is miles.

String
id_field
(Opcional)

A unique ID field for existing facilities.

Field
dissolve_option
(Opcional)

Specifies whether overlapping or nonoverlapping service areas for a single location will be used when multiple distances are specified.

  • OVERLAP Each polygon will include the area reachable from the facility up to the distance value. This is the default.
  • SPLIT Each polygon will include only the area between consecutive distance values.
String
remove_overlap
(Opcional)

Specifies whether overlapping concentric rings will be created or overlap will be removed from multiple locations in relation to one another.

  • REMOVE_OVERLAPPolygons will be split and the overlap between output features will be removed.
  • KEEP_OVERLAPOutput features will be created with overlap. This is the default.
Boolean
travel_direction
(Opcional)

Specifies the direction of travel toward or away from stores.

  • TOWARD_STORES The direction of travel will be toward stores. This is the default.
  • AWAY_FROM_STORES The direction of travel will be away from stores.
String
time_of_day
(Opcional)

The time and date that will be used when calculating distance.

Date
time_zone
(Opcional)

Specifies the time zone that will be used for the time_of_day parameter.

  • TIME_ZONE_AT_LOCATIONThe time zone in which the territories are located will be used. This is the default.
  • UTCCoordinated universal time (UTC) will be used.
String
search_tolerance
(Opcional)

The maximum distance that input points can be from the network. Points located beyond the search tolerance will be excluded from processing.

This parameter requires a distance value and units for the tolerance. The default value is 5000 meters.

Linear Unit
polygon_detail
(Opcional)

Specifies the level of detail that will be used for the output drive time polygons.

  • STANDARD Polygons with a standard level of detail will be created. This is the default.
  • GENERALIZEDGeneralized polygons will be created using the hierarchy present in the network data source to produce results quickly.
  • HIGH Polygons with a high level of detail will be created for applications in which precise results are important.
String
input_method
(Opcional)

Specifies the type of value that will be used for each drive time.

  • VALUESA constant value will be used (all trade areas will be the same size). This is the default.
  • EXPRESSION The values from a field or an expression will be used (trade areas can be different sizes).
String
expression
(Opcional)

A fields-based expression used to calculate drive time.

SQL Expression

Muestra de código

GenerateDriveTimeTradeArea example (Python window)

The following Python window script demonstrates how to use the GenerateDriveTimeTradeArea function.

import arcpy
arcpy.ba.GenerateDriveTimeTradeArea(r"C:\Project1.gdb\DriveTime.gdb\Starbucks","\Documents\ArcGIS\Projects\Project1.gdb\Starbucks_GenerateDriveTimeTradeArea","Driving
Distance", 1.3, "MILES", None,"OVERLAP", "KEEP_OVERLAP",
"TOWARD_STORES",None, "TIME_ZONE_AT_LOCATION", None,"STANDARD", Values,
None)

Información de licenciamiento

  • Basic: Requiere Business Analyst, Extensión ArcGIS Network Analyst
  • Standard: Requiere Business Analyst, Extensión ArcGIS Network Analyst
  • Advanced: Requiere Business Analyst, Extensión ArcGIS Network Analyst

Temas relacionados