Mediante ArcGIS Earth Automation API

Habilitar ArcGIS Earth Automation API

Para habilitar ArcGIS Earth Automation API y comunicarse con ArcGIS Earth, active Habilitar API de automatización en la configuración Avanzada de la aplicación. Una vez habilitada, la página de muestra de ArcGIS Earth Automation API y los vínculos de la página de ayuda están disponibles y se enumeran a continuación.

Configuración

Puede configurar ArcGIS Earth Automation API usando el archivo de configuración de settings.json. Normalmente, el archivo de configuración de settings.json se encuentra en la carpeta de C:\Program Files\ArcGIS\Earth\bin\automation y se copia automáticamente a la carpeta de Documents/ArcGISEarth/automation del usuario cuando se inicia ArcGIS Earth. De esta forma, los usuarios pueden configurar ArcGIS Earth Automation API usando el archivo de configuración de settings.json.

La función autoStart se habilita automáticamente ArcGIS Earth Automation API al iniciar ArcGIS Earth. El valor predeterminado es false. Cuando autoStart=true, ArcGIS Earth crea el .NET Generic Host e inicia un servicio web con una implementación de servidor HTTP en su equipo local en el inicio. Compruebe el estado de ArcGIS Earth Automation API desde la configuración Avanzada de la aplicación.

Para el usuario nuevo, puede usar el parámetro autoStart del archivo de configuración importado para controlar el cambio de API en la configuración Avanzada de la aplicación.

Nota:

• ArcGIS Earth Automation API utiliza primero el archivo de configuración de settings.json en su directorio.
• El parámetro autoStart del archivo de configuración solo funciona para la primera instalación de ArcGIS Earth.

Parámetros configurables de la API de automatización

ArcGIS Earth Automation API funciona listo para usar, sin necesidad de una configuración especial. Sin embargo, si necesita cambiar los valores predeterminados, se requiere conocer los diversos parámetros de configuración.

Parámetro	Descripción
autoStart	Habilita ArcGIS Earth Automation API al iniciarse ArcGIS Earth. El valor predeterminado es falso.
baseUrl	Establece la dirección URL que ArcGIS Earth Automation API escuchará. El valor predeterminado es http://localhost:8000. Sugerencia: Solo se admite el tipo de protocolo HTTP. El host predeterminado de baseUrl es localhost. También puede utilizar la dirección IP local o el nombre del host si desea que se pueda acceder a ArcGIS Earth Automation API desde un origen diferente. ArcGIS Earth Automation API admite las solicitudes de Uso compartido de recursos de orígenes distintos (CORS) de todos los orígenes con un esquema HTTP y admite cualquier método HTTP. Aún no se admite la configuración de los orígenes y métodos HTTP permitidos. Para obtener más información, consulte Opciones de la política de CORS en ASP.NET Core.
webRoot	Especifica el directorio raíz web utilizado por ArcGIS Earth Automation API. Esto es opcional. El directorio raíz web predeterminado se encuentra en su carpeta de Documents/ArcGISEarth/automation. Sugerencia: La raíz web determina la ruta relativa a los activos estáticos de la aplicación. Si la ruta no existe, se utilizará un proveedor de archivos que no requiere operaciones. Para obtener más información, consulte WebRoot.

Conexión con ArcGIS Earth

Una vez que se inicia ArcGIS Earth Automation API, la aplicación cliente puede iniciar la comunicación con ArcGIS Earth a través de la API de automatización RESTful.

Para trabajar con ArcGIS Earth Automation API, es necesario comprender cómo se construye una dirección URL y cómo se interpreta la respuesta. Todas las operaciones expuestas por ArcGIS Earth Automation API son accesibles a través de una jerarquía de extremos.

Cuando se utiliza la API de automatización, se necesita una dirección de extremo específica para enviar solicitudes. El extremo es http://localhost:8000/arcgisearth/<controller>. Por ejemplo, para obtener información de la cámara de ArcGIS Earth, la dirección URL es la siguiente:

http://localhost/arcgisearth/camera

Compruebe el estado de ArcGIS Earth Automation API desde la configuración Avanzada de la aplicación y utilice la página de muestra en su navegador, o visite ArcGIS Earth Automation API GitHub para obtener más detalles.