Kamerayı harita öğelerine otomatik olarak sığdırma

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ğinde FLY_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:

  • center ve range: 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ış center ve range değerlerini kullanır.
  • tilt ve heading: Kadrajlama sırasında önerilen değerler olarak değerlendirilir. Atlandığında, her ikisi de varsayılan olarak 0° değerini alır ve kuş bakışı, kuzey yukarıda görünümü elde edilir.
  • roll ve fov: Map3DElement tarihinde 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 bounds ve kamera sınırları (minAltitude, maxAltitude, minTilt, maxTilt, minHeading ve maxHeading) 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.

Sonraki adımlar