Kamera ve görünüm

Android için Haritalar SDK'sındaki haritalar, kolay hareketlerle eğilip döndürülebilir. Bu sayede kullanıcılar haritayı kendileri için uygun bir yönde ayarlayabilir. Vektör tabanlı harita karolarının daha küçük ayak izi sayesinde, herhangi bir yakınlaştırma düzeyinde haritayı kaydırabilir veya perspektifini çok az gecikmeli olarak değiştirebilirsiniz.

Kod örnekleri

GitHub'daki ApiDemos deposu, kamera özelliklerini gösteren bir örnek içerir:

• CameraDemoActivity - Kotlin: Kamera konumunu değiştirme
• CameraDemoActivity - Java: Kamera konumunu değiştirme

Giriş

Web'deki Google Haritalar gibi Android için Haritalar SDK'sı da Mercator projeksiyonunu kullanarak dünyanın yüzeyini (bir küre) cihazınızın ekranında (düz bir düzlem) gösterir. Dünya kendi etrafında sorunsuz bir şekilde döndüğü için doğu ve batı yönünde harita sonsuz olarak tekrarlanır. Kuzey ve güney yönünde harita yaklaşık 85 derece kuzey ve 85 derece güney ile sınırlıdır.

Not: Merkatör projeksiyonu boylam olarak sonlu bir genişliğe, ancak yatay olarak sonsuz bir yüksekliğe sahiptir. Elde edilen harita şeklini kare yapmak için Mercator projeksiyonunu yaklaşık +/- 85 derece kullanarak temel harita görüntülerini "keseriz". Bu işlem, karo seçimi için daha kolay bir mantık sağlar.

Android için Haritalar SDK'sı, haritanın kamerasını değiştirerek kullanıcının haritaya bakış açısını değiştirmenize olanak tanır.

Kamerada yapılan değişiklikler, eklediğiniz işaretçilerde, yer paylaşımlarında veya diğer grafiklerde herhangi bir değişiklik yapmaz. Ancak eklediğiniz öğeleri yeni görünüme daha iyi uyacak şekilde değiştirmek isteyebilirsiniz.

Haritada kullanıcı hareketlerini dinleyebildiğiniz için kullanıcı isteklerine yanıt olarak haritayı değiştirebilirsiniz. Örneğin, geri çağırma yöntemi OnMapClickListener.onMapClick() haritaya tek bir dokunuşa yanıt verir. Yöntem, dokunma konumunun enlem ve boylamasını aldığından, ekranı kaydırarak veya yakınlaştırarak o noktaya yanıt verebilirsiniz. İşaretçi balonuna yapılan dokunmalara veya işaretçi üzerinde yapılan sürükleme hareketlerine yanıt vermek için benzer yöntemler kullanılabilir.

Ayrıca kamera hareketlerini de dinleyebilirsiniz. Böylece, kamera hareket etmeye başladığında, hareket halindeyken veya hareket etmeyi bıraktığında uygulamanız bildirim alır. Ayrıntılar için kamera değiştirme etkinlikleri kılavuzunu inceleyin.

Kamera konumu

Harita görünümü, düz bir düzleme bakan bir kamera olarak modellenmiştir. Kameranın konumu (dolayısıyla haritanın oluşturulması) şu özellikler tarafından belirlenir: hedef (enlem/boylam konumu), dönme, yatırma ve yakınlaştırma.

Hedef (konum)

Kamera hedefi, haritanın merkezinin enlem ve boylam koordinatları olarak belirtilen konumudur.

Yön (yönlendirme)

Kamera yönü, haritanın üst kenarına karşılık gelen, gerçek kuzeyden derece cinsinden ölçülen pusula yönünü belirtir. Haritanın merkezinden haritanın üst kenarına dikey bir çizgi çizerseniz, yer, kameranın gerçek kuzey yönüne göre kameranın yönüne (derece cinsinden ölçülür) karşılık gelir.

