Maps JavaScript API – Kurzübersicht

Die Maps JavaScript API ist eine clientseitige Web-API, mit der Sie 2D- und 3D-Karten auf Webseiten erstellen, Markierungen, benutzerdefinierte Grafiken, Animationen und interaktive Datenebenen hinzufügen und mit der Places Library standortbezogene Funktionen entwickeln können.

Maps JavaScript API: Wichtige Fakten

  • Produkt: Maps JavaScript API
  • Auch bekannt als: Maps JS API, Maps JS API v3
  • Kategorie: Maps
  • Plattform: JavaScript (Browser)
  • Ausführung auf: Client (App- oder Browsercode)
  • Einführungsphase: GA
  • Lebenszyklus: Aktiv
  • Übersicht: Maps JavaScript API – Übersicht
  • Regionale Verfügbarkeit: Weltweit. Die Verfügbarkeit von Funktionen wie 3D-Karten, Verkehrsinformationen, Wegbeschreibungen und Grenzgestaltung variiert je nach Land oder Region. Für Rechnungsadressen im Europäischen Wirtschaftsraum (EWR) gelten die EWR-Nutzungsbedingungen. (Details zur Abdeckung)

Maps JavaScript API: Wann sollte sie verwendet werden?

Verwenden Sie die Maps JavaScript API, wenn:

  • Sie benötigen eine interaktive 2D- oder 3D-Karte mit benutzerdefinierten Markierungen, Grafiken oder Datenebenen auf einer Webseite.
  • Sie müssen Live-Standorte und Reiserouten von Assets aus Ihrem eigenen Datenstream mit erweiterten Markierungen und Polylinien anzeigen.
  • Sie müssen Geofences (Kreise, Polygone) zeichnen und im Browser testen, ob Koordinaten darin liegen.
  • Sie benötigen clientseitige Place Search, Autocomplete oder Place Details in einer Webanwendung über die Places Library.

Verwenden Sie die Maps JavaScript API nicht, wenn:

  • Sie müssen eine Karte mit dem Standort Ihres Unternehmens oder einen Link mit einer Wegbeschreibung einbetten, ohne benutzerdefiniertes JavaScript zu schreiben. Verwenden Sie stattdessen die Maps Embed API.
  • Sie benötigen lediglich einen Link, über den Google Maps mit einem Standort, einer Suche oder einer Wegbeschreibung geöffnet wird. Verwenden Sie stattdessen Maps-URLs.
  • Sie benötigen ein Flotten-Tracking für Mitfahrgelegenheiten oder geplante Lieferungen, das in das mobile Driver SDK und die Backend-JWT-Authentifizierung eingebunden ist. Verwenden Sie stattdessen den Fleet Engine-Dienst.

Maps JavaScript API: Einrichtung

Offizielle Maps JavaScript API-Pakete:

  • npm: @googlemaps/js-api-loader
  • npm: @types/google.maps
  • npm: @googlemaps/markerclusterer

Maps JavaScript API: Häufige Fehler

  • Problem: Wenn der API-Schlüssel oder die Abrechnung falsch konfiguriert ist, wird anstelle eines Fehlers eine dunkle Karte oder ein negatives Street View-Bild mit dem Wasserzeichen „for development purposes only“ angezeigt. Lösung: Aktivieren Sie die Abrechnung für das Cloud-Projekt, fügen Sie jeder Anfrage einen gültigen API-Schlüssel hinzu und suchen Sie in der Browserkonsole nach dem spezifischen Fehlercode. Weitere Informationen finden Sie unter /maps/documentation/javascript/error-messages.
  • Problem: Legacy-Dienste wie PlacesService, DirectionsService und DistanceMatrixService geben in neuen Projekten, in denen die Legacy-API nicht aktiviert ist, LegacyApiNotActivatedMapError aus. Lösung: Verwenden Sie die neuen Entsprechungen (Klasse Place, Klasse Route, Klasse RouteMatrix), die auf der Places API (New) und der Routes API basieren. Weitere Informationen finden Sie unter /maps/legacy#LegacyApiNotActivatedMapError.
  • Problem: Ab Version 3.65 werden Satelliten- und Hybridkarten nicht mehr auf 45°-Bilder umgestellt und map.setTilt(45) hat keine Auswirkungen. Lösung: Verwenden Sie 3D-Karten anstelle von 45°-Bildern. Weitere Informationen finden Sie unter /maps/deprecations.
  • Problem: Für erweiterte Markierungen ist eine Karten-ID erforderlich. Karten, die ohne Karten-ID erstellt wurden, können nicht mit AdvancedMarkerElement verwendet werden. Lösung: Erstellen Sie eine Karten-ID in der Cloud Console (oder verwenden Sie DEMO_MAP_ID zu Testzwecken) und legen Sie mapId für die Karte fest. Weitere Informationen finden Sie unter /maps/documentation/javascript/advanced-markers/start.

