CameraUpdateFactory

herkese açık nihai sınıf KameraUpdateFactory Nesneyi genişletiyor

Bir haritanın kamerasını değiştiren CameraUpdate nesneleri oluşturma yöntemlerini içeren bir sınıf. Haritanın kamerasını değiştirmek için, bu sınıfla oluşturulmuş bir CameraUpdate nesnesini kullanarak animateCamera(CameraUpdate), animateCamera(CameraUpdate, GoogleMap.CancelableCallback) veya moveCamera(CameraUpdate) numaralı telefonu arayın.

Örneğin, haritayı yakınlaştırmak için aşağıdaki kodu kullanabilirsiniz:

GoogleMap map = ...;
 map.animateCamera(CameraUpdateFactory.zoomIn());
 

Bu sınıftaki herhangi bir yöntemi kullanmadan önce, sınıfın başlatılması için aşağıdakilerden birini yapmanız gerekir:

Geliştirici Kılavuzu

Daha fazla bilgi için Kamera ve Görünüm geliştirici kılavuzunu okuyun.

Herkese Açık Yöntem Özeti

statik KameraUpdate
newKameraPosition(KameraKonumu kamera konumu)
Kamerayı belirtilen CameraPosition konumuna taşıyan bir CameraUpdate döndürür.
statik KameraUpdate
newLatLng(LatLng latLng)
Ekranın ortasındaki bir LatLng nesnesi tarafından belirtilen enlem ve boylamı taşıyan bir CameraUpdate döndürür.
statik KameraUpdate
newLatLngBounds(LatLngBounds sınırları, int genişlik, int yükseklik, int dolgu)
Kamerayı, belirtilen enlem/boylam sınırlarının ekranda mümkün olan en yüksek yakınlaştırma düzeyinde bir sınırlayıcı kutunun içinde ortalayacak şekilde dönüştüren bir CameraUpdate döndürür.
statik KameraUpdate
newLatLngBounds(LatLngBounds sınırları, int Dolgusu)
Kamerayı, belirtilen enlem/boylam sınırlarının mümkün olan en yüksek yakınlaştırma düzeyinde ortalanacağı şekilde dönüştüren bir CameraUpdate döndürür.
statik KameraUpdate
newLatLngZoom(LatLng latLng, kayan noktalı yakınlaştırma)
Ekranın ortasındaki LatLng nesnesi tarafından belirtilen enlem ve boylamı hareket ettiren ve belirtilen yakınlaştırma düzeyine giden bir CameraUpdate değerini döndürür.
statik KameraUpdate
scrollBy(xPixel, kayan yPixel)
Kamerayı haritanın üzerinde kaydıran bir CameraUpdate değeri döndürür. Bu işlem, görünümün merkezini x ve y yönlerinde belirtilen piksel sayısına kaydırır.
statik KameraUpdate
ZoomBy(kayan tutar, Nokta odağı)
Geçerli kameranın bakış açısının yakınlaştırma düzeyini değiştiren bir CameraUpdate değeri döndürür.
statik KameraUpdate
ZoomBy (kayan tutar)
Geçerli kameranın bakış açısının yakınlaştırma düzeyini değiştiren bir CameraUpdate değeri döndürür.
statik KameraUpdate
ZoomIn()
Görüş noktasının yüksekliğini Dünya yüzeyine yaklaştırarak haritayı yakınlaştıran bir CameraUpdate döndürür.
statik KameraUpdate
ZoomOut()
Görüş açısının yüksekliğini Dünya yüzeyinden daha uzaklaştırarak haritayı uzaklaştıran bir CameraUpdate döndürür.
statik KameraUpdate
ZoomTo (kayan yakınlaştırma)
Kameranın bakış açısını belirli bir yakınlaştırma düzeyine taşıyan bir CameraUpdate değerini döndürür.

Devralınan Yöntem Özeti

Herkese Açık Yöntemler

herkese açık statik statik KameraUpdate yeni KameraKonumu (KameraKonumu kamera konumu)

Kamerayı belirtilen CameraPosition konumuna taşıyan bir CameraUpdate döndürür. Gerçekte bu, CameraPosition nesnesinin enlemi, boylamı, yakınlaştırma düzeyi, eğimi ve yatırmasından bir dönüşüm oluşturur.

