Cache-Kacheln für Kartenserver verwalten (Server)

Zusammenfassung

Erstellt und aktualisiert Kacheln in einem vorhandenen Web-Kachel-Layer-Cache. Dieses Werkzeug wird verwendet, um neue Kacheln zu erstellen, fehlende Kacheln zu ersetzen, veraltete Kacheln zu überschreiben und Kacheln zu löschen.

Verwendung

  • Die Ausführung dieses Werkzeugs kann für Caches, die eine große geographische Ausdehnung oder sehr große Kartenmaßstäbe abdecken, ggf. einen langen Zeitraum in Anspruch nehmen. Wenn das Werkzeug abgebrochen wird, wird die Kachelerstellung beendet, aber die vorhandenen Kacheln werden nicht gelöscht. Dies bedeutet, dass Sie das Werkzeug aus Zeitgründen abbrechen können. Später können Sie es dann für denselben Cache erneut ausführen, indem Sie den Parameter Aktualisierungsmodus auf Fehlende Kacheln erstellen (update_mode="RECREATE_EMPTY_TILES" in Python) festlegen.

Parameter

BeschriftungErläuterungDatentyp
Eingabeservice

Der Web-Kachel- oder Kartenbild-Layer, dessen Cache-Kacheln Sie aktualisieren möchten. Sie können ihn auswählen, indem Sie zu dem gewünschten Service in Portal navigieren. Sie haben auch die Möglichkeit, einen Web-Kachel-Layer per Drag-and-drop aus dem Bereich Projekt der Registerkarte Portal zu verschieben, um diesen Parameter einzugeben.

Image Service; Map Server
Maßstäbe

Eine Liste mit Maßstabsebenen, auf denen Kacheln erstellt werden.

Standardmäßig liegen die im Werkzeugdialogfeld aufgelisteten Maßstäbe zwischen dem Minimum und dem Maximum der für den Service gecachten Maßstäbe. Der Cache-Maßstabsbereich des Service kann mit ArcGIS Pro nicht geändert werden.

Double
Aktualisierungsmodus

Der Modus für die Aktualisierung des Cache.

  • Fehlende Kacheln erstellenEs werden nur Kacheln erstellt, die leer sind. Vorhandene Kacheln werden unverändert beibehalten. Diese Option ist für Web-Kachel-Layer, die in ArcGIS Online veröffentlicht werden, nicht verfügbar.
  • Alle Kacheln neu erstellenVorhandene Kacheln werden ersetzt und neue Kacheln werden hinzugefügt, wenn die Ausdehnung geändert wurde.
  • Kacheln löschenKacheln werden aus dem Cache gelöscht. Die Cache-Ordnerstruktur wird nicht gelöscht.
String
Anzahl der Caching-Service-Instanzen
(optional)

Definiert die Anzahl der Instanzen, die zum Aktualisieren/Erstellen der Kacheln verwendet werden. Der Wert für diesen Parameter ist auf unbegrenzt (-1) festgelegt und kann nicht geändert werden.

Long
Interessenbereich
(optional)

Definiert einen Interessenbereich, um einzuschränken, wo Kacheln erstellt oder gelöscht werden. Dieser Parameter ist hilfreich, wenn Sie Kacheln für unregelmäßig geformte Bereiche verwalten möchten. Er ist außerdem in Situationen hilfreich, in denen Sie einige Bereiche im Voraus cachen und weniger frequentierte Bereiche ungecacht lassen möchten.

Wenn Sie keinen Wert für diesen Parameter angeben, wird standardmäßig die volle Ausdehnung der Karte verwendet.

Feature Set
Aktualisierungsausdehnung
(optional)

Rechteckige Ausdehnung, bei der Kacheln je nach Wert des Parameters Aktualisierungsmodus erstellt oder gelöscht werden. Sie sollten nicht für beide Parameter Aktualisierungsausdehnung und Interessenbereich gleichzeitig Werte angeben. Wenn für beide Parameter Werte angegeben werden, wird der Wert für Interessenbereich verwendet.

  • Default: Die Ausdehnung basiert auf der maximalen Ausdehnung aller beteiligten Layer. Dies ist die Standardeinstellung.
  • Aktuelle Anzeigeausdehnung: Die Ausdehnung entspricht dem Datenrahmen oder der sichtbaren Anzeige. Die Option ist nicht verfügbar, wenn keine aktive Karte vorhanden ist.
  • Wie unten angegeben: Die Ausdehnung basiert auf den angegebenen Minimal- und Maximalwerten der Ausdehnung.
  • Durchsuchen: Die Ausdehnung basiert auf einem vorhandenen Dataset.
Extent
Auf Auftragsabschluss warten
(optional)

Dieser Parameter ermöglicht Ihnen das Überwachen des Fortschritts des Cache-Auftrags, der in ArcGIS Online oder Portal for ArcGIS ausgeführt wird.

  • Aktiviert: Dieses Werkzeug wird weiterhin in Pro ausgeführt, während der Cache-Auftrag in Portal for ArcGIS oder ArcGIS Online ausgeführt wird. Mit dieser Option können Sie jederzeit detaillierte Fortschrittsberichte anfordern und die Geoverarbeitungs-Meldungen anzeigen, wenn sie auftreten.
  • Deaktiviert: Dieses Werkzeug übermittelt den Auftrag an das Portal, wo Sie in ArcGIS Pro weitere Geoverarbeitungsaufgaben ausführen oder ihn schließen können. Diese Option wird verwendet, wenn Sie einen Cache automatisch beim Veröffentlichen des Service erstellen möchten. Sie können diese Option auch für jeden anderen Cache festlegen, den Sie erstellen.
