Maps Embed API – Kurzübersicht

Mit der Maps Embed API wird über eine HTTP-Anfrage, die als iFrame-src-URL festgelegt ist, eine interaktive Karte oder ein Street View-Panorama auf einer Webseite platziert. JavaScript ist nicht erforderlich. Die Kartenmodi place, view, directions, streetview und search werden unterstützt.

Maps Embed API: Wichtige Fakten

  • Produkt: Maps Embed API
  • Auch bekannt als: Google Maps Embed API, Maps Embed
  • Kategorie: Maps
  • Plattform: JavaScript (Browser)
  • Ausführung auf: Client (App- oder Browsercode)
  • Einführungsphase: GA
  • Lebenszyklus: Aktiv
  • Übersicht: Maps Embed API – Übersicht
  • Regionale Verfügbarkeit: Weltweit. Der Street View-Modus hängt von der Street View-Abdeckung ab. Der Parameter region akzeptiert Regionen, die auf der Detailseite zur Maps Platform-Abdeckung aufgeführt sind. (Details zur Abdeckung)

Maps Embed API: Wann sollte sie verwendet werden?

Verwenden Sie die Maps Embed API, wenn:

  • Sie benötigen eine interaktive Karte oder ein Street View-Panorama auf einer Webseite, die nur ein HTML-Iframe und kein JavaScript enthält.
  • Sie möchten eine Ortsmarkierung, eine Kartenansicht, eine Wegbeschreibung zwischen Punkten oder Suchergebnisse für ein Gebiet in einer eingebetteten Karte anzeigen.
  • Sie benötigen eine eingebettete Karte ohne Gebühren pro Anfrage und ohne Limits für Abfragen pro Sekunde oder tägliche Anfragen. Ein API-Schlüssel ist weiterhin erforderlich.

Verwenden Sie die Maps Embed API nicht, wenn:

  • Sie müssen eine Webkarte mit eigenen Inhalten und Bildern anpassen. Verwenden Sie stattdessen die Maps JavaScript API.
  • Sie möchten eine eingebettete Karte mit programmatischen Funktionen erweitern, die über die iFrame-URL-Parameter hinausgehen. Verwenden Sie stattdessen die Maps JavaScript API.

Maps Embed API: Einrichtung

Maps Embed API: Häufige Fehler

  • Problem: Wenn auf der Hostseite ein referrer-Meta-Tag auf no-referrer oder same-origin gesetzt ist, sendet der Browser den Referer-Header nicht und ein API-Schlüssel mit HTTP-Referrer-Einschränkung kann die Einbettungsanfragen ablehnen. Lösung: Fügen Sie dem iFrame referrerpolicy="strict-origin-when-cross-origin" hinzu, damit die Domain der Website an Google gesendet wird. Weitere Informationen finden Sie unter /maps/documentation/embed/embedding-map.
  • Problem: Eingebettete Karten werden nicht unterstützt, wenn sie in einer der beiden Dimensionen kleiner als 200 px sind. Lösung: Legen Sie für width und height des iFrames mindestens 200 Pixel fest. Weitere Informationen finden Sie unter /maps/documentation/embed/embedding-map.
  • Problem: Obwohl die Nutzung kostenlos ist, wird eine abgedunkelte Karte mit dem Wasserzeichen „Nur für Entwicklungszwecke“ angezeigt, wenn die Abrechnung nicht aktiviert ist, die Abrechnungsmethode ungültig ist, ein selbst auferlegtes Tageslimit überschritten wurde oder die Anfrage keinen HTTP-Referrer enthält, während ein Schlüssel mit Referrer-Einschränkung verwendet wird. Lösung: Aktivieren Sie die Abrechnung mit einer gültigen Zahlungsmethode für das Projekt, erhöhen oder entfernen Sie selbst auferlegte tägliche Kontingentlimits und achten Sie darauf, dass der Referrer für Schlüssel mit Referrer-Einschränkung gesendet wird (z. B. mit referrerpolicy="strict-origin-when-cross-origin" im iFrame). Weitere Informationen finden Sie unter /maps/documentation/embed/error-messages.
  • Problem: Bei ungültigen Anfragen (fehlerhafte oder fehlende Parameter sowie API-Schlüssel- und Kontingentfehler wie ein fehlender oder ungültiger Schlüssel, eine nicht aktivierte Maps Embed API oder ein Verstoß gegen eine Schlüsseleinschränkung) wird in der Browserkonsole nur der HTTP-Statuscode 4xx gemeldet, keine beschreibende Meldung. Der Fehlertext wird im iFrame anstelle der Karte angezeigt. Lösung: Lesen Sie den Fehlertext im iFrame und den Statuscode in der Konsole (400 für Parameterfehler, 401 für einen fehlenden Schlüssel, 403 für einen ungültigen Schlüssel). Prüfen Sie dann, ob die Parameter und der Schlüssel gültig sind, die Maps Embed API aktiviert ist und die Schlüsseleinschränkungen die Anfrage zulassen. Weitere Informationen finden Sie unter /maps/documentation/embed/error-messages.

Was Sie mit der Maps Embed API tun können

In den unten verlinkten Anleitungen finden Sie Informationen zu den einzelnen Aufgaben. Sie können die Produkte auch im Capabilities Explorer vergleichen.

Maps Embed API: Wegbeschreibungen und Routenplanung

Maps Embed API: Maps

Maps Embed API: Places

Maps Embed API: Street View