Cache-Kacheln für Kartenserver verwalten (Server)

Zusammenfassung

Erstellt und aktualisiert in einem vorhandenen Web-Kachel-Layer-Cache (in ArcGIS Enterprise oder ArcGIS Online), in Kartenbild-Layern in ArcGIS Enterprise und in gecachten Karten- oder Image-Services auf einem eigenständigen Server Kacheln. 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 festlegen.

Parameter

BeschriftungErläuterungDatentyp
Eingabeservice

Der Web-Kachel-Layer, Web-Bilddaten-Layer oder Kartenbild-Layer, dessen Cache-Kacheln aktualisiert werden.

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 in ArcGIS AllSource nicht geändert werden.

Double
Aktualisierungsmodus

Legt den Modus fest, der zum Aktualisieren der Kacheln verwendet wird.

  • 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)
Long
Interessenbereich
(optional)

Ein Interessenbereich, der einschränkt, wo Kacheln erstellt oder gelöscht werden. Dieser Parameter ist bei der Verwaltung von unregelmäßig geformten Bereichen hilfreich. Zudem ist er für das Vorab-Caching von bestimmten Bereichen nützlich, wobei weniger frequentierte Bereiche ungecacht gelassen werden.

Wenn Sie keinen Wert für diesen Parameter angeben, wird als Standardwert die volle Ausdehnung der Karte verwendet.

Feature Set
Aktualisierungsausdehnung
(optional)

Eine rechteckige Ausdehnung, bei der Kacheln je nach Wert des Parameters Aktualisierungsmodus erstellt oder gelöscht werden. Wenn der Parameter Aktualisierungsausdehnung als auch der Parameter Interessenbereich angegeben ist, wird der Wert für Interessenbereich verwendet.

  • Aktuelle Anzeigeausdehnung Kartenansicht: Die Ausdehnung basiert auf der aktiven Karte oder Szene. Diese Option ist nur verfügbar, wenn eine aktive Karte vorhanden ist.
  • Ausdehnung darstellen Draw Extent: Die Ausdehnung basiert auf einem Rechteck, das auf der Karte oder Szene aufgezogen wurde. Bei dieser Option wird eine Feature-Class in der Projekt-Geodatabase erstellt und ein Layer zur Karte hinzugefügt. Das Koordinatensystem der Feature-Class stimmt mit dem der Karte überein.
    Hinweis:

    Diese Option ist im Dialogfeld Umgebungen nicht verfügbar. Sie ist nur über einen Werkzeugparameter mit dem Datentyp "Ausdehnung" oder über die Registerkarte Umgebungen eines Werkzeugdialogfeldes verfügbar.

    Hinweis:

    Wenn die Bearbeitungsoption Bearbeitung über die Registerkarte "Bearbeiten" aktivieren und deaktivieren aktiviert ist, dann müssen Sie auf der Registerkarte Bearbeiten des Menübands die Bearbeitung aktivieren, um die Ausdehnung darzustellen.

  • Ausdehnung eines Layers:Layer Die Ausdehnung basiert auf einem aktiven Karten-Layer. Verwenden Sie die Dropdown-Liste, um einen verfügbaren Layer auszuwählen, oder verwenden Sie die Option Ausdehnung von Daten in allen Layern, um die kombinierte Ausdehnung aller aktiven Karten-Layer mit Ausnahme der Grundkarte zu erhalten. Diese Option ist nur verfügbar, wenn eine aktive Karte mit Layern vorhanden ist.

    Jeder Karten-Layer bietet die folgenden Optionen:

    • Alle Features Alles auswählen: Die Ausdehnung aller Features im Layer.
    • Ausgewählte FeaturesArea from Selected Features: Die Ausdehnung der ausgewählten Features im Layer.
    • Sichtbare Features Extent Indicator: Die Ausdehnung der sichtbaren Features im Layer.
      Hinweis:

      Die Ausdehnungen der Optionen Ausgewählte Features Area from Selected Features und Sichtbare Features Extent Indicator sind nur für Feature-Layer verfügbar.

  • Durchsuchen:Durchsuchen Die Ausdehnung basiert auf einem vorhandenen Dataset.
  • Zwischenablage Einfügen: Die Ausdehnung kann in die Zwischenablage kopiert und aus der Zwischenablage eingefügt werden.
    • Ausdehnung kopieren Kopieren: Kopiert die Ausdehnungskoordinaten und das Ausdehnungskoordinatensystem in die Zwischenablage.
    • Ausdehnung einfügen Einfügen: Fügt die Ausdehnungskoordinaten und optional das Koordinatensystem aus der Zwischenablage ein. Wenn die Werte in der Zwischenablage kein Koordinatensystem beinhalten, wird für die Ausdehnung das Koordinatensystem der Karte verwendet.
    Hinweis:

    Beim Kopieren der Ausdehnungskoordinaten in die und Einfügen aus der Zwischenablage wird dieselbe Formatierung und Reihenfolge wie beim ArcPy-Objekt Extent verwendet: X-Min, Y-Min, X-Max, Y-Max und der Raumbezug.

  • Ausdehnung zurücksetzen: ZurücksetzenDie Ausdehnung wird auf den Standardwert zurückgesetzt.
  • Manuell eingegebene Koordinaten: Die Koordinaten müssen numerische Werte sein und im Koordinatensystem der aktiven Karte liegen.
    Vorsicht:

    Die Karte kann statt der eingegebenen Koordinaten auch andere Anzeigeeinheiten verwenden. Die Verwendung einer Kardinalrichtung (N, S, O, W) wird nicht unterstützt. Verwenden Sie für die Koordinaten in Richtung Süden und Westen Werte mit negativem Vorzeichen.

