CameraUpdateFactory

class final publik CameraUpdateFactory memperluas Objek

Class yang berisi metode untuk membuat objek CameraUpdate yang mengubah kamera peta. Untuk mengubah kamera peta, panggil animateCamera(CameraUpdate), animateCamera(CameraUpdate, GoogleMap.CancelableCallback), atau moveCamera(CameraUpdate), menggunakan objek CameraUpdate yang dibuat dengan class ini.

Misalnya, untuk memperbesar peta, Anda dapat menggunakan kode berikut:

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

Sebelum menggunakan metode dari class ini, Anda harus melakukan salah satu hal berikut untuk memastikan bahwa class ini diinisialisasi:

• Tunggu hingga GoogleMap tersedia dari MapFragment atau MapView yang telah Anda tambahkan ke aplikasi. Anda bisa mendapatkan GoogleMap dengan memanggil getMapAsync() dan menunggu callback onMapReady(GoogleMap map).
• Hubungi initialize(Context). Selama GooglePlayServicesNotAvailableException tidak ditampilkan, class ini akan ditampilkan dengan benar diinisialisasi.

Panduan Developer

Untuk informasi selengkapnya, baca Kamera dan Tampilan panduan developer.

Ringkasan Metode Publik

statis CameraUpdate	newCameraPosition(CameraPosition cameraPosition) Menampilkan CameraUpdate yang menggerakkan kamera ke CameraPosition yang ditentukan.
statis CameraUpdate	newLatLng(LatLng latLng) Menampilkan CameraUpdate yang memindahkan bagian tengah layar ke lintang dan bujur yang ditentukan oleh objek LatLng.
statis CameraUpdate	newLatLngBounds(batas LatLngBounds, lebar int, tinggi int, padding int) Menampilkan CameraUpdate yang mengubah kamera sedemikian rupa sehingga batas garis lintang/bujur dipusatkan di layar dalam kotak pembatas dimensi tertentu pada tingkat zoom tertinggi.
statis CameraUpdate	newLatLngBounds(batas LatLngBounds, padding int) Menampilkan CameraUpdate yang mengubah kamera sedemikian rupa sehingga batas garis lintang/bujur dipusatkan di layar dengan tingkat zoom setinggi mungkin.
statis CameraUpdate	newLatLngZoom(LatLng latLng, zoom mengambang) Menampilkan CameraUpdate yang memindahkan bagian tengah layar ke lintang dan bujur yang ditentukan oleh objek LatLng, dan berpindah ke tingkat zoom yang diberikan.
statis CameraUpdate	scrollBy(xPixel mengambang, yPixel mengambang) Menampilkan CameraUpdate yang men-scroll kamera ke atas peta, menggeser ke tengah tampilan berdasarkan jumlah {i>pixel<i} yang ditentukan dalam arah x dan y.
statis CameraUpdate	zoomBy(jumlah mengambang, Fokus titik) Menampilkan CameraUpdate yang menggeser tingkat zoom titik pandang kamera saat ini.
statis CameraUpdate	zoomBy(jumlah mengambang) Menampilkan CameraUpdate yang menggeser tingkat zoom titik pandang kamera saat ini.
statis CameraUpdate	zoomIn() Menampilkan CameraUpdate yang memperbesar peta dengan mendekatkan tinggi titik pandang ke permukaan Bumi.
statis CameraUpdate	zoomOut() Menampilkan CameraUpdate yang memperkecil peta dengan memindahkan tinggi titik pandang yang lebih jauh dari permukaan Bumi.
statis CameraUpdate	zoomTo(zoom mengambang) Menampilkan CameraUpdate yang memindahkan titik pandang kamera ke tingkat zoom tertentu.

Ringkasan Metode Turunan

Dari class java.lang.Object

boolean	equals(Object arg0)
final Kelas<?>	getClass()
int	hashCode()
final void	notify()
final void	notifyAll()
String	toString()
final void	wait(long arg0, int arg1)
final void	wait(long arg0)
final void	wait()

Metode Publik

publik statis CameraUpdate newCameraPosition (CameraPosition cameraPosition)

Menampilkan CameraUpdate yang menggerakkan kamera ke CameraPosition yang ditentukan. Di beberapa , ini akan membuat transformasi dari lintang objek CameraPosition, bujur, tingkat zoom, arah dan kemiringan.

