Ajouter une couche

Ajoutez une couche à la table des matières, au fond de carte ou au terrain de ArcGIS Earth et renvoyez l’ID de la couche ainsi que les informations sur son statut de chargement.

URL de la requête

<baseUrl>/arcgisearth/layer(POST only)

Paramètres de requête

ParamètreDescription

URI (URIs)

(obligatoire)

Spécifie l’URL ou le chemin d’une couche.

Type : chaîne

target

(facultatif)

Indique le lieu cible où les couches sont ajoutées. Si aucune valeur n’est spécifiée, la valeur par défaut est operationalLayers.

Valeurs :

  • operationalLayers - Couches ajoutées à la table des matières
  • baseMaps - Couches ajoutées au fond de carte
  • elevationLayers - Couches ajoutées au terrain

Type : chaîne

type

(facultatif)

Spécifie le type de données pris en charge dans ArcGIS Earth.

Valeur :

  • ArcGISFeatureService - Service d’entités ArcGIS
  • ArcGISMapService - Service de carte ArcGIS
  • ArcGISImageService - Service d’imagerie ArcGIS
  • Shapefile - Shapefile local
  • WMS - Service de carte Web OGC
  • KML - KML et KMZ
  • SceneLayerPackage - Paquetage de couche de scène ArcGIS
  • SceneService - Service de scène ArcGIS
  • RasterDataLayer - Formats de raster d’élévation locale
  • TilePackage - Paquetage de tuiles ArcGIS
  • ArcGISMobileScenePackage - Paquetage de scène mobile ArcGIS
  • ArcGISWebScene - Scène Web ArcGIS
  • ArcGISWebMap - Carte Web ArcGIS
  • PortalItem - Élément de portail ArcGIS, inclut une scène Web ArcGIS, une carte Web ArcGIS et des services REST ArcGIS
  • GeoJSON - GeoJSON
  • GPX - GPX

Type : chaîne

Remarque :

  • Lorsque vous ajoutez une couche avec un jeton, vous devez spécifier ?token=<your-token> pour URI.
  • Lors de l’ajout d’une couche WMS, vous devez spécifier la valeur WMS pour le type.
  • Utilisez URIs lorsque vous souhaitez ajouter plusieurs fichiers d’élévation en tant que ElevationLayers.

Les types pris en charge pour target sont les suivants :

ValeurOperationalLayersBasemapLayersElevationLayers
ArcGISFeatureService
ArcGISMapService
ArcGISImageService
Shapefile
WMS
KML
SceneLayerPackage
SceneService
RasterDataLayer
TilePackage
PortalItem
GeoJSON
GPX
Remarque :
  • Seuls les services d’imagerie d’élévation et les paquetages de tuiles avec un format de tuile LERC peuvent être ajoutés en tant que couches d’élévation dans ArcGIS Earth.
  • Lorsque vous ajoutez un paquetage de scène mobile ArcGIS, une scène Web ArcGIS ou une cartes Web ArcGIS, il n’est pas nécessaire de spécifier la cible.
  • Si l’élément de portail est une scène Web ArcGIS ou une cartes Web ArcGIS, il n’est pas nécessaire de spécifier la cible.

Exemple d'utilisation

Voici un exemple d’entrée pour l’ajout d’un élément de portail ArcGIS (scène Web) :

{
    "URI": "https://www.arcgis.com/home/item.html?id=19dcff93eeb64f208d09d328656dd492",
    "target": "operationalLayers",
    "type": "PortalItem"
}

Pour ajouter un service de carte Web OGC, vous devez spécifier la valeur du type :

{
    "URI": "http://ogc.bgs.ac.uk/cgi-bin/BGS_Bedrock_and_Superficial_Geology/wms?SERVICE=WMS&REQUEST=GetCapabilities",
    "target": "baseMaps",
    "type": "WMS"
}

Pour ajouter plusieurs fichiers d’élévation en tant que elevationLayers, vous devez utiliser URIs :

{
    "URIs": [
        "C:\\test1.dt1",
        "C:\\test2.dt1"
    ],
    "target": "elevationLayers",
    "type": "RasterDataLayer"
}

Exemple de réponse JSON

Voici un exemple de réponse JSON pour l’ajout d’un élément de portail ArcGIS (scène Web) :

{
    "displayName": "Visualize New Developments",
    "isVisible": true,
    "classType": "ArcGISScene",
    "id": "311b7317-94f8-4f80-89f2-0e3ca5e77d28",
    "sourceURI": "https://www.arcgis.com/sharing/rest/content/items/19dcff93eeb64f208d09d328656dd492",
    "loadStatus": "Loaded"
}

Voici un exemple de réponse JSON pour l’ajout d’un service de carte Web OGC :

{
    "id": "cb689cd9-0957-4fde-9b63-634d4287864e",
    "opacity": 1.0,
    "displayName": "BGS Bedrock and Superficial geology",
    "isVisible": true,
    "classType": "WMS_Layer",
    "sourceURI": "http://ogc.bgs.ac.uk/cgi-bin/BGS_Bedrock_and_Superficial_Geology/wms?SERVICE=WMS&REQUEST=GetCapabilities",
    "brightness": 0.0,
    "contrast": 0.0,
    "gamma": 0.0,
    "loadStatus": "Loaded"
}

Voici un exemple de réponse JSON pour l’ajout d’un service de carte ArcGIS :

{
    "classType": "Raster_Elevation_Source",
    "displayName": "test1.dt1,test2.dt1",
    "isEnabled": true,
    "thumbnailUri": "",
    "id": "0841c791-d01d-4d69-a0bf-ed49801b5449",
    "fileNames": [
        "C\\test1.dt1",
        "C\\test2.dt1"
    ],
    "loadStatus": "Loaded"
}