Kachel-Cache verwalten (Data Management)

Zusammenfassung

Erstellt einen Kachel-Cache oder aktualisiert Kacheln in einem vorhandenen Kachel-Cache. Sie können dieses Werkzeug verwenden, um Kacheln zu erstellen, fehlende Kacheln zu ersetzen, veraltete Kacheln zu überschreiben und neue Kacheln hinzuzufügen.

Verwendung

  • Wenn ein Kachel-Cache mit diesem Werkzeug erstellt wird und für den Parameter Interessenbereich kein Wert angegeben wurde, wird der Cache mit der vollen Ausdehnung des Quell-Rasters bzw. Mosaik-Datasets oder der aktuellen Ausdehnung der Kartendatei erstellt.

  • Die Ausdehnung des erstellten Cache kann größer sein als der Wert des Parameters Interessenbereich. In diesem Fall unterteilt das Werkzeug die Daten in größere Bereiche, sogenannte Superkacheln, bevor sie auf Kacheln der angegebenen Größe zugeschnitten werden. Wenn der Parameterwert Eingabe-Datenquelle Antialiasing verwendet, hat die Superkachel das Format 2.048 x 2.048 Pixel; ansonsten beträgt ihr Format 4.096 x 4.096 Pixel. Wenn der angegebene Interessenbereich die Grenze einer Superkachel schneidet, wird die gesamte Superkachel erstellt. Dies bedeutet, dass Sie die Ansicht möglicherweise vergrößern müssen, bevor sich das Caching basierend auf einer Feature-Class in Form von Zeit- und Speicherplatzeinsparungen erst wirklich bemerkbar macht. Bei mehreren Interessenbereichen, die den größten Teil des Parameterwertes Eingabe-Datenquelle abdecken, zeigt das Caching basierend auf der Feature-Class möglicherweise keine große Wirkung, da die meisten Features eine Superkachel schneiden.

  • Um einen Cache in einem benutzerdefinierten Kachelschema zu erstellen, müssen Sie vor der Verwendung dieses Werkzeugs sicherstellen, dass ein Kachelschema für das Quellen-Dataset definiert wurde. Sie können das Werkzeug Kachelschema für Kachel-Cache erstellen verwenden, um das Kachelschema zu erstellen.

  • Um einen Cache in einem ArcGIS Online-Kachelschema zu erstellen, legen Sie ArcGIS Online-Schema für den Parameter Eingabekachelschema fest.

  • Die Ausführung dieses Werkzeugs kann für Caches, die eine große geographische Ausdehnung oder sehr große Maßstabsebenen abdecken, 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 jederzeit abbrechen können. Falls Sie es später für denselben Cache erneut ausführen und Fehlende Kacheln erstellen für den Parameter Verwaltungsmodus angeben, wird es an dem Punkt fortgesetzt, an dem es abgebrochen wurde.

  • Dieses Werkzeug unterstützt die Umgebungseinstellung "Parallele Verarbeitung".

  • Wenn der Parameter Sofort einsatzfähiges Format aktiviert ist, wird der Cache-Inhalt mithilfe der offenen Kachelpaketspezifikation generiert. Das Cache-Format lautet Compact V2, das Cache-Schema wird jedoch im JSON- und nicht im XML-Format gespeichert. Weitere Informationen zum sofort einsatzfähigen Format finden Sie unter Veröffentlichen eines Kachel-Layers aus einem Cache-Dataset.

Parameter

BeschriftungErläuterungDatentyp
Cache-Verzeichnis

Der Ordner, in dem das Cache-Dataset erstellt wird, der Raster-Layer oder der Pfad zu einem vorhandenen Kachel-Cache.

Folder; Raster Layer
Verwaltungsmodus

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

  • Alle Kacheln neu erstellenVorhandene Kacheln werden ersetzt, und neue Kacheln werden hinzugefügt, wenn die Ausdehnung geändert wurde oder einem Multilayer-Cache neue Layer hinzugefügt wurden.
  • Fehlende Kacheln erstellenEs werden nur Kacheln erstellt, die leer sind. Vorhandene Kacheln werden unverändert beibehalten.
  • Kacheln löschenKacheln werden aus dem Cache gelöscht. Die Cache-Ordnerstruktur wird nicht gelöscht.
String
Cache-Name
(optional)

Der Name des Cache-Datasets, das im Cache-Verzeichnis erstellt wird.

String
Eingabe-Datenquelle
(optional)

Ein Raster-Dataset, ein Mosaik-Dataset oder eine Kartendatei.

Dieser Parameter ist nicht erforderlich, wenn der Parameter Verwaltungsmodus auf Kacheln löschen festgelegt ist.

Eine Kartendatei (.mapx) kann keinen Karten- oder Image-Service enthalten.

