Webkarte exportieren (Server)

Zusammenfassung

Gibt basierend auf dem Status einer Web-App (zum Beispiel enthaltene Services, Layer-Sichtbarkeitseinstellungen und clientseitige Grafiken) ein druckbares Seitenlayout oder eine grundlegende Karte eines angegebenen Interessenbereichs zurück.

Verwendung

  • Die Eingabe für dieses Werkzeug ist ein Text im JSON-Format, der die Layer, Grafiken und andere Einstellungen in der Webkarte beschreibt. Die JSON-Repräsentation muss entsprechend der ExportWebMap-Spezifikation strukturiert sein.

  • Dieses Werkzeug ist in ArcGIS Server enthalten, um Web-Services zum Drucken zu unterstützen, darunter der vorkonfigurierte Service PrintingTools. Die ArcGIS API for JavaScript verwendet den Service PrintingTools, um Images für den Kartendruck zu generieren.

  • Für erweiterte Druckszenarien, zum Beispiel Ersetzen von Service-Layern durch lokale Vektordaten, Erstellen von Kartensammlungen usw., sollten Sie dieses Werkzeug nicht verwenden. Verwenden Sie stattdessen die Funktion ConvertWebMapToArcGISProject im Python arcpy.mp-Modul, das im Lieferumfang von ArcGIS enthalten ist. Um ein Python-Skript für eine Web-App verfügbar zu machen, können Sie das Skript über einen ArcGIS Server-Geoverarbeitungsservice bereitstellen. Weitere Informationen finden Sie unter Drucken in Webanwendungen in der ArcGIS Server-Hilfe.

  • Beim Exportformat TIFF wird eine 32-Bit-TIFF-Datei (.tiff) mit Geofunktionen und einem Alpha-Kanal generiert.

Parameter

BeschriftungErläuterungDatentyp
Webkarte als JSON

Eine JSON-Repräsentation des Status der zu exportierenden Karte, wie sie in der Web-App angezeigt wird. Informationen zum Formatieren dieses Textes finden Sie im Abschnitt zur ExportWebMap-Spezifikation. Die ArcGIS API for JavaScript ermöglicht den Abruf dieser JSON-Zeichenfolge aus der Karte.

String
Ausgabedatei

Der Name der Ausgabedatei. Die Erweiterung der Datei hängt vom Parameterwert Format ab.

File
Format
(optional)

Gibt das Format an, in dem das Karten-Image zum Drucken bereitgestellt wird.

  • 8-Bit Portable Network Graphics (PNG8)Das PNG-8-Format (8-Bit Portable Network Graphics) wird verwendet. Dies ist die Standardeinstellung.
  • Portable Document Format (PDF)Das PDF-Format (Portable Document Format) wird verwendet.
  • 32-Bit Portable Network Graphics (PNG32)Das PNG-32-Format (32-Bit Portable Network Graphics) wird verwendet.
  • Joint Photographic Experts Group (JPG)Das JPG-Format (Joint Photographic Experts Group) wird verwendet.
  • GIF (Graphics Interchange Format)Das GIF-Format (Graphics Interchange Format) wird verwendet.
  • Encapsulated PostScript (EPS)Das EPS-Format (Encapsulated PostScript) wird verwendet.
  • Scalable Vector Graphics (SVG)Das SVG-Format (Scalable Vector Graphics) wird verwendet.
  • Compressed Scalable Vector Graphics (SVGZ)Das SVGZ-Format (Compressed Scalable Vector Graphics) wird verwendet.
  • Adobe Illustrator Exchange (AIX)Das AIX-Format (Adobe Illustrator Exchange) wird verwendet.
  • Tag Image File Format (TIFF)Das TIFF-Format (Tag Image File Format) wird verwendet.
Hinweis:

Der Hintergrund der Ausgabedatei ist immer undurchsichtig.

String
Layout-Vorlagenordner
(optional)

