Rechercher dans le blog

Mise à jour de l'API Python d'ArcGIS : nouveautés de la 2.4.0

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
Dans la version 2.4.0, Esri travaillé pour rationaliser l'accès à tous les services SIG à travers une unique classe Service du nouveau module arcgis.layers.  Il s'agit d'une seule classe (et d'une seule instruction d'importation) qui fournit un moyen centralisé et facile pour accéder à tous les services SIG pris en charge, sans que l'utilisateur ne spécifie ou n'ait besoin de sacvoir de quel type de service il s'agit. 
Import unique depuis la version 2.4.0
Note : Les workflows précédents pour interagir avec les services SIG continueront à fonctionner, mais seront probablement obsolètes dans une prochaine version.  Il est recommandé de commencer à migrer votre code le plus tôt possible. 

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 :

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