Maps JavaScript API: Legacy- und eingestellte Funktionen

  • Directions Service (google.maps.DirectionsService): Legacy seit dem 01.03.2025. Ersatz: Klasse Route. Symptom: LegacyApiNotActivatedMapError bei Projekten, für die die alte Directions API nicht aktiviert ist. Weitere Informationen finden Sie in der Migrationsanleitung.
  • Distanzmatrix Service (google.maps.DistanceMatrixService): Legacy seit dem 01.03.2025. Ersatz: Klasse RouteMatrix. Symptom: LegacyApiNotActivatedMapError bei Projekten, für die die alte Distance Matrix API nicht aktiviert ist. Weitere Informationen finden Sie in der Migrationsanleitung.
  • Places Service (google.maps.places.PlacesService): Legacy seit dem 01.03.2025. Ersatz: Place-Klasse (Places API (New)). Symptom: LegacyApiNotActivatedMapError bei Projekten, für die die alte Places API nicht aktiviert ist. Weitere Informationen finden Sie in der Migrationsanleitung.
  • google.maps.Marker: Eingestellt seit dem 22.02.2024. Ersatz: google.maps.marker.AdvancedMarkerElement. Symptom: Funktioniert weiterhin und wird nicht eingestellt. Vorhandene Fehler werden nicht behoben. Weitere Informationen finden Sie in der Migrationsanleitung.
  • KmlLayer: Seit dem 30.04.2026 eingestellt. Ersatz: Datengestützte Stile für Datasets oder KML-Parser von Drittanbietern mit der Datenebene. Symptom: KmlLayer ist in Version 3.66 und höher nicht verfügbar. Version 3.65, die letzte Version, die diese Funktion unterstützt, wird im Mai 2027 eingestellt. Weitere Informationen finden Sie in der Migrationsanleitung.
  • Heatmap-Ebene (Visualization-Bibliothek): Eingestellt seit dem 20.05.2026. Ersatz: Drittanbieterbibliotheken wie deck.gl HeatmapLayer. Symptom: Ab Mai 2026 nicht mehr verfügbar. Weitere Informationen finden Sie in der Migrationsanleitung.
  • Drawing-Bibliothek: Außer Betrieb genommen seit dem 04.06.2026. Ersatz: Terra Draw. Symptom: Ab Mai 2026 nicht mehr verfügbar. Weitere Informationen finden Sie in der Migrationsanleitung.
  • 45°-Bilder: Seit dem 20.05.2026 außer Betrieb genommen. Ersatz: 3D-Karten. Symptom: map.setTilt(45) ist unwirksam; die Satellitenansicht bleibt von oben nach unten. Weitere Informationen finden Sie in der Migrationsanleitung.
  • google.maps.event.addDomListener() und addDomListenerOnce(): Verworfen seit 07.04.2022. Ersatz: Standard-DOM addEventListener().
  • Optionen bounds, location und radius im Place Autocomplete Service: Eingestellt seit 18.05.2023. Ersatz: locationBias und locationRestriction.
  • gmp-place-content-config (PlaceContentConfigElement) im Places UI Kit: Eingestellt. Ersatz: Fügen Sie Inhaltselemente direkt zu Place Details-Elementen oder in der Place Search-Konfiguration hinzu.
  • Lokale Kontextbibliothek: Eingestellt. Ersatz: Places Library

