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
regionakzeptiert 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
- Zu aktivierender Dienst:
maps-embed-backend.googleapis.com - Authentifizierung: API-Schlüssel
- Erste Schritte: Maps Embed API einrichten
- Referenz: Maps Embed API-Referenz
- Preise: Maps Embed API-Nutzung und -Abrechnung
Maps Embed API: Häufige Fehler
- Problem: Wenn auf der Hostseite ein
referrer-Meta-Tag aufno-referrerodersame-origingesetzt ist, sendet der Browser denReferer-Header nicht und ein API-Schlüssel mit HTTP-Referrer-Einschränkung kann die Einbettungsanfragen ablehnen. Lösung: Fügen Sie dem iFramereferrerpolicy="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
widthundheightdes 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.