Intégrations

Les intégrations vous permettent d’apporter vos propres comptes tiers dans ALIGN, pour que la plateforme puisse utiliser des services externes en votre nom : fournisseurs de fonds de carte, imagerie au niveau de la rue et, avec le temps, les outils avec lesquels vous travaillez déjà.

Comment cela fonctionne

Vous connectez un compte une fois, et le service est ensuite disponible dans les builders, sans rien avoir à recoller pour chaque carte ou chaque couche. Chaque fournisseur a sa propre page, ci-dessous, qui explique ce qu’il est, ce qu’il apporte dans ALIGN et comment le connecter.

Deux types de connexion

Les intégrations sont de deux types, et la différence décide de qui elles servent.

Les clés de fournisseurs, comme Mapbox, MapTiler, Google ou Mapillary, sont des clés d’API. Vous pouvez ajouter les vôtres depuis Dashboard, Integrations, et elles servent alors votre propre travail. Une organisation peut aussi détenir ses clés, dans Settings, Organization, Integrations : configurées une fois, elles servent chaque membre, si bien que personne n’a à obtenir sa propre clé, et la facturation reste en un seul endroit.

Les connexions personnelles, GitHub et Supabase, passent par OAuth et restent toujours personnelles. Elles sont liées à votre compte et ne sont jamais partagées avec l’organisation, quel que soit votre rôle. Ce qu’une organisation décide ici, c’est seulement si ses membres peuvent les connecter ou non, pour tout le monde, propriétaires et administrateurs compris. Les lecteurs ne connectent jamais de compte OAuth.

Où vont vos clés

Un identifiant connecté est traité selon celui des deux types auquel il appartient, parce que les fournisseurs cartographiques en délivrent deux et qu’ils ne sont pas protégés de la même façon.

Une clé secrète, comme un jeton Mapbox sk., ne quitte jamais nos serveurs. Aucune route de notre API ne la renvoie, elle n’est jamais écrite dans une carte que vous enregistrez, un export ou un lien partagé, et elle est supprimée quand vous retirez l’intégration.

Une clé publique, comme une clé MapTiler ou un jeton Mapbox pk., est faite pour être utilisée par un navigateur. Elle est stockée sur votre compte ALIGN, et elle est transportée par les cartes que vous publiez, parce que le navigateur du visiteur charge lui-même les tuiles et a besoin de la clé pour le faire. Ce qui protège une clé publique, ce n’est pas le secret, c’est la restriction de domaine que vous définissez dans la console de votre fournisseur. ALIGN vous indique le domaine exact à autoriser au moment de publier.

La carte stockée dans votre Datastore ne transporte aucune clé, quel que soit le type que vous utilisez. La clé n’est ajoutée qu’à la copie publiée, au moment où elle est servie.

Ce que vous pouvez connecter

Imagerie au niveau de la rue

Les fournisseurs qui alimentent le widget Street View du Map Builder : cliquez sur un point de la carte et voyez le panorama le plus proche.

Fournisseur	Ce qu’il alimente	Statut
Mapillary	L’imagerie communautaire au niveau de la rue dans le widget Street View.	Disponible
Google Street View	Les panoramas Google à 360° dans le widget Street View.	Disponible

Fonds de carte et services cartographiques

Les fournisseurs dont les tuiles et les styles deviennent disponibles comme fonds de carte (Add Data → Basemap et le widget Basemap switcher) et, pour certains, le calcul d’itinéraires et le géocodage dans les widgets.

Fournisseur	Ce qu’il alimente	Statut
Mapbox	Les fonds de carte Mapbox, le calcul d’itinéraires Directions, le géocodage inverse (Reverse geocode).	Disponible
MapTiler	Les fonds de carte MapTiler.	Disponible

Données et bases de données

Fournisseur	Ce qu’il alimente	Statut
Supabase	Une base de données PostgreSQL + PostGIS gérée pour les applications que vous construisez.	Disponible

Gestion de versions et CI

Fournisseur	Ce qu’il alimente	Statut
GitHub	Poussez le code source de votre application vers votre propre dépôt, exécutez des GitHub Actions.	Disponible

SIG bureautique

Ni une clé, ni un compte OAuth personnel comme ceux décrits plus haut : un plugin que vous installez dans votre SIG bureautique, qui se connecte à ALIGN comme le fait le navigateur et porte votre propre rôle. Une organisation décide si ses membres peuvent ou non connecter des plugins de bureau, dans Settings, Organization, Integrations.

Outil	Ce qu’il alimente	Statut
QGIS	Publiez des couches, leur style et leurs métadonnées, ou un projet entier sous forme de carte web, depuis QGIS vers votre Datastore.	Bêta