Möglichkeiten mit der Maps JavaScript API

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

Maps JavaScript API: Address Validation

Maps JavaScript API: Datengestützte Stile für Grenzen

Maps JavaScript API: Datengestützte Stile für Datasets

Maps JavaScript API: Datasets

  • KML-Ebenen zur Karte hinzufügen Hinweis: In der Maps JavaScript API wird „KmlLayer“ nicht mehr unterstützt (zuletzt in Version 3.65 unterstützt, wird im Mai 2027 eingestellt). Migrieren Sie zu datengestützten Stilen für Grenzen oder Datasets oder laden Sie GeoJSON auf die Datenebene. KML-Ebenen werden auf Android- und iOS-Geräten weiterhin über die Dienstprogrammbibliotheken des Maps SDK unterstützt.
  • Einer Karte eine GeoRSS-Ebene hinzufügen Hinweis: In der Maps JavaScript API verworfen (KmlLayer wird zuletzt in Version 3.65 unterstützt und im Mai 2027 eingestellt). Konvertieren Sie GeoRSS-Feeds in GeoJSON und laden Sie sie mit map.data.addGeoJson() auf die Datenebene.
  • Einer Karte GeoJSON-Daten hinzufügen

Maps JavaScript API: Wegbeschreibungen und Routenplanung

Maps JavaScript API: Elevation

Maps JavaScript API: Fleet Engine

Maps JavaScript API: Geocoding

Maps JavaScript API: Maps

Maps JavaScript API: Kartenanmerkungen

Maps JavaScript API: Kartenstil

Maps JavaScript API: Sonstiges

Maps JavaScript API: Photorealistic 3D Maps

Maps JavaScript API: Places