Mosaic Layer; Raster Layer; Map
Eingabe-Kachelschema
(optional)

Gibt das zu verwendende Kachelschema an.

  • ArcGIS Online-SchemaIn diesem Fall wird das in ArcGIS Online festgelegte Standard-Kachelschema verwendet.
  • Schema importierenIn diesem Fall wird ein vorhandenes Kachelschema importiert und verwendet.
  • Höhen-KachelschemaIn diesem Fall wird das in Höhenservices festgelegte Kachelschema verwendet.
  • Kachelschema von WGS84, Version 2In diesem Fall wird das in WGS84, Version 2 festgelegte Kachelschema verwendet.
  • Höhen-Kachelschema von WGS84, Version 2In diesem Fall wird das in WGS84, Version 2 festgelegte Kachelschema verwendet, um einen Kachel-Cache für Höhendaten zu erstellen.
String
Kachelschema importieren
(optional)

Der Pfad zu einer vorhandenen Schemadatei (.xml) oder zu einem Kachelschema, das aus einem vorhandenen Image-Service oder Karten-Service importiert wurde.

Image Service; Map Server; File
Maßstäbe [Pixelgröße] (Geschätzter Speicherplatz)
(optional)

Die Maßstabsebenen, auf denen Kacheln je nach Wert des Parameters Verwaltungsmodus erstellt oder gelöscht werden sollen. Die Pixelgröße basiert auf dem Raumbezug des Kachelschemas.

  • Standardmäßig werden nur die Werte für Gecachter Mindestmaßstab und Gecachter Maximalmaßstab verwendet.
  • Wenn Sie den Wert des Parameters Gecachter Mindestmaßstab oder des Parameters Gecachter Maximalmaßstab ändern, werden die entsprechenden Maßstabswerte aktiviert bzw. deaktiviert.
  • Aktivierte Maßstäbe, die sich nicht innerhalb des Bereichs der Werte der Parameter Gecachter Mindestmaßstab oder Gecachter Maximalmaßstab befinden, werden beim Erstellen des Cache ignoriert.
Double
Interessenbereich
(optional)

Ein Interessenbereich, der verwendet wird, um einzuschränken, wo Kacheln erstellt oder gelöscht werden.

Dabei kann es sich um eine Feature-Class oder um ein Feature-Set handeln, die bzw. das Sie interaktiv definieren.

Dieser Parameter ist hilfreich, wenn Sie Kacheln für unregelmäßig geformte Bereiche verwalten möchten. Er ist außerdem hilfreich, wenn Sie einige Bereiche im Voraus cachen und weniger frequentierte Bereiche ungecacht lassen möchten.

Feature Set
Maximale Größe der Quellenzellen
(optional)

Der Wert, der die Sichtbarkeit der Datenquelle definiert, für die der Cache erstellt wird. Der Wert ist standardmäßig leer.

Wenn dieser Wert leer ist, gilt Folgendes:

  • Für Cache-Ebenen, die innerhalb der Sichtbarkeitsbereiche der Datenquelle liegen, wird der Cache aus der Datenquelle erstellt.
  • Für Cache-Ebenen, die außerhalb der Sichtbarkeitsbereiche der Datenquelle liegen, wird der Cache aus der vorherigen Cache-Ebene erstellt.

Wenn dieser Wert größer als 0 ist, gilt Folgendes:

  • Für Ebenen mit Zellengrößen, die kleiner als oder gleich diesem Parameterwert sind, wird der Cache aus der Datenquelle generiert.
  • Für Ebenen mit Zellengrößen, die größer als dieser Parameterwert sind, wird der Cache aus der vorherigen Cache-Ebene generiert.

Die Maßeinheit dieses Parameterwertes sollte mit der Maßeinheit der Zellengröße des Quellen-Datasets übereinstimmen.

Double
Gecachter Mindestmaßstab
(optional)

Der minimale Maßstab, in dem Kacheln erstellt werden. Dies muss nicht der kleinste Maßstab im Kachelschema sein. Anhand des gecachten Minimalmaßstabs wird festgelegt, welche Maßstäbe beim Erstellen des Cache verwendet werden.

Double
Gecachter Maximalmaßstab
(optional)

Der Maximalmaßstab, in dem Kacheln erstellt werden. Dies muss nicht der größte Maßstab im Kachelschema sein. Anhand des gecachten Maximalmaßstabs wird festgelegt, welche Maßstäbe beim Erstellen des Cache verwendet werden.

Double
Sofort einsatzfähiges Format
(optional)