Parametreler
kamera konumu
İadeler

herkese açık statik KameraUpdate newLatLng (LatLng latLng)

Ekranın ortasındaki bir LatLng nesnesi tarafından belirtilen enlem ve boylamı taşıyan bir CameraUpdate döndürür. Bu işlem, kamerayı LatLng nesnesine ortalar.

Parametreler
Latng istediğiniz enlem ve boylamı içeren bir LatLng nesnesi.
İadeler

herkese açık statik KameraUpdate newLatLngBounds (LatLngBounds sınırları, int genişliği, int yüksekliği, int dolgusu)

Kamerayı, belirtilen enlem/boylam sınırlarının ekranda mümkün olan en yüksek yakınlaştırma düzeyinde bir sınırlayıcı kutunun içinde ortalayacak şekilde dönüştüren bir CameraUpdate döndürür. Sınırlama kutusunun boyutunu daha da daraltmak için ek dolgu belirtebilirsiniz. Döndürülen CameraUpdate öğesinin 0 konumu ve 0 eğimi vardır.

newLatLngBounds(LatLngBounds, int) politikasından farklı olarak, bağımsız değişkenler sınırlayıcı kutunun istenen boyutunu belirttiğinden haritanın düzen aşamasından önce kamerayı değiştirmek için bu yöntem tarafından döndürülen CameraUpdate yöntemini kullanabilirsiniz.

Parametreler
sınırlar sınırlayıcı kutuya sığacak bölge
genişlik sınırlayıcı kutu genişliği (piksel) (piksel)
yükseklik sınırlayıcı kutu yüksekliği (piksel)
padding sınırlayıcı kutunun ek boyut kısıtlaması (piksel cinsinden)
İadeler

herkese açık statik KameraUpdate newLatLngBounds (LatLngBounds sınırları, int Dolgusu)

Kamerayı, belirtilen enlem/boylam sınırlarının mümkün olan en yüksek yakınlaştırma düzeyinde ortalanacağı şekilde dönüştüren bir CameraUpdate döndürür. Harita görünümünün kenarlarından sınırlayıcı kutuyu girmek için dolgu belirtebilirsiniz. Döndürülen CameraUpdate öğesinin 0 konumu ve 0 eğimi vardır.

Bu kamera güncellemesiyle, harita düzene girene kadar kamerayı değiştirmeyin (bu yöntemin doğru sınırlayıcı kutusunu ve yakınlaştırma düzeyini doğru şekilde belirleyebilmesi için haritanın boyutu olmalıdır). Aksi takdirde IllegalStateException atılır. Haritanın kullanılabilir olması yeterli DEĞİLDİR. Haritayı içeren görünüm, boyutlarının belirlenmesi için de düzenlenmiş olmalıdır. Bunun gerçekleştiğinden emin değilseniz bunun yerine newLatLngBounds(LatLngBounds, int, int, int) özelliğini kullanın ve haritanın boyutlarını manuel olarak sağlayın.

Parametreler
sınırlar ekrana sığacak bölge
padding sınırlı kutu kenarları ve görünüm kenarları arasında boşluk (piksel olarak) bırakılmalıdır. Bu değer, sınırlayıcı kutunun dört tarafının tümüne uygulanır.
İadeler

herkese açık statik KameraUpdate newLatLngZoom (LatLng latLng, kayan noktalı yakınlaştırma)

Ekranın ortasındaki LatLng nesnesi tarafından belirtilen enlem ve boylamı hareket ettiren ve belirtilen yakınlaştırma düzeyine giden bir CameraUpdate değerini döndürür.

Parametreler
Latng istediğiniz enlem ve boylamı içeren bir LatLng nesnesi.
zoom istediğiniz yakınlaştırma düzeyini (2,0 - 21,0 aralığında). Bu aralığın altındaki değerler 2,0 olarak ayarlanmıştır. Üzerindeki değerler ise 21,0 olarak ayarlanmıştır. Yakınlaştırmak için değeri artırın. Tüm alanlarda en büyük yakınlaştırma seviyelerinde karolar bulunmaz.
İadeler

genel statik KameraUpdate scrollBy (kayan xPixel, kayan yPixel)

