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
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ámetro | Explicación | Tipo 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.
| 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.
| 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:
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.
| 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.
| 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.
| 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.
| 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:
| 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_.
| 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.
| Boolean |
Salida derivada
Nombre | Explicación | Tipo 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