Gibt an, ob der Cache-Inhalt mithilfe der offenen Kachelpaketspezifikation generiert wird, und bestimmt auch das Dateiformat des Cache-Schemas.

  • Aktiviert: Der Cache-Inhalt wird mithilfe der offenen Kachelpaketspezifikation generiert. Ein Kachelpaket kann für Offline-Workflows in ein ZIP-Archiv gepackt werden. Das Cache-Format lautet Compact V2, und das Cache-Schema wird im JSON-Format gespeichert.
  • Deaktiviert: Der Cache-Inhalt wird mit einem im XML-Format gespeicherten Schema generiert. Dies ist die Standardeinstellung.

Boolean

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
Cache-Name

Das im Cache-Ausgabeverzeichnis, das im Cache-Dataset erstellt werden soll.

Raster Dataset

arcpy.management.ManageTileCache(in_cache_location, manage_mode, {in_cache_name}, {in_datasource}, {tiling_scheme}, {import_tiling_scheme}, {scales}, {area_of_interest}, {max_cell_size}, {min_cached_scale}, {max_cached_scale}, {ready_to_serve_format})
NameErläuterungDatentyp
in_cache_location

Der Ordner, in dem das Cache-Dataset erstellt wird, der Raster-Layer oder der Pfad zu einem vorhandenen Kachel-Cache.

Folder; Raster Layer
manage_mode

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

  • RECREATE_ALL_TILESVorhandene Kacheln werden ersetzt, und neue Kacheln werden hinzugefügt, wenn die Ausdehnung geändert wurde oder einem Multilayer-Cache neue Layer hinzugefügt wurden.
  • RECREATE_EMPTY_TILESEs werden nur Kacheln erstellt, die leer sind. Vorhandene Kacheln werden unverändert beibehalten.
  • DELETE_TILESKacheln werden aus dem Cache gelöscht. Die Cache-Ordnerstruktur wird nicht gelöscht.
String
in_cache_name
(optional)

Der Name des Cache-Datasets, das im Cache-Verzeichnis erstellt wird.

String
in_datasource
(optional)

Ein Raster-Dataset, ein Mosaik-Dataset oder eine Kartendatei.

Dieser Parameter ist nicht erforderlich, wenn der Parameter manage_mode auf DELETE_TILES festgelegt ist.

Eine Kartendatei (.mapx) kann keinen Karten- oder Image-Service enthalten.

Mosaic Layer; Raster Layer; Map
tiling_scheme
(optional)

Gibt das zu verwendende Kachelschema an.

  • ARCGISONLINE_SCHEMEIn diesem Fall wird das in ArcGIS Online festgelegte Standard-Kachelschema verwendet.
  • IMPORT_SCHEMEIn diesem Fall wird ein vorhandenes Kachelschema importiert und verwendet.
  • ARCGISONLINE_ELEVATION_SCHEMEIn diesem Fall wird das in Höhenservices festgelegte Kachelschema verwendet.
  • WGS84_V2_SCHEMEIn diesem Fall wird das in WGS84, Version 2 festgelegte Kachelschema verwendet.
  • WGS84_V2_ELEVATION_SCHEMEIn diesem Fall wird das in WGS84, Version 2 festgelegte Kachelschema verwendet, um einen Kachel-Cache für Höhendaten zu erstellen.
String
import_tiling_scheme
(optional)

Der Pfad zu einer vorhandenen Schemadatei (.xml) oder zu einem Kachelschema, das aus einem vorhandenen Image-Service oder Karten-Service importiert wurde.

Image Service; Map Server; File
scales
[scale,...]
(optional)

Die Maßstabsebenen, auf denen Kacheln je nach Wert des Parameters manage_mode erstellt oder gelöscht werden sollen. Die Pixelgröße basiert auf dem Raumbezug des Kachelschemas.

  • Standardmäßig werden beim Erstellen des Cache nur die Werte verwendet, die zwischen min_cached_scale und max_cached_scale liegen.
  • Wenn Sie den Wert des Parameters min_cached_scale oder des Parameters max_cached_scale ändern, werden die zum Generieren des Cache verwendeten Maßstäbe ebenfalls geändert.
  • Vorhandene Maßstäbe, die nicht innerhalb des Bereichs der Werte der Parameter min_cached_scale oder max_cached_scale liegen, werden beim Erstellen des Cache ignoriert.
Double
area_of_interest
(optional)

Ein Interessenbereich, der verwendet wird, um einzuschränken, wo Kacheln erstellt oder gelöscht werden.

Dabei kann es sich um eine Feature-Class oder um ein Feature-Set handeln, die bzw. das Sie interaktiv definieren.

Dieser Parameter ist hilfreich, wenn Sie Kacheln für unregelmäßig geformte Bereiche verwalten möchten. Er ist außerdem hilfreich, wenn Sie einige Bereiche im Voraus cachen und weniger frequentierte Bereiche ungecacht lassen möchten.

