iFrame-API · Hjälp för Measure Map Online

Visa ett av dina projekt som en levande karta på din egen webbplats, med de enheter, den kartstil och det tema som passar din sida.

iFrame-API:t lägger ett projekts karta på din egen webbsida. Besökarna ser satellitkartan med dina mätningar och kan röra sig i den, utan konto och utan att lämna din webbplats. Du väljer projekt, enheter, kartstil och färgtema.

Innan du börjar#

En live-API-nyckel med åtkomsten Inbäddade kartor. Se API-nycklar.
Ett projekt som besökare får se: ditt eget eller ett annat kontos, delat som Endast visa eller Offentlig. Ett Privat projekt visas bara om det tillhör ett annat konto och dess ägare har godkänt dig (se kunders privata projekt); dina egna privata projekt visas aldrig. Se vilka projekt som kan bäddas in.
Eventuellt webbplatsbegränsningar på nyckeln, så att inbäddningen bara fungerar på dina egna webbplatser. Se API-nycklar.

Bygg inbäddningskoden#

Utvecklare > Bädda in en karta bygger koden åt dig med din livenyckel: välj projekt, välj tema, enheter, karttyp och storlek, kontrollera Liveförhandsvisning och kopiera Inbäddningskod. Om projektet är privat säger avsnittet det och erbjuder Gör det skrivskyddat. Se hämta inbäddningskoden för varje steg.

Bädda in en karta med ett valt projekt och liveförhandsvisningen

Koden innehåller din nyckel, så den fortsätter fungera tills du byter ut nyckeln. Avsnittet varnar dig när nyckeln kan mer än Inbäddade kartor, eftersom vem som helst kan läsa den i sidans källkod, och när nyckeln saknar webbplatsbegränsningar. Bara Liveförhandsvisning använder en kortlivad token. Se nyckel eller token.

Inbäddningsadressen#

En inbäddning är en <iframe> vars adress börjar med https://app.measuremaponline.com/iframe_api, följd av dessa parametrar:

Parameter	Behövs	Värden
`pid`	obligatorisk	Projektets ID: delen efter `/p/` i projektets adress i appen. Dess ägare kan kopiera det längst ned i projektets översikt, och ett klick på projektets namn i en inbäddad karta kopierar det också.
`key`	`key` eller `token`	Din API-nyckel.
`token`	`key` eller `token`	En token från din server (se nedan).
`ms`	valfri	Enheter: `metric` eller `imperial`. Utan den ser besökare i USA imperiska enheter och alla andra metriska.
`maptype`	valfri	`satellite` (standard), `map`, `hybrid` eller `terrain`.
`theme`	valfri	`auto` (standard: följer besökarens egen systeminställning), `light` eller `dark`.

Ett minimalt exempel#

<iframe src="https://app.measuremaponline.com/iframe_api?pid=YOUR_PROJECT_ID&key=YOUR_API_KEY&maptype=satellite&theme=auto"
  title="YOUR_PROJECT_NAME" width="500" height="500" style="border:0" allow="fullscreen"></iframe>

Byt ut YOUR_PROJECT_ID, YOUR_API_KEY och YOUR_PROJECT_NAME (skärmläsare läser upp title) och ställ in bredd och höjd efter din sida.

Inbäddningskoden med sin kopieringsknapp

Nyckel eller token#

Med key, som i koden som avsnittet Bädda in en karta ger dig, fortsätter inbäddningen fungera så länge nyckeln gör det, på de webbplatser som dess begränsningar tillåter. Din nyckel syns då i sidans källkod, så:

använd en nyckel med bara åtkomsten Inbäddade kartor;
begränsa den till dina egna webbplatser;
när du byter ut nyckeln uppdaterar du dina sidor inom de 24 timmar som den gamla nyckeln fortsätter fungera (en nyckel som skapades innan nycklar hade åtkomstinställningar gäller till det datum du fick).

Med token stannar nyckeln på din server. Det passar inbäddningar som din egen server skriver in i sidan för varje besök: innan sidan visas ber den REST-API:t om en token och lägger den i iframens adress:

POST https://api.measuremaponline.com/api/v2/auth/iframe/token, med din nyckel i Authorization-huvudet, returnerar en token som gäller i 60 minuter;
POST https://api.measuremaponline.com/api/v2/auth/token gör detsamma och godtar en duration i sekunder, upp till 24 timmar. Svaret anger när token går ut.

Ditt konto kan få upp till 600 token i timmen. Använd en livenyckel: inbäddningar visar bara liveprojekt, så en token som skapats med en sandbox-nyckel öppnar ingen karta. Se API-referensen.

Vad besökare kan göra#

Besökare kan panorera och zooma kartan, läsa måtten på dina former och läsa projektets kommentarer. De kan lägga till kommentarer när projektet låter alla kommentera, och ett klick på projektets namn kopierar dess ID. Inget annat kan de ändra: redigering är avstängd i en inbäddning, oavsett projektets åtkomstnivå. Det enda undantaget är ett Open Guest-projekt på Open Guest-planen, där besökare mäter själva.

När kartan inte visas#

I de flesta fall visar kartan ett meddelande om varför: se när kartan visar ett meddelande. Kontrollera i ordning:

Adressen har en token som har gått ut. Token gäller i 60 minuter om inte din server bad om längre tid. Kopiera koden igen från Bädda in en karta, som använder din nyckel, eller låt din server hämta en ny token för varje besök (se ovan).
Projektet är privat. Är det ditt, sätt det till Endast visa eller Offentlig, eller tryck på Gör det skrivskyddat i Bädda in en karta. Är det en kunds kan de godkänna dig från kartan, eller så kan du be dem i Privata projekt.
Projektets plan har upphört: dess ägares plan, eller för en organisations projekt, organisationens. Det visas igen när planen förnyas.
Webbplatsen är inte tillåten. Om nyckeln har webbplatsbegränsningar måste sidan som visar inbäddningen finnas bland dem. Vissa webbläsare och webbplatser döljer vilken sida en inbäddning finns på; med begränsningar inställda avvisas en sådan inbäddning.
Nyckeln har bytts ut. En gammal nyckel slutar fungera 24 timmar efter att en ny har skapats, eller genast om den återkallades.
Nyckeln är en sandbox-nyckel. Inbäddningar fungerar bara med livenycklar och liveprojekt.
Prenumerationen är inte aktiv, eller API-åtkomsten har stängts av: avsnittet API-nycklar säger det.