Extent
Auf Auftragsabschluss warten
(optional)

Gibt an, ob das Werkzeug weiter ausgeführt wird, während der Cache-Auftrag in ArcGIS Online oder Portal for ArcGIS ausgeführt wird.

  • Aktiviert: Das Werkzeug wird weiterhin ausgeführt, während der Cache-Auftrag in ArcGIS Online oder Portal for ArcGIS ausgeführt wird. Mit dieser Option können Sie jederzeit detaillierte Fortschrittsberichte anfordern und die Geoverarbeitungsmeldungen anzeigen, wenn sie auftreten. Dies ist die Standardeinstellung.
  • Deaktiviert: Ein Auftrag wird an das Portal übermittelt, wo Sie in ArcGIS AllSource weitere Geoverarbeitungs-Tasks ausführen oder ArcGIS Pro schließen können. Nutzen Sie diese Option, wenn Sie bei der Veröffentlichung des Service automatisch einen Cache erstellen. Sie können diese Option auch für jeden anderen Cache, den Sie erstellen, festlegen.
Boolean
Portal-URL
(optional)

Die URL des Portals.

String

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
Kartenservice-URL der Ausgabe

Die Ausgabe-URL.

String

arcpy.management.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-Layer, Web-Bilddaten-Layer oder Kartenbild-Layer, dessen Cache-Kacheln aktualisiert werden.

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

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

Double
update_mode

Legt den Modus fest, der zum Aktualisieren der Kacheln verwendet wird.

  • 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)
Long
area_of_interest
(optional)

Ein Interessenbereich, der einschränkt, wo Kacheln erstellt oder gelöscht werden. Dieser Parameter ist bei der Verwaltung von unregelmäßig geformten Bereichen hilfreich. Zudem ist er für das Vorab-Caching von bestimmten Bereichen nützlich, wobei weniger frequentierte Bereiche ungecacht gelassen werden.

Wenn Sie keinen Wert für diesen Parameter angeben, wird als Standardwert die volle Ausdehnung der Karte verwendet.

Feature Set
update_extent
(optional)

Eine rechteckige Ausdehnung, bei der Kacheln je nach Wert des Parameters update_mode erstellt oder gelöscht werden. Wenn der Parameter update_extent als auch der Parameter area_of_interest angegeben ist, wird der Wert für area_of_interest verwendet.

  • MAXOF: Die maximale Ausdehnung aller Eingaben wird verwendet.
  • MINOF: Die minimale 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)

Gibt an, ob das Werkzeug weiter ausgeführt wird, während der Cache-Auftrag in ArcGIS Online oder Portal for ArcGIS ausgeführt wird.

  • WAITDas Werkzeug wird weiterhin ausgeführt, während der Cache-Auftrag in ArcGIS Online oder Portal for ArcGIS ausgeführt wird. Mit dieser Option können Sie jederzeit detaillierte Fortschrittsberichte anfordern und die Geoverarbeitungsmeldungen anzeigen, wenn sie auftreten. Dies ist die Standardeinstellung. Diese Option sollten Sie in Python-Skripts verwenden.
  • DO_NOT_WAITEin Auftrag wird an den Server übermittelt, sodass Sie weitere Geoverarbeitungs-Tasks ausführen können. Nutzen Sie diese Option, wenn Sie bei der Veröffentlichung des Service automatisch einen Cache erstellen. Sie können diese Option auch für jeden anderen Cache, den Sie erstellen, festlegen.
Boolean
portal_url
(optional)

Die URL des Portals.

String

Abgeleitete Ausgabe

NameErläuterungDatentyp
out_job_url

Die Ausgabe-URL.

String