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:
- Uygulamanıza eklediğiniz bir
MapFragment
veyaMapView
tarafından kullanılabilen birGoogleMap
bekleyin.getMapAsync()
yöntemini çağırıponMapReady(GoogleMap map)
geri çağırmasını bekleyerekGoogleMap
örneğini alabilirsiniz. initialize(Context)
Hizmetleri İçin Arayın.GooglePlayServicesNotAvailableException
atılmadığı sürece bu sınıf doğru şekilde başlatılacak.
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
- dönüşümü içeren
CameraUpdate
.
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
- dönüşümü içeren
CameraUpdate
.
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
- dönüşümü içeren
CameraUpdate
.
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
- dönüşümü içeren
CameraUpdate
.
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
- dönüşümü içeren
CameraUpdate
.
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
- dönüşümü içeren
CameraUpdate
.
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
- dönüşümü içeren
CameraUpdate
.
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
- dönüşümü içeren
CameraUpdate
.
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
- dönüşümü içeren
CameraUpdate
.
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
- dönüşümü içeren
CameraUpdate
.
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. |
---|