Der vollständige Pfad zum Ordner mit den Kartendokumenten (.pagx-Dateien), die als Layout-Vorlagen verwendet werden sollen. Das Standardverzeichnis ist <install_directory>\Resources\ArcToolBox\Templates\ExportWebMapTemplates.

Folder
Layout-Vorlage
(optional)

Der Name einer Vorlage aus der Liste oder das Schlüsselwort MAP_ONLY. Wenn MAP_ONLY verwendet oder eine leere Zeichenfolge übergeben wird, enthält die Ausgabekarte keine Seitenlayout-Elemente, wie zum Beispiel Titel, Legende oder Maßstabsleiste.

String
Layout-Element-ID
(optional)

Die Portal-ID (im JSON-Format) des Layout-Elements, das für Vorlagen verwendet werden soll. Verwenden Sie das Format: {"id": "<portal-id>"}. Wenn dieser Parameter angegeben wurde, dann hat er Vorrang vor dem Parameter Layout-Vorlage.

String

arcpy.server.ExportWebMap(Web_Map_as_JSON, Output_File, {Format}, {Layout_Templates_Folder}, {Layout_Template}, {Layout_Item_ID})
NameErläuterungDatentyp
Web_Map_as_JSON

Eine JSON-Repräsentation des Status der zu exportierenden Karte, wie sie in der Web-App angezeigt wird. Informationen zum Formatieren dieses Textes finden Sie im Abschnitt zur ExportWebMap-Spezifikation. Die ArcGIS API for JavaScript ermöglicht den Abruf dieser JSON-Zeichenfolge aus der Karte.

String
Output_File

Der Name der Ausgabedatei. Die Erweiterung der Datei hängt vom Parameterwert Format ab.

File
Format
(optional)

Gibt das Format an, in dem das Karten-Image zum Drucken bereitgestellt wird.

  • PNG8Das PNG-8-Format (8-Bit Portable Network Graphics) wird verwendet. Dies ist die Standardeinstellung.
  • PDFDas PDF-Format (Portable Document Format) wird verwendet.
  • PNG32Das PNG-32-Format (32-Bit Portable Network Graphics) wird verwendet.
  • JPGDas JPG-Format (Joint Photographic Experts Group) wird verwendet.
  • GIFDas GIF-Format (Graphics Interchange Format) wird verwendet.
  • EPSDas EPS-Format (Encapsulated PostScript) wird verwendet.
  • SVGDas SVG-Format (Scalable Vector Graphics) wird verwendet.
  • SVGZDas SVGZ-Format (Compressed Scalable Vector Graphics) wird verwendet.
  • AIXDas AIX-Format (Adobe Illustrator Exchange) wird verwendet.
  • TIFFDas TIFF-Format (Tag Image File Format) wird verwendet.
Hinweis:

Der Hintergrund der Ausgabedatei ist immer undurchsichtig.

String
Layout_Templates_Folder
(optional)

Der vollständige Pfad zum Ordner mit den Kartendokumenten (.pagx-Dateien), die als Layout-Vorlagen verwendet werden sollen. Das Standardverzeichnis ist <install_directory>\Resources\ArcToolBox\Templates\ExportWebMapTemplates.

Folder
Layout_Template
(optional)

Der Name einer Vorlage aus der Liste oder das Schlüsselwort MAP_ONLY. Wenn MAP_ONLY verwendet oder eine leere Zeichenfolge übergeben wird, enthält die Ausgabekarte keine Seitenlayout-Elemente, wie zum Beispiel Titel, Legende oder Maßstabsleiste.

String
Layout_Item_ID
(optional)

Die Portal-ID (im JSON-Format) des Layout-Elements, das für Vorlagen verwendet werden soll. Verwenden Sie das Format: {"id": "<portal-id>"}. Wenn dieser Parameter angegeben wurde, dann hat er Vorrang vor dem Parameter Layout_Template.

String

Umgebungen

Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.

Lizenzinformationen

  • Basic: Ja
  • Standard: Ja
  • Advanced: Ja

Verwandte Themen