Wenn Sie eine Karte mit dem Geoverarbeitungsservice PrintingTools drucken möchten, der in ArcGIS Server enthalten ist, müssen Sie eine JavaScript Object Notation (JSON)-Repräsentation der Karte, einschließlich der zugehörigen Layer- und Ausdehnungsinformationen, bereitstellen. Die JSON muss der Esri ExportWebMap-Spezifikation entsprechend strukturiert sein.
Wenn Sie die ArcGIS-Web-APIs verwenden, müssen Sie die Konstruktion der JSON nicht berücksichtigen; diese Aufgabe wird von den APIs übernommen. Dieses Thema ist jedoch zu Referenzzwecken enthalten, falls Sie die JSON-Darstellung selbst konstruieren müssen. Dies kann der Fall sein, wenn Sie den PrintingTools-Service direkt aufrufen müssen oder dessen Quell-Geoverarbeitungswerkzeug "Webkarte exportieren" über eine andere Anwendung ausführen möchten.
Hinweis:
Aus Gründen der Klarheit und Lesbarkeit werden JSON-Beispiele in diesem Thema formatiert dargestellt. In der Praxis sollten Sie über die Druckservices allerdings unformatierte JSON übergeben.
Die Webkarte besteht aus fünf Objekten der obersten Ebene:
{
"mapOptions": {},
"operationalLayers": [],
"baseMap": [],
"exportOptions": {},
"layoutOptions": {},
"reportOptions": {}
}
mapOptions
Das Objekt mapOptions ist erforderlich und definiert Kartenanzeigeeigenschaften.
Syntax: | Beispiel |
---|---|
|
|
Beschreibung | |
|
operationalLayers
Die Liste operationalLayers enthält alle operationalen Layer, die auf der Karte angezeigt werden sollen. Die Reihenfolge des Arrays definiert die Reihenfolge der Layer auf der Karte. Der Typ der einzelnen Layer wird anhand der URL-Ressourcenantwort definiert. Wenn die Ressource nicht von der URL bestimmt werden kann, wird der Typ anhand der Typeigenschaft definiert. Ein WMS-Layer erfordert beispielsweise die Angabe "type": "wms". Es gibt einige Eigenschaften, die für alle Typen von operationalen Layern gelten, während andere für den jeweiligen Typ des operationalen Layers spezifisch sind.
Bei gesicherten Layern geben Sie das Token in einer Layer-Definition an. Ein Benutzername und ein Kennwort werden nicht als Teil der URL unterstützt.
Hinweis:
Verwenden Sie für einen Kartenservice, Feature-Service oder Image-Service eine URL, die auf den REST-Endpunkt des Service verweist. SOAP-Endpunkte werden nicht unterstützt.
Syntax für operationale Layer |
---|
|
Beschreibung |
Hinweis:Die unten beschriebenen Eigenschaften gelten für alle Typen von operationalen Layern (wie Kartenservice-Layer, clientseitige Grafiken, KML-Layer usw.). Aus diesem Grund werden sie in diesem Abschnitt möglicherweise nicht für jeden Typ von operationalen Layern aufgeführt.
|
Syntax für einen Kartenservice-Layer | Beispiel |
---|---|
|
|
Beschreibung | |
|
Syntax für einen Feature-Layer | Beispiel |
---|---|
|
|
Beschreibung | |
|
Syntax für einen Image-Service-Layer | Beispiel |
---|---|
|
|
Beschreibung | |
Hinweis:Weitere Informationen zu Image-Service-Layern finden Sie unter ArcGIS-REST-API. |
Syntax für einen WMS-Service-Layer | |
---|---|
| |
Beschreibung | |
|
Syntax für einen KML-Layer | Beispiel |
---|---|
|
|
Beschreibung | |
|
Syntax für einen clientseitigen Image-Service-Layer | Beispiel |
---|---|
|
|
Beschreibung | |
|
Syntax für clientseitige Grafiken | Beispiel | |
---|---|---|
|
| |
Beschreibung | ||
|
Syntax für Dateien mit kommagetrennten Werten (CSV) nach URL | Beispiel | |
---|---|---|
|
| |
Beschreibung | ||
|
Weitere Eigenschaften
Hinweis:
Weitere Informationen zu den folgenden Eigenschaften finden Sie unter ArcGIS REST API.
- source
- renderer
- symbol
- textSymbol
- labelingInfo
- geometry
- geometryType
- spatialRel
- relationParam
Syntax für die Definition von drawingInfo für einen Zeit-Renderer | Beispiel |
---|---|
Hinweis:Zeit-Renderer werden von über ArcGIS Pro veröffentlichte Druck-Services nicht unterstützt.
|
|
Syntax für die Definition von symbolAger | |
| |
Syntax für die Definition von agerClassBreakInfo | |
| |
Beschreibung | |
|
Geoverarbeitungsergebnis
Es gibt zwei Methoden zum Einbeziehen eines Geoverarbeitungsergebnisses:
- Wenn ein Geoverarbeitungsergebnis als Feature-Set zurückgegeben und als Grafik auf dem Client dargestellt wird, senden Sie das Ergebnis als Feature-Erfassung.
- Wenn das Ergebnis vom Ergebnis-Kartenservice eines Auftrags dargestellt wird, fügen Sie einen neuen Kartenservice-Layer in operationalLayers hinzu, und legen Sie die URL-Eigenschaft so fest, dass sie auf den Endpunkt des Ergebnisses verweist. Beispiel:
- Geoverarbeitungsergebnis aus 10.1 oder einer höheren Version: https://gisserver.domain.com:6080/arcgis/rest/services/GPJobMapServiceName/MapServer/jobs/job_id
- Geoverarbeitungsergebnis aus 10.0 und früheren Versionen: https://gisserver.domain.com/arcgis/rest/services/GPServiceName/GPServer/GPTaskName/jobs/job_id/results/out_param_name
Beispiel: Geoverarbeitungsergebnis als operationaler Layer, der vom Ergebnis-Kartenservice eines Auftrags dargestellt wird.
"operationalLayers": [
{
"url": "https://gisserver.domain.com:6080/arcgis/rest/services/Buffer/MapServer/jobs/j9aa6c36d59f44829a0daeadb2d0ff87b",
"title": "Geoprocessing Result"
}
]
baseMap
Die Karte enthält eine baseMap, die einen Titel und eine baseMapLayers-Eigenschaft aufweist, die eine geordnete baseMapLayers-Liste enthält. Jeder baseMapLayer muss sich im gleichen Raumbezug und Kachelschema befinden. Wenn eine baseMap vorhanden ist, definiert sie den Raumbezug der Karte.
Syntax für baseMap | Beispiel |
---|---|
|
|
Syntax für Vektorkachel-Layer als baseMapLayer | Beispiel |
---|---|
Hinweis:Vektorkachel-Layer werden nur von über ArcGIS Pro veröffentlichte Druck-Services unterstützt.
|
|
Syntax für Bing Maps als basemapLayer | Beispiel |
---|---|
|
|
Syntax für OpenStreetMap als basemapLayer | Beispiel |
---|---|
|
|
Beschreibung | |
|
Syntax für WebTiledLayer als basemapLayer | Beispiel |
---|---|
|
|
Beschreibung | |
|
Syntax für WMTS als basemapLayer |
---|
|
exportOptions
Dieses Objekt gibt die Einstellungen für die Ausgabekarte an.
Syntax | Beispiel |
---|---|
|
|
Beschreibung | |
|
layoutOptions
Mit dieser Eigenschaft werden die Einstellungen für verschiedene verfügbare Seitenlayoutelemente definiert. Sie ist nur erforderlich, wenn eine verfügbare Vorlage ausgewählt wird. Seitenlayoutelemente beinhalten Titel, Copyright-Text, Maßstabsleiste, Name des Autors, benutzerdefinierte und dynamische Textelemente, Diagrammrahmenelemente und Tabellenrahmenelemente.
Hinweis:
Diese Option ersetzt nur die Eigenschaften vorhandener Elemente. Wenn ein Element nicht in der ausgewählten Layout-Vorlage vorhanden ist, werden die zugehörigen Eigenschaften ignoriert. Wenn eine Layout-Vorlage beispielsweise kein Copyright-Textelement enthält, wird dem Layout auch dann kein neues Copyright-Textelement hinzugefügt, wenn das copyrightText-Element in den layoutOptions angegeben ist.
Diagramme müssen in operationalen Layern vollständig definiert werden, bevor sie als Quellen für Diagrammrahmenelemente verwendet werden können.
Alle Eigenschaften dieses Objekts sind optional. Wenn ein Wert einer Eigenschaft angegeben wird, wird das entsprechende Seitenlayoutelement ersetzt, andernfalls wird das vorhandene Element unverändert übernommen.
Benutzerdefiniertes ExportWebMap-Textelement | Entsprechender dynamischer Text in ArcGIS Pro |
---|---|
titleText | <dyn type="layout" property="metadata" attribute="title" emptyStr=""/> |
authorText | <dyn type="layout" property="metadata" attribute="contactname" emptyStr=""/> |
copyrightText | <dyn type="layout" property="metadata" attribute="credits" emptyStr=""/> |
Hinweis:
Weitere Informationen zu dynamicText finden Sie in der ArcGIS-Hilfe.
Syntax | Beispiel |
---|---|
|
|
Beschreibung | |
|
reportOptions
Damit werden die Einstellungen für verschiedene verfügbare Berichtselemente definiert. Dies ist nur erforderlich, wenn eine verfügbare Berichtsvorlage ausgewählt wird. Zu den Berichtselementen gehören die Quelle und zugehörigen Quell-IDs, eine Feldliste usw.
Hinweis:
Diese Option ersetzt nur die Eigenschaften vorhandener Elemente. Wenn ein Element nicht in der ausgewählten Berichtsvorlage vorhanden ist, werden die zugehörigen Eigenschaften ignoriert. Wenn eine Berichtsvorlage z. B. keinen zugehörigen Bericht aufweist, enthalten Ausgabeberichte keine zugehörigen Datensätze.
Alle Eigenschaften dieses Objekts sind erforderlich.
Senden Sie Anforderungen an den Task Berichtsvorlageninformationen abrufen, um die für jede Berichtsvorlage verfügbaren Elemente abzurufen.
Syntax | Beispiel |
---|---|
|
|
Beschreibung | |
| |
Einschränkungen
Symbole auf Feature-Ebene, die in Notizen-Layern überschrieben werden, werden nicht unterstützt, wenn der Renderertyp "Klassenunterbrechung" oder "einfach" ist.