Übersicht

Über die WebGL-gestützten Funktionen für die Maps JavaScript API können Sie u. a. Neigung und Drehung Ihrer Karte steuern und 3D-Objekte direkt auf der Karte einfügen. Die folgenden Funktionen sind enthalten:

  • Mit WebGL Overlay View können Sie Ihren Karten benutzerdefinierte 2D- und 3D-Grafiken sowie animierte Inhalte hinzufügen.
  • Neigung und Position lassen sich jetzt programmatisch und mithilfe von Maus und Tastatur anpassen.
  • Mit map.moveCamera() können Sie mehrere Kameraeigenschaften gleichzeitig ändern.
  • Der Zoom unterstützt jetzt Bruchwerte.

Jetzt starten

Wenn Sie die neuen WebGL-Funktionen verwenden möchten, müssen Sie eine Vektorkarte verwenden. In diesem Abschnitt wird gezeigt, wie das geht.

Option renderingType angeben

Mit der Option renderingType können Sie entweder den Raster- oder den Vektor-Rendering-Typ für Ihre Karte angeben (keine Karten-ID erforderlich):

  1. Laden Sie die RenderingType-Bibliothek. Das geht auch beim Laden der Maps-Bibliothek:

    const { Map, RenderingType } = await google.maps.importLibrary("maps") as google.maps.MapsLibrary;

  2. Verwenden Sie beim Initialisieren der Karte die Option renderingType, um entweder RenderingType.VECTOR oder RenderingType.RASTER anzugeben:

    map = new Map(
  document.getElementById('map') as HTMLElement,
  {
    zoom: 4,
    center: position,
    renderingType: RenderingType.VECTOR,
  }
);

Mit der Option renderingType werden alle Einstellungen für den Renderingtyp überschrieben, die durch die Konfiguration einer Karten-ID vorgenommen wurden.

  • Wenn Sie Neigung und Drehung aktivieren möchten, setzen Sie für die Kartenoption tiltInteractionEnabled den Wert „wahr“ oder rufen Sie map.setTiltInteractionEnabled auf.
  • Wenn Sie das Schwenken aktivieren möchten, legen Sie die Kartenoption headingInteractionEnabled auf true fest oder rufen Sie map.setHeadingInteractionEnabled auf.

Mit einer Karten-ID den Renderingtyp 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 die Option Vektor aus. Setzen Sie ein Häkchen neben Neigung und/oder Drehung, damit die Karte geneigt oder gedreht werden kann. 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.

Vektorkarten-ID erstellen

Aktualisieren Sie als Nächstes 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'
});

<gmp-map>-Element verwenden

Vektorkarten, Neigung und Ausrichtung sind standardmäßig aktiviert, wenn Sie das Element <gmp-map> verwenden. Damit können Sie Ihrer Seite eine Karte mit HTML hinzufügen. Weitere Informationen

Beispiele

Beispiele zur Veranschaulichung folgender Elemente: