Dodaj warstwę

Dodaje warstwę do tabeli zawartości, mapy bazowej lub terenu w aplikacji ArcGIS Earth i zwraca identyfikator warstwy oraz informacje o statusie jej wczytywania.

Adres URL żądania

<baseUrl>/arcgisearth/layer(POST only)

Parametry żądania

Parametr	Opis
URI (URIs) (wymagane)	Służy do podawania adresu URL lub ścieżki warstwy. Typ: ciąg znakowy
target (opcja)	Służy do podawania docelowego miejsca, w którym warstwy mają zostać dodane. Jeśli wartość nie zostanie podana, zostanie użyta domyślna wartość operationalLayers. Wartości: operationalLayers — warstwy zostaną dodane do tabeli zawartości baseMaps — warstwy zostaną dodane do mapy bazowej elevationLayers — warstwy zostaną dodane do terenu Typ: ciąg znakowy
type (opcja)	Służy do podawania typu danych obsługiwanego w aplikacji ArcGIS Earth. Wartość: ArcGISFeatureService — usługa obiektowa ArcGIS ArcGISMapService — usługa mapowa ArcGIS ArcGISImageService — usługa rastrowa ArcGIS Shapefile — lokalny plik shape WMS — usługa OGC Web Map Service (WMS) KML — KML i KMZ SceneLayerPackage — pakiet warstw scen ArcGIS SceneService — usługa scen ArcGIS RasterDataLayer — lokalne formaty rastra wysokości TilePackage — pakiet kafli ArcGIS ArcGISMobileScenePackage — pakiet scen mobilnych ArcGIS ArcGISWebScene — scena internetowa ArcGIS ArcGISWebMap — mapa internetowa ArcGIS PortalItem — element portalu ArcGIS, obejmuje scenę internetową ArcGIS, mapę internetową ArcGIS i usługi ArcGIS REST GeoJSON — GeoJSON GPX — GPX Typ: ciąg znakowy

Notatka:

• W przypadku dodawania warstwy z tokenem musisz podać wartość ?token=<your-token> w parametrze URI.
• W przypadku dodawania warstwy WMS musisz podać wartość WMS dla typu.
• Użyj parametrów URIs, jeśli chcesz dodać wiele plików wysokości jako warstwy ElevationLayers.

Typy obsługiwane w przypadku parametru target są następujące:

Wartość	OperationalLayers	BasemapLayers	ElevationLayers
ArcGISFeatureService
ArcGISMapService
ArcGISImageService
Shapefile
WMS
KML
SceneLayerPackage
SceneService
RasterDataLayer
TilePackage
PortalItem
GeoJSON
GPX

Notatka:

• Jako warstwy wysokościowe w aplikacji ArcGIS Earth można dodać jedynie usługi rastrowe wysokości i pakiety kafli korzystające z formatu kafli LERC.
• W przypadku dodawania pakietu scen mobilnych ArcGIS, sceny internetowej ArcGIS lub mapy internetowej ArcGIS nie trzeba podawać celu.
• Jeśli element portalu jest sceną internetową ArcGIS lub mapą internetową ArcGIS, nie trzeba podawać celu.

Przykłady użycia

Przykładowe dane wejściowe umożliwiające dodanie elementu portalu ArcGIS (sceny internetowej):

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

W przykładowych danych wejściowych umożliwiających dodanie usługi OGC Web Map Service należy podać wartość typu:

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

W przykładowych danych wejściowych umożliwiających dodanie wielu plików wysokości jako elevationLayers należy użyć URIs:

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

Przykładowa odpowiedź JSON

Poniżej przedstawiono przykładową odpowiedź JSON dotyczącą dodawania elementu portalu ArcGIS (sceny internetowej):

{
    "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"
}

Poniżej przedstawiono przykładową odpowiedź JSON dotyczącą dodawania usługi OGC Web Map Service:

{
    "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"
}

Poniżej przedstawiono przykładową odpowiedź JSON dotyczącą dodawania usługi mapowej 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"
}