Za pomocą aplikacji ArcGIS Earth Automation API

Włącz ArcGIS Earth Automation API

Aby włączyć interfejs ArcGIS Earth Automation API i komunikować się z aplikacją ArcGIS Earth, zaznacz pole Włącz interfejs Automation API w ustawieniach Zaawansowane aplikacji. Gdy interfejs ArcGIS Earth Automation API jest włączony, poniżej wyświetlane są łącza do strony z przykładami i strony pomocy.

Konfiguracja

Interfejs ArcGIS Earth Automation API można skonfigurować za pomocą pliku konfiguracyjnego settings.json. Plik konfiguracyjny settings.json zwykle znajduje się w folderze C:\Program Files\ArcGIS\Earth\bin\automation i jest automatycznie kopiowany do folderu Documents/ArcGISEarth/automation użytkownika przy uruchamianiu aplikacji ArcGIS Earth. W ten sposób użytkownicy mogą konfigurować interfejs ArcGIS Earth Automation API za pomocą pliku konfiguracyjnego settings.json.

Funkcja autoStart automatycznie włącza interfejs ArcGIS Earth Automation API po uruchomieniu aplikacji ArcGIS Earth. Wartość domyślna to false. Przy ustawieniu autoStart=true aplikacja ArcGIS Earth tworzy host .NET Generic Host i uruchamia usługę internetową z implementacją serwera HTTP na komputerze lokalnym przy uruchamianiu. Status interfejsu ArcGIS Earth Automation API można sprawdzić w sekcji Zaawansowane w ustawieniach aplikacji.

W przypadku nowego użytkownika można użyć parametru autoStart z zaimportowanego pliku konfiguracyjnego do sterowania przełącznikiem interfejsu API w sekcji Zaawansowane w ustawieniach aplikacji.

Notatka:

  • Interfejs ArcGIS Earth Automation API najpierw wykorzystuje plik konfiguracyjny settings.json znajdujący się w katalogu użytkownika.
  • Parametr autoStart pliku konfiguracyjnego działa tylko w przypadku pierwszej instalacji aplikacji ArcGIS Earth.

Konfigurowalne parametry interfejsu Automation API

Interfejs ArcGIS Earth Automation API jest od razu gotowy do działania i nie wymaga specjalnej konfiguracji. Jeśli jednak konieczna jest zmiana wartości domyślnych, wymagane jest zrozumienie różnych parametrów konfiguracyjnych.

ParametrOpis
autoStart

Włącza interfejs ArcGIS Earth Automation API przy uruchamianiu aplikacji ArcGIS Earth. Domyślna wartość to fałsz (false).

baseUrl

Służy do konfigurowania adresu URL używanego do nasłuchiwania przez interfejs ArcGIS Earth Automation API. Wartość domyślna to http://localhost:8000.

Wskazówka:
  • Obsługiwany jest wyłącznie typ protokołu HTTP.
  • Hostem domyślnym baseUrl jest localhost. Można też użyć lokalnego adresu IP lub nazwy hosta lokalnego, jeśli interfejs ArcGIS Earth Automation API ma być dostępny z innego źródła.
  • Interfejs ArcGIS Earth Automation API zezwala na żądania CORS (Cross-Origin Resource Sharing) ze wszystkich źródeł ze schematem HTTP i zezwala na każdą metodę HTTP. Ustawianie dozwolonych źródeł i metod HTTP nie jest jeszcze obsługiwane. Więcej informacji zawiera temat Opcje strategii CORS w ASP.NET Core.

webRoot

Określa internetowy katalog główny używany przez interfejs ArcGIS Earth Automation API. To ustawienie jest opcjonalne. Domyślny internetowy katalog główny znajduje się w folderze Documents/ArcGISEarth/automation użytkownika.

Wskazówka:
  • Internetowy katalog główny określa ścieżkę względną do statycznych zasobów aplikacji. Jeśli ścieżka ta nie istnieje, używany jest dostawca pliku no-op. Więcej informacji zawiera temat WebRoot.

Łączenie z interfejsem ArcGIS Earth

Po uruchomieniu interfejsu ArcGIS Earth Automation API aplikacja kliencka może rozpocząć komunikację z aplikacją ArcGIS Earth za pomocą interfejsu Automation API zgodnego ze specyfikacją REST.

Aby pracować z interfejsem ArcGIS Earth Automation API, należy zrozumieć sposób konstruowania adresu URL i interpretowania odpowiedzi. Wszystkie operacje udostępniane przez interfejs ArcGIS Earth Automation API są dostępne za pośrednictwem hierarchii punktów końcowych.

Gdy używany jest interfejs Automation API, potrzebny jest konkretny adres punktu końcowego do wysyłania żądań. Domyślny punkt końcowy to http://localhost:8000/arcgisearth/<controller>. Aby na przykład uzyskać informacje o kamerze z aplikacji ArcGIS Earth, adres URL ma następującą postać:

http://localhost/arcgisearth/camera

Status interfejsu ArcGIS Earth Automation API można sprawdzić w sekcji Zaawansowane w ustawieniach aplikacji, a następnie można użyć strony przykładowej w przeglądarce lub odwiedzić serwis ArcGIS Earth Automation API GitHub w celu uzyskania dodatkowych informacji.