Die Maps JavaScript API bietet zwei verschiedene Kartenimplementierungen: Raster und Vektor. Bei der Rasterkarte wird die Karte als Raster aus pixelbasierten Rasterbildkacheln geladen, die serverseitig von der Google Maps Platform generiert und dann an Ihre Webanwendung gesendet werden. Die Vektorkarte besteht aus vektorbasierten Kacheln, die beim Laden auf der Clientseite mit WebGL gezeichnet werden. WebGL ist eine Webtechnologie, mit der der Browser auf die GPU auf dem Gerät des Nutzers zugreifen kann, um 2D- und 3D-Grafiken zu rendern.
Der Vektorkartentyp wird für die beste Nutzererfahrung empfohlen, da er eine verbesserte visuelle Wiedergabetreue, besseres Caching über Karten hinweg sowie die Möglichkeit bietet, Neigung und Ausrichtung auf der Karte zu steuern. Weitere Informationen zu Vektorkartenfunktionen
Standard-Rendering-Typ
Der Standard-Rendering-Typ der Karte variiert je nach Implementierung.
Bei Karten, die das
<gmp-map>-Element verwenden, wird standardmäßig der Rendering-Typ „Vektor“ verwendet.Bei Karten, die ein
<div>-Element mitgoogle.maps.Mapverwenden, wird standardmäßig der Rendering-Typ „Raster“ verwendet.
Sie können den Renderingtyp für eine Karte entweder über die Kartenoption renderingType oder über eine verknüpfte Karten-ID festlegen. Die Option renderingType überschreibt alle Einstellungen für den Rendering-Typ, die durch die Konfiguration einer Karten-ID vorgenommen wurden.
Geben Sie die Option renderingType an.
Mit der Option renderingType können Sie entweder den Raster- oder den Vektor-Rendering-Typ für Ihre Karte angeben (keine Karten-ID erforderlich). Für Karten, die mit einem div-Element und JavaScript geladen werden, ist der Standardrenderingtyp google.maps.RenderingType.RASTER. So legen Sie die Option renderingType fest:
Laden Sie die
RenderingType-Bibliothek. Das kann beim Laden der Maps-Bibliothek erfolgen:const { Map, RenderingType } = await google.maps.importLibrary("maps");Verwenden Sie beim Initialisieren der Karte die Option
renderingType, um entwederRenderingType.VECTORoderRenderingType.RASTERanzugeben:map = new Map( document.getElementById('map'), { zoom: 4, center: position, renderingType: RenderingType.VECTOR, } );
Wenn der Renderingtyp für die Vektorkarte festgelegt ist, müssen Sie die Optionen für die erforderlichen Funktionen festlegen.
- Wenn Sie die Neigung aktivieren möchten, setzen Sie die Kartenoption
tiltInteractionEnabledauftrueoder rufen Siemap.setTiltInteractionEnabled(true)auf. - Wenn Sie das Schwenken aktivieren möchten, setzen Sie die Kartenoption
headingInteractionEnabledauftrueoder rufen Siemap.setHeadingInteractionEnabled(true)auf.
Bei Karten, die mit dem <gmp-map>-Element geladen werden, ist der Standardrenderingtyp google.maps.RenderingType.VECTOR, wobei die Steuerung von Neigung und Ausrichtung aktiviert ist. Wenn Sie den Renderingtyp mit dem Element <gmp-map> festlegen möchten, verwenden Sie das Attribut rendering-type.
Renderingtyp mit einer Karten-ID festlegen
Sie können den Renderingtyp auch mithilfe einer Karten-ID angeben. Eine Anleitung zum Erstellen einer Karten-ID finden Sie unter Cloudbasiertes Gestalten von Karteninhalten. Legen Sie den Kartentyp auf JavaScript fest und wählen Sie eine Option aus (Vektor oder Raster). Setzen Sie ein Häkchen bei Neigung und Drehung, um Neigung und Drehung auf der Karte zu aktivieren. Wenn Sie so vorgehen, lassen sich diese Werte programmatisch anpassen. Außerdem haben die Nutzer die Möglichkeit, Neigung und Position direkt auf der Karte zu ändern. Wenn sich die Verwendung dieser Optionen negativ auf Ihre App auswirkt, lassen Sie Neigung und Drehung deaktiviert, damit Nutzer die Karte nicht neigen und drehen können.

Aktualisieren Sie dann den Initialisierungscode der Karte mit der von Ihnen erstellten Karten-ID. Sie finden Ihre Karten-IDs auf der Seite Kartenverwaltung. Geben Sie eine Karten-ID an, wenn Sie die Karte mit der mapId-Eigenschaft instanziieren:
map = new google.maps.Map(document.getElementById('map'), { center: {lat: -34.397, lng: 150.644}, zoom: 8, mapId: 'MAP_ID' });
Rendering-Typ erkennen
Wenn Sie herausfinden möchten, welcher Renderingtyp verwendet wird, rufen Sie getRenderingType() für das Kartenobjekt auf, wie im folgenden Beispiel gezeigt:
// Wait for the map to finish loading.
google.maps.event.addListenerOnce(map, "tilesloaded", () => {
// Print the rendering type to the console.
console.log(`${map.getRenderingType()}`);
});```