0 noktası, haritanın üst kısmının gerçek kuzeyi gösterdiği anlamına gelir. 90 olan yön değeri, haritanın üst kısmının tam doğuya (pusulada 90 derece) baktığı anlamına gelir. 180 değeri, güneye doğru yapılması gereken harita noktalarının üst kısmı anlamına gelir.

Maps API, haritanın yönünü değiştirmenize olanak tanır. Örneğin, araba kullanan bir kişi kendi seyahat yönü ile uyumlu bir yol haritası çevirir. Yürüyüşçüler ise harita ve pusulayı kullanarak genellikle haritayı dikey bir çizginin kuzeyi gösterecek şekilde yönlendirir.

Eğim (görüntüleme açısı)

Eğim, kameranın doğrudan haritanın merkez konumunun üzerindeki bir yay üzerindeki konumunu tanımlar. Bu konum, nadir (kameranın tam altına doğru olan yön) referans alınarak derece cinsinden ölçülür. 0 değeri, doğrudan aşağı doğru doğrulanan bir kameraya karşılık gelir. 0'dan büyük değerler, belirtilen derece sayısı kadar ufuğa doğru eğimli bir kameraya karşılık gelir. Görüntüleme açısını değiştirdiğinizde harita perspektifli olarak gösterilir. Uzaktaki özellikler daha küçük, yakındaki özellikler ise daha büyük görünür. Aşağıdaki görseller bunu göstermektedir.

Aşağıdaki resimlerde görüntüleme açısı 0 derecedir. İlk resimde bunun bir şeması gösterilmektedir. Konum 1 kamera konumu, 2 konumu ise geçerli harita konumudur. Elde edilen harita aşağıda gösterilir.

Aşağıdaki resimlerde görüntüleme açısı 45 derecedir. Kameranın yukarıdan düz (0 derece) ile zemin (90 derece) arasında bir yay boyunca 3 konumuna kadar hareket ettiğine dikkat edin. Kamera hâlâ haritanın merkez noktasını gösteriyor ancak 4 konumundaki çizgiyle gösterilen alan artık görünür durumda.

Bu ekran görüntüsünde gösterilen harita, orijinal haritadakiyle aynı noktaya odaklanmış durumdadır ancak haritanın üst kısmında daha fazla özellik gösterilmektedir. Açıyı 45 derecenin üzerine çıkardığınızda kamera ile harita konumu arasındaki özellikler orantılı olarak daha büyük, harita konumunun dışındaki özellikler ise orantılı olarak daha küçük görünür. Bu da üç boyutlu bir etki oluşturur.

Tarih aralığını

Kameranın yakınlaştırma düzeyi, haritanın ölçeğini belirler. Daha yüksek yakınlaştırma seviyelerinde ekranda daha fazla ayrıntı, daha düşük yakınlaştırma seviyelerinde ise dünyanın daha büyük bir kısmı görülebilir. 0 yakınlaştırma düzeyinde, haritanın ölçeği öyle ayarlanır ki dünyanın tamamı yaklaşık 256 dp (yoğunluktan bağımsız piksel) genişliğinde olur.

Yakınlaştırma düzeyini 1 artırdığınızda ekrandaki dünyanın genişliği iki katına çıkar. Bu nedenle, N yakınlaştırma düzeyinde dünyanın genişliği yaklaşık 256 * 2^N dp'dir. Örneğin, 2. yakınlaştırma seviyesinde tüm dünya yaklaşık 1024 dp genişliğindedir.

Yakınlaştırma düzeyi tam sayı olmak zorunda değildir. Haritanın izin verdiği yakınlaştırma seviyeleri aralığı hedef, harita türü ve ekran boyutu gibi bir dizi faktöre bağlıdır. Aralık dışında kalan tüm sayılar, minimum yakınlaştırma seviyesi veya maksimum yakınlaştırma seviyesi olabilecek bir sonraki geçerli değere dönüştürülür. Aşağıdaki listede, her bir yakınlaştırma düzeyinde görmeyi bekleyebileceğiniz yaklaşık ayrıntı düzeyi gösterilmektedir:

