Desteklenen alt öğelerde autofits-camera HTML özelliğini veya autofitsCamera özelliğini ayarlayarak işaretçileri, çoklu çizgileri, poligonları ve 3D rotaları <gmp-map-3d> görüntü alanında otomatik olarak çerçeveleyebilirsiniz. Bir veya daha fazla alt öğe etkinleştirildiğinde harita, etkinleştirilen tüm öğeleri görünürde tutan bir kamera konumu hesaplar.
Otomatik kamera sığdırma özelliği, Maps JavaScript API'nin v=beta kanalında kullanılabilir. Beta kanalını yükleme talimatları için Sürüm oluşturma başlıklı makaleyi inceleyin.
Desteklenen öğeler
Aşağıdaki tabloda, autofits-camera (autofitsCamera) destekleyen Map3DElement alt öğeleri listelenmiştir:
| HTML öğesi | JavaScript sınıfı | Kitaplık | Notlar |
|---|---|---|---|
<gmp-marker-3d>, <gmp-marker-3d-interactive> |
Marker3DElement,
Marker3DInteractiveElement
|
maps3d |
İşaretçinin position değerini çerçeveler. |
<gmp-marker>, <gmp-marker-interactive> |
MarkerElement,
MarkerInteractiveElement
|
maps3d |
İşaretçinin position değerini çerçeveler. |
<gmp-polyline-3d>, <gmp-polyline-3d-interactive> |
Polyline3DElement,
Polyline3DInteractiveElement
|
maps3d |
Çoklu çizginin path içindeki tüm koordinatları çerçeveler. |
<gmp-polygon-3d>, <gmp-polygon-3d-interactive> |
Polygon3DElement,
Polygon3DInteractiveElement
|
maps3d |
Çokgenin path içindeki tüm koordinatları çerçeveler. |
<gmp-route-3d> |
Route3DElement
|
routes |
Rota isteğinin çözümlenmesini bekler, ardından rota yolunu çerçeveler. |
Desteklenmeyen öğeler
Model3DElement,
PopoverElement
ve
FlattenerElement
autofitsCamera özelliğini desteklemiyor. Bu öğeleri çerçevelemek için <gmp-map-3d> üzerinde center ve range değerlerini ayarlayın veya flyCameraTo işlevini çağırın.
Kamerayı ilk yüklemede sığdır
Harita yüklendiğinde öğeleri çerçevelemek için ilk görüntü alanında olmasını istediğiniz her alt öğeye autofits-camera özelliğini ekleyin. <gmp-map-3d> için center veya range hesaplamanız gerekmez:
<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>
YOUR_API_KEY kısmını Google Haritalar Platformu API anahtarınızla değiştirin.
Dinamik güncellemeleri sığdırma ve animasyon ekleme
İlk yüklemeden sonra etkinleştirilmiş bir öğe eklediğinizde, koordinatlarını veya rota uç noktalarını güncellediğinizde ya da autofitsCamera değerini true olarak ayarladığınızda harita, etkinleştirilmiş tüm öğeleri çerçevelemek için kamerayı yeniden hesaplar. Bir öğeyi kaldırmak veya autofitsCamera değerini false olarak ayarlamak, kamerayı olduğu konumda bırakır ve bu öğeyi gelecekteki güncellemelerden hariç tutar.
Dinamik güncellemelerin anlık olarak mı yoksa animasyonlu olarak mı gerçekleşeceğini kontrol etmek için Map3DElement üzerinde autofitsCameraAnimation (autofits-camera-animation) özelliğini bir AutofitsCameraAnimation değerine ayarlayın:
AutofitsCameraAnimation.NONE("none", varsayılan): Animasyon olmadan güncellenen konuma geçer.AutofitsCameraAnimation.FLY_TO("fly-to"): Güncellenen konuma sorunsuz bir şekilde uçar. İlk harita yüklemesi animasyon olmadan gerçekleşir ve kullanıcının işletim sistemi daha az hareket istediğindeFLY_TO, animasyon olmadan gerçekleşir.
autofitsCamera ve AutofitsCameraAnimation.FLY_TO ayarlarını programatik olarak yapılandırmak için aşağıdaki örneğe bakın:
<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>
YOUR_API_KEY kısmını Google Haritalar Platformu API anahtarınızla değiştirin.
Kamera özellikleri ve kısıtlamalarının etkileşimi
En az bir alt öğe autofits-camera ile etkinleştirildiğinde Map3DElement, harita yapılandırmanızı aşağıdaki kurallara göre hesaplanan sınırlarla birleştirir:
centerverange: Hesaplanan kadrajlama tarafından geçersiz kılınır. Bu, %20 aralık dolgusu ekler ve 80 m minimum aralığı zorunlu kılar. Etkinleştirilmiş alt öğelerden hiçbiri koordinat sağlamıyorsa harita, yedek olarak yapılandırılmışcenterverangedeğerlerini kullanır.tiltveheading: Kadrajlama sırasında önerilen değerler olarak değerlendirilir. Atlandığında, her ikisi de varsayılan olarak0°değerini alır ve kuş bakışı, kuzey yukarıda görünümü elde edilir.rollvefov:Map3DElementtarihinde yapılandırıldığı şekilde korunur.- Eşzamansız alt öğeler:
Map3DElement, ilk görünümü oluşturmadan önce<gmp-route-3d>gibi etkinleştirilmiş eşzamansız alt öğelerin rota geometrisini yüklemeyi tamamlamasını bekler. - Harita ve kamera kısıtlamaları: Coğrafi
boundsve kamera sınırları (minAltitude,maxAltitude,minTilt,maxTilt,minHeadingvemaxHeading) otomatik sığdırılan görünümü kısıtlamaya devam eder. Daha fazla bilgi için Kamera görünümünü ve sınırlarını kısıtlama başlıklı makaleyi inceleyin.