Resumir cerca de (Standard Feature Analysis)

Resumen

Busca entidades que están dentro de una distancia especificada de las entidades de la capa de entrada.

La distancia puede medirse como una distancia en línea recta o mediante un modo de viaje especificado. A continuación, se calculan las estadísticas para las entidades cercanas, como en el siguiente ejemplo:

  • 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

  • Para la herramienta Resumir cerca de se requieren dos capas: una capa desde la cual se medirán las distancias y una capa para resumir. Ambas capas pueden ser de puntos, líneas o áreas. La primera capa de entrada puede incluir hasta 1.000 entidades.

  • La distancia cercana puede estar basada en una distancia en línea o en varios modos de viaje diferentes utilizando el tiempo o la distancia como medida. Los modos de viaje solo están habilitados si la primera capa de entrada contiene entidades de puntos. Puede crear varias áreas de salida introduciendo varios tiempos o distancias.

  • Algunos modos de viaje tienen una opción para usar las condiciones de tráfico. Cuando se usan las condiciones de tráfico, se pueden basar en las condiciones en directo o en las condiciones típicas para un día de la semana y una hora. Las condiciones de tráfico en directo se pueden desplazar hasta 12 horas con respecto a la hora actual. Las horas de las condiciones típicas se pueden establecer en intervalos de 15 minutos durante todo el día y toda la noche.

  • El administrador de la organización puede configurar los modos de viaje. El administrador también puede agregar nuevos modos de viaje o eliminar los modos de viaje que no sean necesarios para la organización. La medida de la distancia predeterminada estará en millas o kilómetros dependiendo del ajuste de units definido en su perfil.

Sintaxis

arcpy.sfa.SummarizeNearby(sumNearbyLayer, summaryLayer, outputName, nearType, {distances}, {units}, {timeOfDay}, {timeZoneForTimeOfDay}, {returnBoundaries}, {sumShape}, {shapeUnits}, {summaryFields}, {groupByField}, {minorityMajority}, {percentShape})
ParámetroExplicaciónTipo de datos
sumNearbyLayer

Entidades de punto, de línea o poligonales desde las que se medirán las distancias a las entidades de la capa de resumen de entrada.

Feature Set
summaryLayer

Entidades de punto, de línea o poligonales. Se resumirán las entidades de esta capa que estén dentro de la distancia especificada a las entidades de la capa cercana de entrada.

Feature Set
outputName

El nombre de la capa de salida que se debe crear en el portal.

String
nearType

Define el tipo de medición de la distancia que se va a usar: distancia en línea recta o medición del tiempo de viaje o la distancia de viaje por una red de calles usando diversos modos de transporte conocidos como modos de viaje.

  • STRAIGHTLINEUse la medición de distancia euclídea en línea recta. Esta es la opción predeterminada.
  • DRIVINGDISTANCEUse la distancia conducida en un automóvil.
  • DRIVINGTIMEUse la distancia cubierta en un tiempo de conducción especificado en un automóvil.
  • TRUCKINGDISTANCEUse la distancia conducida en un camión.
  • TRUCKINGTIMEUse la distancia cubierta en un tiempo de conducción especificado en un camión.
  • WALKINGDISTANCEUse la distancia caminada por una calle.
  • WALKINGTIMEUse la distancia cubierta caminando en un tiempo especificado.
String
distances
[distances,...]
(Opcional)

Una lista de valores dobles que define la distancia de búsqueda (para los modos de viaje en línea recta y basados en la distancia) o en el tiempo (para los modos de viaje basados en el tiempo). Puede introducir un único valor de distancia o varios valores. Se resumirán las entidades que estén dentro (o equivalgan a) las distancias introducidas. Las units de los valores de distancia vienen dadas por el parámetro units.

Double
units
(Opcional)

Si el tipo cercano es un modo de viaje en línea recta o basado en la distancia, esta es la unidad lineal que se va a usar con los valores de distancia especificados en las distancias. Entre las opciones válidas se incluyen los metros, los kilómetros, los pies, las yardas y las millas.

Si el tipo cercano es un modo de viaje basado en el tiempo, entre los valores se incluyen los segundos, los minutos y las horas.

  • MILESMillas
  • FEETPies
  • KILOMETERSKilómetros
  • METERSMetros
  • YARDSYardas
  • SECONDSSegundos
  • MINUTESMinutos
  • HOURSHoras
String
timeOfDay
(Opcional)

Indique si en los tiempos de viaje se debe tener en cuenta el estado del tráfico. Para usar el tráfico en el análisis, debe definir el tipo cercano en un modo de viaje basado en el tiempo. El valor de hora del día representa la hora a la que comienza el viaje u hora de partida de los puntos de entrada.

Se admiten dos tipos de tráfico: típico y en directo. El tráfico típico hace referencia a velocidades de viaje compuestas por las medias históricas de los intervalos de 5 minutos a lo largo de una semana. El tráfico en directo recupera las velocidades de una fuente de tráfico que procesa los registros de sondeos telefónicos, sensores y otras fuentes de datos para registrar las velocidades de viaje reales y predecir las velocidades para el futuro cercano.

Para garantizar que la tarea usa el tráfico típico en las ubicaciones en las que está disponible, elija una hora y un día de la semana y convierta el día de la semana en una de las siguientes fechas de 1990:

  • Lunes, 1/1/1990
  • Martes, 2/1/1990
  • Miércoles, 3/1/1990
  • Jueves, 4/1/1990
  • Viernes, 5/1/1990
  • Sábado, 6/1/1990
  • Domingo, 7/1/1990
