获得 Business Analyst 许可后可用。
描述
Assigns customers to the closest store based on a selected distance type.
使用方法
The ID of the closest store is assigned to each customer. Store assignments are influenced by the selected value for Distance Type.
An Origin-Destination matrix calculates the least-cost paths between customers and stores using the Business Analyst network dataset and routing service.
When using a network distance type, you can adjust the Search Tolerance parameter value to define the maximum distance the input customer features can be from a road. Customer points beyond this distance will not receive a store assignment.
If a store cannot be assigned to a customer point, the new Store ID value will be null and the Distance value will contain a -1.
语法
AssignCustomersByDistance(in_features, in_store_features, store_id_field, out_feature_class, {link_field}, {distance_type}, {distance_units}, {travel_direction}, {time_of_day}, {time_zone}, {search_tolerance})
参数 | 说明 | 数据类型 |
in_features | The input point feature layer representing customers. | Feature Layer |
in_store_features | The input point feature layer representing store or facilities. | Feature Layer |
store_id_field | A unique ID field for in_store_features. | Field |
out_feature_class | A point layer containing customers with assigned store or facility and distance. | Feature Class |
link_field (可选) | A new field that contains the assigned store or facility ID. | String |
distance_type (可选) | The method of travel used to calculate the distance between customers and stores. | String |
distance_units (可选) | The units that will be used to measure the selected distance type. | String |
travel_direction (可选) | Specifies the direction of travel that will be used between stores or facilities and 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.
| 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. The parameter requires a distance value and units for the tolerance. The default value is 5000 meters. | Linear Unit |
代码示例
The following Python window script demonstrates how to use the AssignCustomersByDistance function.
import arcpy
arcpy.ba.AssignCustomersByDistance("SF_Custs", "SF_Stores", "STORE_ID",
r"C:\ArcGIS\Projects\MyProject.gdb\SF_Custs_AssignCustomersByDistance",
"STORE_ID_1", "Driving Time", "MINUTES",
"TOWARD_STORES", None,
"TIME_ZONE_AT_LOCATION")
许可信息
- Basic: 需要 Business Analyst
- Standard: 需要 Business Analyst
- Advanced: 需要 Business Analyst