Añadir capa

Agregue una capa a la tabla de contenido, al mapa base o al terreno de ArcGIS Earth, y devuelva el id. de capa y su información de estado de carga.

Dirección URL de solicitud

<baseUrl>/arcgisearth/layer(POST only)

Parámetros de solicitud

ParámetroDescripción

URI (URIs)

(necesario)

Especifica la dirección URL o la ruta de una capa.

Tipo: cadena de caracteres

target

(opcional)

Especifica el lugar objetivo donde se agregan las capas. Si no se especifica, el valor predeterminado es operationalLayers.

Valores:

  • operationalLayers: capas agregadas a la tabla de contenido
  • baseMaps: capas agregadas al mapa base
  • elevationLayers: capas agregadas al terreno

Tipo: cadena de caracteres

type

(opcional)

Especifica el tipo de datos compatible en ArcGIS Earth.

Valor:

  • ArcGISFeatureService: servicio de entidades de ArcGIS
  • ArcGISMapService: servicio de mapas de ArcGIS
  • ArcGISImageService: servicio de imágenes de ArcGIS
  • Shapefile: shapefile local
  • WMS: servicio de mapas web de OGC
  • KML: KML y KMZ
  • SceneLayerPackage: paquete de capas de escena de ArcGIS
  • SceneService: servicio de escenas de ArcGIS
  • RasterDataLayer: formatos ráster de elevación locales
  • TilePackage: paquete de teselas de ArcGIS
  • ArcGISMobileScenePackage: paquete de escenas móviles de ArcGIS
  • ArcGISWebScene: escena web de ArcGIS
  • ArcGISWebMap: mapa web de ArcGIS
  • PortalItem: elemento del portal de ArcGIS, incluye servicios de escenas web de ArcGIS, de mapas web de ArcGIS y REST de ArcGIS
  • GeoJSON: GeoJSON
  • GPX: GPX

Tipo: cadena de caracteres

Nota:

  • Al agregar una capa con un token, debe especificar ?token=<your-token> para URI.
  • Al agregar una capa WMS, es necesario especificar el valor WMS para el tipo.
  • Utilice URIs cuando desee agregar varios archivos de elevación como ElevationLayers.

Los tipos compatibles para target son los siguientes:

ValorOperationalLayersBasemapLayersElevationLayers
ArcGISFeatureService
ArcGISMapService
ArcGISImageService
Shapefile
WMS
KML
SceneLayerPackage
SceneService
RasterDataLayer
TilePackage
PortalItem
GeoJSON
GPX
Nota:
  • Solo los servicios de imágenes de elevación y los paquetes de teselas con formato de tesela LERC pueden agregarse como capas de elevación en ArcGIS Earth.
  • Al agregar un paquete de escenas móviles de ArcGIS, una escena web de ArcGIS o un mapa web de ArcGIS, no es necesario especificar el objetivo.
  • Si el elemento del portal es una escena web de ArcGIS o un mapa web de ArcGIS, no es necesario especificar el objetivo.

Uso de ejemplo

Una entrada de muestra para agregar un elemento del portal de ArcGIS (escena web) es como se describe a continuación:

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

Para una entrada de muestra para agregar un servicio de mapas web de OGC, es necesario especificar el valor del tipo:

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

Para una entrada de muestra para agregar varios archivos de elevación como elevationLayers, es necesario utilizar URIs:

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

Ejemplo de respuesta JSON

A continuación, se muestra un ejemplo de respuesta JSON para agregar un elemento del portal de ArcGIS (escena 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"
}

A continuación, se muestra un ejemplo de respuesta JSON para agregar un servicio de mapas web de 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"
}

A continuación, se muestra un ejemplo de respuesta JSON para agregar un servicio de mapas de 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"
}