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.

Choix du profil 

Différents types de profils sont disponibles :

• Carte avec légende
• Carte avec outils
• Carte simple

Profil “Carte avec légende”

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

Profil “Carte avec outils”

Profile Simple +

• Recherche d’adresse
• Boutons de zoom

Profil “Carte simple”

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

Choix de la langue

Le choix de la langue de la carte embarquée est celle qui est définie dans l’interface lors de la création. Il est cependant possible de changer la langue par après en modifiant lang=fr, lang=en ou lang=nl dans le code de l’embed.

Pour plus de détail sur le format de l’URL, voir les détails de la structure en bas de cette page.

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 adapté.
• 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.

Création de l’URL d’embed manuellement

Il est recommandé d’utiliser le système de création d’embed présent dans l’atlas comme vu plus haut. Il est cependant possible de configurer une URL d’embed manuellement. Les URLs d’embed sont sous le format suivant :

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

Les types de profiles disponibles sont les suivant :

• simple qui correspond à “Carte avec légende”
• all-tools qui correspond à “Carte avec outils”
• full-screen qui correspond à “Carte simple”