Een kaart op je website insluiten

Een ingesloten kaart zet een project op een pagina van je eigen website: zijn vormen, hun metingen en, als het is geprijsd, zijn offerte. Bezoekers bekijken het daar ter plekke, zonder account, en kunnen het in Measure Map Online openen als ze meer ruimte willen.

Welke projecten kunnen worden ingesloten#

Je embeds kunnen je eigen projecten en de projecten van andere accounts, zoals die van je klanten, tonen, voor zover hun toegangsniveau dat toestaat:

• Projecten met visibilityAlleen lezen en publicOpenbaar worden op je pagina getoond, wie ze ook bezit. Bezoekers kunnen kijken maar niets wijzigen: bewerken staat uit in een ingesloten kaart, zelfs voor de leden van een project.
• De lockPrivé projecten van een ander account worden alleen getoond zodra de eigenaar je heeft gemachtigd. Ze worden dan alleen-lezen getoond, in jouw embeds en nergens anders. Zie privéprojecten van klanten.
• Je eigen lockPrivé projecten worden nooit getoond, zelfs niet met je sleutel. Zet ze eerst op visibilityAlleen lezen.
• Met person_pin_circleOpen Guest-projecten kunnen bezoekers zelf meten en een offerte aanvragen. Zie Open Guest.

Een project wordt alleen getoond zolang het abonnement van de eigenaar loopt, of, bij projecten van een organisatie, het abonnement van de organisatie. Projecten in de prullenbak en sjablonen worden niet getoond. Kan een project niet worden getoond, dan zegt de kaart waarom: zie wanneer de kaart een bericht toont.

De embedcode ophalen#

1. Druk in het dashboard op codeOntwikkelaar en daarna op web_assetEen kaart insluiten. De embed gebruikt altijd je live sleutel: projecten die met een sandboxsleutel zijn gemaakt, kunnen niet door de bezoekers van je website worden geopend (zie live en sandbox).
2. Als de pagina onder Haal je API-sleutel op nog geen sleutel toont, druk je op addNieuwe sleutel genereren en maak je er een in het venster dat opent. Zie een sleutel maken.
3. Typ onder Stel de project-ID in een deel van de naam van het project in Kies een project en kies het in de lijst. De lijst zegt hoe elk project wordt gedeeld en laat sjablonen en projecten in de prullenbak weg. Kies je een Privé project, dan waarschuwt de pagina dat je bezoekers een bericht zien dat het privé is, en biedt ze visibilityOp alleen lezen zetten aan.
4. Kies onder Insluitcode hoe de kaart eruitziet:
   • Thema: Auto volgt de eigen lichte of donkere instelling van elke bezoeker; of altijd Licht of Donker.
   • Eenheden: Automatisch (land van de bezoeker) toont imperiale eenheden aan bezoekers in de Verenigde Staten en metrische aan iedereen anders; of altijd Imperiaal of Metrisch.
   • Kaarttype: Satelliet, Kaart, Hybride of Terrein.
   • Breedte en Hoogte van de kaart op je pagina, in pixels (200 tot 2000).
5. Controleer de Livevoorbeeld.
6. Druk op content_copy naast Embedcode en plak de code in de HTML van je pagina, waar de kaart moet verschijnen.

Om het project van iemand anders in te sluiten, zoals dat van een klant, heb je de project-ID nodig. De eigenaar vindt die aan het eind van het overzicht van het project, met een knop content_copy Kopiëren; in een ingesloten kaart kopieert een klik op de naam van het project hem. Zet hem in de pid van het embedadres.

De code bevat je API-sleutel, dus de kaart blijft werken totdat je de sleutel vervangt, op de websites die de sleutel toestaat. Nadat je hem hebt vervangen, wordt de oude sleutel nog 24 uur geaccepteerd, dus plak de nieuwe code binnen die tijd in je pagina's. Een sleutel die is gemaakt voordat sleutels toegangsinstellingen hadden, behoudt in plaats daarvan de datum die je kreeg. Alleen het Livevoorbeeld op deze pagina gebruikt een kortlevend token.

Om de sleutel helemaal van je pagina's te houden, laat je de server van je website elke keer dat de pagina wordt getoond om een token vragen. Zie sleutel of token, dat ook elke instelling opsomt die het embedadres accepteert.

De kaart beperken tot je websites#

Standaard werkt een embed op elke website. Om te voorkomen dat andere sites je kaarten tonen, druk je op codeOntwikkelaar > vpn_keyAPI-sleutels en voeg je je eigen websites, zoals example.com, toe onder Websitebeperkingen. Een website in de lijst geldt ook voor zijn subdomeinen. Zodra de lijst minstens één website bevat, opent een kaart die ergens anders is ingesloten niet. Zie de sleutel beperken tot je websites.

Wat bezoekers kunnen doen#

In een ingesloten kaart kunnen bezoekers:

• zich over de kaart bewegen en zoomen, en op een vorm klikken om zijn metingen te lezen;
• de offerte van het project zien, als het er een heeft;
• de opmerkingen van het project lezen, en hun eigen toevoegen als het project iedereen laat reageren;
• op settings drukken om het kaarttype en de meeteenheden te wijzigen (zie instellingen);
• op de naam van het project klikken om zijn project-ID te kopiëren;
• op de knop Measure Map Online rechtsonder drukken om het project in een nieuw tabblad te openen.

In een Open Guest-project kunnen ze ook tekenen en meten, en op Offerte aanvragen drukken om je hun gegevens te sturen.

Bewerken staat uit in elke andere ingesloten kaart, zelfs voor de leden van het project. Om de embed met je eigen code te bouwen, of er een kortlevend token in te zetten in plaats van je sleutel, zie je de iFrame API.

Wanneer de kaart een bericht toont#

Kan een project niet worden getoond, dan zegt de kaart op zijn plaats waarom, en wat eraan kan worden gedaan.

Voor de technische kant van elk geval, zie wanneer de kaart niet verschijnt.