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_TOwird 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:
centerundrange: 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ürcenterundrangeals Fallback verwendet.tiltundheading: Werden beim Framing als vorgeschlagene Werte behandelt. Wenn sie weggelassen werden, werden beide standardmäßig auf0°gesetzt, um eine Draufsicht mit Nordausrichtung zu erhalten.rollundfov: Werden wie aufMap3DElementkonfiguriert 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,minHeadingundmaxHeading) eingeschränkt. Weitere Informationen finden Sie unter Kameraansicht und -grenzen einschränken.