embed : Une visionneuse cartographique simplifiée pour présenter une carte sur un site tiers

Comment embarquer une carte de cartostation dans un autre site ?

La solution la plus simple techniquement consiste à copier le code proposé sur une carte dans l’application atlas, et à l’insérer dans le code HTML de la page de votre site.

Note : Dans le cas d’un embed créé à la main, il est important de s’assurer que l’url utilisé dans l’iframe pointe vers l’application embed, et non vers atlas.

Structure de l’url vers la carte 

Les urls sont structurées selon le modèle suivant : [url-du-déploiement]/client/embed/[identifiant-de-la-carte]?profile=[type-de-profile]&lang=[code_lang]

Choix du profil 

Différents types de profils sont disponibles

• simple
• all-tools
• full-screen

Exemple d’usage : [url-du-déploiement]/client/embed/[identifiant-de-la-carte]?profile=full-screen

Profil simple

• Switch de langue
• Lien vers Atlas
• Titre
• Description
• Légende
• Affichage des informations au clic sur la carte

Profil all-tools

Profile Simple +

• Recherche d’adresse
• Boutons de zoom

Profil full-screen

• Switch de langue
• Lien vers Atlas
• Affichage des informations au clic sur la carte

Choix de la langue

La langue de la carte embarquée peut être configurée dans l’url en utilisant le paramètre de langue. Par exemple : lang=fr ou lang=nl

Exemple d’usage :

[url-du-déploiement]/client/embed/[identifiant-de-la-carte]?lang=fr

Exemple d’usage combiné profil + langue :

[url-du-déploiement]/client/embed/[identifiant-de-la-carte]?profile=fancy&lang=fr

Taille de l’iframe

Les cartes embarquées dans des sites tiers sont généralement contraintes par la mise en page dans laquelle l’iframe va être inséré.

Il reste cependant pertinent d’ajuster la taille de l’iframe au contenu de la carte, notamment en fonction de la taille de la description, de celle de la légende ou des informations consultables.

Une taille de 1000x600px est généralement un minimum pour présenter confortablement l’information.

Pratiques conseillées pour la création de cartes prévues pour être placées dans un iframe

• Ajuster le contenu de la carte en fonction du contenu éditorial du site. Si le contenu et le contexte de la carte sont déjà introduits dans la page du site, la description de la carte peut être concise. Son titre peut également être adpaté.
• Privilégier une légende simple et sobre

Pratiques déconseillées

Embarquer une carte de l’Atlas dans un iframe n’est pas recommandé. Une carte de l’Atlas comprend de nombreux outillages annexes et n’est pas adaptée à un usage dans un site tiers.

Un bouton est présent depuis l’iframe de l’embed pour voir la carte outillée dans de bonne conditions dans l’Atlas du portail cartographique.

Visibilité de l’application

embed est une application qui n’a pas vocation à être visible dans la liste des applications. Elle doit néanmoins être activée lors du déploiement cartostation pour être utilisable.

Cette application est automatiquement utilisée lorsque le code de publication sur site tiers est copié depuis le widget correspondant dans atlas.