Date
01 mars 2024

Arrêt du service d’autoconfiguration début mars 2024

Contenu
Texte

Le service d’autoconfiguration sera définitivement arrêté le 4 mars 2024 (échéance susceptible d’être modifiée).

Texte

Si vous utilisez les API JavaScript Géoportail (extensions ou SDK) dans votre application, nous vous recommandons de mettre à niveau la version de l’API JavaScript avec les dernières versions bêta actuellement publiées (plus d'informations ici) si vous ne l’avez pas déjà fait, à partir des dépôts suivants :

Une fois la mise à jour réalisée, vous pouvez alors générer votre fichier de configuration sur mesure branché à la Géoplateforme à partir de cet outil, l’héberger localement et l’utiliser via les API Web JavaScript comme expliqué dans ce post.

Si toutefois vous n’étiez pas en mesure d'effectuer cette mise à jour rapidement, il existe une solution temporaire de contournement via l’utilisation de fichiers d’autoconfiguration locaux qui donnent accès à toutes les données de la plateforme :

  • autoconf_magique.json
  • autoconf_magiqueplus.json

Pour obtenir les fichiers spécifiques à votre clé, vous pouvez contacter geoplateforme@ign.fr

Vous êtes concernés par cette action si vous utilisez les versions suivantes de l’API :

  • bibliothèque d'accès versions 3.2.2 et antérieures
  • ext gp pour openlayers versions 3.2.22 et antérieures
  • ext gp pour leaflet versions 2.2.9 et antérieures
  • ext gp pour itowns versions 2.3.11 et antérieures
  • sdk versions 3.3.26 et antérieures

Pour utiliser ces fichiers dans les anciennes versions des API JavaScript, voici la marche à suivre :

Avec la bibliothèque d’accès :

Complétez la valeur du paramètre serverUrl (qui remplace le paramètre apiKey) dans la fonction Gp.Services.getConfig() avec le chemin vers le fichier json ci-dessus :

-	the Gp.Services.getConfig({
    ...
    serverUrl : "path/to/autoconf_magique.json",
    callbackSuffix : "",
    ...
}) ;

 

Avec les extensions Géoportail :

Complétez la valeur de l’attribut data-url (qui remplace l’attribut data-key) avec le chemin vers le fichier json ci-dessus dans le tag script utilisé lors du chargement de l’extension Géoportail :

<script type="text/javascript" src="path/to/GpPluginLeaflet.js" data-url="path/to/autoconf_magique.json"></script>
<!-- or -->
<script type="text/javascript" src="path/to/GpPluginOpenLayers.js" data-url="path/to/autoconf_magique.json"></script>

 

Avec le SDK Géoportail :

Complétez la valeur du paramètre configUrl (qui remplace le paramètre apiKey) avec le chemin vers le fichier json ci-dessus dans l’objet Gp.MapOptions utilisé dans la fonction Gp.Map.load() :

Gp.Map.load(
    "mapDiv",    
    {
        ...
        configUrl : "path/to/autoconf_magique.json",
        ...
    }
) ;

A noter que les services suivants seront aussi définitivement arrêtés :