Kamera automatisch an Kartenelemente anpassen

Sie können Markierungen, Polylinien, Polygone und 3D-Routen automatisch in einem <gmp-map-3d>-Darstellungsbereich einrahmen, indem Sie das HTML-Attribut autofits-camera oder die Property autofitsCamera für unterstützte untergeordnete Elemente festlegen. Wenn ein oder mehrere untergeordnete Elemente aktiviert sind, wird eine Kameraposition berechnet, bei der alle aktivierten Elemente sichtbar sind.

Die automatische Kameraanpassung ist im v=beta-Kanal der Maps JavaScript API verfügbar. Eine Anleitung zum Laden der Betaversion finden Sie unter Versionsverwaltung.

Unterstützte Elemente

In der folgenden Tabelle sind die untergeordneten Elemente von Map3DElement aufgeführt, die autofits-camera (autofitsCamera) unterstützen:

HTML-Element JavaScript-Klasse Bibliothek Hinweise
<gmp-marker-3d>, <gmp-marker-3d-interactive> Marker3DElement, Marker3DInteractiveElement maps3d Rahmt das position der Markierung ein.
<gmp-marker>, <gmp-marker-interactive> MarkerElement, MarkerInteractiveElement maps3d Rahmt das position der Markierung ein.
<gmp-polyline-3d>, <gmp-polyline-3d-interactive> Polyline3DElement, Polyline3DInteractiveElement maps3d Setzt alle Koordinaten in den path der Polylinie.
<gmp-polygon-3d>, <gmp-polygon-3d-interactive> Polygon3DElement, Polygon3DInteractiveElement maps3d Rahmt alle Koordinaten im path des Polygons ein.
<gmp-route-3d> Route3DElement routes Wartet, bis die Routenanfrage aufgelöst wurde, und rahmt dann den Routenpfad ein.

Nicht unterstützte Elemente

Model3DElement, PopoverElement und FlattenerElement unterstützen autofitsCamera nicht. Wenn Sie diese Elemente einrahmen möchten, legen Sie center und range für <gmp-map-3d> fest oder rufen Sie flyCameraTo auf.

Kamera beim ersten Laden anpassen

Wenn Sie Elemente beim Laden der Karte einrahmen möchten, fügen Sie jedem untergeordneten Element, das im ursprünglichen Darstellungsbereich angezeigt werden soll, das Attribut autofits-camera hinzu. Sie müssen center oder range nicht für <gmp-map-3d> berechnen:

<gmp-map-3d
  style="height: 400px; width: 100%;"
  mode="hybrid">
  <gmp-marker-3d
    position="47.6205,-122.3493"
    title="Space Needle"
    autofits-camera>
  </gmp-marker-3d>
  <gmp-marker-3d
    position="47.6097,-122.3425"
    title="Pike Place Market"
    autofits-camera>
  </gmp-marker-3d>
  <gmp-polyline-3d
    path="47.6205,-122.3493,0 47.6097,-122.3425,0"
    stroke-color="#4285F4"
    stroke-width="8"
    altitude-mode="clamp-to-ground"
    autofits-camera>
  </gmp-polyline-3d>
</gmp-map-3d>

<script async
  src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&v=beta&libraries=maps3d">
</script>

Ersetzen Sie YOUR_API_KEY durch Ihren Google Maps Platform-API-Schlüssel.

Dynamische Updates anpassen und animieren

Wenn Sie nach dem ersten Laden ein Element hinzufügen, für das die Funktion aktiviert ist, die Koordinaten oder Routenendpunkte aktualisieren oder autofitsCamera auf true setzen, wird die Kamera neu berechnet, um alle Elemente, für die die Funktion aktiviert ist, im Bild zu erfassen. Wenn Sie ein Element entfernen oder autofitsCamera auf false setzen, bleibt die Kamera an ihrer Position und das Element wird von zukünftigen Aktualisierungen ausgeschlossen.

Wenn Sie festlegen möchten, ob dynamische Aktualisierungen einrasten oder animiert werden, setzen Sie autofitsCameraAnimation (autofits-camera-animation) für Map3DElement auf einen AutofitsCameraAnimation-Wert:

  • AutofitsCameraAnimation.NONE ("none", Standard): Springt ohne Animation zur aktualisierten Position.
  • AutofitsCameraAnimation.FLY_TO ("fly-to"): Fliegt flüssig zur aktualisierten Position. Das erste Laden der Karte erfolgt ohne Animation. FLY_TO wird auf ein Einrasten zurückgesetzt, wenn das Betriebssystem des Nutzers eine reduzierte Bewegung anfordert.

Informationen zum programmatischen Konfigurieren von autofitsCamera und AutofitsCameraAnimation.FLY_TO finden Sie im folgenden Beispiel:

<div id="map-container" style="height: 400px; width: 100%;"></div>

<script>
  async function initMap() {
    const {
      AutofitsCameraAnimation,
      Map3DElement,
      Marker3DElement,
      MapMode,
    } = await google.maps.importLibrary('maps3d');

    const map = new Map3DElement({
      mode: MapMode.HYBRID,
      autofitsCameraAnimation: AutofitsCameraAnimation.FLY_TO,
    });
    document.getElementById('map-container').append(map);

    const originMarker = new Marker3DElement({
      position: { lat: 37.7955, lng: -122.3937 },
      autofitsCamera: true,
    });
    map.append(originMarker);

    /* Adding a second opted-in marker flies the camera to frame both. */
    const destinationMarker = new Marker3DElement({
      position: { lat: 37.8080, lng: -122.4177 },
      autofitsCamera: true,
    });
    map.append(destinationMarker);
  }
</script>
<script async
  src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&v=beta&loading=async&callback=initMap">
</script>

Ersetzen Sie YOUR_API_KEY durch Ihren Google Maps Platform-API-Schlüssel.

Zusammenspiel von Kameraeigenschaften und Einschränkungen

Wenn mindestens ein untergeordnetes Element mit autofits-camera aktiviert ist, kombiniert Map3DElement Ihre Kartenkonfiguration mit den berechneten Grenzen gemäß den folgenden Regeln:

  • center und range: Werden durch den berechneten Frame überschrieben, der einen Bereichspuffer von 20 % hinzufügt und einen Mindestbereich von 80 m erzwingt. Wenn keine aktivierten untergeordneten Elemente Koordinaten bereitstellen, werden die konfigurierten Werte für center und range als Fallback verwendet.
  • tilt und heading: Werden beim Framing als vorgeschlagene Werte behandelt. Wenn sie weggelassen werden, werden beide standardmäßig auf 0° gesetzt, um eine Draufsicht mit Nordausrichtung zu erhalten.
  • roll und fov: Werden wie auf Map3DElement konfiguriert beibehalten.
  • Asynchrone untergeordnete Elemente: Vor dem Rendern der ersten Ansicht wartet Map3DElement, bis aktivierte asynchrone untergeordnete Elemente wie <gmp-route-3d> die Routengeometrie geladen haben.
  • Karten- und Kameraeinschränkungen: Die automatisch angepasste Ansicht wird weiterhin durch geografische bounds- und Kameraeinschränkungen (minAltitude, maxAltitude, minTilt, maxTilt, minHeading und maxHeading) eingeschränkt. Weitere Informationen finden Sie unter Kameraansicht und -grenzen einschränken.

Nächste Schritte