iFrame API · Hjælp til Measure Map Online

Vis et af dine projekter som et levende kort på dit eget websted, i de enheder, den kortstil og det tema, der passer til dit websted.

iFrame API'et sætter et projekts kort ind på din egen webside. Besøgende ser satellitkortet med dine målinger og kan flytte rundt på det uden en konto og uden at forlade dit websted. Du vælger projektet, enhederne, kortstilen og farvetemaet.

Før du går i gang#

En livenøgle med adgangen Indlejrede kort. Se API-nøgler.
Et projekt, som besøgende må se: dit eget eller en anden kontos, delt som Kun visning eller Offentlig. Et Privat projekt vises kun, hvis det tilhører en anden konto, og dens ejer har godkendt dig (se kunders private projekter); dine egne private projekter vises aldrig. Se hvilke projekter der kan indlejres.
Eventuelt begrænsninger for websteder på nøglen, så det indlejrede kort kun virker på dine egne websteder. Se API-nøgler.

Byg koden til indlejring#

Udvikler > Indlej et kort bygger koden for dig med din livenøgle: vælg projektet, vælg tema, enheder, korttype og størrelse, tjek Liveeksempel, og kopiér Indlejringskode. Hvis projektet er privat, siger afsnittet det og tilbyder Gør det skrivebeskyttet. Se hent koden til indlejring for hvert trin.

Indlejr et kort med et valgt projekt og den levende forhåndsvisning

Koden indeholder din nøgle, så den bliver ved med at virke, indtil du udskifter nøglen. Afsnittet advarer dig, når nøglen kan mere end Indlejrede kort, da alle kan læse den i din sides kildekode, og når nøglen ikke har begrænsninger for websteder. Kun Liveeksempel bruger et kortvarigt token. Se nøgle eller token.

Adressen til indlejring#

Et indlejret kort er en <iframe>, hvis adresse begynder med https://app.measuremaponline.com/iframe_api, efterfulgt af disse parametre:

Parameter	Påkrævet	Værdier
`pid`	påkrævet	Projektets ID: den del, der står efter `/p/` i projektets adresse i appen. Ejeren kan kopiere det nederst i projektets oversigt, og et klik på projektets navn i et indlejret kort kopierer det også.
`key`	`key` eller `token`	Din API-nøgle.
`token`	`key` eller `token`	Et token fra din server (se nedenfor).
`ms`	valgfri	Enheder: `metric` eller `imperial`. Uden den ser besøgende i USA imperiale enheder og alle andre metriske.
`maptype`	valgfri	`satellite` (standard), `map`, `hybrid` eller `terrain`.
`theme`	valgfri	`auto` (standard: følger den besøgendes egen systemindstilling), `light` eller `dark`.

Et minimalt eksempel#

<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>

Erstat YOUR_PROJECT_ID, YOUR_API_KEY og YOUR_PROJECT_NAME (skærmlæsere læser title op), og tilpas bredde og højde, så de passer til din side.

Koden til indlejring med sin kopieringsknap

Nøgle eller token#

Med key, som i den kode, afsnittet Indlej et kort giver dig, bliver det indlejrede kort ved med at virke, så længe nøglen gør, på de websteder, dens begrænsninger tillader. Din nøgle er så synlig i din sides kildekode, så:

brug en nøgle, der kun har adgangen Indlejrede kort;
begræns den til dine egne websteder;
når du udskifter nøglen, skal du opdatere dine sider inden for de 24 timer, den gamle nøgle bliver ved med at virke (en nøgle oprettet før adgangsindstillinger beholder den dato, du fik oplyst).

Med token bliver nøglen på din server. Det passer til indlejringer, som din egen server skriver ind på siden for hvert besøg: før siden vises, beder den REST API'et om et token og sætter det ind i iframens adresse:

POST https://api.measuremaponline.com/api/v2/auth/iframe/token med din nøgle i headeren Authorization returnerer et token, der virker i 60 minutter;
POST https://api.measuremaponline.com/api/v2/auth/token gør det samme og accepterer en duration i sekunder, op til 24 timer. Svaret fortæller, hvornår tokenet udløber.

Din konto kan få op til 600 tokens i timen. Brug en livenøgle: indlejrede kort viser kun liveprojekter, så et token oprettet med en sandboxnøgle åbner ikke et kort. Se API-referencen.

Hvad besøgende kan#

Besøgende kan flytte og zoome kortet, læse målingerne på dine figurer og læse projektets kommentarer. De kan tilføje kommentarer, når projektet lader alle kommentere, og et klik på projektets navn kopierer dets ID. De kan ikke ændre andet: redigering er slået fra i et indlejret kort, uanset projektets adgangsniveau. Den eneste undtagelse er et Open Guest-projekt på Open Guest-abonnementet, hvor besøgende måler for sig selv.

Når kortet ikke vises#

I de fleste tilfælde viser kortet en besked, der fortæller hvorfor: se når kortet viser en besked. Tjek i rækkefølge:

Adressen har et token, der er udløbet. Tokens varer 60 minutter, medmindre din server bad om længere. Kopiér koden igen fra Indlej et kort, som bruger din nøgle, eller lad din server hente et nyt token til hvert besøg (se ovenfor).
Projektet er privat. Hvis det er dit, så sæt det til Kun visning eller Offentlig, eller tryk på Gør det skrivebeskyttet i Indlej et kort. Hvis det er en kundes, kan kunden godkende dig fra kortet, eller du kan spørge kunden under Private projekter.
Projektets abonnement er udløbet: ejerens abonnement, eller for en organisations projekt organisationens. Det vises igen, når abonnementet fornyes.
Webstedet er ikke tilladt. Hvis nøglen har begrænsninger for websteder, skal den side, der viser det indlejrede kort, ligge på et af dem. Nogle browsere og websteder skjuler, hvilken side en indlejring ligger på; når der er sat begrænsninger, afvises sådan en indlejring.
Nøglen blev udskiftet. En gammel nøgle stopper 24 timer efter, at en ny er oprettet, eller med det samme, hvis den blev tilbagekaldt.
Nøglen er en sandboxnøgle. Indlejrede kort virker kun med livenøgler og liveprojekter.
Abonnementet er ikke aktivt, eller API-adgangen er suspenderet: afsnittet API-nøgler siger det.