embed: Een vereenvoudigde kaartviewer om een kaart op een externe website weer te geven

Hoe integreer je een kaart van cartostation in een andere site?

De eenvoudigste oplossing is technisch gezien om de voorgestelde code te kopiëren naar een kaart in de atlas applicatie en deze in de HTML-code van de pagina van uw site in te voegen.

Opmerking: Bij een handmatig aangemaakte embed is het belangrijk om ervoor te zorgen dat de url die in het iframe wordt gebruikt, naar de embed-applicatie verwijst en niet naar atlas.

Structuur van de url naar de kaart

De url’s zijn gestructureerd volgens het volgende model: [url-van-de-implementatie]/client/embed/[identificatie-van-de-kaart]?profile=[type-profiel]&lang=[code_lang]

Profielkeuze

Er zijn verschillende soorten profielen beschikbaar:

• simple
• all-tools
• full-screen

Voorbeeld van gebruik: [url-van-de-implementatie]/client/embed/[kaart-id]?profile=full-screen

Profiel simple

• Taalkeuzeschakelaar
• Link naar Atlas
• Titel
• Beschrijving
• Bijschrift
• Weergave van informatie bij klikken op de kaart

Profiel all-tools

Profiel Simple +

• Adres zoeken
• Zoomknoppen

Profiel full-screen

• Taalwisselaar
• Link naar Atlas
• Weergave van informatie bij klikken op de kaart

Taalkeuze

De taal van de ingebedde kaart kan in de url worden geconfigureerd met behulp van de taalparameter. Bijvoorbeeld: lang=fr of lang=nl.

Voorbeeld van gebruik:

[url-van-de-implementatie]/client/embed/[kaart-ID]?lang=fr

Voorbeeld van gecombineerd gebruik van profiel + taal:

[url-van-de-implementatie]/client/embed/[kaart-id]?profile=fancy&lang=fr

Grootte van het iframe

Kaarten die in websites van derden worden ingebed, worden doorgaans beperkt door de lay-out waarin het iframe wordt ingevoegd.

Het blijft echter relevant om de grootte van het iframe aan te passen aan de inhoud van de kaart, met name op basis van de grootte van de beschrijving, de grootte van de legenda of de raadpleegbare informatie.

Een grootte van 1000x600px is over het algemeen een minimum om de informatie comfortabel weer te geven.

Aanbevolen werkwijzen voor het maken van kaarten die in een iframe worden geplaatst

• Pas de inhoud van de kaart aan aan de redactionele inhoud van de website. Als de inhoud en de context van de kaart al op de pagina van de website staan, kan de beschrijving van de kaart beknopt zijn. De titel kan ook worden aangepast.
• Geef de voorkeur aan een eenvoudige en sobere legenda

Af te raden praktijken

Het is niet aan te raden om een kaart uit de Atlas in een iframe op te nemen. Een kaart uit de Atlas bevat veel aanvullende tools en is niet geschikt voor gebruik op een website van een derde partij.

In het iframe van de embed is een knop aanwezig om de kaart met alle tools onder goede omstandigheden te bekijken in de Atlas van het cartografische portaal.

Weergave van de applicatie

embed is een toepassing die niet bedoeld is om zichtbaar te zijn in de dashboard applicatie. Het moet echter wel ingeschakeld zijn tijdens de implementatie van cartostation om bruikbaar te zijn.

Deze applicatie wordt automatisch gebruikt wanneer de code van een andere site wordt gekopieerd van de overeenkomstige widget in atlas.