Parameter

cameraPosition

Hasil

• CameraUpdate yang berisi transformasi.

publik statis CameraUpdate newLatLng (LatLng latLng)

Menampilkan CameraUpdate yang memindahkan bagian tengah layar ke lintang dan bujur yang ditentukan oleh objek LatLng. Tindakan ini akan menempatkan kamera di tengah pada objek LatLng.

Parameter

latLng	objek LatLng yang berisi lintang dan bujur yang diinginkan.

Hasil

• CameraUpdate yang berisi transformasi.

publik statis CameraUpdate newLatLngBounds (LatLngBounds batas, lebar int, tinggi int, padding int)

Menampilkan CameraUpdate yang mengubah kamera sedemikian rupa sehingga batas garis lintang/bujur dipusatkan di layar dalam kotak pembatas dimensi tertentu pada tingkat zoom tertinggi. Anda dapat menentukan padding tambahan, untuk lebih membatasi ukuran kotak pembatas. CameraUpdate yang ditampilkan memiliki bearing 0 dan kemiringan dari 0.

Tidak seperti newLatLngBounds(LatLngBounds, int), Anda dapat menggunakan CameraUpdate yang ditampilkan oleh metode ini untuk mengubah kamera sebelum fase tata letak peta, karena menentukan ukuran kotak pembatas yang diinginkan.

Parameter

batas	wilayah untuk dimasukkan ke dalam kotak pembatas
lebar	lebar kotak pembatas dalam piksel (px)
tinggi	tinggi kotak pembatas dalam piksel (px)
padding	pembatasan ukuran tambahan (dalam px) kotak pembatas

Hasil

• CameraUpdate yang berisi transformasi.

publik statis CameraUpdate newLatLngBounds (LatLngBounds batas, padding int)

Menampilkan CameraUpdate yang mengubah kamera sedemikian rupa sehingga batas garis lintang/bujur dipusatkan di layar dengan tingkat zoom setinggi mungkin. Anda dapat menentukan padding, untuk menyisipkan kotak pembatas dari tepi tampilan peta. URL yang dikembalikan CameraUpdate memiliki bearing 0 dan kemiringan 0.

Jangan ubah kamera dengan update kamera ini hingga peta diberi tata letak (di agar metode ini dapat menentukan kotak pembatas dan tingkat zoom yang sesuai, peta harus memiliki ukuran). Jika tidak, IllegalStateException akan ditampilkan. BUKAN memadai agar peta tersedia; tampilan yang berisi peta juga harus menjalani tata letak sedemikian rupa sehingga dimensinya telah ditentukan. Jika Anda tidak yakin bahwa hal ini memiliki terjadi, gunakan newLatLngBounds(LatLngBounds, int, int, int) sebagai gantinya dan berikan dimensi peta secara manual.

Parameter

batas	agar pas dengan layar
padding	spasi (dalam px) untuk tersisa di antara tepi kotak pembatas dan tepi tampilan. Ini diterapkan ke keempat sisi kotak pembatas.

Hasil

• CameraUpdate yang berisi transformasi.

publik statis CameraUpdate newLatLngZoom (LatLng latLng, zoom mengambang)

Menampilkan CameraUpdate yang memindahkan bagian tengah layar ke lintang dan bujur yang ditentukan oleh objek LatLng, dan berpindah ke tingkat zoom yang diberikan.

Parameter

latLng	objek LatLng yang berisi lintang dan bujur yang diinginkan.
zoom	tingkat zoom yang diinginkan, dalam kisaran 2,0 hingga 21,0. Nilai di bawah rentang ini adalah ditetapkan ke 2.0, dan nilai di atasnya ditetapkan ke 21.0. Naikkan nilai untuk memperbesar. Tidak semua area memiliki ubin dengan tingkat zoom terbesar.

Hasil

• CameraUpdate yang berisi transformasi.

publik statis CameraUpdate scrollBy (xPixel mengambang, yPixel mengambang)

Menampilkan CameraUpdate yang men-scroll kamera ke atas peta, menggeser ke tengah tampilan berdasarkan jumlah {i>pixel<i} yang ditentukan dalam arah x dan y.

