ExportWebMap-Spezifikation

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
"mapOptions": { "extent": { "xmin": <xmin>, "ymin": <ymin>, "xmax": <xmax>, "ymax": <ymax>, "spatialReference": {<spatialReference>} }, "scale": <mapScale>, "rotation": <mapRotation>, "spatialReference": {<spatialReference>}, "time": [ <timeInstant> | <startTime>,<endTime> ], "background": { "color": [R, G, B, A] } }	"mapOptions": { "extent": { "xmin": -12933906.537, "ymin": 3993856.886, "xmax": -12933371.998, "ymax": 3994375.189, "spatialReference": { "wkid": 102100 } }, "scale": 1234.5, "rotation": -45, "spatialReference": { "wkid": 102100 }, "time": [ 1199145600000, 1230768000000 ], "background": { "color": [51, 227, 200, 255] } }
Beschreibung
extent (erforderlich): Eine erforderliche Eigenschaft, die die Ausdehnung der Karte definiert. Der Raumbezug des Ausdehnungsobjekts ist optional. Wenn er nicht bereitgestellt wird, wird davon ausgegangen, dass er im Raumbezug der Karte enthalten ist. Wenn das Seitenverhältnis der Kartenausdehnung sich von der Größe der Karte auf der Ausgabeseite oder von exportOptions:outputSize unterscheidet, kann die Ausgabekarte mehr Features aufweisen. scale (optional): Der Kartenmaßstab, bei dem die Karte exportiert werden soll. Diese Eigenschaft ist optional, wird jedoch zur Erzielung optimaler Ergebnisse empfohlen. Die Maßstabeigenschaft ist besonders nützlich, wenn für die Kartenservices auf dieser Webkarte maßstabsabhängige Layer oder Bezugsmaßstäbe festgelegt wurden. Da die Karte, die Sie in der Webanwendung anzeigen, kleiner sein kann als die Ausgabekarte (z. B. 8,5 x 11 Zoll bzw. A4-Format), weist die Ausgabekarte einen anderen Maßstab auf und es könnten Unterschiede bei den Features und/oder Symbolen der Webanwendung im Vergleich zur Ausgabekarte sichtbar werden. Wenn ein Maßstab verwendet wird, hat dieser Vorrang vor der Ausdehnung, die Ausgabekarte wird jedoch mit dem angeforderten Maßstab gezeichnet und auf dem Mittelpunkt der Ausdehnung zentriert. rotation (optional): Diese Eigenschaft stellt die Gradzahl dar, um die der Datenrahmen gedreht wird, von Norden aus gegen den Uhrzeigersinn gemessen. Um den Datenrahmen im Uhrzeigersinn zu drehen, verwenden Sie einen negativen Wert. spatialReference (optional): Der Raumbezug der Karte. Folgende Reihenfolge wird bevorzugt, wenn die Eigenschaft spatialReference fehlt: mapOptions.extent.spatialReference baseMap.baseMapLayers.spatialReference Raumbezug der Kartenvorlage time (optional): Wenn ein zeitbezogener Layer vorhanden ist und dieser zu einer bestimmten Zeit gezeichnet werden soll, geben Sie diese Eigenschaft an. Diese Liste kann eine oder mehrere Elemente beinhalten. Fügen Sie zwei Elemente (startTime gefolgt von endTime) hinzu, um eine Zeitausdehnung darzustellen, oder nur ein Zeitelement, um einen Zeitpunkt darzustellen. Uhrzeiten werden immer in UTC angegeben. background (optional): Sie können die Hintergrundfarbe der Karte ändern. Wenn ein Layout mehrere Karten enthält, wird die Farbe für die Karte übernommen, die mit dem Kartenrahmen WEBMAP_MAP_FRAME verknüpft ist.

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
"operationalLayers": [ { "id": "<webmapOperationalLayerId>", "layerType": "<ArcGISFeatureLayer | ArcGISImageServiceLayer | ArcGISMapServiceLayer | ArcGISTiledImageServiceLayer | ArcGISTiledMapServiceLayer | VectorTileLayer | WebTiledLayer | WFS | WMS | KML>", "url": "<url1>", "token": "<tokenString1>", "title": "<title1>", "opacity": <opacity1>, "visibility": <true | false>, "minScale": <minScale1>, "maxScale": <maxScale1> } ]
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. id (optional): Eine Zeichenfolge, die einen operationalen Layer eindeutig identifiziert. Diese wird meist für Legenden benötigt. layerType: Der Typ des operationalen Layers. Dieser kann entweder als ArcGISFeatureLayer, ArcGISImageServiceLayer, ArcGISMapServiceLayer, ArcGISTiledImageServiceLayer, ArcGISTiledMapServiceLayer, VectorTileLayer, WebTiledLayer, WMS oder KML angegeben werden. url: Der Endpunkt eines Service. Er wird für "featureCollection" nicht benötigt. token (optional): Ein Token für den Zugriff auf einen gesicherten Service. title (optional): Der Name eines operationalen Layers. Wenn er in der Legende angezeigt wird, sollte die Legende des Layouts dies unterstützten. visibility (optional): Der Standardwert ist true. opacity (optional): Wertbereiche von 0 bis 1 (Standard), wobei 1 undurchsichtig und 0 vollständig transparent bedeutet. minScale (optional): Der Layer wird nicht dargestellt, wenn er über diesen Maßstab hinaus verkleinert wird. maxScale (optional): Der Layer wird nicht dargestellt, wenn er über diesen Maßstab hinaus vergrößert wird.