• 1: Dünya
• 5: Kara/kıta
• 10: Şehir
• 15: Sokaklar
• 20: Binalar

Kamerayı hareket ettirme

Haritalar API, haritanın hangi kısmının görüneceğini değiştirmenize olanak tanır. Bu işlem, haritayı hareket ettirmek yerine kameranın konumunu değiştirerek yapılır.

Kamerayı değiştirdiğinizde, kamera hareketini animasyonlu hale getirme seçeneğiniz vardır. Animasyon, mevcut kamera özellikleri ile yeni kamera özellikleri arasında geçiş yapar. Animasyonun süresini de kontrol edebilirsiniz.

Kameranın konumunu değiştirmek için CameraUpdate kullanarak kamerayı taşımak istediğiniz yeri belirtmeniz gerekir. Maps API, CameraUpdateFactory kullanarak farklı türde CameraUpdate oluşturmanıza olanak tanır. Aşağıdaki seçenekler kullanılabilir:

Yakınlaştırma düzeyini değiştirme ve minimum/maksimum yakınlaştırmayı ayarlama

CameraUpdateFactory.zoomIn() ve CameraUpdateFactory.zoomOut(), diğer tüm özellikleri aynı tutarken yakınlaştırma düzeyini 1,0 artıran bir CameraUpdate döndürür.

CameraUpdateFactory.zoomTo(float), diğer tüm özellikleri aynı tutarken yakınlaştırma düzeyini belirtilen değere değiştiren bir CameraUpdate döndürür.

CameraUpdateFactory.zoomBy(float) ve CameraUpdateFactory.zoomBy(float, Point) yakınlaştırma düzeyini belirtilen değer kadar artıran (veya değer negatifse düşüren) bir CameraUpdate döndürür. İkincisi, ekrandaki belirli bir noktayı aynı konumda (enlem/boylam) sabitler ve bunu yapmak için kameranın konumunu değiştirebilir.

Tercih ettiğiniz minimum ve/veya maksimum yakınlaştırma seviyesini ayarlamak yararlı olabilir. Örneğin, uygulamanız bir önemli yer etrafında tanımlanmış bir alanı gösteriyorsa veya sınırlı sayıda yakınlaştırma düzeyi içeren özel bir karo yer paylaşımı kullanıyorsanız kullanıcının deneyimini kontrol etmek için bu özelliği kullanabilirsiniz.

private lateinit var map: GoogleMap

    map.setMinZoomPreference(6.0f)
    map.setMaxZoomPreference(14.0f)

      

private GoogleMap map;
    map.setMinZoomPreference(6.0f);
    map.setMaxZoomPreference(14.0f);

      

API'nin, kullanıcıların çok yakın veya çok uzaklaştırma yapmasını engelleyebilecek teknik hususlar olduğunu unutmayın. Örneğin, uydu veya arazi görünümü, temel harita karolarına kıyasla daha düşük bir maksimum yakınlaştırma değerine sahip olabilir.

Kamera konumunu değiştirme

Sık kullanılan konum değişiklikleri için iki kolay yöntem vardır. CameraUpdateFactory.newLatLng(LatLng), diğer tüm özellikleri koruyarak kameranın enlem ve boylamını değiştiren bir CameraUpdate döndürür. CameraUpdateFactory.newLatLngZoom(LatLng, float), diğer tüm özellikleri koruyarak kameranın enlem, boylam ve yakınlaştırma ayarlarını değiştiren bir CameraUpdate döndürür.

Kamera konumunu değiştirme konusunda tam esneklik için CameraUpdateFactory.newCameraPosition(CameraPosition) simgesini kullanın. Bu simge, kamerayı belirli bir konuma taşıyan CameraUpdate seçeneğini sunar. CameraPosition, doğrudan new CameraPosition() kullanılarak veya new CameraPosition.Builder() kullanılarak CameraPosition.Builder ile elde edilebilir.

Kaydırma