Contoh:

• Jika xPixel = 5 dan yPixel = 0, sistem akan menggulir ke kanan dengan menggerakkan kamera sehingga peta tampaknya bergeser 5 piksel ke kiri.
• Jika xPixel = 0 dan yPixel = 5, sistem akan menggulir ke bawah dengan menggerakkan kamera sehingga peta tampaknya bergeser 5 piksel ke atas.

Scrolling relatif dengan orientasi kamera saat ini. Misalnya, jika kamera arah 90 derajat, maka timur adalah "atas" dan menggulir ke kanan akan menggerakkan kamera ke selatan.

Parameter

xPixel	jumlah {i>pixel<i} untuk di-scroll secara horizontal. Nilai positif menggerakkan kamera ke sebelah kanan, dalam kaitannya dengan orientasinya saat ini. Nilai negatif menggerakkan kamera ke sebelah kiri, sesuai dengan orientasinya saat ini.
yPixel	jumlah {i>pixel<i} untuk menggulir secara vertikal. Nilai positif menggerakkan kamera ke bawah, dalam kaitannya dengan orientasinya saat ini. Nilai negatif menggerakkan kamera ke atas, dalam kaitannya dengan orientasinya saat ini.

Hasil

• CameraUpdate yang berisi transformasi.

publik statis CameraUpdate zoomBy (jumlah mengambang, Fokus titik)

Menampilkan CameraUpdate yang menggeser tingkat zoom titik pandang kamera saat ini.

Titik yang ditentukan oleh fokus akan tetap (yaitu, sesuai dengan lintang/bujur yang sama sebelum dan sesudah proses {i>zoom<i}).

Metode ini berbeda dengan zoomTo(float) pada zoom tersebut relatif terhadap saat ini kamera.

Misalnya, jika LatLng (11.11, 22.22) saat ini berada di lokasi layar (23, 45). Setelah memanggil metode ini dengan jumlah zoom dan LatLng ini, lokasi layar dari LatLng ini akan tetap menjadi (23, 45).

Parameter

jumlah	untuk mengubah tingkat zoom. Nilai positif menunjukkan zoom mendekati permukaan bumi sementara nilai negatif menunjukkan pembesaran (zoom) menjauh dari permukaan Bumi.
fokus	lokasi piksel pada layar yang akan tetap berada setelah proses zoom. Lintang/bujur yang ada di lokasi piksel tersebut sebelum gerakan kamera akan tetap sama setelah kamera digerakkan.

Hasil

• CameraUpdate yang berisi transformasi.

publik statis CameraUpdate zoomBy (jumlah mengambang)

Menampilkan CameraUpdate yang menggeser tingkat zoom titik pandang kamera saat ini.

Metode ini berbeda dengan zoomTo(float) pada zoom tersebut relatif terhadap saat ini kamera.

Parameter

jumlah	untuk mengubah tingkat zoom. Nilai positif menunjukkan zoom mendekati permukaan bumi sementara nilai negatif menunjukkan pembesaran (zoom) menjauh dari permukaan Bumi.

Hasil

• CameraUpdate yang berisi transformasi.

publik statis CameraUpdate zoomIn ()

Menampilkan CameraUpdate yang memperbesar peta dengan mendekatkan tinggi titik pandang ke permukaan Bumi. Kenaikan zoom adalah 1,0.

Hasil

• CameraUpdate yang berisi transformasi.

publik statis CameraUpdate zoomOut ()

Menampilkan CameraUpdate yang memperkecil peta dengan memindahkan tinggi titik pandang yang lebih jauh dari permukaan Bumi. Kenaikan zoom adalah -1,0.

Hasil

• CameraUpdate yang berisi transformasi.

publik statis CameraUpdate zoomTo (zoom mengambang)

Menampilkan CameraUpdate yang memindahkan titik pandang kamera ke tingkat zoom tertentu.

Parameter

zoom	tingkat zoom yang diinginkan, dalam kisaran 2,0 hingga 21,0. Nilai di bawah rentang ini adalah ditetapkan ke 2.0, dan nilai di atasnya ditetapkan ke 21.0. Naikkan nilai untuk memperbesar. Tidak semua area memiliki ubin dengan tingkat zoom terbesar.