Summarize Nearby (Standard Feature Analysis Tools)
Summary
Finds features that are within a specified distance of features in the input layer.
Distance can be measured as a straight-line distance or by a specified travel mode. Statistics are then calculated for the nearby features, as in the following examples:
Calculate the total population within 5 minutes of driving time of a proposed new store location.
Calculate the number of freeway access ramps within a 1-mile driving distance of a proposed new store location to use as a measure of store accessibility.
Illustration
Usage
This tool requires two input layers: a layer from which distances will be measured and a layer to summarize. Both layers can be points, lines, or areas. The first input layer can contain up to 1,000 features.
The nearby distance can be based on a line distance or several different travel modes using time or distance as the measure. Travel modes are only enabled when the first input layer contains point features. You can create multiple output areas by inputting multiple distances or times.
Some travel modes have an option for using traffic conditions. When traffic conditions are used, they can be based on live conditions or typical conditions for a specified day of the week and time. Live traffic conditions can be offset up to 12 hours from the current time. Times for typical conditions can be set by 15-minute intervals for the entire day and night.
Travel modes can be configured by the administrator of your organization. The administrator can also add new travel modes or remove travel modes that are not necessary for your organization. The default distance measure will be in miles or kilometers, depending on the units setting in your profile.
Parameters
| Label | Explanation | Data type |
|---|---|---|
|
Input Nearby Layer |
Point, line, or polygon features from which distances will be measured to features in the input summary layer. |
Feature Set |
|
Input Summary Features |
Point, line, or polygon features. Features in this layer that are within the specified distance to features in the input nearby layer will be summarized. |
Feature Set |
|
Output Name |
The name of the output layer that will be created on your portal. |
String |
|
Distance Measurement |
Specifies the distance measurement that will be used: straight-line distance or by measuring travel time or travel distance along a street network using various modes of transportation known as travel modes.
|
String |
|
Distances (Optional) |
A list of double values that defines the search distance (for straight-line and distance-based travel modes) or time (for time-based travel modes). A single distance value or multiple values can be provided. Features that are within (or equal to) the distances provided will be summarized. The units of the distance values is supplied by the Distance Units parameter value. |
Double |
|
Distance Units (Optional) |
If the distance is straight-line or a distance-based travel mode, this is the linear unit that will be used with the distance values specified in the Distances parameter. The options are miles, feet, kilometers, meters, and yards. If the distance is a time-based travel mode, the options are seconds, minutes, and hours.
|
String |
|
Time Of Day (Optional) |
The time and date when travel times will consider traffic conditions. To use traffic in the analysis, you must set the distance to a travel time-based mode. The time of day value represents the time at which travel begins, or departs, from the input points. Two kinds of traffic are supported: typical and live. Typical traffic references travel speeds that are composed of historical averages for each 5-minute interval spanning a week. Live traffic retrieves speeds from a traffic feed that processes phone probe records, sensors, and other data sources to record actual travel speeds and predict speeds for the near future. To ensure that the task uses typical traffic in locations where it is available, provide a time and day of the week and convert the day of the week to one of the following dates from 1990:
Although the dates representing days of the week are from 1990, typical traffic is calculated from recent traffic trends—usually over the last several months. To use live traffic when and where it is available, choose a date and time within 12 hours of the current time. Esrisaves live traffic data for 12 hours and references predictive data extending 12 hours into the future. If the time and date you provide for this parameter are outside the 24-hour time window, or the travel time in the analysis continues past the predictive data window, the task will use typical traffic speeds. |
Date |
|
Time Zone (Optional) |
Specifies the time zone or zones of the specified time of day.
|
String |
|
Return boundaries (Optional) |
Specifies whether the input geometries or the straight-line or travel mode buffer geometry will be returned.
|
Boolean |
|
Add shape summary attributes (Optional) |
Specifies whether statistics will be calculated based on the shape of the Input Summary Features parameter value, such as the length of lines or areas of polygons of the summary features within each polygon in the input summary layer.
|
Boolean |
|
Shape Unit (Optional) |
Specifies the units that will be used for the shape summary. When the input summary features are polygons, the valid options are acres, hectares, square meters, square kilometers, square feet, square yards, and square miles. When the input summary features are lines, the valid options are miles, feet, kilometers, meters, and yards.
|
String |
|
Summary Fields (Optional) |
A list of field names and statistical summary type that will be calculated for all points within each polygon. The count of points within each polygon is always returned. Value table columns:
|
Value Table |
|
Group By Field (Optional) |
A field from the input summary features that will be used to calculate statistics separately for each unique attribute value. For example, the input summary features contain point locations of businesses that store hazardous materials, and the |
Field |
|
Add minority and majority attributes (Optional) |
Specifies whether minority and majority fields will be added to the output. This parameter only applies when using a group by field.
|
Boolean |
|
Add group percentages (Optional) |
Specifies whether group percentage fields will be added to the output. This parameter only applies when using a group by field.
|
Boolean |
Derived output
| Label | Explanation | Data type |
|---|---|---|
|
Output Feature Service |
The output summarized layer. |
Feature Set |
|
Output Group Table |
If a group by field was provided, the tool will output a table that contains the calculated statistics for each unique group. |
Record Set |
Environments
Licensing information
- Basic: Requires your account in ArcGIS Enterprise to have the Perform Analysis privilege
- Standard: Requires your account in ArcGIS Enterprise to have the Perform Analysis privilege
- Advanced: Requires your account in ArcGIS Enterprise to have the Perform Analysis privilege