Resumen
Devuelve polígonos de áreas visibles para un conjunto determinado de puntos de observación de entrada.
Uso
Las herramientas de la caja de herramientas listas para usar son servicios de geoprocesamiento de ArcGIS Online que usan datos alojados y capacidades de análisis de ArcGIS Online.
Existen varias fuentes de elevación disponibles con resoluciones espaciales diferentes y que abarcan áreas distintas. No todas las resoluciones están disponibles para todas las áreas. La herramienta devolverá un mensaje de error si la resolución especificada no está disponible en ninguna de las ubicaciones de observador de entrada.
Si el parámetro Resolución de DEM no se indica, se utilizará la resolución menor (90 m). Si se especifica Finest, la herramienta utilizará la mayor resolución disponible en la ubicación de observador que permita el parámetro Distancia máxima.
Para el parámetro de Distancia máxima, el valor permitido para las resoluciones de DEM de 10 m y 30 m es de 15 kilómetros o menos. Para la resolución de DEM de 90 m, el valor permitido es de 50 kilómetros o menos. Si este parámetro no se especifica, la herramienta utilizará un valor predeterminado en función del parámetro Resolución de DEM. Para la resolución de 10 m, la distancia máxima predeterminada es de 5 kilómetros. Para las resoluciones de DEM de 30 m y de 90 m, la distancia predeterminada es de 15 kilómetros.
La herramienta utiliza una única fuente de elevación de resolución para las entidades de entrada. Todas las entidades de entrada deben encajar en una sola resolución, de lo contrario, la herramienta identificará la mayor resolución que abarque todas las entidades de entrada.
La visibilidad del agua es limitada, de forma que la herramienta utiliza la superficie de agua como la superficie de elevación. Se asigna un valor de cero a los océanos y una elevación local llana adecuada a las masas de agua más importantes.
La cuenca visual de salida se devuelve como entidades poligonales. El campo Frequency se utiliza para registrar el número de puntos de observación desde los cuales se ve cada polígono. El campo DEMResolution se utiliza para registrar la resolución de DEM de origen para el cómputo de la cuenca visual.
Se devuelven tres campos adicionales que identifican la fuente de datos de DEM que se utiliza en el cálculo. Estos campos son Product Name, Source y Source URL.
Una resolución de DEM más baja dará lugar a una respuesta más rápida de la herramienta. Por ejemplo, la resolución de 90 m tiene el menor tiempo de respuesta. La desventaja es que una resolución de DEM más baja tiene una menor precisión en el resultado de cuenca visual, en comparación con una resolución de DEM más elevada.
El parámetro Distancia máxima también puede afectar al tiempo de respuesta de la herramienta. En general, si se utiliza una distancia menor, el tiempo de respuesta es menor.
El número máximo de puntos de entrada es de 1.000. Si se proporcionan más de 1.000 puntos de entrada, la herramienta devuelve un error y no se ejecuta.
Sintaxis
arcpy.agolservices.Viewshed(InputPoints, {MaximumDistance}, {MaximumDistanceUnits}, {DEMResolution}, {ObserverHeight}, {ObserverHeightUnits}, {SurfaceOffset}, {SurfaceOffsetUnits}, {GeneralizeViewshedPolygons})
Parámetro | Explicación | Tipo de datos |
InputPoints | Entidades de puntos que se van a usar como ubicaciones del observador. | Feature Set |
MaximumDistance (Opcional) | La distancia máxima a la que hacer el cálculo de cuenca visual. | Double |
MaximumDistanceUnits (Opcional) | Especifica las unidades del parámetro Distancia máxima.
| String |
DEMResolution (Opcional) |
Especifica la resolución espacial aproximada (tamaño de celda) de los datos de elevación de origen utilizados para el cálculo. La palabra clave de resolución es una aproximación de la resolución espacial del modelo digital de elevación. Muchas fuentes de elevación se distribuyen en unidades de arcosegundos; la palabra clave es una aproximación en metros para facilitar su comprensión.
| String |
ObserverHeight (Opcional) | La altura del observador sobre la superficie. El valor predeterminado de 1,75 metros es la altura media de una persona. Si va a observar desde una ubicación elevada como, por ejemplo, una torre de observación o un edificio elevado, utilice esa altura en su lugar. | Double |
ObserverHeightUnits (Opcional) | Especifica las unidades del parámetro Altura del observador.
| String |
SurfaceOffset (Opcional) | La altura sobre la superficie del objeto que está viendo. El valor predeterminado es 0. Si está viendo edificios o aerogeneradores, utilice su altura. | Double |
SurfaceOffsetUnits (Opcional) | Especifica las unidades del parámetro Desplazamiento de superficie.
| String |
GeneralizeViewshedPolygons (Opcional) | Especifica si se generalizarán los polígonos de cuenca visual. El cálculo de la cuenca visual se basa en un modelo de elevación de ráster que crea un resultado con bordes escalonados. Para crear una apariencia más agradable y mejorar el rendimiento, el comportamiento predeterminado generaliza los polígonos. Esta generalización no modificará la precisión del resultado de ninguna ubicación en más de la mitad de la resolución de DEM.
| Boolean |
Salida derivada
Nombre | Explicación | Tipo de datos |
OutputViewshed | La cuenca visual de salida. | Conjunto de entidades |