Resumen
Permite buscar entidades que se encuentran a una determinada distancia de las entidades de la capa de entrada y calcular estadísticas para las entidades próximas. La distancia se puede medir como distancia en línea recta, como distancia de tiempo de recorrido (por ejemplo, en 10 minutos) o como distancia de recorrido (a 5 kilómetros). Las mediciones del tiempo de conducción y la distancia requieren que inicie sesión en una cuenta de organización de ArcGIS Online con privilegios de Análisis de red, y consumen créditos.
Escenarios de ejemplo en los que se utiliza Resumir cerca de:
- Calcule la población total que se encuentra a menos de 5 minutos de tiempo de conducción de la ubicación propuesta para una nueva tienda.
- Calcule el número de incorporaciones a la autovía a una distancia de conducción de 1 kilómetro de la ubicación propuesta para una nueva tienda con el fin de usarlas como medida de la accesibilidad de una tienda.
Ilustración
Uso
Puede especificar varias distancias y cada valor de distancia dará lugar a un área generada alrededor de cada entidad de entrada. Por ejemplo, si especifica dos distancias, se creará dos veces una zona de influencia para cada entidad de entrada, y la salida incluirá dos áreas para dicha entidad de entrada, una para cada distancia.
Desde el punto de vista conceptual, las herramientas Resumir dentro de y Resumir cerca de son idénticas. No obstante, con la herramienta Resumir dentro de puede resumir entidades dentro de polígonos existentes, mientras que con la herramienta Resumir cerca de puede generar áreas alrededor de puntos, líneas o polígonos, y resumir entidades dentro de dichas áreas derivadas.
Puede crear grupos especificando un nombre de grupo en los puntos de entrada. Por ejemplo, si está haciendo un resumen de los actos delictivos que se producen dentro de una distancia determinada respecto de los límites de un vecindario, puede que tenga un atributo Crime_type con cinco tipos distintos de actos delictivos. Cada tipo de delito único constituye un grupo y las estadísticas que elijas se calcularán para cada valor único de Crime_type.
Licencia:
Para usar las opciones de medición del tiempo de conducción y la distancia, debe iniciar sesión en una cuenta de organización de ArcGIS Online con privilegios de Análisis de red. Cada vez que la herramienta se ejecuta correctamente, se descuentan créditos de servicio de su suscripción según el servicio utilizado y los resultados obtenidos. La página Créditos de servicio de ArcGIS Online le ofrece detalles sobre los créditos de servicio.
Sintaxis
arcpy.analysis.SummarizeNearby(in_features, in_sum_features, out_feature_class, distance_type, distances, {distance_units}, {time_of_day}, {time_zone}, {keep_all_polygons}, {sum_fields}, {sum_shape}, {shape_unit}, {group_field}, {add_min_maj}, {add_group_percent}, {Output_Grouped_Table})
Parámetro | Explicación | Tipo de datos |
in_features | Las entidades de punto, línea o poligonales en las que se creará una zona de influencia y las zonas de influencia usadas para resumir las entidades de resumen de entrada. | Feature Layer |
in_sum_features | Las entidades de punto, línea o poligonales que se van a resumir. | Feature Layer |
out_feature_class | La clase de entidad poligonal de salida que contiene las entidades de entrada para las que se han creado zonas de influencia, los atributos de las entidades de entrada, los atributos nuevos sobre los puntos numéricos, la longitud de las líneas, el área de los polígonos dentro de cada zona de influencia y las estadísticas sobre dichas entidades. | Feature Class |
distance_type | Define el tipo de medición de distancia que se va a utilizar para generar zonas de influencia alrededor de las entidades de entrada. La distancia y el tiempo de conducción utilizan la red de carreteras y respetan restricciones como las vías de sentido único. El tiempo de conducción respeta las limitaciones de velocidades vigentes en un momento dado. Para usar las opciones de medición del tiempo de conducción y la distancia, debe iniciar sesión en una cuenta de organización de ArcGIS Online con privilegios de Análisis de red. Cada vez que la herramienta se ejecuta correctamente, se descuentan créditos de servicio de su suscripción según el servicio utilizado y los resultados obtenidos. La página Créditos de servicio de ArcGIS Online le ofrece detalles sobre los créditos de servicio. Todos los tipos de distancia, excepto distancia en línea recta, utilizan los servicios de elaboración de rutas y redes de ArcGIS Online.
| String |
distances [distance,...] | Los valores de distancia permiten definir una distancia de búsqueda (para la distancia en línea recta, la distancia de conducción, la distancia en camión o la distancia a pie) o el tiempo de viaje (de conducción, en camión o a pie). Se resumirán las entidades que estén dentro (o equivalgan a) las distancias introducidas. Se pueden especificar varios valores. Se generará un área alrededor de cada entidad de entrada para cada distancia. | Double |
distance_units (Opcional) | Las unidades de los valores de distancia.
| String |
time_of_day (Opcional) | Indique si en los tiempos de viaje se debe tener en cuenta el estado del tráfico. El estado del tráfico, sobre todo en áreas urbanas, puede afectar considerablemente al área recorrida en un tiempo de viaje determinado. Si no se especifica ninguna fecha u hora, no se tendrá en cuenta el tráfico al calcular la distancia recorrida durante un determinado tiempo de viaje. Las condiciones del tráfico pueden ser en directo o típicas (históricas) basándose en la fecha y hora especificada para este parámetro. Esri guarda los datos de tráfico en directo durante 12 horas y hace referencia a datos predictivos que abarcan hasta 12 horas en el futuro. Si la fecha y la hora especificadas se encuentran en la ventana de tiempo de 24 horas, se utilizará el tráfico en directo. En cambio, si están fuera de la ventana de tiempo, se utilizará el tráfico típico o histórico. | Date |
time_zone (Opcional) | La zona horaria correspondiente a la hora del día especificada. Las zonas horarias se pueden especificar siguiendo la hora local o la hora universal coordinada (UTC).
| String |
keep_all_polygons (Opcional) | Determina si en la clase de entidad de salida se copiarán todas las zonas de influencia de las entidades de entrada o solo aquellas que intersequen o contengan al menos una entidad de resumen de entrada.
| Boolean |
sum_fields [[summary_field, statistic_type],...] (Opcional) | Una lista de los nombres de campo de atributo provenientes de las entidades de resumen de entrada y los tipos de resumen de estadísticas que desea calcular para dichos campos de atributos en todos los puntos de cada zona de influencia de cada entidad de entrada. Los campos de resumen deben ser numéricos. No se admiten campos de texto ni otros tipos de campos de atributos. Entre los tipos de estadísticas se incluyen los siguientes:
| Value Table |
sum_shape (Opcional) | Determina si la clase de entidad de salida incluirá atributos para el número de puntos, la longitud de las líneas y el área de las entidades poligonales que se resumen en la zona de influencia de cada entidad de entrada.
| Boolean |
shape_unit (Opcional) | La unidad en la que se van a calcular los atributos de resumen de forma. Si las entidades de resumen de entrada son puntos, no se usa ninguna unidad de forma, dado que solo se agrega el recuento de puntos de cada zona de influencia de entidad de entrada. Si las entidades de resumen de entrada son líneas, debe especificar una unidad lineal. Si las entidades de resumen de entrada son polígonos, debe especificar una unidad de área.
| String |
group_field (Opcional) | Campo de atributo de las entidades de resumen de entrada utilizado para la agrupación. Las entidades que tengan el mismo valor de campo de grupo se combinarán y resumirán con otras entidades que tengan el mismo valor de campo de grupo. Si elige un campo de grupo, se creará una tabla agrupada de salida adicional y deberá especificar la ubicación en el parámetro out_grouped_table. | Field |
add_min_maj (Opcional) | Esta opción solo está habilitada si seleccionó un campo de grupo. Le permite determinar qué valor de campo de grupo corresponde a la minoría (menos dominante) y a la mayoría (más dominante) en cada zona de influencia de la entidad de entrada.
| Boolean |
add_group_percent (Opcional) | Esta opción solo está habilitada si seleccionó un campo de grupo. Le permite determinar el porcentaje de cada valor de atributo en cada grupo.
| Boolean |
Output_Grouped_Table (Opcional) | Si se ha especificado un campo de grupo, la tabla agrupada de salida es necesaria. Se trata de una tabla de salida que incluye campos de resumen para cada grupo de entidades de la zona de influencia de cada entidad de entrada. La tabla contendrá los siguientes campos de atributos:
| Table |
Muestra de código
La siguiente secuencia de comandos de la ventana de Python muestra cómo utilizar la función SummarizeNearby.
import arcpy
arcpy.env.workspace = "C:/data/city.gdb"
arcpy.SummarizeNearby_analysis("new_store_location", "census_blocks",
"new_store_population", "STRAIGHT_LINE", "1;2",
"Miles", "", "", "KEEP_ALL", "Pop2014 SUM")
La siguiente secuencia de comandos independiente es un ejemplo de cómo utilizar la función SummarizeNearby en un entorno de secuencias de comandos.
# Description: Use SummarizeNearby to summarize population
# import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/data/city.gdb"
# Set local variables
newStore = "new_store_location"
censusInfo = "census_blocks"
outFeatureClass = "crimes_aggregated"
distanceType = "TRAVEL_TIME"
distance = "10;20"
distanceUnit = "Minutes"
time = "10/15/2014 2:14:19 PM"
timeZone = "GEOLOCAL"
keepPolys = True
sumFields = [["Pop2010", "Sum"],["OWNERS", "Sum"]]
addShapeSum = True
arcpy.SummarizeNearby_analysis(newStore, censusInfo, outFeatureClass,
distanceType, distance, distanceUnit,
time, timeZone, keepPolys, sumFields,
addShapeSum)
Entornos
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí