Verwendung der ArcGIS Earth Automation API

ArcGIS Earth Automation API aktivieren

Um ArcGIS Earth Automation API zu aktivieren und mit ArcGIS Earth zu kommunizieren, aktivieren Sie Automatisierungs-API aktivierenin den Anwendungseinstellungen unter Erweitert. Nach der Aktivierung sind die Links zur Beispielseite und zur Hilfeseite für ArcGIS Earth Automation API verfügbar und unten aufgeführt.

Konfiguration

Sie können ArcGIS Earth Automation API über die Konfigurationsdatei settings.json installieren. Die Konfigurationsdatei settings.json befindet sich normalerweise im Ordner C:\Program Files\ArcGIS\Earth\bin\automation und wird automatisch in den Ordner Documents/ArcGISEarth/automation des Benutzers kopiert, wenn ArcGIS Earth gestartet wird. Auf diese Weise können Benutzer die ArcGIS Earth Automation API mit der Konfigurationsdatei settings.json konfigurieren.

Die Funktion autoStart aktiviert automatisch die ArcGIS Earth Automation API, wenn ArcGIS Earth gestartet wird. Die Standardeinstellung ist false. Bei der Einstellung autoStart=true werden von ArcGIS Earth ein generischer .NET-Host erstellt und beim Programmstart ein Web-Service mit HTTP-Serverimplementierung auf dem lokalen Computer gestartet. Prüfen Sie den ArcGIS Earth Automation API-Status in den Anwendungseinstellungen unter Erweitert.

Erstbenutzer können den autoStart-Parameter der importierten Konfigurationsdatei verwenden, um den API-Schalter in den Anwendungseinstellungen unter Erweitert zu steuern.

Hinweis:

• Die ArcGIS Earth Automation API greift zunächst auf die Konfigurationsdatei settings.json im Benutzerverzeichnis zurück.
• Der autoStart-Parameter der Konfigurationsdatei funktioniert nur bei der ersten Installation von ArcGIS Earth.

Konfigurierbare Automatisierungs-API-Parameter

Die ArcGIS Earth Automation API kann sofort ohne besondere Konfiguration verwendet werden. Wenn Sie die Standardeinstellungen ändern müssen, sind jedoch Kenntnisse der verschiedenen Konfigurationsparameter erforderlich.

Parameter	Beschreibung
autoStart	Aktiviert die ArcGIS Earth Automation API, wenn ArcGIS Earth gestartet wird. Der Standardwert ist "false".
baseUrl	Legt die URL fest, die von der ArcGIS Earth Automation API überwacht wird. Die Standardeinstellung ist http://localhost:8000. Tipp: Nur der Protokolltyp HTTPS wird unterstützt. Der Standardhost von baseUrl ist "localhost". Sie können auch die lokale IP-Adresse oder den Hostnamen angeben, wenn es möglich sein soll, von einem anderen Startpunkt aus auf die ArcGIS Earth Automation API zuzugreifen. Die ArcGIS Earth Automation API lässt CORS (Cross-Origin Resource Sharing)-Anfragen von allen Startpunkten mit HTTP-Schema und jede beliebige HTTP-Methode zu. Die Einstellungen von zulässigen Startpunkten und zulässigen HTTP-Methoden werden noch nicht unterstützt. Weitere Informationen finden Sie unter CORS policy options in ASP.NET Core.
webRoot	Gibt das von der ArcGIS Earth Automation API verwendete Webstammverzeichnis an. Diese Angabe ist optional. Das standardmäßige Webstammverzeichnis befindet sich im Benutzerordner Documents/ArcGISEarth/automation. Tipp: Das Webstammverzeichnis bestimmt den relativen Pfad zu den statischen Ressourcen der App. Wenn der Pfad nicht vorhanden ist, wird ein No-Op-Dateianbieter verwendet. Weitere Informationen finden Sie unter WebRoot.

Herstellen einer Verbindung mit ArcGIS Earth

Nachdem die ArcGIS Earth Automation API gestartet wurde, kann die Client-App die Kommunikation mit ArcGIS Earth über die RESTful Automatisierungs-API aufnehmen.

Für die Arbeit mit der ArcGIS Earth Automation API benötigen Sie Kenntnisse über das Erstellen einer URL und Interpretieren der Antwort. Alle von der ArcGIS Earth Automation API bereitgestellten Operationen können über eine Hierarchie von Endpunkten aufgerufen werden.

Bei Verwendung der Automatisierungs-API benötigen Sie eine bestimmte Endpunktadresse zum Senden von Anfragen. Der Standardendpunkt ist http://localhost:8000/arcgisearth/<controller>. Um etwa Kamerainformationen von ArcGIS Earth abzurufen, lautet die URL folgendermaßen:

http://localhost/arcgisearth/camera

Prüfen Sie den Status der ArcGIS Earth Automation API in den Anwendungseinstellungen unter Erweitert und verwenden Sie die Beispielseite im Browser, oder besuchen Sie das GitHub-Repository zur ArcGIS Earth Automation API, um weitere Informationen zu erhalten.