Resumir cerca de (Analysis)

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

Resumir cerca de

Uso

    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.

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

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ámetroExplicaciónTipo 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.

  • DRIVING_DISTANCELa distancia recorrida por un coche u otro vehículo pequeño similar, como camionetas. En los viajes se siguen todas las reglas específicas de los coches.
  • DRIVING_TIMELa distancia recorrida en un determinado tiempo por un coche u otro vehículo pequeño similar, como camionetas. Cuando se especifica una hora del día, se utilizan las velocidades de viaje dinámicas basadas en el tráfico, si están disponibles. En los viajes se siguen todas las reglas específicas de los coches.
  • STRAIGHT_LINEDistancia euclidiana o en línea recta.
  • TRUCKING_DISTANCELa distancia recorrida en rutas designadas para camiones. En los viajes se siguen todas las reglas de los coches, así como las reglas específicas para camiones.
  • TRUCKING_TIMELa distancia recorrida en un tiempo determinado cuando se viaja por rutas designadas para camiones. Cuando se especifica una hora del día, se utilizan las velocidades de viaje dinámicas basadas en el tráfico, si están disponibles. En los viajes se siguen todas las reglas de los coches, así como las reglas específicas para camiones.
  • WALKING_DISTANCELa distancia recorrida por rutas y carreteras que permiten el tráfico peatonal.
  • WALKING_TIMELa distancia recorrida en un tiempo determinado cuando se camina por rutas y carreteras que permiten el tráfico peatonal.
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.

  • MILESMillas
  • KILOMETERSKilómetros
  • FEETPies
  • YARDSYardas
  • METERSMetros
  • HOURSHoras
  • MINUTESMinutos
  • SECONDSSegundos
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).

  • GEOLOCALLa hora del día hace referencia a las zonas horarias locales en las que estén ubicadas las entidades de entrada. Esta opción puede provocar horas de inicio rotativas en las diferentes zonas horarias para los análisis. Esta es la opción predeterminada.Por ejemplo, si se selecciona una hora geolocal de las 9:00 de la mañana, los tiempos de conducción de los puntos de la zona horaria del Este se cuentan a partir de las 9:00 de la mañana. Hora del Este y las 9:00. Hora central para puntos de la zona horaria central. (Las horas de inicio tienen una variación de una hora respecto a la hora real o UTC).
  • UTCLa hora del día hace referencia a la hora universal coordinada (UTC). Las horas de inicio son simultáneas para todos los puntos, independientemente de las zonas horarias.Por ejemplo, si se selecciona una hora UTC de las 9:00 de la mañana, los tiempos de conducción de los puntos de la zona horaria del Este se cuentan a partir de las 4:00 de la mañana. Hora del Este y las 3:00. Hora central para puntos de la zona horaria central. (Las horas de inicio son simultáneas).
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.

  • KEEP_ALLSe copiarán todas las zonas de influencia en la clase de entidad de salida. Esta es la opción predeterminada.
  • ONLY_INTERSECTINGSe copiarán solo las zonas de influencia 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:

  • Suma: agrega el valor total de los puntos de cada zona de influencia.
  • Media: calcula la media de los puntos de cada zona de influencia.
  • Mínimo: busca el valor más pequeño de los puntos de cada zona de influencia.
  • Máximo: busca el valor más grande de los puntos de cada zona de influencia.
  • Desviación estándar: busca la desviación estándar de los puntos de cada zona de influencia.

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.

  • ADD_SHAPE_SUMAgrega los atributos de resumen de forma a la clase de entidad de salida. Esta es la opción predeterminada.
  • NO_SHAPE_SUMNo agrega los atributos de resumen de forma a la clase de entidad de salida.
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.

  • METERSMetros
  • KILOMETERSKilómetros
  • FEETPies
  • YARDSYardas
  • MILESMillas
  • ACRESAcres
  • HECTARESHectáreas
  • SQUAREMETERSMetros cuadrados
  • SQUAREKILOMETERSKilómetros cuadrados
  • SQUAREFEETPies cuadrados
  • SQUAREYARDSYardas cuadradas
  • SQUAREMILESMillas cuadradas
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.

  • NO_MIN_MAJNo agrega los campos de minoría y mayoría a la salida. Esta es la opción predeterminada.
  • ADD_MIN_MAJAgrega los campos de minoría y mayoría a la salida.
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.

  • NO_PERCENTNo agrega un campo de atributo de porcentaje a la salida. Esta es la opción predeterminada.
  • ADD_PERCENTAgrega un campo de atributo de porcentaje a la salida.
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:

  • Join_ID: Id. correspondiente a un campo de Id. agregado a la clase de entidad de salida.
  • El campo de grupo.
  • Un campo de resumen de forma, como el recuento de puntos o la longitud de las líneas.
  • Un campo para cada uno de los campos de resumen.
  • Campo de porcentaje.

Table

Muestra de código

Ejemplo 1 de SummarizeNearby (ventana de Python)

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")
Ejemplo 2 de SummarizeNearby (secuencia de comandos independiente)

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)

Información de licenciamiento

  • Basic: Sí
  • Standard: Sí
  • Advanced: Sí

Temas relacionados