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.
Kamera Konumu
Harita görünümü, uzayda belirli bir noktaya bakan bir kamera olarak modellenir. Kameranın konumu ve yönü; enlem/boylam/yükseklik koordinatları (kameranın baktığı "merkez" olarak tanımlanır), yön, eğim, aralık ve yuvarlanma ile tanımlanır.
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ı üç boyutlu olarak hassas bir şekilde konumlandırılabilir.
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. Yükseklik, deniz seviyesinden metre cinsinden belirtilir.
Başlık
Yön, haritanın pusula yönü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.
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
Aralık, kameranın kendi konumu ile haritanın merkezi 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 çekimden küresel bir bakış açısına kadar her türlü görüntüleme yapılabilir. Bu, 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
Yuvarlanma, 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 silindir yuvarlanması gibi efektler oluşturmak için kullanılabilir.
Kamerayı kontrol etme
Aşağıdaki kod örneğinde,setCamera yöntemini çağırarak kameranın programatik olarak nasıl kontrol edileceği 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
}
)