Boolean
Portal-URL
(optional)

Die URL des Portals.

String

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
Kartenservice-URL der Ausgabe

Die Ausgabe-URL.

String

arcpy.server.ManageMapServerCacheTiles(input_service, scales, update_mode, {num_of_caching_service_instances}, {area_of_interest}, {update_extent}, {wait_for_job_completion}, {portal_url})
NameErläuterungDatentyp
input_service

Der Web-Kachel- oder Kartenbild-Layer, dessen Cache-Kacheln Sie aktualisieren möchten.

Image Service; Map Server
scales
[scales,...]

Die Maßstabsebenen, auf denen Sie beim Ausführen dieses Werkzeugs je nach update_mode Kacheln erstellen oder löschen.

Double
update_mode

Der Modus für die Aktualisierung des Cache.

  • RECREATE_EMPTY_TILESEs werden nur Kacheln erstellt, die leer sind. Vorhandene Kacheln werden unverändert beibehalten. Diese Option ist für Web-Kachel-Layer, die in ArcGIS Online veröffentlicht werden, nicht verfügbar.
  • RECREATE_ALL_TILESVorhandene Kacheln werden ersetzt und neue Kacheln werden hinzugefügt, wenn die Ausdehnung geändert wurde.
  • DELETE_TILESKacheln werden aus dem Cache gelöscht. Die Cache-Ordnerstruktur wird nicht gelöscht.
String
num_of_caching_service_instances
(optional)

Definiert die Anzahl der Instanzen, die zum Aktualisieren/Erstellen der Kacheln verwendet werden. Der Wert für diesen Parameter ist auf unbegrenzt (-1) festgelegt und kann nicht geändert werden.

Long
area_of_interest
(optional)

Definiert einen Interessenbereich, um einzuschränken, wo Kacheln erstellt oder gelöscht werden. Dieser Parameter ist hilfreich, wenn Sie Kacheln für unregelmäßig geformte Bereiche verwalten möchten. Er ist außerdem in Situationen hilfreich, in denen Sie einige Bereiche im Voraus cachen und weniger frequentierte Bereiche ungecacht lassen möchten.

Wenn Sie keinen Wert für diesen Parameter angeben, wird standardmäßig die volle Ausdehnung der Karte verwendet.

Feature Set
update_extent
(optional)

Rechteckige Ausdehnung, bei der Kacheln je nach Wert des Parameters update_mode erstellt oder gelöscht werden. Sie sollten nicht für beide Parameter update_extent und area_of_interest gleichzeitig Werte angeben. Wenn für beide Parameter Werte angegeben werden, wird der Wert für area_of_interest verwendet.

  • MAXOF: Die maximale Ausdehnung aller Eingaben wird verwendet.
  • MINOF: Die kleinste gemeinsame Fläche aller Eingaben wird verwendet.
  • DISPLAY: Die Ausdehnung entspricht der sichtbaren Anzeige.
  • Layer-Name: Die Ausdehnung des angegebenen Layers wird verwendet.
  • Extent-Objekt: Die Ausdehnung des angegebenen Objekts wird verwendet.
  • Durch Leerzeichen getrennte Koordinatenzeichenfolge: Die Ausdehnung der angegebenen Zeichenfolge wird verwendet. Die Koordinaten werden in der Reihenfolge X-Min, Y-Min, X-Max, Y-Max ausgedrückt.
Extent
wait_for_job_completion
(optional)

Mit diesem Parameter können Sie den Fortschritt des Cache-Auftrags überwachen, der im Portal ausgeführt wird.

  • WAITDieses Werkzeug wird weiterhin im Python-Fenster ausgeführt, während der Cache-Auftrag in Portal for ArcGIS oder ArcGIS Online ausgeführt wird. Mit dieser Option können Sie jederzeit detaillierte Fortschrittsberichte anfordern und die Geoverarbeitungs-Meldungen anzeigen, wenn sie auftreten. Dies ist die Standardoption. Diese Option sollten Sie in Python-Skripts verwenden.
  • DO_NOT_WAITDas Geoverarbeitungswerkzeug sendet den Auftrag an den Server, sodass Sie andere Geoverarbeitungs-Tasks ausführen können. Diese Option wird verwendet, wenn Sie einen Cache automatisch beim Veröffentlichen des Service erstellen möchten. Sie können diese Option auch für jeden anderen Cache festlegen, den Sie erstellen. Zum Nachverfolgen des Status eines Cache-Auftrags öffnen Sie ArcMap klicken im Fenster Katalog mit der rechten Maustaste auf den Service, und klicken Sie dann auf Cache-Status anzeigen. Sie können auch die URL verwenden, die in der Ergebnismeldung des Werkzeugs angezeigt wird.
Boolean
portal_url
(optional)

Die URL des Portals.

String

Abgeleitete Ausgabe

NameErläuterungDatentyp
out_job_url

Die Ausgabe-URL.

String

Umgebungen

Sonderfälle

Lizenzinformationen

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

Verwandte Themen