Beschriftung | Erläuterung | Datentyp |
Eingabekarte | Die Karte, aus der die Kacheln generiert und gepackt werden. | Map |
Paket für ArcGIS Online | Bing Maps | Google Maps | Legt fest, ob das Kachelschema aus einem vorhandenen Kartenservice generiert wird oder ob Kartenkacheln für ArcGIS Online, Bing Maps und Google Maps generiert werden.
| Boolean |
Ausgabedatei | Der Ausgabepfad und der Dateiname für das Kartenkachelpaket. Wenn der Parameter Mehrere Pakete erstellen aktiviert ist, wird dieser Parameter durch den Parameter Ausgabeordner ersetzt, um anzugeben, wo die Kachelpakete generiert werden sollen. | File |
Kachelformat | Gibt das Format an, das für die generierten Kacheln verwendet wird.
| String |
Maximale Detaillierungsebene | Die ganzzahlige Darstellung, die der Anzahl der Maßstabsebenen entspricht, mit denen ein Cache-Kachelschema definiert wird. Dieser Maßstabswert definiert die maximale Ebene, bis zu der die Cache-Kacheln im Kachelpaket generiert werden. Größere Werte stellen größere Maßstäbe dar, die mehr Details anzeigen, aber mehr Speicherplatz erfordern. Kleinere Werte stellen kleinere Maßstäbe dar, die weniger Details anzeigen und weniger Speicherplatz erfordern. Mögliche Werte sind 1 bis 23. Der Standardwert ist 1. Der Wert der maximalen Detaillierungsebene muss größer als der Wert der minimalen Detaillierungsebene sein. | Long |
Service (optional) | Der Name des Kartenservice oder der .xml-Dateien, der/die für das Kachelschema verwendet wird/werden. Dieser Parameter ist nur erforderlich, wenn der Parameter Paket für ArcGIS Online | Bing Maps | Google Maps deaktiviert ist. | Map Server; File |
Zusammenfassung (optional) | Die zusammenfassenden Informationen, die den Eigenschaften des Pakets hinzugefügt werden. | String |
Tags (optional) | Die Tag-Informationen, die den Eigenschaften des Pakets hinzugefügt werden. Es können mehrere Tags – durch ein Komma oder ein Semikolon getrennt – hinzugefügt werden. | String |
Ausdehnung (optional) | Gibt die Ausdehnung an, die zum Auswählen oder Ausschneiden von Features verwendet werden soll.
Wenn die Koordinaten manuell eingegeben wurden, dann müssen die Koordinaten numerische Werte sein und im Koordinatensystem der aktiven Karte liegen. Die Karte kann statt der angegebenen Koordinaten auch andere Anzeigeeinheiten verwenden. Verwenden Sie für die Koordinaten in Richtung Süden und Westen Werte mit negativem Vorzeichen. | Extent |
Komprimierungsqualität (optional) | Ein Wert zwischen 1 und 100 für die JPEG-Komprimierungsqualität. Der Standardwert für das JPEG-Kachelformat ist 75, für die anderen Formate beträgt er 0. Die Komprimierung wird nur für das Format JPEG und gemischte Formate unterstützt. Ein höherer Wert ergibt eine größere Datei mit höherer Bildqualität. Ein niedrigerer Wert ergibt eine kleinere Datei mit niedrigerer Bildqualität. | Long |
Pakettyp (optional) | Gibt den Typ des erstellten Kachelpakets an.
| String |
Minimale Detaillierungsebene (optional) | Die ganzzahlige Darstellung, die der Anzahl der Maßstabsebenen entspricht, mit denen ein Cache-Kachelschema definiert wird. Dieser Maßstabswert definiert die Ebene, ab der Cache-Kacheln verfügbar sind und im Kachelpaket generiert werden. Mögliche Werte sind 0 bis 23. Der Standardwert ist 0. Der Wert der minimalen Detaillierungsebene muss kleiner als oder gleich groß wie der Wert der maximalen Detaillierungsebene sein. | Long |
Interessenbereich (optional) | Ein Feature-Set, mit dem beschränkt wird, wo Kacheln erstellt werden. Verwenden Sie einen Interessenbereich, um Kacheln für Gebiete mit unregelmäßiger Form oder für Multipart-Features zu erstellen. Die Gebiete außerhalb des umgebenden Rechtecks des Interessenbereichs werden nicht gecacht. Wenn für diesen Parameter kein Wert angegeben wird, entspricht der Interessenbereich der vollen Ausdehnung der Eingabekarte. | Feature Set |
Mehrere Pakete erstellen (optional) | Gibt an, ob ein einzelnes großes Kachelpaket oder mehrere kleine Kachelpakete erzeugt werden sollen. Dieser Parameter ist nicht verfügbar, wenn die Umgebungsvariable Faktor für parallele Verarbeitung den Wert 0 hat oder wenn der Parameter Pakettyp auf tpk gesetzt ist.
| Boolean |
Ausgabeordner | Der Speicherort, an dem die Kachelpakete erstellt werden. Wenn der Ausgabeordner nicht leer ist, wird ein Unterordner im Ausgabeordner erstellt, in dem die Kacheln gespeichert werden. Eine automatisch generierte GUID wird als Ordnername verwendet. Wenn der Parameter Mehrere Pakete erstellen nicht aktiviert ist, wird dieser Parameter durch den Parameter Ausgabedatei ersetzt, um den Namen des Kachelpakets anzugeben, das erstellt wird. | Folder |
Zusammenfassung
Generiert Kacheln aus einer Karte und packt sie in ein Kachelpaket oder mehrere kleinere Kachelpakete.
Verwendung
Dieses Werkzeug berücksichtigt die Umgebungsvariable Faktor für parallele Verarbeitung. Wenn der Parameter Mehrere Pakete erstellen aktiviert ist, generiert die parallele Verarbeitung den Cache-Inhalt über mehrere Prozesse hinweg, um die verfügbare CPU zu nutzen und Kachelpakete zu erstellen, wenn der Standardschwellenwert (1 GB) erreicht wird.
Verwenden Sie den Parameter Mehrere Pakete erstellen, wenn Sie mit großen Datenmengen arbeiten. Wenn dieser Parameter aktiviert ist, werden mehrere kleine Kachelpakete anstelle eines einzigen großen Pakets erstellt. Dies ermöglicht es Ihnen, Kachelinhalte mit mehr als 500 GB für einen Auftrag zu generieren und ihn freizugeben oder hochzuladen und in ArcGIS Online als gehosteten Kachel-Layer zu veröffentlichen. Mit diesem Ansatz können Sie große Kachelinhalte als kleine, freizugebende Kachelpakete generieren, ohne die Cache-Ausdehnungen und Ebenen auf mehrere Aufträge aufteilen zu müssen.
Wenn dieser Parameter aktiviert ist, müssen Sie im Parameter Ausgabeordner einen Pfad zu einem leeren Ordner im Dateisystem angeben, in dem die Ausgabepakete gespeichert werden sollen. Sie können Multipart-Pakete nur erstellen, wenn der Parameter Pakettyp auf tpkx festgelegt ist und die Umgebungsvariable "Faktor für parallele Verarbeitung" nicht 0 ist.
Wenn der Parameter Kachelformat auf PNG festgelegt ist, wählt das Werkzeug automatisch das korrekte Format (PNG8, PNG24 oder PNG32) basierend auf dem Wert, der für den Parameter Maximale Detaillierungsebene angegeben ist.
Damit das Werkzeug ausgeführt werden kann, muss die Eingabekarte eine Beschreibung und Tags enthalten. Um eine Beschreibung und Tags hinzuzufügen, klicken Sie im Bereich Inhalt mit der rechten Maustaste auf den Kartennamen, und wählen Sie Eigenschaften aus. Füllen Sie im Dialogfeld Karteneigenschaften auf der Registerkarte Metadaten die Textfelder Tags und Beschreibung aus.
Parameter
arcpy.management.CreateMapTilePackage(in_map, service_type, output_file, format_type, level_of_detail, {service_file}, {summary}, {tags}, {extent}, {compression_quality}, {package_type}, {min_level_of_detail}, {area_of_interest}, {create_multiple_packages}, output_folder)
Name | Erläuterung | Datentyp |
in_map | Die Karte, aus der die Kacheln generiert und gepackt werden. | Map |
service_type | Legt fest, ob das Kachelschema aus einem vorhandenen Kartenservice generiert wird oder ob Kartenkacheln für ArcGIS Online, Bing Maps und Google Maps generiert werden.
| Boolean |
output_file | Der Ausgabepfad und der Dateiname für das Kartenkachelpaket. | File |
format_type | Gibt das Format an, das für die generierten Kacheln verwendet wird.
| String |
level_of_detail | Die ganzzahlige Darstellung, die der Anzahl der Maßstabsebenen entspricht, mit denen ein Cache-Kachelschema definiert wird. Dieser Maßstabswert definiert die maximale Ebene, bis zu der die Cache-Kacheln im Kachelpaket generiert werden. Größere Werte stellen größere Maßstäbe dar, die mehr Details anzeigen, aber mehr Speicherplatz erfordern. Kleinere Werte stellen kleinere Maßstäbe dar, die weniger Details anzeigen und weniger Speicherplatz erfordern. Mögliche Werte sind 1 bis 23. Der Standardwert ist 1. Der Wert der maximalen Detaillierungsebene muss größer als der Wert der minimalen Detaillierungsebene sein. | Long |
service_file (optional) | Der Name des Kartenservice oder der .xml-Dateien, der/die für das Kachelschema verwendet wird/werden. Dieser Parameter ist nur erforderlich, wenn der Parameter service_type auf EXISTING festgelegt ist. | Map Server; File |
summary (optional) | Die zusammenfassenden Informationen, die den Eigenschaften des Pakets hinzugefügt werden. | String |
tags (optional) | Die Tag-Informationen, die den Eigenschaften des Pakets hinzugefügt werden. Es können mehrere Tags – durch ein Komma oder ein Semikolon getrennt – hinzugefügt werden. | String |
extent (optional) | Gibt die Ausdehnung an, die zum Auswählen oder Ausschneiden von Features verwendet werden soll.
| Extent |
compression_quality (optional) | Ein Wert zwischen 1 und 100 für die JPEG-Komprimierungsqualität. Der Standardwert für das JPEG-Kachelformat ist 75, für die anderen Formate beträgt er 0. Die Komprimierung wird nur für das Format JPEG und gemischte Formate unterstützt. Ein höherer Wert ergibt eine größere Datei mit höherer Bildqualität. Ein niedrigerer Wert ergibt eine kleinere Datei mit niedrigerer Bildqualität. | Long |
package_type (optional) | Gibt den Typ des erstellten Kachelpakets an.
| String |
min_level_of_detail (optional) | Die ganzzahlige Darstellung, die der Anzahl der Maßstabsebenen entspricht, mit denen ein Cache-Kachelschema definiert wird. Dieser Maßstabswert definiert die Ebene, ab der Cache-Kacheln verfügbar sind und im Kachelpaket generiert werden. Mögliche Werte sind 0 bis 23. Der Standardwert ist 0. Der Wert der minimalen Detaillierungsebene muss kleiner als oder gleich groß wie der Wert der maximalen Detaillierungsebene sein. | Long |
area_of_interest (optional) | Ein Feature-Set, mit dem beschränkt wird, wo Kacheln erstellt werden. Verwenden Sie einen Interessenbereich, um Kacheln für Gebiete mit unregelmäßiger Form oder für Multipart-Features zu erstellen. Die Gebiete außerhalb des umgebenden Rechtecks des Interessenbereichs werden nicht gecacht. Wenn für diesen Parameter kein Wert angegeben wird, entspricht der Interessenbereich der vollen Ausdehnung der Eingabekarte. | Feature Set |
create_multiple_packages (optional) | Gibt an, ob ein einzelnes großes Kachelpaket oder mehrere kleine Kachelpakete erzeugt werden sollen. Dieser Parameter ist nicht verfügbar, wenn die Umgebungsvariable parallelProcessingFactor auf 0 festgelegt ist oder wenn der Parameter package_type auf tpk festgelegt ist.
| Boolean |
output_folder | Der Ausgabeordner, in dem die Kachelpakete erstellt werden sollen. Wenn der Ausgabeordner nicht leer ist, wird ein Unterordner im Ausgabeordner erstellt, in dem die Kacheln gespeichert werden. Eine automatisch generierte GUID wird als Ordnername verwendet. | Folder |
Codebeispiel
Das folgende Python-Skript veranschaulicht, wie Sie die Funktion CreateMapTilePackage im Python-Fenster verwenden.
import arcpy
arcpy.env.workspace = r"C:\Data\MinMaxLOD\states73K"
aprx = arcpy.mp.ArcGISProject(r"C:\Data\MinMaxLOD\states73K\states73K_1.aprx")
map1 = aprx.listMaps()[0]
arcpy.management.CreateMapTilePackage(map1, "ONLINE", "Example.tpkx", "PNG", "5")
Suchen Sie alle Karten im Projekt und erstellen Sie für jede Karte ein eigenes Kartenkachelpaket.
# Name: CreateMapTilePackage.py
# Description: Find all the maps in the project and
# create a single map tile package for each map
# import system modules
import os
import arcpy
# Set environment settings
arcpy.env.overwriteOutput = True
arcpy.env.workspace = r"C:\Data\MinMaxLOD\states73K"
# Loop through the project, find all the maps, and
# create a single map tile package for each map,
# using the same name as the map
p = arcpy.mp.ArcGISProject("c:\\temp\\myproject.aprx")
extent = ""
aoi = ""
for m in p.listMaps():
print("Packaging " + m.name)
arcpy.management.CreateMapTilePackage(m, "ONLINE", "{}.tpkx".format(m.name),
"PNG", 9, None, "MapSummary", "MapTag", extent, "", "tpkx", 5, aoi)
Es werden mehrere Kartenkachelpakete für eine Karte erstellt.
# Name: CreateMapTilePackage.py
# Description: Create multiple map tile packages for a given map
# import system modules
import os
import arcpy
# Set environment settings
arcpy.env.overwriteOutput = True
arcpy.env.workspace = r"C:\Data\MinMaxLOD\states73K"
# Create multiple map tile packages for given map,
aprx = arcpy.mp.ArcGISProject("c:\\temp\\myproject.aprx")
map1 = aprx.listMaps()[0]
extent = ""
aoi = ""
createMultiplePackages = "create_multiple_packages"
outputFolder = r"C:\11\multi"
arcpy.management.CreateMapTilePackage(map1, "ONLINE", "", "PNG", 9, None, "MapSummary", "MapTag",
extent, "", "tpkx", 5, aoi,createMultiplePackages, outputFolder )
Lizenzinformationen
- Basic: Ja
- Standard: Ja
- Advanced: Ja