Kamera kontrollerini yapılandırma

Platform seçin: Android iOS JavaScript

Kullanıcılar, haritada hareketleri kullanarak kameranın yakınlaştırma, eğme, konum ve döndürme özelliklerini kontrol edebilir. Kamerayı programatik olarak da yapılandırabilirsiniz.

3D kamera modelini gösteren şema

Kamera Konumu

Harita görünümü, 3D uzayda belirli bir noktaya bakan bir kamera olarak modellenir. Kameranın konumu ve yönü (dolayısıyla haritanın oluşturulması) aşağıdaki özelliklerle belirtilir: merkez (kameranın baktığı enlem/boylam/rakım konumu), istikamet, eğim, aralık ve dönüş.

Merkez (Enlem/Boylam/Yükseklik)

Merkez, kameranın gözlemlediği 3D uzaydaki belirli noktayı tanımlar. Bu, enlem, boylam ve rakım değerlerini birleştiren LatLngAltitude sınıfı kullanılarak belirtilir. Bu sayede kameranın odak noktasını üç boyutlu olarak hassas bir şekilde konumlandırabilirsiniz.

Enlem -90 ile 90 derece arasında (bu değerler dahil) olabilir. Boylam, -180 ile 180 derece arasında (bu değerler dahil) olmalıdır. Rakım, deniz seviyesinden yüksekliği metre cinsinden belirtir.

Başlık

Kameranın istikameti, kameranın bakacağı yönü belirtir. Bu yön, gerçek kuzeyden saat yönünde derece cinsinden ölçülür. Kuzey 0 dereceye, Doğu 90 dereceye, Güney 180 dereceye ve Batı 270 dereceye karşılık gelir. Bu, kameranın merkez noktasının dikey ekseni etrafındaki yönünü belirler.

Yatır

Eğme, kameranın dikey eksene göre açısını derece cinsinden belirtir. 0 derecelik eğim, kameranın doğrudan Dünya'ya (nadir) doğru baktığı anlamına gelir. 90 derecelik bir eğim, kameranın başlık tarafından belirtilen yönde yatay olarak yönlendirildiği anlamına gelir.

Aralık

Menzil, kameranın kendi konumu ile baktığı merkez nokta arasındaki mesafeyi metre cinsinden tanımlar. Aralık sıfır metreden (çok yakın çekim) altmış üç milyon metreye kadar değişebilir. Bu sayede çok yakın çekimlerden başlayıp gerçekten küresel bir bakış açısına kadar her türlü görüntü elde edilebilir. Bu ayar, haritanın ne kadar "yakınlaştırılmış" veya "uzaklaştırılmış" görüneceğini etkili bir şekilde kontrol eder.

Döndür

Dönme, kameranın ufka göre açısını derece cinsinden ayarlar. Bu parametre, uçuş simülasyonları sırasında eğilme veya kamerayı görüntüleme ekseni etrafında döndürerek tam bir varil yuvarlanması gibi efektler oluşturmak için kullanılabilir.

Kamerayı kontrol etme

Aşağıdaki kod örneğinde, setCamera yöntemini çağırarak kamerayı programatik olarak nasıl kontrol edeceğiniz gösterilmektedir. Bu kod örneğini kullanmak için Kurulum ve Uygulamanıza 3D harita ekleme bölümündeki talimatları uygulayarak Android Studio projenizi temel bir 3D harita ile ayarlayın. Ardından, aşağıdaki kodu MainActivity.kt dosyasına ekleyin:

// Add imports
import com.google.android.gms.maps3d.model.latLngAltitude

...

// Add to the onMap3DViewReady method, after the googleMap3D object has been initialized
googleMap3D.setCamera(
    camera {
        center = latLngAltitude {
            latitude = 38.743502
            longitude = -109.499374
            altitude = 1467.0
        }
        heading = 350.0
        tilt = 58.1
        range = 138.2
        roll = 0.0
    }
)