Syntax für einen Kartenservice-Layer	Beispiel
"operationalLayers": [ { "url": "<url1>", "title": "<title1>", "opacity": <opacity2>, "gdbVersion": "<gdbVersion>", "visibleLayers": [ <layerId1>, <layerId2> ], "layers": [ { "id": <sublayerId1>, "name": <name>, "layerDefinition": { "definitionExpression": "<definitionExpression>", "layerTimeOptions": { "useTime": <true | false>, "timeDataCumulative": <true | false>, "timeOffset": <timeOffset1>, "timeOffsetUnits": "<esriTimeUnits>" }, "drawingInfo": { "renderer": {<renderer>}, "transparency": <transparency>, "scaleSymbols": <true | false>, "showLabels": <true | false>, "labelingInfo": {<labelingInfo>}, }, "source": {<layerSource>}, "gdbVersion": "<Geodatabase version name>" } } ] } ]	"operationalLayers": [ { "url": "https://servicesbeta.esri.com/ArcGIS/rest/services/HomelandSecurity/operations/MapServer", "title": "Homeland security operations", "opacity": 0.8, "visibleLayers": [ 0, 1 ] } ]
Beschreibung
visibleLayers (optional): Array von Sublayer-IDs, die innerhalb des Kartenservice-Layers sichtbar gemacht werden sollten. Wenn diese Eigenschaft nicht angegeben wird, wird der operationale Layer mit den Standard-Sichtbarkeitsstatus der einzelnen Sublayer angezeigt. Sie müssen die ID des Gruppen-Layers nicht angeben. Beachten Sie, dass layers Vorrang vor visibleLayers haben, wenn ein Kartenservice dynamische Layer unterstützt. Verwenden Sie für Kartenservices nicht dynamicLayers, es wird nur layerDefinition in der Eigenschaft layers unterstützt. layers (optional): Liste der zu exportierenden Layer. Bei Kartenservices, die dynamische Layer verwenden, werden alle im Array layers festgelegten Layer exportiert, während visibleLayers ignoriert werden. Verwenden Sie bei der Definition des Namens für einen Layer die Eigenschaft name. Dies ist in der Regel erforderlich, wenn der Typ source des Layers dataLayer lautet. drawingInfo (optional): Verwenden Sie diese Eigenschaft zum Überschreiben der Darstellungseigenschaften eines Sublayers, beispielsweise den Renderer des Sublayers. renderer (optional): Wenn diese Eigenschaft angegeben ist, wird der ursprüngliche Renderer des Sublayers überschrieben. source (optional): Stellt die Quelle eines Layers dar, der dem Kartenservice pro Anforderung dynamisch hinzugefügt wird. Weitere Informationen zur Definition der Quelle finden Sie unter ArcGIS-REST-API. gdbVersion (optional): Geben Sie diese Eigenschaft an, wenn Features aus einer anderen Geodatabase-Version dargestellt werden sollen. Sie können diese Eigenschaft auf Ebene der operationalen Layer definieren, um alle Layer auf die angegebene Version umzustellen. Alternativ können Sie sie als Sublayer in einem Array für layers definieren, um die Geodatabase-Version für einen einzelnen Layer zu ändern.