CameraUpdateFactory.scrollBy(float, float), kameranın enlem ve boylamını, haritanın belirtilen piksel sayısı kadar hareket edecek şekilde değiştiren bir CameraUpdate döndürür. Pozitif x değeri kameranın sağa doğru hareket etmesine neden olur ve harita sola gitmiş gibi görünür. Pozitif y değeri, kameranın aşağı hareket etmesine neden olur. Böylece harita yukarı doğru hareket etmiş gibi görünür. Buna karşılık, negatif x değerleri kameranın sola hareket etmesine neden olur. Böylece harita sağa doğru hareket etmiş gibi görünür. Negatif y değerleri ise kameranın yukarı hareket etmesine neden olur. Kaydırma, kameranın mevcut yönüne göre yapılır. Örneğin, kameranın yön açısı 90 derece ise doğu "yukarı"dır.

Sınır belirleme

Haritanın sınırlarını ayarlama

Bazen kamerayı, ilgilenilen alanın tamamının mümkün olan en yüksek yakınlaştırma düzeyinde görüleceği şekilde hareket ettirmek yararlı olabilir. Örneğin, kullanıcının o anki konumuna 10 km mesafedeki tüm benzin istasyonlarını gösteriyorsanız, kamerayı hepsinin ekranda görüneceği şekilde hareket ettirebilirsiniz. Bunu yapmak için önce ekranda görünmesini istediğiniz LatLngBounds değerini hesaplayın. Ardından, kamera konumunu belirtilen LatLngBounds'in tamamen haritaya sığacağı şekilde değiştiren bir CameraUpdate elde etmek için CameraUpdateFactory.newLatLngBounds(LatLngBounds bounds, int padding)'ü kullanabilirsiniz. Bu işlemde, belirtilen dolgu (piksel cinsinden) dikkate alınır. Döndürülen CameraUpdate, belirtilen sınırlar ile haritanın kenarı arasındaki boşluğun (piksel cinsinden) en az belirtilen dolgu kadar olmasını sağlar. Haritanın eğiminin ve yönünün 0 olacağını unutmayın.

val australiaBounds = LatLngBounds(
    LatLng((-44.0), 113.0),  // SW bounds
    LatLng((-10.0), 154.0) // NE bounds
)
map.moveCamera(CameraUpdateFactory.newLatLngBounds(australiaBounds, 0))

      

LatLngBounds australiaBounds = new LatLngBounds(
    new LatLng(-44, 113), // SW bounds
    new LatLng(-10, 154)  // NE bounds
);
map.moveCamera(CameraUpdateFactory.newLatLngBounds(australiaBounds, 0));

      

Haritayı bir alan içinde merkezleme

Bazı durumlarda, kameranızı aşırı kenarları dahil etmek yerine bir sınır içinde merkezlemek isteyebilirsiniz. Örneğin, sabit bir yakınlaştırmayla kamerayı bir ülkeye odaklamak için. Bu durumda, LatLngBounds oluşturarak ve CameraUpdateFactory.newLatLngZoom(LatLng latLng, float zoom) ile LatLngBounds kullanarak benzer bir yöntem kullanabilirsiniz.getCenter() yöntemini kullanın. getCenter() yöntemi, LatLngBounds öğesinin coğrafi merkezini döndürür.

val australiaBounds = LatLngBounds(
    LatLng((-44.0), 113.0),  // SW bounds
    LatLng((-10.0), 154.0) // NE bounds
)
map.moveCamera(CameraUpdateFactory.newLatLngZoom(australiaBounds.center, 10f))

      

LatLngBounds australiaBounds = new LatLngBounds(
    new LatLng(-44, 113), // SW bounds
    new LatLng(-10, 154)  // NE bounds
);
map.moveCamera(CameraUpdateFactory.newLatLngZoom(australiaBounds.getCenter(), 10));

      

