Introduction à arcpy.mp

Arcpy.mp est un sous-module Python appartenant au paquetage de site ArcPy. Il est installé avec ArcGIS Pro et accessible à tous les types de licences. Il a été conçu dans le but de manipuler le contenu de projets (.aprx) et de fichiers de couche (.lyrx) existants. Vous pouvez automatiser le contenu des projets sans même avoir à ouvrir l’application. Dans certains cas, il fournit des fonctionnalités non disponibles avec ArcGIS Pro. Par exemple, arcpy.mp est requis pour générer des atlas complets, car il comprend des fonctions d’exportation, de création et de gestion des documents PDF.

Décrire certains des scénarios possibles permet de mieux comprendre les fonctionnalités offertes par arcpy.mp. Voici quelques uns des nombreux processus qu’un script Python arcpy.mp peut vous aider à exécuter :

• Automatiser l’exportation de mises en page, de vues cartographiques, de séries de cartes et de rapports.
• Générer plusieurs atlas au format PDF, comme un atlas de référence ou un atlas thématique comportant une page de titre et plusieurs pages de cartes ainsi qu’un nombre indéfini de pages additionnelles proposant du contenu complémentaire, comme des rapports tabulaires et des listes de contact.
• Manipuler les éléments d’une mise en page (par exemple, mettre à jour une image, un logo d’entreprise ou des chaînes de texte et bien plus encore.
• Étendre des outils de script de géotraitement pour utiliser directement des cartes, des mises en page et d’autres éléments de projet.
• Scripts d’inventaire qui consignent des informations sur les projets, les données, les sources de données endommagées, les connexions à des dossiers, etc.
• Mettre à jour, réparer ou remplacer des sources de données.
• Gérer des éléments de projet tels que des mises en page, des cartes, des rapports, des connexions à des dossiers, des vues et davantage.
• Modifier la symbologie d’une couche.
• Automatiser le partage des éléments de projet à héberger en ligne dans votre organisation.

Public cible et objectif

Arcpy.mp a été conçu pour les analystes et développeurs SIG professionnels. À l’origine, les scénarios répertoriés ci-dessus devaient être réalisés à l’aide du SDK .NET, lequel s’avérait être un environnement de programmation difficile à apprendre pour la plupart des professionnels du SIG. Arcpy.mp est un modèle d’objet plus rudimentaire, ce qui signifie que les fonctions sont conçues pour remplacer de nombreuses lignes de code .NET. Voici un exemple simple de la façon dont arcpy.mp permet de référencer une mise en page existante dans un projet et de l’exporter au format PDF en utilisant simplement quatre lignes de code :

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 première ligne charge le module arcpy et est requise pour tous les scripts exécutés en dehors d’ArcGIS Pro. La seconde ligne référence un projet ArcGIS Pro sur le disque. La troisième ligne recherche la première mise en page (à l’aide d’un index en base zéro) dont le nom commence par les mots Main Attractions. La dernière ligne de code exporte la mise en page au format PDF avec une résolution en sortie de 300.

Conseils de prise en main

Les meilleures façons de commencer comprennent ce qui suit :

• Suivez le didacticiel Prise en main d’arcpy.mp.
• Révisez les Instructions concernant arcpy.mp.
• Si vous avez utilisé des versions antérieures du logiciel arcpy.mapping et que vous utilisez maintenant ArcGIS Pro, consultez la rubrique Migration d’arcpy.mapping à ArcGIS Pro.
• Révisez la Liste alphabétique des fonctions arcpy.mp et la Liste alphabétique des classes arcpy.mp pour vous familiariser avec les fonctionnalités disponibles. Ces impressions sont également utiles pour écrire des scripts avec arcpy.mp.
• Toutes les rubriques d’aide concernant les classes et les fonctions arcpy.mp contiennent des explications détaillées et des extraits de code qu’il est possible de copier et coller directement dans la fenêtre Python.

Au-delà des concepts de base

L’API arcpy.mp existante peut exécuter des fonctionnalités incroyables, sans cependant être aussi extensible que le SDK .NET. S’il vous faut effectuer une tâche ne figurant pas dans l’API, cela ne signifie pas que cette tâche est impossible à réaliser. L’API a également été conçue pour autoriser un accès aux composants internes qui conservent toutes les données enregistrées dans un fichier de couche ou de projet. Pour plus d’informations, reportez-vous à la rubrique d’aide Accès au CIM par Python.

Rendez-vous sur le site Exemples de scripts d’automatisation de carte Python, sur lequel vous pourrez télécharger des solutions plus avancées.