La version 2.4.0 de l'API Python d'ArcGIS est disponible depuis fin septembre
2024. Cette nouvelle version propose une API plus moderne et proposant une
meilleure prise en main, en introduisant des nouveautés, des améliorations
ainsi que des corrections de bugs. Je vous propose de découvrir les
changements majeurs dans cet article.
Nouveau widget de carte pour améliorer la cartographie et la visualisation.
Le widget map du module arcgis.mappig est très populaire parmi les
utilisateurs de l'API car il permet de visualiser les données spatiales
et les résultats d'analyse dans des webmaps interactives directement dans un
Notebook. Nous en avions parlé
dans cet article
durant l'été. En version 2.4.0, une nouvelle version plus moderne de ce widget
a été ajoutée à l'API. Voici les différences à noter :
- Les anciens modules arcgis.mapping et arcgis.widget sont désormais dépréciés et ont été refactorés dans un unique module arcgis.map.
- Vous pouvez utiliser l'API pour concevoir et visualiser vos carte via ce widget directement dans un notebook (ajouter des couches, modifier la symbologie, changer le fond de carte, ajouter des géosignets...) puis sauvegarder ces cartes en tant que webmaps et les consommer directement dans le Map Viewer et les autres applications du système ArcGIS.
- Le nouveau widget de carte vous offre une validation interne lors de la création de fenêtres contextuelles, d'éléments de rendu et de symboles.
- Dans la version 2.4.0 (et les suivantes), le nouveau widget de carte prend en charge la dernière version de l'API JavaScript d'ArcGIS, ce qui vous permet de tirer parti des dernières capacités de l'API JavaScript.
- Le nouveau widget de carte fonctionne également avec la nouvelle génération du Jupyter Notebook (Jupyter Notebook 7 et JupyterLab 4). Avec les prochaines versions d'ArcGIS Pro 3.4, ArcGIS Enterprise 11.4 et la mise à jour d'ArcGIS Online de novembre 2024, tous les produits ArcGIS Notebooks seront basés sur Jupyter Notebook 7, ce qui signifie qu'ils seront compatibles avec le nouveau widget cartographique.
Dans le code ci-dessous, vous pourrez noter la différence dans
l'initialisation de la web map entre l'ancien widget de carte et le nouveau :
Initialisation de la web map en version 2.3.x et antérieures |
Initiation de la web map à partir de la 2.4.0 |
Note : Si vous souhaitez continuer à utiliser Jupyter Notebook 6, vous devrez rester à la version 2.3.1. Si vous utilisez l'ancien widget de carte dans votre code et que vous passez à la version 2.4.0, vous devrez procéder à une migration de votre code.
Vous devrez peut-être également ajuster une partie de votre code si vous
utilisez ArcGIS Notebooks et décidez de
modifier ou mettre à jour le runtime de votre notebook
vers la version 11.0, car il sera livré avec l'API Python 2.4.0.
Veuillez vous référer à
cette documentation
pour les meilleures pratiques, les extraits de code et une comparaison des
fonctionnalités lors de cette migration.
Nouvelle classe Service pour un accès simplifié aux services SIG
L'objectif fondamental de l'API ArcGIS pour Python est d'être « l'API Python
de votre SIG Web ». En d'autres termes, elle fournit un moyen Python
d'interagir avec les services REST d'ArcGIS à partir d'ArcGIS Online ou
d'ArcGIS Enterprise.
Au sein d'ArcGIS, il existe des centaines de services disponibles dans les
catégories
cartographie et localisation,
portail et données, ou encore
analyse spatiale
; et l'API d'ArcGIS pour Python possède des classes, des fonctions et des
méthodes pour interagir avec la plupart d'entre eux. Avant cette
version, les utilisateurs pouvaient avoir plusieurs déclarations
d'importation dans leur code en fonction des types spécifiques de services
avec lesquels ils travaillaient.
Imports multiples avec la version 2.3.x et antérieures |
Import unique depuis la version 2.4.0 |
Administration
L'administration de votre SIG Web peut se référer à la gestion des
utilisateurs, des groupes, de l'infrastructure et des serveurs, ou à la
personnalisation de l'aspect et de votre portail ArcGIS Online ou
Enterprise. Voici quelques points forts de la version 2.4.0 :
- Prise en charge des nouveaux types d'utilisateurs - Comme vous le savez peut-être, Esri a mis à jour le modèle de type d'utilisateur d'ArcGIS en juin 2024. Les types d'utilisateurs contrôlent les licences attribuées à un utilisateur, et donc les capacités auxquelles il a accès. Beaucoup des clients d'Esri utilisent l'API Python d'ArcGIS afin d'automatiser la création des comptes utilisateurs et de configurer toutes les licences, privilèges, etc. qui leur sont associés. Esri s'est donc assuré que notre code sous-jacent a été ajusté pour prendre en compte ces nouveaux changements de type d'utilisateur, afin que votre code existant continue à fonctionner et prenne en compte ces changements lorsque vous créez de nouveaux utilisateurs à l'aide de l'API.
- Vérification des licences hors ligne - Une autre amélioration ajoutée à la version 2.4.0 est la possibilité de vérifier les licences d'utilisateurs nommés hors ligne. Cela permet aux administrateurs d'organisations d'identifier les utilisateurs de leur organisation ArcGIS Online qui ont pris une licence hors ligne.
- Prise en charge de la corbeille - En juin 2024, Esri a introduit la corbeille dans ArcGIS Online. Elle permet aux utilisateurs individuels ou aux administrateurs de récupérer des éléments qui ont été supprimés. L'équipe de l'API Python a donc ajouté une fonctionnalité pour travailler avec la corbeille de manière dans la version 2.2.0. Dans la version 2.4.0, ils ont ajouté des améliorations pour permettre aux administrateurs d'organisations d'accéder et de récupérer le contenu de la corbeille de l'ensemble de l'organisation, ainsi que la possibilité de restaurer le contenu supprimé d'un dossier spécifique.
Gestion du contenu
La gestion du contenu de manière automatisée est l'une des tâches les plus
courantes avec l'API ArcGIS pour Python. C'est pourquoi les
workflows de gestion de contenu sont à l'origine de bon nombre des projets
de développement lors du développement des nouvelles versions. Voici
quelques-unes des nouveautés à ce sujet :
- Aide à la classification des items - La classification des itemsest le processus qui consiste à attribuer une étiquette spécifique à des données ou à des items. Elle est utilisée notamment pour attribuer des niveaux de protection, restreindre l'accès ou contrôler la diffusion des données ou du contenu au sein de l'organisation. Avec la prochaine version d'ArcGIS Enterprise 11.4, les administrateurs de portails pourront définir et appliquer un schéma de classification et de diffusion à chaque item du portail. Dans la version 2.4.0, Esri a ajouté une fonctionnalité permettant d'activer ou de désactiver la classification des items via la nouvelle classe ClassificationManager de l'API Python.
- Mise à jour du contenu du Living Atlas v2.0 dans ArcGIS Enterprise - Avec Enterprise 11.3 ou supérieur, les utilisateurs peuvent mettre à jour le contenu du Living Atlas d'ArcGIS au fur et à mesure que les mises à jour sont disponibles, plutôt que d'attendre la mise à niveau vers une nouvelle version d'Enterprise. La version 2.4.0 de l'API Python prend en charge la vérification, la planification et le téléchargement des mises à jour du Living Atlas.
- Remappage d'éléments - la nouvelle méthode remap_data vous permet de remplacer facilement les sources de données dans les cartes web ou les applications par de nouvelles sources de données. Cela peut être utile si les données sont corrompues ou obsolètes, ou si vous remplacez des données de test par des données de production.
Analyse et Data Science
Suite à la sortie des outils web publiés à partir de Notebook dans la
mise à jour de juin 2024 d'ArcGIS Online, Esri a ajouté des
fonctionnalités pour travailler avec les outils web Notebook dans ArcGIS
Online. Vous pouvez désormais publier, écraser et consommer des
outils web Notebook de manière programmatique à l'aide de l'API ArcGIS
pour Python !
Chaque version contient également des innovations et des évolutions dans
le domaine de la GeoAI (machine learning et deep learning) en ajoutant
de nouvelles fonctionnalités au module
arcgis.learn
de l'API Python. Voici quelques exemples :
- Un nouveau modèle de base d'apprentissage profond pour la prévision de séries temporelles de données climatiques/météorologiques (ClimaX).
- Extensibilité du modèle pour les modèles d'IA textuelle.
- Nouveaux modèles de détection d'objets.
Documentation, guides et extraits de code
Dépréciations
Alors que l'API évolue, des éléments viennent s'y ajouter mais
d'autres sont dépréciés ou retirés. Retrouvez la liste exhaustive dans
la
page d'annonce des dépréciations.
Notes de version
Cette article ne surligne que les changements majeurs, mais vous pouvez
vous référer aux notes de version complètes pour plus d'informations.
Nouveaux guides
Deux nouveaux guides sont disponibles :
- Sur le modèle ClimaX ;
- Sur l'utilisation de modèles de langages tiers avec ArcGIS.
Nouveaux extraits de code
Deux nouveaux extraits de code sont désormais disponibles :
Documentation des versions précédentes
Il reste possible d'accéder à
la documentation pour la version 2.3.x
de l'API en cliquant ici :
Communauté et collaboration
Il existe d'excellentes ressources disponibles pour obtenir de l'aide
avec l'API et partager vos commentaires. Vous pouvez utiliser la
page
ArcGIS API for Python d'Esri Community
pour poser des questions spécifiques, suggérer des idées
d'améliorations, entrer en contact avec d'autres utilisateurs, etc. Vous
pouvez également utiliser le
repo public GitHub d'ArcGIS API for Python
pour soumettre des bogues, des demandes d'amélioration et d'autres
problèmes. L'équipe derrière l'API surveille ces pages de très
près, et utilise vos commentaires et suggestions pour donner la priorité
à ce qu'ils intègrent dans l'API à l'avenir. N'hésitez pas à
les utiliser !
Aucun commentaire:
Enregistrer un commentaire