Measure Map Online für Entwickler

Aus Ihrem eigenen Anfrageformular

Damit die Angaben des Besuchers schon ausgefüllt sind, fordert Ihr Server mit Ihrem Live-Schlüssel ein Token an und schickt den Besucher zu einem neuen Gastprojekt. Der Schlüssel gelangt nie in den Browser.

// Node.js 18+ with Express. Your API key stays on this server.
const express = require('express');
const app = express();

app.get('/start-measuring', async (req, res) => {
  // A token lets one visitor start one project in your account.
  const reply = await fetch('https://api.measuremaponline.com/api/v2/auth/token', {
    method: 'POST',
    headers: {'Authorization': process.env.MMO_API_KEY, 'Content-Type': 'application/json'},
    body: '{}',
  });
  if (!reply.ok) {
    return res.sendStatus(502);
  }
  const {token} = await reply.json();
  const name = String(req.query.name || '');
  const email = String(req.query.email || '');
  // URLSearchParams encodes every value: "Smith & Sons" arrives whole.
  const params = new URLSearchParams({
    token,
    name,                       // the project's name in your account
    description: email,         // any text you want to search by later
    guest_name: name,           // shown in the email you receive
    guest_email: email,
    // folder_id: 'FOLDER_ID',  // optional: the folder new projects go into
  });
  res.redirect('https://app.measuremaponline.com/app/projects/guest/new?' + params.toString());
});

app.listen(3000);

// On your page: call this from the button on your quote form.
function startMeasuring(name, email) {
  const params = new URLSearchParams({name, email});
  window.open('/start-measuring?' + params.toString(), '_blank', 'noopener');
}

Die Entwicklerseite hält diesen Code für Ihr Konto bereit, unter Gastlink > Open-Guest-API. Jedes Gastprojekt zählt zu Ihrer Open-Guest-Nutzung.

<iframe
  src="https://app.measuremaponline.com/iframe_api?pid=PROJECT_ID&key=YOUR_API_KEY&ms=metric&maptype=satellite&theme=auto"
  width="100%" height="500" style="border: 0"
  title="Messungen des Auftrags">
</iframe>

ms: metric oder imperial · maptype: satellite, map, hybrid oder terrain · theme: auto, light oder dark