newLatLngBounds(boundary, width, height, padding) yönteminin aşırı yüklemesi, bir dikdörtgen için piksel cinsinden genişlik ve yükseklik belirtmenize olanak tanır. Bu genişlik ve yükseklik, haritanın boyutlarına karşılık gelir. Dikdörtgen, merkezi harita görünümüyle aynı olacak şekilde konumlandırılır (böylece belirtilen boyutlar harita görünümüyle aynıysa dikdörtgen harita görünümüyle çakışır). Döndürülen CameraUpdate, kamerayı, belirtilen LatLngBounds'ın gerekli dolgu dikkate alınarak mümkün olan en yüksek yakınlaştırma düzeyinde, belirtilen dikdörtgen içinde ekranın ortasına gelecek şekilde hareket ettirir.

Not: CameraUpdate oluşturmak için yalnızca daha basit newLatLngBounds(boundary, padding) yolunu kullanın. Bu yöntem, harita düzene girdikten sonra kamerayı hareket ettirmek için kullanılacaksa tercih edilmelidir. API, düzen sırasında sınırlayıcı kutuyu doğru şekilde yansıtmak için gereken haritanın görüntüleme sınırlarını hesaplar. Buna karşılık, API görüntüleme sınırlarını ilettiğiniz bağımsız değişkenlerden hesapladığından, daha karmaşık yöntem newLatLngBounds(boundary, width, height, padding) tarafından döndürülen CameraUpdate değerini dilediğiniz zaman, hatta harita düzene girmeden önce bile kullanabilirsiniz.

Kullanıcının kaydırma hareketini belirli bir alana kısıtlama

Yukarıdaki senaryolarda haritanın sınırlarını siz belirlersiniz ancak kullanıcı bu sınırların dışında kaydırma veya kaydırma yapabilir. Bunun yerine, kullanıcıların yalnızca bu sınırlar içinde kaydırıp yakınlaştırabilmesi için haritanın odak noktasının (kamera hedefi) enlem/boylam merkezi sınırlarını kısıtlamak isteyebilirsiniz. Örneğin, bir alışveriş merkezi veya havaalanı için perakende uygulaması, haritayı belirli sınırlarla kısıtlamak isteyebilir. Bu durumda kullanıcılar, bu sınırlar içinde kaydırma ve yakınlaştırma yapabilir.

// Create a LatLngBounds that includes the city of Adelaide in Australia.
val adelaideBounds = LatLngBounds(
    LatLng(-35.0, 138.58),  // SW bounds
    LatLng(-34.9, 138.61) // NE bounds
)

// Constrain the camera target to the Adelaide bounds.
map.setLatLngBoundsForCameraTarget(adelaideBounds)

      

// Create a LatLngBounds that includes the city of Adelaide in Australia.
LatLngBounds adelaideBounds = new LatLngBounds(
    new LatLng(-35.0, 138.58), // SW bounds
    new LatLng(-34.9, 138.61)  // NE bounds
);

// Constrain the camera target to the Adelaide bounds.
map.setLatLngBoundsForCameraTarget(adelaideBounds);

      

Aşağıdaki şemada, kamera hedefinin görüntü alanından biraz daha büyük bir alana kısıtlandığı bir senaryo gösterilmektedir. Kullanıcı, kamera hedefinin sınırlı alanda kalması koşuluyla kaydırabilir ve yakınlaştırıp uzaklaştırabilir. Çarpım, kamera hedefini temsil eder:

Harita, görüntü alanında tanımlanan sınırların dışında kalan alanlar gösterilse bile her zaman görüntü alanını doldurur. Örneğin, kamera hedefini sınırlı alanın bir köşesine yerleştirirseniz köşenin ötesindeki alan görüntü alanında görünür ancak kullanıcılar bu alanın daha ötesine kaydıramaz. Aşağıdaki diyagramda bu senaryo gösterilmektedir. Çarpım, kamera hedefini temsil eder:

Aşağıdaki şemada kamera hedefinin sınırları çok kısıtlıdır. Bu nedenle kullanıcıya haritayı kaydırma veya kaydırma yapma fırsatı çok azdır. Çarpım, kamera hedefini temsil eder:

