CameraUpdateFactory

herkese açık son sınıf CameraUpdateFactory Nesneyi genişletir

Bir haritanın kamerasını değiştiren CameraUpdate nesne 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ş CameraUpdate nesnesini kullanarak animateCamera(CameraUpdate), animateCamera(CameraUpdate, GoogleMap.CancelableCallback) veya moveCamera(CameraUpdate) numaralı telefonu arayın.

Örneğin, bir 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, bu sınıfın başlatıldığından emin olmak için aşağıdakilerden birini yapmanız gerekir:

• Uygulamanıza eklediğiniz MapFragment veya MapView aracılığıyla bir GoogleMap tutarının kullanılabilir hale gelmesini bekleyin. getMapAsync() yöntemini çağırıp onMapReady(GoogleMap map) geri çağırmasını bekleyerek GoogleMap örneğini alabilirsiniz.
• initialize(Context) Hizmetleri İçin Arayın. Bir GooglePlayServicesNotAvailableException atılmadığı sürece bu sınıf doğru şekilde başlatılır.

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 CameraUpdate	newCameraPosition(CameraPosition kameraKonumu) Kamerayı belirli bir CameraPosition konumuna hareket eden bir CameraUpdate döndürür.
statik CameraUpdate	newLatLng(LatLng latLng) Ekranın merkezini bir LatLng nesnesi tarafından belirtilen enlem ve boylama hareket ettiren bir CameraUpdate döndürür.
statik CameraUpdate	newLatLngBounds(LatLngBounds sınırları, tam genişlik, int yükseklik, int dolgu) Kamerayı, belirtilen enlem/boylam sınırları mümkün olan en yüksek yakınlaştırma düzeyinde belirtilen boyutlardaki bir sınırlayıcı kutu içinde ekranın ortasına gelecek şekilde dönüştüren bir CameraUpdate döndürür.
statik CameraUpdate	newLatLngBounds(LatLngBounds sınırları, int dolgu) Kamerayı, belirtilen enlem/boylam sınırları ekranı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 CameraUpdate	newLatLngZoom(LatLng latLng, kayan yakınlaştırma) Ekranın merkezini bir LatLng nesnesi tarafından belirtilen enlem ve boylama hareket ettiren ve belirtilen yakınlaştırma düzeyine ulaşan bir CameraUpdate döndürür.
statik CameraUpdate	scrollBy(kaydırma: xPixel, kayan yPixel) Kamerayı harita üzerinde kaydıran bir CameraUpdate döndürerek görüş merkezini x ve y yönlerinde belirtilen piksel sayısına kadar kaydırır.
statik CameraUpdate	zoomBy(kayan nokta miktarı, Nokta odağı) Geçerli kamera görüş noktasının yakınlaştırma düzeyini değiştiren bir CameraUpdate döndürür.
statik CameraUpdate	zoomBy(kayan tutar) Geçerli kamera görüş noktasının yakınlaştırma düzeyini değiştiren bir CameraUpdate döndürür.
statik CameraUpdate	zoomIn() Seyir 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 CameraUpdate	zoomOut() Seyir noktasının yüksekliğini Dünya yüzeyinden daha uzağa hareket ettirerek haritayı uzaklaştıran bir CameraUpdate döndürür.
statik CameraUpdate	zoomTo(kayan yakınlaştırma) Kamera görüş noktasını belirli bir yakınlaştırma düzeyine hareket ettiren bir CameraUpdate döndürür.

Devralınan Yöntem Özeti

java.lang.Object sınıfından

boolean	eşittir(Nesne arg0)
son Sınıf<?>	getClass()
int	hashCode()
son geçersiz	notify()
son geçersiz	notifyAll()
Dize	toString()
son geçersiz	wait(uzun arg0, int arg1)
son geçersiz	wait(uzun arg0)
son geçersiz	wait()

Herkese Açık Yöntemler

herkese açık statik CameraUpdate newCameraPosition (CameraPosition CameraPosition)

