ArcGIS Earth Automation API

Interfaces publiques

ArcGIS Earth Automation API offre les interfaces publiques suivantes :

API	Description
GET /arcgisearth/camera	Obtenez la perspective d’affichage actuelle de la scène.
PUT /arcgisearth/camera	Définissez ou mettez à jour la perspective d’affichage de la scène sur une position spécifiée.
POST /arcgisearth/flight	Définissez ou mettez à jour l’animation de la caméra lorsque vous survolez la scène vers une position cible.
POST /arcgisearth/drawings	Ajoutez un dessin à ArcGIS Earth.
DELETE /arcgisearth/drawings	Supprimez tous les dessins existants de ArcGIS Earth.
DELETE /arcgisearth/drawings/{id}	Supprimez un dessin existant de ArcGIS Earth.
POST /arcgisearth/layer	Ajoutez une couche à la table des matières, au fond de carte ou au terrain de ArcGIS Earth.
GET /arcgisearth/layer/{id}	Obtenez le statut de chargement d’une couche en spécifiant l’ID de couche.
DELETE /arcgisearth/layer/{id}	Supprimez une couche en spécifiant l’ID de couche.
DELETE /arcgisearth/layers/{target}	Supprimez des couches d’ArcGIS Earth par cible.
GET /arcgisearth/graphics/{id}	Obtenez un graphique en spécifiant son ID.
POST /arcgisearth/graphics	Ajoutez un graphique à ArcGIS Earth.
PATCH /arcgisearth/graphics	Mettez un graphique à jour dans ArcGIS Earth.
DELETE /arcgisearth/graphics/{id}	Supprimez un graphique en spécifiant son ID.
DELETE /arcgisearth/graphics	Supprimez tous les graphiques d’ArcGIS Earth.
POST /arcgisearth/project	Crée un nouveau projet.
POST /arcgisearth/project/open	Ouvre un projet existant.
POST /arcgisearth/project/save	Enregistrez le projet actuel au même emplacement.
POST /arcgisearth/project/saveAs	Enregistrez le projet actuel à un nouvel emplacement.
GET /arcgisearth/project/recent	Obtenez les projets récemment ouverts, regroupés par type de projet.
GET /arcgisearth/project/recent/{type}	Obtenez les projets récemment ouverts d’un seul type.
GET /arcgisearth/snapshot	Prenez une capture d’écran de la vue actuelle de ArcGIS Earth.

API de projet

ArcGIS Earth 3.0 introduit l’API de projet, un ensemble unique d’extrémités permettant la création, l’ouverture et l’enregistrement des projets. Les projets de type scène globale, scène locale et film sont tous gérés par les mêmes demandes ; le type de projet est fourni à la création du projet ou résolu à partir du chemin d’accès au fichier.

Les projets de type scène utilisent l’extension .aescx et les projets de type film utilisent l’extension .aemvx.

Remarque :

Le module Movie (Film) est publié en version bêta dans ArcGIS Earth 3.0. Les projets de type Movie (Film) peuvent être créés, ouverts et enregistrés via l’API de projet, mais le format de document Movie (Film) n’est pas encore final et est susceptible d’être modifié dans une version future.

API d’espace de travail

L’API d’espace de travail n’est pas disponible dans ArcGIS Earth 3.0 et versions ultérieures. Elle est remplacée par l’API de projet.

API d’espace de travail	Utilisez à la place dans la version 3.0.
GET /arcgisearth/workspace	POST /arcgisearth/project/saveAs écrit le projet actuel dans un fichier.
PUT /arcgisearth/workspace	POST /arcgisearth/project/open ouvre un fichier de projet.
DELETE /arcgisearth/workspace	POST /arcgisearth/project crée un nouveau projet, qui remplace le projet actuel.

Dans ArcGIS Earth 3.0, une demande vers /arcgisearth/workspace sans api-version ou avec api-version=1.0, 1.12 ou 1.16 renvoie 409 Conflict avec un message pointant vers l’API de projet. Une demande avec api-version=3.0 renvoie UnsupportedApiVersion.

Les pages de l’API d’espace de travail sont conservées pour ArcGIS Earth 1.x et 2.x, là où ces extrémités fonctionnent toujours comme indiqué dans la documentation.

Versionnement

La version de l’API est indiquée sous forme de paramètre de requête, par exemple ?api-version=3.0. La valeur par défaut est 3.0. Les segments de chemin d’URL tels que /v3.0/arcgisearth/... ne sont pas pris en charge.