Generate Drive Time Trade Areas (Business Analyst)

Доступно с лицензией Business Analyst.

Краткая информация

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

Иллюстрация

Generate Drive Time Trade Areas tool illustration

Использование

  • 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.

Параметры

ПодписьОписаниеТип данных
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
(Дополнительный)

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

String
ID Field
(Дополнительный)

A unique ID field for existing facilities.

Field
Dissolve Option
(Дополнительный)

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
(Дополнительный)

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
(Дополнительный)

Specifies the direction of travel that will be used between stores and customers.

  • Toward StoresThe direction of travel will be from customers to stores. This is the default.
  • Away from StoresThe direction of travel will be from stores to customers.
String
Time of Day
(Дополнительный)

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

Date
Time Zone
(Дополнительный)

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
(Дополнительный)

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
(Дополнительный)

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
(Дополнительный)

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
(Дополнительный)

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})
ИмяОписаниеТип данных
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
(Дополнительный)

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

String
id_field
(Дополнительный)

A unique ID field for existing facilities.

Field
dissolve_option
(Дополнительный)

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
(Дополнительный)

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
(Дополнительный)

Specifies the direction of travel that will be used between stores and customers.

  • TOWARD_STORESThe direction of travel will be from customers to stores. This is the default.
  • AWAY_FROM_STORESThe direction of travel will be from stores to customers.
String
time_of_day
(Дополнительный)

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

Date
time_zone
(Дополнительный)

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
(Дополнительный)

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
(Дополнительный)

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
(Дополнительный)

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
(Дополнительный)

A fields-based expression used to calculate drive time.

SQL Expression

Пример кода

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)

Информация о лицензиях

  • Basic: Обязательно Business Analyst, Расширение ArcGIS Network Analyst
  • Standard: Обязательно Business Analyst, Расширение ArcGIS Network Analyst
  • Advanced: Обязательно Business Analyst, Расширение ArcGIS Network Analyst

Связанные разделы