Kamera görüntüsünü güncelleme

Haritaya CameraUpdate uygulamak için kamerayı anında hareket ettirebilir veya kamerayı sorunsuz bir şekilde hareket ettirebilirsiniz. Kamerayı CameraUpdate ile anında hareket ettirmek için GoogleMap.moveCamera(CameraUpdate)'ü çağırabilirsiniz.

Değişikliği animasyonlu hale getirerek, özellikle kısa hareketler için kullanıcı deneyimini daha keyifli hale getirebilirsiniz. Bunun için GoogleMap.moveCamera yerine GoogleMap.animateCamera numarayı arayın. Harita, yeni özelliklere sorunsuz bir şekilde geçer. Bu yöntemin en ayrıntılı biçimi olan GoogleMap.animateCamera(cameraUpdate, duration, callback), üç bağımsız değişken sunar:

cameraUpdate

Kameranın taşınacağı yeri açıklayan CameraUpdate.

callback

GoogleMap.CancellableCallback sınıfını uygulayan bir nesne. Görevlerin işlenmesine yönelik bu genelleştirilmiş arayüz, "onCancel()" ve "onFinished()" olarak iki yöntem tanımlar. Animasyon için yöntemler aşağıdaki durumlarda çağrılır:

onFinish()

Animasyon kesinti olmadan tamamlanırsa çağrılır.

onCancel()

Animasyon, stopAnimation() çağrılarak veya yeni bir kamera hareketi başlatılarak kesintiye uğrarsa çağrılır.

Alternatif olarak, GoogleMap.stopAnimation() numaralı telefonu aradığınızda da bu durumla karşılaşabilirsiniz.

duration

Animasyonun int olarak milisaniye cinsinden istenen süresi.

Aşağıdaki kod snippet'lerinde, kamerayı hareket ettirmenin yaygın yollarından bazıları gösterilmektedir.

val sydney = LatLng(-33.88, 151.21)
val mountainView = LatLng(37.4, -122.1)

// Move the camera instantly to Sydney with a zoom of 15.
map.moveCamera(CameraUpdateFactory.newLatLngZoom(sydney, 15f))

// Zoom in, animating the camera.
map.animateCamera(CameraUpdateFactory.zoomIn())

// Zoom out to zoom level 10, animating with a duration of 2 seconds.
map.animateCamera(CameraUpdateFactory.zoomTo(10f), 2000, null)

// Construct a CameraPosition focusing on Mountain View and animate the camera to that position.
val cameraPosition = CameraPosition.Builder()
    .target(mountainView) // Sets the center of the map to Mountain View
    .zoom(17f)            // Sets the zoom
    .bearing(90f)         // Sets the orientation of the camera to east
    .tilt(30f)            // Sets the tilt of the camera to 30 degrees
    .build()              // Creates a CameraPosition from the builder
map.animateCamera(CameraUpdateFactory.newCameraPosition(cameraPosition))

      

LatLng sydney = new LatLng(-33.88,151.21);
LatLng mountainView = new LatLng(37.4, -122.1);

// Move the camera instantly to Sydney with a zoom of 15.
map.moveCamera(CameraUpdateFactory.newLatLngZoom(sydney, 15));

// Zoom in, animating the camera.
map.animateCamera(CameraUpdateFactory.zoomIn());

// Zoom out to zoom level 10, animating with a duration of 2 seconds.
map.animateCamera(CameraUpdateFactory.zoomTo(10), 2000, null);

// Construct a CameraPosition focusing on Mountain View and animate the camera to that position.
CameraPosition cameraPosition = new CameraPosition.Builder()
    .target(mountainView )      // Sets the center of the map to Mountain View
    .zoom(17)                   // Sets the zoom
    .bearing(90)                // Sets the orientation of the camera to east
    .tilt(30)                   // Sets the tilt of the camera to 30 degrees
    .build();                   // Creates a CameraPosition from the builder
map.animateCamera(CameraUpdateFactory.newCameraPosition(cameraPosition));