iFrame-API · Measure Map Online Hilfe

Zeigen Sie eines Ihrer Projekte als Live-Karte auf Ihrer eigenen Website, in den Einheiten, dem Kartenstil und dem Design, die zu Ihrer Website passen.

Die iFrame-API setzt die Karte eines Projekts auf Ihre eigene Webseite. Besucher sehen die Satellitenkarte mit Ihren Messungen und können sich darauf bewegen, ohne Konto und ohne Ihre Website zu verlassen. Sie wählen das Projekt, die Einheiten, den Kartenstil und das Farbdesign.

Bevor Sie beginnen#

Ein Live-API-Schlüssel mit Zugriff Eingebettete Karten. Siehe API-Schlüssel.
Ein Projekt, das Besucher sehen dürfen. Stellen Sie seine Zugriffsebene auf Nur anzeigen oder Öffentlich. Ein Privat-Projekt öffnet sich nicht für Besucher ohne Konto. Siehe Welche Projekte eingebettet werden können.
Optional Website-Einschränkungen für den Schlüssel, damit die Einbettung nur auf Ihren eigenen Websites funktioniert. Siehe API-Schlüssel.

Den Einbettungscode erstellen#

Entwickler > Karte einbetten erstellt den Code für Sie mit Ihrem Live-Schlüssel: Wählen Sie das Projekt, wählen Sie Design, Einheiten, Kartentyp und Größe, prüfen Sie die Live-Vorschau und kopieren Sie den Einbettungscode. Ist das Projekt privat, weist der Abschnitt darauf hin und bietet Auf „Nur anzeigen“ stellen an. Jeder Schritt wird unter Den Einbettungscode erhalten erklärt.

„Karte einbetten“ mit einem gewählten Projekt und der Live-Vorschau

Der Code enthält Ihren Schlüssel und funktioniert daher, bis Sie den Schlüssel ersetzen. Der Abschnitt warnt Sie, wenn der Schlüssel mehr kann als Eingebettete Karten, da jeder ihn im Quelltext Ihrer Seite lesen kann, und wenn der Schlüssel keine Website-Einschränkungen hat. Nur die Live-Vorschau verwendet ein kurzlebiges Token. Siehe Schlüssel oder Token.

Die Einbettungsadresse#

Eine Einbettung ist ein <iframe>, dessen Adresse mit https://app.measuremaponline.com/iframe_api beginnt, gefolgt von diesen Parametern:

Parameter	Erforderlich	Werte
`pid`	erforderlich	Die Kennung des Projekts: der Teil nach `/p/` in der Adresse des Projekts in der App.
`key`	`key` oder `token`	Ihr API-Schlüssel.
`token`	`key` oder `token`	Ein Token von Ihrem Server (siehe unten).
`ms`	optional	Einheiten: `metric` oder `imperial`. Ohne diesen Parameter sehen Besucher in den Vereinigten Staaten imperiale Einheiten und alle anderen metrische.
`maptype`	optional	`satellite` (Standard), `map`, `hybrid` oder `terrain`.
`theme`	optional	`auto` (Standard: folgt der Systemeinstellung des Besuchers), `light` oder `dark`.

Ein Minimalbeispiel#

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

Ersetzen Sie YOUR_PROJECT_ID, YOUR_API_KEY und YOUR_PROJECT_NAME (Screenreader lesen den title vor), und passen Sie Breite und Höhe an Ihre Seite an.

Der Einbettungscode mit seiner Kopierschaltfläche

Schlüssel oder Token#

Mit key, wie im Code aus dem Abschnitt Karte einbetten, funktioniert die Einbettung, solange der Schlüssel funktioniert, und zwar auf den Websites, die seine Einschränkungen erlauben. Ihr Schlüssel ist dann im Quelltext Ihrer Seite sichtbar, daher:

verwenden Sie einen Schlüssel, der nur den Zugriff Eingebettete Karten hat;
beschränken Sie ihn auf Ihre eigenen Websites;
wenn Sie den Schlüssel ersetzen, aktualisieren Sie Ihre Seiten innerhalb der 24 Stunden, in denen der alte Schlüssel weiter funktioniert.

Mit token bleibt der Schlüssel auf Ihrem Server. Das eignet sich für Einbettungen, die Ihr eigener Server bei jedem Besuch in die Seite schreibt: Bevor die Seite angezeigt wird, fragt er die REST-API nach einem Token und setzt es in die Adresse des iFrames:

POST https://api.measuremaponline.com/api/v2/auth/iframe/token mit Ihrem Schlüssel im Header Authorization gibt ein token zurück, das 60 Minuten lang funktioniert;
POST https://api.measuremaponline.com/api/v2/auth/token tut dasselbe und akzeptiert eine duration in Sekunden, bis zu 24 Stunden. Seine Antwort nennt, wann das Token abläuft.

Ihr Konto kann bis zu 600 Tokens pro Stunde abrufen. Verwenden Sie einen Live-Schlüssel: Einbettungen zeigen nur Live-Projekte, daher öffnet ein Token, das mit einem Sandbox-Schlüssel erstellt wurde, keine Karte. Siehe die REST-API.

Was Besucher tun können#

Besucher können die Karte verschieben und zoomen und die Messwerte Ihrer Formen ablesen. Sie können nichts ändern: Das Bearbeiten ist in einer Einbettung ausgeschaltet, unabhängig von der Zugriffsebene des Projekts. Die einzige Ausnahme ist ein Open-Guest-Projekt im Open-Guest-Tarif, in dem Besucher selbst messen.

Wenn die Karte nicht erscheint#

Prüfen Sie der Reihe nach:

Die Adresse enthält ein token, das abgelaufen ist. Tokens gelten 60 Minuten, sofern Ihr Server nicht eine längere Dauer angefordert hat. Kopieren Sie den Code erneut aus Karte einbetten, der Ihren Schlüssel verwendet, oder lassen Sie Ihren Server für jeden Besuch ein neues Token holen (siehe oben).
Das Projekt ist privat. Stellen Sie es auf Nur anzeigen oder Öffentlich, oder klicken Sie in Karte einbetten auf Auf „Nur anzeigen“ stellen.
Die Website ist nicht erlaubt. Wenn der Schlüssel Website-Einschränkungen hat, muss die Seite, die die Einbettung anzeigt, zu einer davon gehören. Manche Browser und Websites verbergen, auf welcher Seite sich eine Einbettung befindet; bei gesetzten Einschränkungen wird eine solche Einbettung abgelehnt.
Der Schlüssel wurde ersetzt. Ein alter Schlüssel funktioniert 24 Stunden nach dem Erstellen eines neuen nicht mehr, oder sofort, wenn er widerrufen wurde.
Der Schlüssel ist ein Sandbox-Schlüssel. Einbettungen funktionieren nur mit Live-Schlüsseln und Live-Projekten.
Das Abonnement ist nicht aktiv, oder der API-Zugriff wurde gesperrt: Der Abschnitt API-Schlüssel zeigt das an.