Introducción a arcpy.mp

¿Qué es arcpy.mp?

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 con todas las licencias. Se ha diseñado principalmente para manipular el contenido de los proyectos existentes (.aprx) y los archivos de capas (.lyr o .lyrx). También proporciona funciones para automatizar la exportación y la impresión. Arcpy.mp se puede utilizar para automatizar la producción de mapas y es necesario para crear libros de mapas completos porque incluye funciones para exportar, crear y administrar documentos PDF.

Comprender las funcionalidades de Arcpy.mp es sencillo al describir algunos escenarios que facilita. Aquí se muestran solo algunos de los diversos escenarios que puede lograr un script de Python arcpy.mp:

  • Crear un informe sobre información contenida en proyectos, como capas y sus fuentes de datos, capas con fuentes de datos defectuosas, extensiones de los datos que se muestran o propiedades de elementos del diseño.
  • Actualizar, reparar o sustituir fuentes de datos de capas en un archivo de capa o mapa.
  • Buscar y reemplazar una cadena de texto en todos los diseños de un proyecto.
  • Automatizar el uso compartido de elementos de proyectos que se alojarán en su organización en línea.
  • Crear datos geográficos en lote con comandos de exportación de mapas, como una serie de imágenes GeoTIFF basada en una lista de entidades de un mapa.
  • Crear una variedad de libros de mapas en PDF, por ejemplo, un libro de mapa de referencia o de mapa temático con página de título, varias páginas de mapa y un número indefinido de páginas adicionales con contenido complementario, como informes tabulares y listas de contactos.

¿Para quién es arcpy.mp? ¿Por qué se creó?

Arcpy.mp se creó para analistas y desarrolladores de SIG profesionales. Tradicionalmente, los escenarios que se muestran antes se debían realizar con ArcObjects y solía ser un entorno de programación muy complicado de aprender para el profesional de SIG medio. Arcpy.mp es un modelo de objetos de grano más grueso, es decir, las funciones están diseñadas de tal forma que una sola función de arcpy.mp puede sustituir varias líneas de código de ArcObjects. A continuación, se muestra un ejemplo muy sencillo de cómo se puede utilizar arcpy.mp para hacer referencia a un diseño existente en un proyecto, así como exportarlo a un documento PDF con tan solo tres 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 de arcpy y se requiere para todos los scripts que se ejecutan de forma externa a ArcGIS Pro. La segunda línea hace referencia a un proyecto de ArcGIS Pro en el disco. La tercera línea busca el primer diseño (con un índice basado en cero) con un nombre que comienza con las palabras Atracciones principales. La última línea de código exporta el diseño a PDF con una resolución de salida de 300.

Las mejores formas de comenzar