Feature Set
max_cell_size
(optional)

Der Wert, der die Sichtbarkeit der Datenquelle definiert, für die der Cache erstellt wird. Der Wert ist standardmäßig leer.

Wenn dieser Wert leer ist, gilt Folgendes:

  • Für Cache-Ebenen, die innerhalb der Sichtbarkeitsbereiche der Datenquelle liegen, wird der Cache aus der Datenquelle erstellt.
  • Für Cache-Ebenen, die außerhalb der Sichtbarkeitsbereiche der Datenquelle liegen, wird der Cache aus der vorherigen Cache-Ebene erstellt.

Wenn dieser Wert größer als 0 ist, gilt Folgendes:

  • Für Ebenen mit Zellengrößen, die kleiner als oder gleich diesem Parameterwert sind, wird der Cache aus der Datenquelle generiert.
  • Für Ebenen mit Zellengrößen, die größer als dieser Parameterwert sind, wird der Cache aus der vorherigen Cache-Ebene generiert.

Die Maßeinheit dieses Parameterwertes sollte mit der Maßeinheit der Zellengröße des Quellen-Datasets übereinstimmen.

Double
min_cached_scale
(optional)

Der minimale Maßstab, in dem Kacheln erstellt werden. Dies muss nicht der kleinste Maßstab im Kachelschema sein. Anhand des gecachten Minimalmaßstabs wird festgelegt, welche Maßstäbe beim Erstellen des Cache verwendet werden.

Double
max_cached_scale
(optional)

Der Maximalmaßstab, in dem Kacheln erstellt werden. Dies muss nicht der größte Maßstab im Kachelschema sein. Anhand des gecachten Maximalmaßstabs wird festgelegt, welche Maßstäbe beim Erstellen des Cache verwendet werden.

Double
ready_to_serve_format
(optional)

Gibt an, ob der Cache-Inhalt mithilfe der offenen Kachelpaketspezifikation generiert wird, und bestimmt auch das Dateiformat des Cache-Schemas.

  • READY_TO_SERVE_FORMATDer Cache-Inhalt wird mithilfe der offenen Kachelpaketspezifikation (https://github.com/Esri/tile-package-spec) generiert. Ein Kachelpaket kann für Offline-Workflows in ein ZIP-Archiv gepackt werden. Das Cache-Format lautet Compact V2, und das Cache-Schema wird im JSON-Format gespeichert.
  • NON_READY_TO_SERVE_FORMATDer Cache-Inhalt wird mit einem im XML-Format gespeicherten Schema generiert. Dies ist die Standardeinstellung.
Boolean

Abgeleitete Ausgabe

NameErläuterungDatentyp
out_cache_location

Das im Cache-Ausgabeverzeichnis, das im Cache-Dataset erstellt werden soll.

Raster Dataset

Codebeispiel

ManageTileCache: Beispiel 1 (Python-Fenster)

Dies ist ein Python-Beispiel für die Funktion ManageTileCache.

import arcpy
            
arcpy.ManageTileCache_management(
      "C:/CacheDatasets/Manage", "RECREATE_ALL_TILES", "Test",
      "C:/Data/Cache.gdb/Md", "IMPORT_SCHEME", "C:/Data/Cache.gdb/Md",
      "#", "#", "#", "40000", "2000", "NON_READY_TO_SERVE_FORMAT")
ManageTileCache: Beispiel 2 (eigenständiges Skript)

Dies ist ein Python-Skriptbeispiel für die Funktion ManageTileCache.

#Generate tile cache for 3 out of 5 levels defined in tiling scheme

import arcpy

folder = "C:/Workspace/CacheDatasets/Manage"
mode = "RECREATE_ALL_TILES"
cacheName = "Test"
dataSource = "C:/Workspace/Cache.gdb/md"
method = "IMPORT_SCHEME"
tilingScheme = "C:/Workspace/Schemes/Tilingscheme.xml"
scales = "16000;8000;4000;2000;1000"
areaofinterest = "#"
maxcellsize = "#"
mincachedscale = "8000"
maxcachedscale = "2000"
ready_to_serve_format="NON_READY_TO_SERVE_FORMAT"

arcpy.ManageTileCache_management(
       folder, mode, cacheName, dataSource, method, tilingScheme,
       scales, areaofinterest, maxcellsize, mincachedscale, maxcachedscale, ready_to_serve_format)

Umgebungen

Sonderfälle

Faktor für parallele Verarbeitung

Wenn der Wert "Faktor für parallele Verarbeitung" leer ist, wird das Werkzeug mit dem Standardwert "50 Prozent" (die Hälfte der verfügbaren Kerne) ausgeführt.

Lizenzinformationen

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

Verwandte Themen