Kamerayı haritanın üzerinde kaydıran bir CameraUpdate değeri döndürür. Bu işlem, görünümün merkezini x ve y yönlerinde belirtilen piksel sayısına kaydırır.

Örnekler:

  • xPixel = 5 ve yPixel = 0 olursa sistem, haritayı sola doğru 5 piksel kaydırılmış gibi görünecek şekilde hareket ettirerek kamerayı sağa kaydırır.
  • xPixel = 0 ve yPixel = 5 olursa sistem, kamerayı 5 piksel yukarı kaydırılmış gibi görünecek şekilde hareket ettirerek kamerayı aşağı kaydırır.

Kaydırma, kameranın mevcut yönüne göre yapılır. Örneğin, kamera 90 derece eğimliyse, doğu "yukarı"dır ve sağa kaydırmak kamerayı Güney'e taşır.

Parametreler
xPiksel yatay olarak kaydırılacak piksel sayısı. Pozitif bir değer, kamerayı mevcut yönüyle sağa doğru taşır. Negatif değer, kamerayı geçerli yöne göre sola taşır.
yPixel dikey olarak kaydırılacak piksel sayısı. Pozitif değer, kamerayı geçerli yöne göre aşağı doğru hareket ettirir. Negatif değer, kamerayı mevcut yönüne göre yukarı taşır.
İadeler

genel statik KameraUpdate zoomBy (kayan tutar, Nokta odağı)

Geçerli kameranın bakış açısının yakınlaştırma düzeyini değiştiren bir CameraUpdate değeri döndürür.

Odakla belirtilen bir nokta sabit kalır (yani yakınlaştırma işleminden önce ve sonra aynı enlem/boylama karşılık gelir).

Bu yöntem, mevcut kameraya kıyasla yakınlaştırma oranıyla zoomTo(float) oranında farklılık gösterir.

Örneğin, LatLng (11.11, 22.22) şu anda ekran konumundaysa (23, 45) Bu yöntemi bir zum tutarı ve bu LatLng ile çağırdıktan sonra, bu LatLng cihazının ekran konumu (23, 45) olmaya devam eder.

Parametreler
amount yakınlaştırma düzeyini değiştirmek için kullanılır. Pozitif değerler Dünya yüzeyine yakınlaşmayı gösterirken negatif değerler Dünya yüzeyinden uzaklaştırmayı belirtir.
odak ekrandaki piksel konumunu yakınlaştırın. Kamera taşıma işleminden önce bu pikselin bulunduğu konumda en boy/uzunluk kamera taşındıktan sonra aynı kalır.
İadeler

genel statik KameraUpdate ZoomBy (kayan tutar)

Geçerli kameranın bakış açısının yakınlaştırma düzeyini değiştiren bir CameraUpdate değeri döndürür.

Bu yöntem, mevcut kameraya kıyasla yakınlaştırma oranıyla zoomTo(float) oranında farklılık gösterir.

Parametreler
amount yakınlaştırma düzeyini değiştirmek için kullanılır. Pozitif değerler Dünya yüzeyine yakınlaşmayı gösterirken negatif değerler Dünya yüzeyinden uzaklaştırmayı belirtir.
İadeler

genel statik KameraUpdate ZoomIn ()

Görüş noktasının yüksekliğini Dünya yüzeyine yaklaştırarak haritayı yakınlaştıran bir CameraUpdate döndürür. Yakınlaştırma artışı 1,0'dır.

İadeler

herkese açık statik statik KameraUpdate ZoomOut ()

Görüş açısının yüksekliğini Dünya yüzeyinden daha uzaklaştırarak haritayı uzaklaştıran bir CameraUpdate döndürür. Yakınlaştırma artışı -1,0'dır.

İadeler

herkese açık statik KameraUpdate ZoomTo (kayan yakınlaştırma)

Kameranın bakış açısını belirli bir yakınlaştırma düzeyine taşıyan bir CameraUpdate değerini döndürür.

Parametreler
zoom istediğiniz yakınlaştırma düzeyini (2,0 - 21,0 aralığında). Bu aralığın altındaki değerler 2,0 olarak ayarlanmıştır. Üzerindeki değerler ise 21,0 olarak ayarlanmıştır. Yakınlaştırmak için değeri artırın. Tüm alanlarda en büyük yakınlaştırma seviyelerinde karolar bulunmaz.