arcgis.features.use_proximity module¶

These functions help you answer one of the most common questions posed in spatial analysis: “What is near what?”

connect_origins_to_destinations measures the travel time or distance between pairs of points. create_buffers create areas of equal distance from features. create_drive_time_areas finds areas around locations that can be reached within a time period. find_nearest identifies those places that are the closest to known locations. plan_routes determines the best way to route a fleet of vehicles to visit many stops.

connect_origins_to_destinations¶

use_proximity.connect_origins_to_destinations(origins_layer, destinations_layer, measurement_type='DrivingTime', origins_layer_route_id_field=None, destinations_layer_route_id_field=None, time_of_day=None, time_zone_for_time_of_day='GeoLocal', output_name=None, context=None, gis=None)¶

Calculates routes between pairs of points.

origins_layer: The routes start from points in the origins layer.
destinations_layer: The routes end at points in the destinations layer.
measurement_type: The routes can be determined by measuring travel distance or travel time along street network using different travel modes or by measuring straight line distance.
origins_layer_route_id_field: The field in the origins layer containing the IDs that are used to match an origin with a destination.
destinations_layer_route_id_field: The field in the destinations layer containing the IDs that are used to match an origin with a destination.
time_of_day: When measurementType is DrivingTime, this value specifies the time of day to be used for driving time calculations based on traffic. WalkingTime and TruckingTime measurementType do not support calculations based on traffic.
time_zone_for_time_of_day: Determines if the value specified for timeOfDay is specified in UTC or in a time zone that is local to the location of the origins.
output_name: Additional properties such as output feature service name.
context: Additional settings such as processing extent and output spatial reference.
gis :: Optional, the GIS on which this tool runs. If not specified, the active GIS is used.

dict with the following keys:: “routes_layer” : layer (FeatureCollection) “unassigned_origins_layer” : layer (FeatureCollection) “unassigned_destinations_layer” : layer (FeatureCollection)

create_buffers¶

use_proximity.create_buffers(input_layer, distances=[], field=None, units='Meters', dissolve_type='None', ring_type='Disks', side_type='Full', end_type='Round', output_name=None, context=None, gis=None)¶

Creates buffer polygon(s) around input features.

input_layer: The input to be buffered.
distances: The distance(s) that will be buffered.
field: Buffers will be created using field values.
units: The linear unit to be used with the distance value(s).
dissolve_type: Specifies the dissolve to be performed to remove buffer overlap.
ring_type: The ring type.
side_type: The side(s) of the input that will be buffered.
end_type: The shape of the buffer at the end of buffered line features.
output_name: Additional properties such as output feature service name.
context: Additional settings such as processing extent and output spatial reference.
gis :: Optional, the GIS on which this tool runs. If not specified, the active GIS is used.

buffer_layer : layer (FeatureCollection)

create_drive_time_areas¶

use_proximity.create_drive_time_areas(input_layer, break_values=[5, 10, 15], break_units='Minutes', travel_mode='Driving', overlap_policy='Overlap', time_of_day=None, time_zone_for_time_of_day='GeoLocal', output_name=None, context=None, gis=None)¶

input_layer : Required layer (see Feature Input in documentation)

break_values : Optional list of floats

break_units : Optional string

travel_mode : Optional string

overlap_policy : Optional string

time_of_day : Optional datetime.datetime

time_zone_for_time_of_day : Optional string

output_name: Additional properties such as output feature service name.
context: Additional settings such as processing extent and output spatial reference.
gis :: Optional, the GIS on which this tool runs. If not specified, the active GIS is used.

drive_time_areas_layer : layer (FeatureCollection)

find_nearest¶

use_proximity.find_nearest(analysis_layer, near_layer, measurement_type='StraightLine', max_count=100, search_cutoff=2147483647, search_cutoff_units=None, time_of_day=None, time_zone_for_time_of_day='GeoLocal', output_name=None, context=None, gis=None)¶

Measures the straight-line distance, driving distance, or driving time from features in the analysis layer to features in the near layer, and copies the nearest features in the near layer to a new layer. Returns a layer containing the nearest features and a line layer that links the start locations to their nearest locations.

analysis_layer: For each feature in this layer, the task finds the nearest features from the nearLayer.
near_layer: The features from which the nearest locations are found.
measurement_type: The nearest locations can be determined by measuring straight-line distance, driving distance, or driving time
max_count: The maximum number of near locations to find for each feature in analysisLayer.
search_cutoff: Limits the search range to this value
search_cutoff_units: The units for the value specified as searchCutoff
time_of_day: When measurementType is DrivingTime, this value specifies the time of day to be used for driving time calculations based on traffic.

time_zone_for_time_of_day : Optional string

output_name: Additional properties such as output feature service name
context: Additional settings such as processing extent and output spatial reference
gis :: Optional, the GIS on which this tool runs. If not specified, the active GIS is used.

dict with the following keys:: “nearest_layer” : layer (FeatureCollection) “connecting_lines_layer” : layer (FeatureCollection)

plan_routes¶

use_proximity.plan_routes(stops_layer, route_count, max_stops_per_route, route_start_time, start_layer, start_layer_route_id_field=None, return_to_start=True, end_layer=None, end_layer_route_id_field=None, travel_mode='Driving', stop_service_time=0, max_route_time=525600, output_name=None, context=None, gis=None)¶

You provide a set of stops and the number of vehicles available to visit the stops, and Plan Routes determines how to efficiently assign the stops to the vehicles and route the vehicles to the stops.

Use this tool to plan work for a mobile team of inspectors, appraisers, in-home support service providers, and others; deliver or pick up items from remote locations; or offer transportation services to people.

stops_layer : Required layer (see Feature Input in documentation)

route_count : Required int

max_stops_per_route : Required int

route_start_time : Required datetime.datetime

start_layer : Required layer (see Feature Input in documentation)

start_layer_route_id_field : Optional string

return_to_start : Optional bool

end_layer : Optional layer (see Feature Input in documentation)

end_layer_route_id_field : Optional string

travel_mode : Optional string

stop_service_time : Optional float

max_route_time : Optional float

output_name : Optional string

context : Optional string

gis :: Optional, the GIS on which this tool runs. If not specified, the active GIS is used.

dict with the following keys:: “routes_layer” : layer (FeatureCollection) “assigned_stops_layer” : layer (FeatureCollection) “unassigned_stops_layer” : layer (FeatureCollection)