Syntax für einen Feature-Layer	Beispiel
"operationalLayers": [ { "url": "<url1>", "title": "<title1>", "opacity": <opacity2>, "layerDefinition": { "drawingInfo": { "renderer": {<renderer1>} }, "definitionExpression": "<definitionExpression1>", "objectIds": [ <oid1>, <oid2> ], "timeInfo": { //optional "trackIdField": "<trackIdFieldName>" }, "geometry": {<geometry>}, "geometryType": "<geometryType>", "spatialRel": "<spatialRel>", "relationParam": "<relationParam>", "gdbVersion": "<geodatabaseVersionName>", "source": {<layerSource>} }, "selectionObjectIds": [ <oid1>, <oid2> ], "selectionSymbol": {<symbol>}, "charts": [ { ... } ] //definition of charts } ]	"operationalLayers": [ { "url": "https://servicesbeta.esri.com/ArcGIS/rest/services/Hydrography/Watershed173811/FeatureServer/1", "title": "Watershed", "opacity": 1, "layerDefinition": { "drawingInfo": { "renderer": {<renderer>} }, "definitionExpression": "Type = 1", "objectIds": [ 534, 434 ] }, "selectionObjectIds": [ 434 ], "selectionSymbol": {<symbol>} } ]
Beschreibung
url (erforderlich): Die URL des Layers. Diese Eigenschaft sollte mit /dynamicLayer enden, wenn ein Feature-Layer auf einem Layer aus einem Kartenservice basiert, der dynamische Layer verwendet. drawingInfo (optional): Legt den Renderer für diesen Layer fest. Für das Rendering mit einem Zeit-Renderer geben Sie neben dem Renderer die Eigenschaften latestObservationRenderer, trackLinesRenderer und observationAger an. observationAger (optional): Der Zeit-Renderer unterstützt zwei Typen für observationAger: rampAger und classBreaksAger. Für jede beliebige Anforderung kann ein Layer entweder rampAger oder classBreaksAger enthalten, jedoch nicht beide Typen. definitionExpression (optional): Eine SQL-Anweisung, die die Darstellung von Features einschränkt. objectIds (optional): Schränkt die darzustellenden Features auf Grundlage von Objekt-IDs ein. timeInfo (optional): trackIdField: Das Feld, das ein oder mehrere angegebene Objekte, die beobachtet werden, eindeutig darstellt. Wenn dieses Feld den Wert NULL hat oder fehlt, wird nur die aktuelle Beobachtung mit dem latestObservationRenderer dargestellt. geometry (optional): Schränkt darzustellende Features nach einer Geometrie ein. geometryType (optional): Diese Eigenschaft ist erforderlich, wenn eine Geometrie angegeben wird. spatialRel (optional): Die räumliche Beziehung, die während der Abfrage auf die Eingabegeometrie angewendet wird. relationParam (optional): Die Funktion für räumliche Beziehung kann während der Abfrage angewendet werden. Ein Beispiel für diese Funktion für räumliche Beziehung ist FFFTTT***. selectionObjectIds (optional): Hebt die Features mit den angegebenen Objekt-IDs mit dem bereitgestellten Symbol hervor; selectionSymbol muss festgelegt werden. selectionSymbol (optional): Features werden mit diesem Symbol hervorgehoben. Dies ist erforderlich, wenn selectionObjectIds angegeben wird. charts (optional): Ein operationaler Layer kann keine Diagramme bzw. ein oder mehr Diagramme enthalten. Diagrammelemente finden Sie in den Webkartenspezifikationen. gdbVersion (optional): Gibt den Namen einer Geodatabase-Version an, wenn Sie eine andere Version verwenden als die, auf die der Karten- oder Feature-Service verweist. source (optional): Diese Eigenschaft ist nur dann erforderlich, wenn ein Feature-Layer auf einem Kartenservice basiert, der dynamische Layer verwendet.

Syntax für einen Image-Service-Layer	Beispiel
"operationalLayers": [ { "url": "<url1>", "title": "<title1>", "opacity": <opacity2>, "noData": <noDataValue>, "format": "<jpgpng | png | png8 | png24 | png32 | jpg | bmp | gif | tiff >", "interpolation": "<RSP_BilinearInterpolation | RSP_CubicConvolution | RSP_Majority | RSP_NearestNeighbor>", "compressionQuality": <compress>, "bandIds": [ <bandId1>, <bandId2> ], "mosaicRule": "<mosaicRule>", "renderingRule": "<renderingRule>", "noDataInterpretation": "<esriNoDataMatchAny | esriNoDataMatchAll>" } ]	"operationalLayers": [ { "url": "https://ais3/ArcGIS/rest/services/QB16/ImageServer", "title": "Satellite image from 1990", "opacity": 0.8, "bandIds": [ 0, 1, 2 ] } ]
Beschreibung
Hinweis: Weitere Informationen zu Image-Service-Layern finden Sie unter ArcGIS-REST-API.

Syntax für einen WMS-Service-Layer
"operationalLayers": [ { "url": "<url1>", "title": "<title1>", "type": "wms", "opacity": <opacity1>, "version": "<wmsServerVersion>", "format": "<jpg | png8 | png24 | png32>", "transparentBackground": <true | false>, "layers": [ {"name": "<layerName1>"}, {"name": "<layerName2>"} ], "visibleLayers": [ "<layerName1>", "<layerName2>" ], "styles": [ "<style1>", "<style2>" ] } ]
Beschreibung
type (erforderlich): Für WMS-Layer muss dies als wms angegeben werden. format (optional): Das vom Server angeforderte Bildformat. transparentBackground (optional): Wenn der Wert auf true festgelegt ist, wird der Hintergrund transparent dargestellt, vorausgesetzt, das angeforderte Bildformat unterstützt eine transparente Farbe. (JPEG ist ein Beispiel für ein Bildformat, das keine transparente Farbe unterstützt.) Der Standardwert lautet false. visibleLayers (optional): Array von Sublayer-Namen, die innerhalb des WMS-Service-Layers sichtbar gemacht werden sollen. Die Reihenfolge ist ebenfalls wichtig; sie muss den Anforderungen des WMS-Service entsprechen. Wenn es nicht angegeben wird, werden alle Layer des WMS-Service sichtbar gemacht. layers (optional): Array von Sublayer-Namen, die der Karte hinzugefügt werden sollen. Wenn es nicht angegeben wird, werden alle Layer eines WMS-Service der Karte hinzugefügt. styles (optional): Verwenden Sie diese Eigenschaft, um den standardmäßigen Darstellungs-Style eines Sublayers zu überschreiben. Stellen Sie beim Festlegen dieser Eigenschaft sicher, dass die Anzahl und die Reihenfolge der Styles mit dem Array visibleLayers übereinstimmen. Wenn der Style eines bestimmten Sublayers nicht geändert werden soll, können Sie eine leere Zeichenfolge übergeben, beispielsweise "styles": ["highways","","population"]. version (optional): Die WMS-Version, zu der Sie eine Verbindung herstellen möchten. Standardmäßig wird die aktuelle Version vom angegebenen WMS-Service unterstützt.

Syntax für einen KML-Layer	Beispiel
"operationalLayers": [ { "type": "kml", "url": "<url1>", "title": "<title1>", "showLabels": "<true | false>", "visibleFolders": [ <folderId1>, <folderId2> ] } ]	"operationalLayers": [ { "type": "kml", "url": "https://myMachine/.../vermont.kmz", "title": "Vermont weather stations", "opacity": 0.75, "showLabels": true, "visibleFolders": [ 0, 1, 2 ] } ]
Beschreibung
type (erforderlich): Für diese Art von Layer muss der Typ kml sein. url (erforderlich): Die URL zu einer KMZ-Datei. showLabels (optional): Standardmäßig handelt es sich hierbei um false. visibleFolders: Array an numerischen IDs von Ordnern, die sichtbar gemacht werden.

Syntax für einen clientseitigen Image-Service-Layer	Beispiel
"operationalLayers": [ { "type": "image", "title": "<title1>", "opacity": <opacity2>, "extent": { "xmin": <xmin>, "ymin": <ymin>, "xmax": <xmax>, "ymax": <ymax>, "spatialReference": {<spatialReference>} }, "url": "<url1>", "imageData": "<base64EncodedImageData>" } ]	"operationalLayers": [ { "type": "image", "title": "heat map", "opacity": 0.75, "extent": { "xmin": -12933906.537, "ymin": 3993856.886, "xmax": -12933371.998, "ymax": 3994375.189, "spatialReference": { "wkid": 102100 } }, "url": "https://myMachine/anImage.png", "imageData": "iVBORw0KGg....", } ]
Beschreibung
type (erforderlich): Für diese Art von Layer muss type imagesein. extent (erforderlich): Das kleinste umgebende Rechteck, in das das Bild passt. url (optional): Die URL zu einem Bild, das dargestellt werden soll. Dies ist nur dann erforderlich, wenn imageData nicht übergeben wird. imageData (optional): Das als base64 codierte Bild. Dies ist erforderlich, wenn die url-Eigenschaft nicht übergeben wird.

Syntax für clientseitige Grafiken		Beispiel
"operationalLayers": [ { "featureCollection": { "layers": [ { "layerDefinition": { "name": "<layerName>", "geometryType": "<esriGeometryType>", "drawingInfo": {<drawingInfo>}, "objectIdField": "<objectIdFieldName>", //optional "fields": [ //optional { "name": "<fieldName>", "type": "<esriFieldType>", "alias": "<fieldAliasName>" } ] }, "featureSet": { "features": [ { "geometry": {<geometry>}, "attributes": { //optional "<fieldName>": "<value>" }, "symbol": {<symbol>} //overrides symbol defined in the renderer } ] } } ] } } ]		"operationalLayers": [ { "id": "map_graphics", "featureCollection": { "layers": [ { "layerDefinition": { "name": "pointLayer", "geometryType": "esriGeometryPoint", "drawingInfo": { "renderer": { "type": "simple", "symbol": { "type": "esriSMS", "style": "esriSMSCircle", "color": [ 76, 115, 0, 255 ], "size": 20, "outline": { "color": [ 255, 0, 0, 255 ], "width": 1 } } } } }, "featureSet": { "features": [ { "geometry": { "x": -10253568.722284, "y": 5463514.62565701, "spatialReference": { "wkid": 102100 } } }, { "geometry": { "x": -13267022.125398, "y": 5463514.62565701, "spatialReference": { "wkid": 102100 } }, "symbol": { "color": [ 255, 138, 255, 191 ], "size": 12, "type": "esriSMS", "style": "esriSMSSquare" } } ] } } ] } } ]
Beschreibung
layers (erforderlich): Sammlung von Layern. Ein Layer verfügt über zwei Eigenschaften: layerDefinition und featureSet. layerDefinition (erforderlich): Enthält Eigenschaften, die einen Layer definieren: name, geometryType, drawingInfo, objectIdField und fields. name (optional): Name des Layers. geometryType (erforderlich): Für einen Text-Layer muss geometryType esriGeometryPoint ein. drawingInfo (optional): Wenn drawingInfo fehlt, werden Grafiken mithilfe von Symbolen symbolisiert. objectIdField (optional): Name des Feldes, das Objekt-IDs enthält. fields (optional): Sammlung von Feldern. featureSet (erforderlich): Feature-Container. features (erforderlich): Sammlung von Features. geometry (erforderlich): Geometrie, die das Feature oder die Grafik definiert. attributes (optional): Sammlung von Feature-Attributen. symbol (optional): Wenn diese Eigenschaft angegeben wird, überschreibt dieses Symbol das im Renderer definierte Symbol.

Syntax für Dateien mit kommagetrennten Werten (CSV) nach URL		Beispiel
"operationalLayers": [ { { "type": "CSV", "url": "<url>", "layerDefinition": { "drawingInfo": { "renderer": {<renderer>} } }, "locationInfo": { "latitudeFieldName": "<latitudeFieldName>", "longitudeFieldName": "<longitudeFieldName>" } } } ]		"operationalLayers": [ { "type": "CSV", "url": "https://servicesbeta.esri.com/demos/exp/data/earthquakes.csv", "id": "Earthquakes", "title": "Earthquakes", "visibility": true, "opacity": 1, "layerDefinition": { "drawingInfo": { "renderer": { "symbol": { "height": 15, "type": "esriPMS", "url": "https://static.arcgis.com/images/Symbols/Basic/RedSphere.png", "width": 15 }, "type": "simple" }, "transparency": 0 } }, "locationInfo": { "latitudeFieldName": "lat", "longitudeFieldName": "lon" } } ]
Beschreibung
latitudeFieldName (erforderlich): Der Name des Feldes, das die Y-Koordinate enthält. longitudeFieldName (erforderlich): Der Name des Feldes, das die X-Koordinate enthält.

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. "drawingInfo": { "observationAger": {<symbolAger>}, "latestObservationRenderer": {<renderer>}, "trackLinesRenderer": {<renderer>}, "renderer": {<renderer>} }	"drawingInfo": { "observationAger": { "alphaRange": [ 0, 255 ] }, "latestObservationRenderer": { "type": "simple", "symbol": { "type": "esriPMS", "url": "https://help.arcgis.com/.../hurr_100_icon.png", "contentType": "image/png", "width": 30, "height": 30 } }, "trackLinesRenderer": { "type": "simple", "symbol": { "type": "esriSLS", "style": "esriSLSSolid", "width": 1, "color": [ 0, 0, 0, 255 ] } }, "renderer": { "type": "simple", "symbol": { "type": "esriSMS", "style": "esriSMSCircle", "size": 24, "outline": { "color": [ 255, 255, 255, 255 ], "width": 1 } } } }
Syntax für die Definition von symbolAger
//rampAger { "colorRange": [ {<color>}, //for oldest events {<color>} //for newest events ], "alphaRange": [ <alpha>, //for oldest events <alpha> //for newest events ], "sizeRange": [ <size>, //for oldest events <size> //for newest events ] } //classBreaksAger { "timeUnits": "<esriTimeUnits>", "agerClassBreakInfos": [{<agerClassBreakInfo>},...] }
Syntax für die Definition von agerClassBreakInfo
{ "oldestAge": <age>, "color": {<color>}, "alpha": <alpha>, "size": <size> }
Beschreibung
Der Zeit-Renderer wird nur von Feature-Layern, nicht von clientseitigen Grafik-Layern oder dynamischen Kartenservice-Layern unterstützt. Alpha ist ein Ganzzahlwert im Bereich von 0 bis 255.

Geoverarbeitungsergebnis

Es gibt zwei Methoden zum Einbeziehen eines Geoverarbeitungsergebnisses:

1. Wenn ein Geoverarbeitungsergebnis als Feature-Set zurückgegeben und als Grafik auf dem Client dargestellt wird, senden Sie das Ergebnis als Feature-Erfassung.
2. 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
"baseMap": { "title": "<title>", "baseMapLayers": [ { "url": "<url1>", "opacity": <opacity1> }, { "url": "<url2>", "opacity": <opacity2> } ] }	"baseMap": { "title": "Shared Imagery Basemap", "baseMapLayers": [ { "url": "https://services.arcgisonline.com/ArcGIS/rest/services/ESRI_Imagery_World_2D/MapServer", }, { "url": "https://services.arcgisonline.com/ArcGIS/rest/services/CSP_Imagery_World_2D/MapServer", } ] }

Syntax für Vektorkachel-Layer als baseMapLayer	Beispiel
Hinweis: Vektorkachel-Layer werden nur von über ArcGIS Pro veröffentlichte Druck-Services unterstützt. "baseMap": { "title": "<title>", "baseMapLayers": [ { "id": "<id1>", "type": "VectorTileLayer", "layerType": "VectorTileLayer", "title": "<title1>", "styleUrl": "<Url1>" "visibility": <true | false>, "opacity": <opacity1> } ] }	"baseMap": { "title": "VectorTileLayer as BaseMap", "baseMapLayers": [ { "id": "VectorTile_1933", "type": "VectorTileLayer", "layerType": "VectorTileLayer", "title": "World_Basemap", "styleUrl": "https://basemaps.arcgis.com/b2/arcgis/rest/services/World_Basemap/VectorTileServer/resources/styles/root.json", "visibility": true, "opacity": 1 } ] }

Syntax für Bing Maps als basemapLayer	Beispiel
"baseMap": { "title": "<title>", "baseMapLayers": [ { "id": "<id1>", "type": "<BingMapsRoad | BingMapsAerial | BingMapsHybrid>", "culture": "<Bing Maps supported culture>", "key": "<bing_key>" //optional } ] }	"baseMap": { "title": "Bing Maps", "baseMapLayers": [ { "id": "BingMap", "visibility": true, "type": "BingMapsRoad", "culture": "fr-ca" } ] }

Syntax für OpenStreetMap als basemapLayer	Beispiel
"baseMap": { "title": "<title>", "baseMapLayers": [ { "type": "OpenStreetMap", "url": "<url>", //optional "credits": "<credits>" //optional } ] }	"baseMap": { "title": "OpenCycle Map", "baseMapLayers": [ { "type": "OpenStreetMap", "url": "https://a.tile.opencyclemap.org/cycle" } ] }
Beschreibung
url (optional): Bei fehlender Angabe wird standardmäßig openstreetmap.org verwendet. credits (optional): Eine Erwähnung aller an der Erstellung des Layers beteiligten Personen. Der Wert dieser Eigenschaft wird ignoriert, wenn url nicht angegeben wird. Stattdessen werden die Credits für den standardmäßigen OpenStreetMap-Service verwendet.

Syntax für WebTiledLayer als basemapLayer	Beispiel
"baseMap": { "title": "<title>", "baseMapLayers": [ { "type": "WebTiledLayer", "urlTemplate": "<urlTemplate1>", "subDomains": [ //optional <subDomain1>, <subDomain2> ], "tileInfo": {}, //optional "credits": "<credits>" //optional } ] }	"baseMap": { "title": "MapQuest", "baseMapLayers": [ { "type": "WebTiledLayer", "urlTemplate": "https://{subDomain}.mqcdn.com/tiles/1.0.0/vx/map/{level}/{col}/{row}.jpg, "subDomains": [ "mtile01", "mtile02", "mtile03", "mtile04" ] } ] }
Beschreibung
urlTemplate (erforderlich): Die URL-Vorlage zum Abrufen der Kacheln Die URL-Vorlage folgt dem Muster https://some.domain.com/{level}/{col}/{row}/, wobei level einer Zoomstufe entspricht und col und row für eine Kachelspalte bzw. -reihe stehen. subDomains (optional): Es wird eine der angegebenen subDomains verwendet, um den Platzhalter {subDomain} in der Eigenschaft urlTemplate zu ersetzen und eine Kachelanforderungs-URL zu bilden. tileInfo (optional): Definiert die Kachelinformationen für den Layer, einschließlich Detaillierungsebenen, Zeilen, Spalten, Ursprung und Raumbezug. Wenn keine tileInfo angegeben ist, wird davon ausgegangen, dass sich der Layer im Web Mercator mit dem Web Mercator-Kachelschema befindet. Weitere Informationen zu tileInfo finden Sie unter ArcGIS REST API. credits (optional): Eine Erwähnung aller an der Erstellung des Layers beteiligten Personen.

Syntax für WMTS als basemapLayer
"baseMap": { "title": "<title>", "baseMapLayers": [ { "type": "wmts", "url": "<url1>", "layer": "<layerName>", //optional "style": "<style>", //optional "format": "<imageFormat>", //optional "tileMatrixSet": "<tileMatrixSet>" //optional } ] }

exportOptions

Dieses Objekt gibt die Einstellungen für die Ausgabekarte an.

Syntax	Beispiel
"exportOptions": { "dpi": <dpi>, "outputSize": [ <width>, <height> ] }	"exportOptions": { "dpi": 300, "outputSize": [ 500, 500 ] }
Beschreibung
dpi (optional): Die Auflösung in dpi (Dots per Inch, Punkte pro Zoll). Die Standardeinstellung ist 96 dpi. outputSize (optional): Die Größe der Karte in Pixel. Die Größe muss definiert werden, wenn eine leere Zeichenfolge oder MAP_ONLY (ohne Anführungszeichen) als Wert an den layout_template-Parameter übergeben wird. Wenn für den Parameter layout_template nicht MAP_ONLY oder eine leere Zeichenfolge angegeben ist, hat layout_template Vorrang vor der Eigenschaft outputSize.

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
"layoutOptions": { "titleText": "<title>", "authorText": "<authorName>", "copyrightText": "<copyright>", "scaleBarOptions": { "metricUnit": "<esriMeters | esriKilometers>" , "metricLabel": "<metricUnitLabel>", "nonMetricUnit": "<esriFeet | esriYards | esriMiles | esriNauticalMiles>" , "nonMetricLabel": "<nonMetricUnitLabel>" }, "customTextElements": [ {"<textElementName1>": "<value1>"}, {"<textElementName2>": "<value2>"} ], "elementOverrides": { "<elementName1>": {"visible" : true | false}, "<elementName2>": {"visible" : true | false}, //for dynamic text elements "<dynTxtElmName1>": { "visible": true | false, // a text element can have multiple dynamic text elements "dynamicTextElements": [ //element's index must match their position inside a text element { "sourceLayerId": "<webmapOperationalLayerId>", //required "field": "<field-name>", "filterType": "<all | visible | selected>", "whereClause": "SQLWhereClause" }, { ... } ] }, //for table frame elements "<tableElmName1>": { "visible": true | false, "sourceLayerId": "<webmapOperationalLayerId>", //required "field": ["field1", "field2", ...], //order is honored "filterType": "<all | visible | selected>", "whereClause": "SQLWhereClause" }, //for chart frame elements "<chartElmName1>": { "visible": true | false, "sourceLayerId": "<webmapOperationalLayerId>", //required "sourceChartId": "<chartId>", //required "filterType": "<all | visible | selected>" } }, "legendOptions": { "operationalLayers": [ { "id": "<webmapOperationalLayerId>", "sublayerIds": [ //array of string or number <mapServerSublayerId1>, <mapServerSublayerId2> ] } ] } }	"layoutOptions": { "titleText": "City Land Use Map", "authorText": "Print by: XYZ", "copyrightText": "© esri", "scaleBarOptions": { "metricUnit": "esriKilometers", "metricLabel": "km", "nonMetricUnit": "esriMiles", "nonMetricLabel": "mi" } "customTextElements": [ {"townshipName": "Town ABC"} ], "elementOverrides": { "myNorthArrow": {"visible" : true} }, "legendOptions": { "operationalLayers": [ { //for dynamic mapservicelayer "id": "myMapserviceLayer", "subLayerIds": [ //array of integer 0, 1 ] }, { //for WMS layer "id": "myWMSLayer", "subLayerIds": [ //array of string "layer1", "layer2" ] }, { //for FeatureLayer "id": "myFeatureLayer" } ] } }
Beschreibung
titleText (optional): Der Text des Textelements für Kartentitel wird aktualisiert, wenn er im Layout vorhanden ist. authorText (optional): Der Text des Autortextelements wird aktualisiert, wenn er im Layout vorhanden ist. copyrightText (optional): Der Text des Copyright-Textelements wird aktualisiert, wenn er im Layout vorhanden ist. scaleBarOptions (optional): Mit diesen Optionen wird eine Maßstabsleiste aktualisiert, sofern vorhanden. metricUnit (optional): Stellt die Einheiten der Maßstabsleiste auf metrische Einheiten ein. metricLabel (optional): Zeichenfolge, die angibt, wie Einheiten beschriftet werden, z. B. KM, Kilometer oder km. Wenn dies nicht festgelegt wird oder eine leere Zeichenfolge übergeben wird, wird der Textwert der Einheit verwendet. nonMetricUnit (optional): Stellt die Einheiten der Maßstabsleiste auf nichtmetrische Einheiten ein. nonMetricLabel (optional): Zeichenfolge, die angibt, wie Einheiten beschriftet werden, z. B. Meilen oder mi. Wenn dies nicht festgelegt wird oder eine leere Zeichenfolge übergeben wird, wird der Textwert der Einheit verwendet. customTextElements (optional): Dies ist ein Array von Namenwertpaaren. Diese Eigenschaft muss verwendet werden, wenn Sie den Text eines Textelements (der kein dynamischer Text ist) im Seitenlayout aktualisieren möchten. Die Werte müssen Zeichenfolgen sein. legendOptions (optional): Legt Eigenschaften eines Legendenelements im Layout fest. Beachten Sie, dass ein leeres Legendenelement im Layout (es enthält keinen Layer) vom Druck-Service entfernt wird. operationalLayers (optional): Gibt die operationalen Layer an, deren Legenden dem Layout hinzugefügt werden. id: Zeichenfolge, die die ID des Layers darstellt. Die ID muss eindeutig sein und mit der ID des Layers im operationalLayers-Element übereinstimmen, in dem der operationale Layer definiert wird. subLayerIds (optional): Ein Array von Sublayern, deren Elementtypen "Zeichenfolge" oder "Long" sind und die kontextabhängig vom operationalen Layer-Typ sind. Beispielsweise muss es für einen Kartenservice-Layer eine Zahl, für einen WMS-Layer hingegen eine Zeichenfolge sein. Es wird empfohlen, die subLayerIds-Werte für operationale Layer festzulegen, die Sublayer aufweisen. Wenn sie bei Kartenservice- und WMS-Layern ausgelassen werden, werden dem Legendenelement im Layout Legenden aus allen Sublayern hinzugefügt. Für Feature- oder Grafik-Layer muss die sublayers-Eigenschaft nicht festgelegt werden. elementOverrides (optional): Dies ist ein Element, das Eigenschaften zum Überschreiben einiger Elemente enthält, beispielsweise Nordpfeile, Textelemente mit dynamischen Textelementen, Tabellenrahmen- oder Diagrammrahmenelemente im Seitenlayout. Sie können mit "GetLayoutTemplatesInfo" herausfinden, ob eine Layout-Vorlage solche Elemente und deren Definitionen enthält. visible (optional): Geben Sie die Sichtbarkeit eines Elements an. Dies gilt für alle Typen von Elementen. sourceLayerId: Erforderlich für Tabellenelemente und Diagrammelemente. sourceChartId: Erforderlich und nur gültig für Diagrammelemente. sourceChartId befindet sich in einer operationalLayer-Definition. filterType (optional): Überschreiben Sie den Filtertyp. Gültig für dynamische Textelemente, Tabellenelemente und Diagrammelemente. whereClause (optional): Geben Sie einen Attributfilter an, der dem SQL-Standard entspricht. Bei filterType="Selected" werden beide berücksichtigt. Wird ignoriert, wenn das Element ein Diagrammelement ist. fields (optional): Geben Sie ein Array von Feldern an, das in einem Tabellenelement verwendet wird. Gilt nicht für ein Diagrammelement. Die Reihenfolge wird berücksichtigt. dynamicTextElements: Ein Array von dynamischen Textelementen mit überschriebenen Eigenschaften. Gilt nur für Textelemente, die dynamische Textelemente enthalten. sourceLayerId (erforderlich): Zeichenfolge, die die ID des Layers darstellt. Die ID muss eindeutig sein und mit der ID des Layers im operationalLayers-Element übereinstimmen, in dem der operationale Layer definiert wird. filterType (optional): Überschreiben Sie den Filtertyp. whereClause (optional): Geben Sie einen Attributfilter an, der dem SQL-Standard entspricht. Bei filterType="Selected" werden beide berücksichtigt. field (optional): Geben Sie den Namen des Feldes an, aus dem die dynamischen Attribute oder einige Statistiken abgerufen oder generiert werden.

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
"reportOptions": { "reportSectionOverrides": { "Report Section": { "name": "<report title>", "sourceId": "<operation layer/table id>", //field mapping "fieldElements": { "<fieldElementName1>": "<fieldName1>", "<fieldElementName2>": "<fieldName2>", "<fieldElementName3>": "<fieldName3>", ... }, //group section when available "groupSections": { "<groupSectionElementName>": "<groupByFieldName1>" }, //statistic elements when available "statisticElements": { "<statElementName1>": "<fieldName1>" } }, //related report section when available "Related Report": { "sourceId": "<related operational layer/table id", //mapping between field element and field name "fieldElements": { "<fieldElementName1>": "<fieldName1>", "<fieldElementName2>": "<fieldName2>" ... }, //field headers "fieldLabelElements": { "<fieldLabelElementName1>": "<fieldHeader1>", "<fieldLabelElementName2>": "<fieldHeader2>" ... }, "groupSections": { "<groupHeaderElementName>": "<group header>" } } } }	"reportOptions": { "reportSectionOverrides": { "Report Section": { "name": "Esri Theme Parks", "sourceId": "18a387780ae-layer-3", "fieldElements": { "Field 1": "Website", "Field 2": "City", "Field 3": "State", "Field 4": "OpeningDay", "Field 5": "ChildPrice", "Field 6": "AdultPrice" }, "groupSections": { "Group field: [group-field-value]": "Name" }, "statisticElements": { "Count Statistic 1": "Name" } }, "Related Report": { "sourceId": "18a387780b0-layer-4", "fieldElements": { "Related Field 1 1": "AttractionName", "Related Field 2 1": "Description" }, "fieldLabelElements": { "Related Field Label 1": "Name", "Related Field Label 2": "Description" }, "groupSections": { "[related-report-name]: Group Header: [group-field-value]": "AttractionType" } } } }
Beschreibung
reportSectionOverrides: Dies ist das einzige Element, das ein reportOptions-Element aufweist. Es enthält Definitionen einiger Abschnitte wie Report Section, Related Report usw., die im Berichts-Layout verfügbar sind. Jedes dieser untergeordneten Elemente enthält Eigenschaften zum Überschreiben einiger Elemente wie Quellen, Feldzuordnungen usw. innerhalb der einzelnen Abschnitte. Sie können mit Berichtsvorlageninformationen abrufen alle Elemente in einer Berichtsvorlage finden, die überschrieben werden können. Weitere Informationen zu Berichten und deren Komponenten finden Sie in der ArcGIS Pro-Hilfe.

Einschränkungen

Symbole auf Feature-Ebene, die in Notizen-Layern überschrieben werden, werden nicht unterstützt, wenn der Renderertyp "Klassenunterbrechung" oder "einfach" ist.