TopoExport Tiles

Tuiles vectorielles, fond de carte mondial OpenStreetMap, cadastres harmonisés, 3D Tiles et terrain, servis depuis Cloudflare. Une clé tpk_… se crée dans l'onglet Tuiles de votre espace TopoExport. Le plan gratuit autorise l'usage commercial, avec l'attribution du TileJSON affichée sur la carte.

1. Démarrer avec MapLibre GL JS

Le plus simple : un style complet, prêt à l'emploi, généré pour votre clé.

const map = new maplibregl.Map({
  container: "map",
  style: "https://geocode-preprod.topoexport.com/v1/styles/osm-world/light.json?key=tpk_VOTRE_CLE&lang=fr",
  center: [2.35, 48.86], zoom: 12,
});

Déclinaisons : positron, light, dark, white, grayscale, black. Paramètre lang : code langue à deux lettres pour les étiquettes.

2. Ajouter un tileset thématique

map.addSource("cadastre", { type: "vector", url: "https://geocode-preprod.topoexport.com/v1/tiles/cadastre-fr.json?key=tpk_VOTRE_CLE" });
map.addLayer({ id: "parcelles", type: "line", source: "cadastre", "source-layer": "cadastre-fr",
  minzoom: 12, paint: { "line-color": "#c2410c", "line-width": 0.8 } });

3. ArcGIS Pro, QGIS, scripts

Ces clients ne conservent pas la query string ou n'envoient pas d'origine : utilisez la forme clé dans le chemin et une clé sans restriction d'origine.

https://geocode-preprod.topoexport.com/v1/k/tpk_VOTRE_CLE/tiles/cadastre-fr.json
https://geocode-preprod.topoexport.com/v1/k/tpk_VOTRE_CLE/tiles/osm-world/{z}/{x}/{y}.mvt

QGIS : Vector Tiles → nouvelle connexion générique, URL de tuiles ci-dessus. ArcGIS Pro : ajouter une couche de tuiles vectorielles depuis l'URL du TileJSON.

4. 3D Tiles et terrain (Cesium, ArcGIS)

https://geocode-preprod.topoexport.com/v1/tiles3d/{tileset}/tileset.json?key=tpk_VOTRE_CLE
https://geocode-preprod.topoexport.com/v1/terrain/{version}/layer.json?key=tpk_VOTRE_CLE

Cesium propage la clé du tileset.json aux ressources filles. Pour ArcGIS, préférez la forme clé dans le chemin.

5. Géocodage

https://geocode-preprod.topoexport.com/v1/geocode/autocomplete?text=10 rue de riv&focus.point.lat=48.85&focus.point.lon=2.35&key=tpk_VOTRE_CLE
https://geocode-preprod.topoexport.com/v1/geocode/search?text=10 rue de rivoli paris&key=tpk_VOTRE_CLE
https://geocode-preprod.topoexport.com/v1/geocode/reverse?point.lat=48.8584&point.lon=2.2945&key=tpk_VOTRE_CLE
https://geocode-preprod.topoexport.com/v1/geocode/place?ids=whosonfirst:locality:101751119&key=tpk_VOTRE_CLE

Moteur Pelias planète (OpenStreetMap, OpenAddresses, Who's On First, GeoNames, numéros interpolés), réponses GeoJSON au format Pelias, paramètres size, layers, sources, lang, boundary.* et focus.point.* acceptés ; structured et nearby existent aussi. Les résultats sont mis en cache (autocomplétion 24 h, recherche et reverse 1 h). Attribution dans geocoding.attribution.

6. Crédits et plans

Chaque réponse porte X-Topotiles-Plan et X-Topotiles-Credits. Les mois sont comptés en UTC. Le quota est partagé entre toutes les clés d'un compte. Limite de débit : 50 requêtes par seconde sur Free, 500 sur les plans payants.

7. Clés et sécurité

Une clé de tuiles est publique : elle vit dans le navigateur. Restreignez-la aux origines de vos sites (https://monsite.fr) depuis l'onglet Tuiles. Une clé sans restriction est nécessaire pour ArcGIS Pro, QGIS et les scripts. Désactivez ou supprimez une clé à tout moment : l'effet est immédiat à une minute près.

8. Attribution et licences

Le champ attribution du TileJSON contient les mentions à afficher : OpenStreetMap contributors pour le fond de carte, Etalab pour le cadastre France, les Länder pour l'Allemagne, et TopoExport sur le plan gratuit. MapLibre les affiche automatiquement.

9. Erreurs

État du service : status.topoexport.com.