Kamerayı belirli bir CameraPosition konumuna hareket eden bir CameraUpdate döndürür. Bu da CameraPosition nesnesinin enlem, boylam, yakınlaştırma düzeyi, yön ve eğim değerlerinde bir dönüşüm oluşturur.

Parametreler

cameraPosition

İlerlemeler

• dönüşümü içeren bir CameraUpdate.

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

Ekranın merkezini bir LatLng nesnesi tarafından belirtilen enlem ve boylama hareket ettiren bir CameraUpdate döndürür. Bu işlem, kamerayı LatLng nesnesinde ortalar.

Parametreler

latLng	istenen enlem ve boylamı içeren bir LatLng nesnesi.

İlerlemeler

• dönüşümü içeren bir CameraUpdate.

herkese açık statik CameraUpdate newLatLngBounds (LatLngBounds sınırlar, tam genişlik, tam yükseklik, tam dolgu)

Kamerayı, belirtilen enlem/boylam sınırları mümkün olan en yüksek yakınlaştırma düzeyinde belirtilen boyutlardaki bir sınırlayıcı kutu içinde ekranın ortasına gelecek şekilde dönüştüren bir CameraUpdate döndürür. Sınırlayıcı kutunun boyutunu daha da kısıtlamak için ek dolgu belirtebilirsiniz. Döndürülen CameraUpdate öğesinin yönü 0 ve eğimi 0'dır.

Bağımsız değişkenler sınırlayıcı kutunun istenen boyutunu belirttiğinden, newLatLngBounds(LatLngBounds, int) işlevinin aksine, bu yöntemin döndürdüğü CameraUpdate kullanarak kamerayı haritanın düzen aşamasından önce değiştirebilirsiniz.

Parametreler

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

İlerlemeler

• dönüşümü içeren bir CameraUpdate.

herkese açık statik CameraUpdate newLatLngBounds (LatLngBounds sınırları, tam dolgu)

Kamerayı, belirtilen enlem/boylam sınırları ekranı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. Sınırlayıcı kutuyu harita görünümünün kenarlarından yerleştirmek için dolgu belirtebilirsiniz. Döndürülen CameraUpdate öğesinin yönü 0 ve eğimi 0'dır.

Harita yerleşimi olana kadar bu kamera güncellemesiyle kamerayı değiştirmeyin (bu yöntemin uygun sınırlayıcı kutuyu ve yakınlaştırma düzeyini doğru bir şekilde belirleyebilmesi için haritanın boyutu olmalıdır). Aksi takdirde bir IllegalStateException atılır. Haritanın kullanılabilir olması için yeterli DEĞİLDİR. Haritayı içeren görünümün, boyutlarının belirlenmesini sağlayacak biçimde bir düzenden de geçmiş olması gerekir. Bunun olduğundan emin olamıyorsanız 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ırlayıcı kutu kenarları ve görünüm kenarları arasında bırakmak için boşluk (px) girin. Bu değer, sınırlayıcı kutunun dört tarafına da uygulanır.

İlerlemeler

• dönüşümü içeren bir CameraUpdate.

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

Ekranın merkezini bir LatLng nesnesi tarafından belirtilen enlem ve boylama hareket ettiren ve belirtilen yakınlaştırma düzeyine ulaşan bir CameraUpdate döndürür.

Parametreler

latLng	istenen enlem ve boylamı içeren bir LatLng nesnesi.
yakınlaştırma	istediğiniz yakınlaştırma düzeyini (2,0 - 21,0 aralığında) ayarlayın. Bu aralığın altındaki değerler 2,0 ve üzerindeki değerler 21,0 olarak ayarlanır. Yakınlaştırmak için değeri artırın. Her alanda en yüksek yakınlaştırma düzeyinde karolar bulunmaz.

İlerlemeler

• dönüşümü içeren bir CameraUpdate.

herkese açık statik CameraUpdate scrollBy (xPixel, kayan yPixel)

