Einführung in arcpy.mp

Was ist arcpy.mp?

Arcpy.mp ist ein Python-Submodul, das Bestandteil des ArcPy-Site-Pakets ist. Es wird mit ArcGIS Pro installiert und ist mit allen Lizenzen verfügbar. Es wurde in erster Linie konzipiert, um den Inhalt vorhandener Projekte (.aprx) und Layer-Dateien (.lyr oder .lyrx) zu bearbeiten. Außerdem enthält es Funktionen für das Automatisieren von Vorgängen zum Exportieren und Drucken. Arcpy.mp kann zur Automatisierung der Kartenherstellung verwendet werden und ist erforderlich, um umfassende Kartensammlungen zu erstellen, da es Funktionen zum Exportieren in PDF sowie zum Erstellen und Verwalten von PDF-Dokumenten enthält.

Die Funktionen von Arcpy.mp lassen sich anhand einiger Anwendungsszenarien besser erläutern. Hier nur einige wenige der zahlreichen Szenarien, die ein arcpy.mp-Python-Skript ermöglicht:

• Erstellen Sie einen Bericht zu in Projekten enthaltenen Informationen, beispielsweise zu Layern und deren Datenquellen, zu Layern mit ungültigen Datenquellen, zu den Ausdehnungen der angezeigten Daten oder zu Eigenschaften von Layout-Elementen.
• Aktualisieren, reparieren oder ersetzen Sie Layer-Datenquellen in einer Karte oder einer Layer-Datei.
• Suchen und ersetzen Sie Textzeichenfolgen für alle Layouts in einem Projekt.
• Automatisieren Sie das Freigeben von Projektelementen, die online in Ihrer Organisation gehostet werden sollen.
• Erstellen Sie geographische Daten batchweise unter Verwendung von Kartenexportbefehlen, beispielsweise eine Reihe von GeoTIFF-Bildern anhand einer Liste von Features in einer Karte.
• Erstellen Sie verschiedene PDF-Kartensammlungen, beispielsweise eine Referenzkartensammlung oder eine thematische Kartensammlung mit Titelseite, mehreren Kartenseiten und beliebig vielen zusätzlichen Seiten mit unterstützenden Inhalten wie Tabellenberichten und Kontaktlisten.

Wozu dient arcpy.mp? Warum wurde das Modul erstellt?

Arcpy.mp wurde für professionelle GIS-Analysten und Entwickler erstellt. Traditionell mussten die oben aufgeführten Szenarien mit ArcObjects durchgeführt werden. Für den durchschnittlichen GIS-Profi erwies sich die Programmierumgebung häufig als recht schwierig. Arcpy.mp ist ein einfacheres Objektmodell. Die Funktionen sind so konzipiert, dass eine einzige arcpy.mp-Funktion viele Zeilen ArcObjects-Code ersetzen kann. Nachstehend ist an einem sehr einfachen Beispiel dargestellt, wie arcpy.mp verwendet werden kann, um mit nur drei Zeilen Code ein vorhandenes Layout in einem Projekt zu referenzieren und in ein PDF-Dokument zu exportieren.

import arcpy
aprx = arcpy.mp.ArcGISProject(r"C:\Projects\YosemiteNP\Yosemite.aprx")
lyt = aprx.listLayouts("Main Attractions*")[0]
lyt.exportToPDF(r"C:\Project\YosemiteNP\Output\Yosemite.pdf", resolution = 300)

Mit der ersten Zeile wird das arcpy-Modul geladen. Sie ist für alle Skripte erforderlich, die außerhalb von ArcGIS Pro ausgeführt werden. Die zweite Zeile referenziert ein ArcGIS Pro-Projekt auf der Festplatte. Die dritte Zeile dient zum Auffinden des ersten Layouts mit einem Namen, der mit den Wörtern Main Attractions beginnt. Dazu wird ein nullbasierter Index verwendet. Mit der letzten Codezeile wird das Layout mit einer Ausgabeauflösung von 300 in eine PDF-Datei exportiert.

Empfehlungen für den Einstieg

• Nutzen Sie das Lernprogramm "Erste Schritte mit arcpy.mp".
• Lesen Sie die Richtlinien für arcpy.mp.
• Wenn Sie in früheren Versionen der Software arcpy.mapping verwendet haben und aktuell mit ArcGIS Pro arbeiten, lesen Sie den Abschnitt Migrieren von arcpy.mapping zu ArcGIS Pro.
• Lesen Sie die Abschnitte Alphabetical list of arcpy.mp functions und Alphabetical list of arcpy.mp classes, um die verfügbare Funktionalität kennenzulernen. Sie können diese Abschnitte auch ausdrucken und bei der Skripterstellung mit arcpy.mp nutzen.
• Alle Hilfethemen zu den Funktionen und Klassen von arcpy.mp enthalten detaillierte Erklärungen und Beispiel-Codeausschnitte, die Sie kopieren und direkt in das Python-Fenster einfügen können.