Arcpy.mp es un submódulo de Python que forma parte del paquete del sitio de ArcPy. Se instala con ArcGIS Pro y está disponible para todas las licencias. Se ha diseñado principalmente para manipular el contenido de los proyectos (.aprx) y los archivos de capas (.lyrx) existentes. Puede automatizar el contenido de los proyectos sin tener que abrir la aplicación. En algunos casos, proporciona funciones que no están disponibles para ArcGIS Pro, por ejemplo, arcpy.mp es necesario para crear libros de mapas completos, ya que incluye funciones para exportar, crear y administrar documentos PDF.
Es más fácil entender las capacidades de arcpy.mp mediante la descripción de algunos escenarios que facilita. A continuación, se enumeran algunos de los muchos flujos de trabajo que un script de Python arcpy.mp puede ayudar a realizar:
- Automatizar la exportación de diseños, vistas de mapas, series de mapas e informes
- Crear una variedad de libros de mapas en PDF, por ejemplo, un libro de mapas de referencia o un libro de mapas temático con página de título, varias páginas de mapas y páginas adicionales con contenido complementario, como informes tabulares y listas de contacto.
- Manipular elementos en un diseño como actualizar una imagen, un logotipo de la compañía o actualizar cadenas de texto y mucho más.
- Ampliar las herramientas de secuencia de comandos de geoprocesamiento para trabajar directamente con mapas, diseños y otros elementos de proyecto.
- Programar scripts de inventario que registran información sobre proyectos, datos, fuentes de datos dañadas, conexiones a carpetas y más.
- Actualizar, reparar o reemplazar fuentes de datos de la capa.
- Administrar elementos del proyecto como diseños, mapas, informes, conexiones a carpetas, vistas y más.
- Modificar la simbología de una capa.
- Automatizar el uso compartido de elementos de proyectos que se alojarán en su organización en línea.
Público y propósito previsto
Arcpy.mp se creó para el analista de SIG profesional y para desarrolladores. Tradicionalmente, los escenarios mencionados tenían que realizarse utilizando el SDK .NET, y a menudo resultaba ser un entorno de programación difícil de aprender para el profesional medio de SIG. Arcpy.mp es un modelo de objetos de nivel general, lo que significa que las funciones están diseñadas de tal forma que una sola función puede sustituir a muchas líneas de código .NET de nivel más específico. El siguiente es un ejemplo simple de cómo se puede utilizar arcpy.mp para hacer referencia a un diseño existente en un proyecto y exportarlo a un documento PDF con solo cuatro líneas de código:
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)La primera línea carga el módulo arcpy y se necesita para todas las secuencias de comandos que se ejecutan fuera de ArcGIS Pro. La segunda línea hace referencia a un proyecto de ArcGIS Pro en el disco. La tercera línea encuentra el primer diseño (utilizando un índice basado en cero) con un nombre que comienza por las palabras Main Attractions. La última línea de código exporta el diseño a PDF con una resolución de salida de 300.
Sugerencias para empezar
Las mejores formas de empezar son:
- Pruebe el tutorial Introducción a arcpy.mp.
- Consulte Directrices para arcpy.mp.
- Si utilizó arcpy.mapping en versiones anteriores del software y ahora utiliza ArcGIS Pro, consulte Migrar desde arcpy.mapping a ArcGIS Pro.
- Consulte la lista alfabética de funciones arcpy.mp y la lista alfabética de clases arcpy.mp para familiarizarse con las funciones disponibles. También resulta de gran ayuda disponer de una copia impresa de las mismas al crear scripts con arcpy.mp.
- Todas las funciones de arcpy.mp y los temas de ayuda de clase incluyen explicaciones detalladas y contienen fragmentos de código de muestra que se pueden copiar y pegar directamente en la ventana de Python.
Conceptos más avanzados
La API arcpy.mp existente puede realizar algunas funciones increíbles, pero también hay que entender que no es tan extensa como el SDK de .NET. Si hay algo que deba hacer y que no esté en la API, no significa que no pueda hacerse. La API también se ha diseñado para permitir el acceso a los componentes internos que persisten todo lo que se guarda en un archivo de proyecto o capa. Para obtener más información, consulte el tema de ayuda sobre el acceso a Python CIM.
Visite el sitio de scripts de ejemplo de automatización de mapas de Python, donde encontrará soluciones más avanzadas disponibles para su descarga.