Kamerayı harita üzerinde kaydıran bir CameraUpdate döndürerek görüş merkezini x ve y yönlerinde belirtilen piksel sayısına kadar kaydırır.

Örnekler:

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

Kaydırma, kameranın mevcut yönüne göre yapılır. Örneğin, kamera 90 derece yönlendiriyorsa doğu yönü "yukarı", sağa kaydırma ise kamerayı güneye taşır.

Parametreler

xPixel	yatay olarak kaydırılacak piksel sayısı. Pozitif değer, kamerayı mevcut yönüne göre sağa taşır. Negatif değerse kamera mevcut yönüne göre sola doğru hareket eder.
yPixel	dikey olarak kaydırılacak piksel sayısını görebilirsiniz. Pozitif değer varsa kamerayı mevcut yönüne göre aşağı hareket ettirir. Negatif bir değerse kamera mevcut yönüne göre yukarı doğru hareket eder.

İlerlemeler

• dönüşümü içeren bir CameraUpdate.

herkese açık statik CameraUpdate zoomBy (kayan öğe miktarı, Nokta odağı)

Geçerli kamera görüş noktasının yakınlaştırma düzeyini değiştiren bir CameraUpdate döndürür.

Odak tarafından 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 zoomTo(float) yönteminden farklıdır, ancak yakınlaştırma düzeyi mevcut kameraya göre belirlenir.

Örneğin, LatLng (11.11, 22.22) şu anda ekran konumundaysa (23, 45). Bu yöntemin ve bu LatLng öğesinin bir yakınlaştırma miktarıyla çağrıldıktan sonra, bu LatLng öğesinin ekran konumu (23, 45) olmaya devam eder.

Parametreler

amount	tuşuna basın. Pozitif değerler yerkürenin yüzeyine daha yakın bir yakınlaştırma yapıldığını, negatif değerler ise Dünya yüzeyinden uzaklaştırmayı belirtir.
odak	yakınlaştırma işleminden sonra sabit kalacak piksel konumu. Kamera hareket etmeden önce söz konusu piksel konumunda bulunan enlem/boylam, kamera hareket ettikten sonra aynı kalır.

İlerlemeler

• dönüşümü içeren bir CameraUpdate.

herkese açık statik CameraUpdate zoomBy (kayan öğe miktarı)

Geçerli kamera görüş noktasının yakınlaştırma düzeyini değiştiren bir CameraUpdate döndürür.

Bu yöntem zoomTo(float) yönteminden farklıdır, ancak yakınlaştırma düzeyi mevcut kameraya göre belirlenir.

Parametreler

amount	tuşuna basın. Pozitif değerler yerkürenin yüzeyine daha yakın bir yakınlaştırma yapıldığını, negatif değerler ise Dünya yüzeyinden uzaklaştırmayı belirtir.

İlerlemeler

• dönüşümü içeren bir CameraUpdate.

herkese açık statik CameraUpdate zoomIn ()

Seyir 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.

İlerlemeler

• dönüşümü içeren bir CameraUpdate.

herkese açık statik CameraUpdate zoomOut ()

Seyir noktasının yüksekliğini Dünya yüzeyinden daha uzağa hareket ettirerek haritayı uzaklaştıran bir CameraUpdate döndürür. Yakınlaştırma artışı -1,0'dır.

İlerlemeler

• dönüşümü içeren bir CameraUpdate.

herkese açık statik CameraUpdate zoomTo (kayan yakınlaştırma)

Kamera görüş noktasını belirli bir yakınlaştırma düzeyine hareket ettiren bir CameraUpdate döndürür.

Parametreler

yakınlaştırma	istediğiniz yakınlaştırma düzeyini (2,0 - 21,0 aralığında) ayarlayın. Bu aralığın altındaki değerler 2,0 ve üzerindeki değerler 21,0 olarak ayarlanır. Yakınlaştırmak için değeri artırın. Her alanda en yüksek yakınlaştırma düzeyinde karolar bulunmaz.