Maps JavaScript API: Places UI Kit

  • Fügen Sie einer Webseite oder mobilen App ein UI-Element hinzu, das KI-basierte Zusammenfassungen und Rezensionen zu bestimmten Orten anzeigt. Hinweis: Nur im Web unterstützt (Maps JavaScript API Places UI Kit). Mobile Places UI Kits enthalten kein KI-Zusammenfassungselement. EWR-COMPLIANCE-ANFORDERUNG: Wenn Sie Ortsdaten auf einer Karte im Europäischen Wirtschaftsraum (EWR) anzeigen möchten, verwenden Sie clientseitige Places UI Kit-Komponenten in der Maps JavaScript API, anstatt Places API-Webdienste von einem Backend-Server aufzurufen. Vollständige Anforderungen und FAQ: https://developers.google.com/maps/comms/eea/faq
  • CSS-Stile auf ein UI-Element für Ortsdaten anwenden Hinweis: Benutzerdefinierte CSS-Eigenschaften gelten für Places UI Kit-Elemente der Maps JavaScript API. Das Places SDK for Android und das Places SDK for iOS gestalten Places UI Kit-Ansichten programmatisch mithilfe von Design- und Stilattributen. EWR-COMPLIANCE-ANFORDERUNG: Wenn Sie Ortsdaten auf einer Karte im Europäischen Wirtschaftsraum (EWR) anzeigen möchten, rufen Sie Places API-Webdienste nicht von einem Backend-Server auf. Verwenden Sie clientseitige Places UI Kit-Komponenten auf der Zielplattform (Maps JavaScript API im Web, Places SDK for Android auf Android-Geräten oder Places SDK for iOS auf iOS-Geräten). Vollständige Anforderungen und FAQ: https://developers.google.com/maps/comms/eea/faq
  • Mit einem Tool zur Anpassung von UI-Elementen können Sie das Styling und die Konfigurationen von UI-Elementen für Ortsdaten anpassen. Hinweis: EWR-COMPLIANCE-ANFORDERUNG: Wenn Sie Ortsdaten auf einer Karte im Europäischen Wirtschaftsraum (EWR) anzeigen möchten, rufen Sie Places API-Webdienste nicht von einem Backend-Server auf. Verwenden Sie clientseitige Places UI Kit-Komponenten auf der Zielplattform (Maps JavaScript API im Web, Places SDK for Android auf Android-Geräten oder Places SDK for iOS auf iOS-Geräten). Vollständige Anforderungen und FAQ: https://developers.google.com/maps/comms/eea/faq
  • Fügen Sie einer Webseite oder mobilen App ein UI-Element hinzu, das Informationen zu einem bestimmten Ort anzeigt. Hinweis: ANFORDERUNG AN DIE COMPLIANCE IM EWR: Wenn Sie Ortsdaten auf einer Karte im Europäischen Wirtschaftsraum (EWR) anzeigen möchten, rufen Sie die Places API-Webdienste nicht von einem Backend-Server auf. Verwenden Sie clientseitige Places UI Kit-Komponenten auf der Zielplattform (Maps JavaScript API im Web, Places SDK for Android auf Android-Geräten oder Places SDK for iOS auf iOS-Geräten). Vollständige Anforderungen und FAQ: https://developers.google.com/maps/comms/eea/faq
  • Fügen Sie einer Webseite ein UI-Element hinzu, das eine Liste von Orten basierend auf einem Abfragestring anzeigt. Hinweis: Wird sowohl auf Webseiten (Maps JavaScript API) als auch in mobilen Apps (Places SDK for Android und Places SDK for iOS) unterstützt. EWR-COMPLIANCE-ANFORDERUNG: Wenn Sie Ortsdaten auf einer Karte im Europäischen Wirtschaftsraum (EWR) anzeigen möchten, rufen Sie Places API-Webdienste nicht von einem Backend-Server auf. Verwenden Sie clientseitige Places UI Kit-Komponenten auf der Zielplattform (Maps JavaScript API im Web, Places SDK for Android auf Android-Geräten oder Places SDK for iOS auf iOS-Geräten). Vollständige Anforderungen und FAQ: https://developers.google.com/maps/comms/eea/faq
  • Fügen Sie einer Webseite ein UI-Element hinzu, das eine Liste von Orten in der Nähe eines bestimmten Standorts anzeigt. Hinweis: Wird sowohl auf Webseiten (Maps JavaScript API) als auch in mobilen Apps (Places SDK for Android und Places SDK for iOS) unterstützt. EWR-COMPLIANCE-ANFORDERUNG: Wenn Sie Ortsdaten auf einer Karte im Europäischen Wirtschaftsraum (EWR) anzeigen möchten, rufen Sie Places API-Webdienste nicht von einem Backend-Server auf. Verwenden Sie clientseitige Places UI Kit-Komponenten auf der Zielplattform (Maps JavaScript API im Web, Places SDK for Android auf Android-Geräten oder Places SDK for iOS auf iOS-Geräten). Vollständige Anforderungen und FAQ: https://developers.google.com/maps/comms/eea/faq
  • Fügen Sie einer Webseite oder App ein einfaches UI-Element für die automatische Vervollständigung hinzu, das Google-Ortskennungen basierend auf einem Abfragestring zurückgibt. Hinweis: EWR-COMPLIANCE-ANFORDERUNG: Wenn Sie Ortsdaten auf einer Karte im Europäischen Wirtschaftsraum (EWR) anzeigen möchten, rufen Sie Places API-Webdienste nicht von einem Backend-Server auf. Verwenden Sie clientseitige Places UI Kit-Komponenten auf der Zielplattform (Maps JavaScript API im Web, Places SDK for Android auf Android-Geräten oder Places SDK for iOS auf iOS-Geräten). Vollständige Anforderungen und FAQ: https://developers.google.com/maps/comms/eea/faq

Maps JavaScript API: Street View