La nouvelle version du service de style de fond de cartes d'Esri est disponible

Le 10 mai dernier, Esri a annoncé qu'un nouveau service de style de fonds de carte (v2) était disponible en bêta au sein de son catalogue de services de localisation. Ce service prêt à l'emploi propose des tuiles vectorielles et des tuiles d'imagerie représentant des entités géographiques du monde entier. Il comprend des styles qui représentent des caractéristiques topographiques, des réseaux routiers, des sentiers, des empreintes de bâtiments, des étendues d'eau, des limites administratives et des images satellite.

Avec cette seconde version, vous pourrez continuer à accéder à tous les styles de fond de carte auxquels vous aviez déjà accès avec le service de style de fond de carte (v1), auxquelles quelques nouvelles options viennent se rajouter :

Un nouveau point de terminaison permettant un accès facile à tous les styles et cartes web ;
Des nouveaux styles de carte comme ArcGIS Outdoor et OSM Navigation avec des modes clairs et sombres ;
La possibilité de traduire les étiquettes de toponymie.

Comment utiliser ce service ?

Vous pouvez d'ores et déjà tester la bêta de ce nouveau service en vous inscrivant au programme Early Adopters.

Vous aurez ensuite besoin d'un compte ArcGIS Developer ou d'un compte ArcGIS Online. Si vous n'en possédez pas déjà un, vous pouvez en créer un gratuitement ici. Vous pourrez ensuite créer une clé d'API dans votre tableau de bord développeur qui vous permettra d'accéder à ce service. Notez que votre clé d'API n'aura pas besoin d'une configuration particulière pour consommer le service de style de fond de carte.

Les API clientes ArcGIS Maps SDKs ne supportent pas encore ce service. Vous pourrez cependant consommer les fonds de carte en accédant directement à la terminaison de la couche de tuile vectorielle ou bien avec les bibliothèques MapLibre GL JS ou OpenLayers. Notez cependant que le support pour les ArcGIS Maps SDK devrait arriver bientôt !

La nouvelle terminaison URL

Le service de style de fond de cates v2 a une nouvelle terminaison URL RESTful. Vous pouvez retourner le style en tant qu'une web map JSON ou qu'un JSON basé sur une spécification de style Mapbox.

Pour référencer un style, il faut paramétrer arcgis ou osm en tant que fournisseur, et webmaps ou styles en tant que réponse JSON, et enfin indiquer le style de basemap que vous souhaitez. Voici deux exemples :

//Style JSON
https://basemapstyles-api.arcgis.com/arcgis/rest/services/styles/v2/styles/arcgis/outdoor
?token=ACCESS_TOKEN

//Web map JSON
https://basemapstyles-api.arcgis.com/arcgis/rest/services/styles/v2/webmaps/arcgis/outdoor
?token=ACCESS_TOKEN

Pour retrouver la liste complète des styles de fond de carte disponibles, rendez-vous dans la documentation de référence de l'API.

Les nouveaux styles de carte

Avec ce nouveau service, vous pourrez accéder à deux nouveaux styles de fond de carte : ArcGIS Outdoor et OSM navigation.

ArcGIS Outdoor :

const apiKey = "YOUR_API_KEY";
const basemapEnum = "arcgis/outdoor";

const map = new maplibregl.Map({
   container: "map", // the id of the div element
   style: `https://basemapstyles-api.arcgis.com/arcgis/rest/services/styles/v2/styles/${basemapEnum}?token=${apiKey}`,
   zoom: 12, // starting zoom
   center: [6.17, 45.11] // starting location [longitude, latitude]
});

OSM Navigation :

const apiKey = "YOUR_API_KEY";
const basemapEnum = "osm/navigation";

const map = new maplibregl.Map({
   container: "map", // the id of the div element
   style: `https://basemapstyles-api.arcgis.com/arcgis/rest/services/styles/v2/styles/${basemapEnum}?token=${apiKey}`,
   zoom: 12, // starting zoom
   center: [6.17, 49.11] // starting location [longitude, latitude]
});

Pour plus d'information sur ce code, vous pouvez retrouver les tutoriels dans les guides de MapLibre GL JS et OpenLayers.

Vous pouvez également retrouver l'ensemble des styles de fond de carte disponibles dans la documentation.

La traduction des étiquettes de toponymie

Une nouvelle capacité clé introduite par ce service est la possibilité de traduire les étiquettes de toponymie de tous les styles de fond de carte. Tout ce que vous avez besoin de faire est d'ajouter le paramètre language à la requête URL et de choisir l'une des 30 langues disponible avec son code de langue. Vous pouvez aussi paramétrer language sur local pour changer de langue automatiquement lorsque vous naviguez dans différentes parties du monde.

Dans l'exemple ci-dessous, j'ai paramétré une carte centrée sur Athènes avec des étiquettes en grec :

const apiKey = "YOUR_API_KEY";
const basemapEnum = "arcgis/midcentury";

const map = new maplibregl.Map({
   container: "map", // the id of the div element
   style: `https://basemapstyles-api.arcgis.com/arcgis/rest/services/styles/v2/styles/${basemapEnum}?token=${apiKey}&language=el`,
   zoom: 14, // starting zoom
   center: [23.729, 37.983] // starting location [longitude, latitude]
});