Aunque las fechas que representan los días de la semana son de 1990, el tráfico típico se calcula a partir de las tendencias de tráfico recientes, normalmente a lo largo de los últimos meses.

Para usar el tráfico en directo cuando y donde esté disponible, elija una fecha y una hora que no estén a más de 12 horas de la hora actual. Esriguarda 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 hora y la fecha que ha especificado para este parámetro están fuera de la ventana de tiempo de 24 horas o el tiempo de viaje del análisis sigue más allá de la ventana de datos predictivos, la tarea vuelve a las velocidades de tráfico típicas.

Date
timeZoneForTimeOfDay
(Opcional)

Especifique la zona o las zonas horarias de la hora del día elegida. Existen dos opciones: GeoLocal (predeterminada) y UTC.

  • GEOLOCALEl valor de hora del día hace referencia a las zonas horarias locales en las que se encuentran los puntos de entrada. Esta opción hace que el análisis tenga horas de inicio rotativas en las diferentes zonas horarias. Esta es la opción predeterminada.
  • UTCEl valor de 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.
String
returnBoundaries
(Opcional)

Especifica si se devolverán las geometrías de entrada o la geometría de zona de influencia de modo de viaje o en línea recta.

  • RETURN_BOUNDARIESLa capa de salida contendrá las áreas definidas por el tipo cercano especificado. Por ejemplo, si se usa una distancia en línea recta de 5 millas, la salida contendrá áreas con un radio de 5 millas alrededor de las entidades de la capa cercana de entrada. Esta es la opción predeterminada.
  • RETURN_INPUTLa capa de salida contendrá las mismas entidades que la capa cercana de entrada.
Boolean
sumShape
(Opcional)

Calcula las estadísticas en función de la forma de las entidades de resumen de entrada, como la longitud de las líneas o las áreas de los polígonos de las entidades de resumen dentro de cada polígono de la capa de resumen de entrada.

  • ADD_SHAPE_SUMCalcula los atributos de resumen de forma. Esta es la opción predeterminada.
  • NO_SHAPE_SUMNo calcula los atributos de resumen de forma.
Boolean
shapeUnits
(Opcional)

Si desea resumir la forma de las entidades cercanas, especifique las unidades del resumen de forma.

Cuando las entidades de resumen de entrada son polígonos, las opciones válidas son acres, hectáreas, metros cuadrados, kilómetros cuadrados, pies cuadrados, yardas cuadradas y millas cuadradas.

Cuando las entidades de resumen de entrada son líneas, las opciones válidas son metros, kilómetros, pies, yardas y millas.

  • MILESMillas
  • FEETPies
  • KILOMETERSKilómetros
  • METERSMetros
  • YARDSYardas
  • ACRESAcres
  • HECTARESHectáreas
  • SQUAREMETERSMetros cuadrados
  • SQUAREKILOMETERSKilómetros cuadrados
  • SQUAREFEETPies cuadrados
  • SQUAREYARDSYardas cuadradas
  • SQUAREMILESMillas cuadradas
String
summaryFields
[[Field, Statistic],...]
(Opcional)

Una lista de los nombres de campos y del tipo de resumen estadístico que desea calcular para todos los puntos de cada polígono. Siempre se devuelve el recuento de puntos de cada polígono. Se admiten los siguientes tipos de estadísticas:

  • SUM: el valor total.
  • MIN: el valor más bajo.
  • MAX: el valor más alto.
  • MEAN: media o valor medio.
  • STD: la desviación estándar.

Value Table
groupByField
(Opcional)

Este es un campo de las entidades de resumen de entrada que puede utilizar para calcular por separado las estadísticas de cada valor de atributo único. Por ejemplo, supongamos que las entidades de resumen de entrada contienen ubicaciones de puntos de compañías que almacenan materiales peligrosos, y uno de los campos es HazardClass, que contiene códigos que describen el tipo de material peligroso almacenado. Para calcular resúmenes por cada valor único de HazardClass, úselo como campo por el que se va a agrupar.

Field
minorityMajority
(Opcional)

Esto solo se aplica cuando se usa un campo de agrupación. Si especifica ADD_MIN_MAJ, se calculan los valores de atributo que son minoría (menos dominantes) o los que son mayoría (más dominantes) para cada campo de grupo en cada límite. Se agregan a la capa de salida dos nuevos campos con el prefijo Majority_ y Minority_.

  • NO_MIN_MAJNo agrega los campos de minoría y mayoría. Esta es la opción predeterminada.
  • ADD_MIN_MAJAgrega los campos de minoría y mayoría.
Boolean
percentShape
(Opcional)

Esto solo se aplica cuando se usa un campo de agrupación. Si está activado, se calcula el porcentaje de cada valor de grupo único para cada entidad cercana de entrada.

  • NO_PERCENTNo agrega los campos de porcentaje. Esta es la opción predeterminada.
  • ADD_PERCENTAgrega los campos de porcentaje.
Boolean

Salida derivada

NombreExplicaciónTipo de datos
resultLayer

Capa resumida de salida.

Conjunto de entidades
groupBySummary

Si se ha proporcionado un campo de agrupación, la herramienta generará una tabla que contiene las estadísticas calculadas para cada grupo único.

Conjunto de registros

Entornos

Información de licenciamiento

  • Basic: Requiere su cuenta de ArcGIS Enterprise que tendrá el privilegio Realizar análisis
  • Standard: Requiere su cuenta de ArcGIS Enterprise que tendrá el privilegio Realizar análisis
  • Advanced: Requiere su cuenta de ArcGIS Enterprise que tendrá el privilegio Realizar análisis

Temas relacionados