Ini adalah class utama Google Maps SDK for Android dan merupakan titik entri untuk semua metode yang terkait dengan peta. Anda tidak dapat membuat instance objek GoogleMap
secara langsung, tetapi Anda harus
memperolehnya dari metode getMapAsync()
pada MapFragment
atau MapView
yang
telah ditambahkan ke aplikasi Anda.
Catatan: Serupa dengan objek View
, GoogleMap
hanya dapat dibaca
dan diubah dari UI thread Android. Memanggil metode GoogleMap
dari thread lain
akan menghasilkan pengecualian.
Anda dapat menyesuaikan sudut pandang peta dengan mengubah posisi kamera (bukan dengan menggerakkan peta). Anda dapat menggunakan kamera peta untuk menetapkan parameter seperti lokasi, tingkat zoom, sudut kemiringan, dan bearing. Untuk informasi selengkapnya, lihat Kamera dan Tampilan.
Panduan Developer
Untuk memulai, baca panduan developer Google Maps SDK for Android .
Ringkasan Class Bertingkat
antarmuka | GoogleMap.CancelableCallback | Antarmuka callback untuk pelaporan saat tugas selesai atau dibatalkan. | |
antarmuka | GoogleMap.InfoWindowAdapter | Memberikan tampilan untuk rendering jendela info yang disesuaikan. | |
antarmuka | GoogleMap.OnCameraChangeListener |
Antarmuka ini tidak digunakan lagi.
Diganti dengan GoogleMap.OnCameraMoveStartedListener , GoogleMap.OnCameraMoveListener , dan
GoogleMap.OnCameraIdleListener . Urutan pemanggilan metode onCameraChange yang tidak digunakan lagi sehubungan dengan metode dalam pemroses perubahan kamera baru tidak ditentukan.
|
|
antarmuka | GoogleMap.OnCameraIdleListener | Antarmuka callback saat gerakan kamera berakhir. | |
antarmuka | GoogleMap.OnCameraMoveCanceledListener | Antarmuka callback saat gerakan kamera telah dihentikan atau saat kamera mulai bergerak karena alasan baru. | |
antarmuka | GoogleMap.OnCameraMoveListener | Antarmuka callback saat kamera mengubah posisi. | |
antarmuka | GoogleMap.OnCameraMoveStartedListener | Antarmuka callback saat gerakan kamera dimulai. | |
antarmuka | GoogleMap.OnCircleClickListener | Antarmuka callback saat lingkaran diklik. | |
antarmuka | GoogleMap.OnGroundOverlayClickListener | Antarmuka callback saat overlay bumi diklik. | |
antarmuka | GoogleMap.OnIndoorStateChangeListener | Pemroses saat keadaan dalam ruangan berubah. | |
antarmuka | GoogleMap.OnInfoWindowClickListener | Antarmuka callback untuk peristiwa klik/ketuk pada jendela info penanda. | |
antarmuka | GoogleMap.OnInfoWindowCloseListener | Antarmuka callback untuk peristiwa tutup di jendela info penanda. | |
antarmuka | GoogleMap.OnInfoWindowLongClickListener | Antarmuka callback saat pengguna menekan lama jendela info penanda. | |
antarmuka | GoogleMap.OnMapClickListener | Antarmuka callback saat pengguna mengetuk peta. | |
antarmuka | GoogleMap.OnMapLoadedCallback | Antarmuka callback saat peta selesai dirender. | |
antarmuka | GoogleMap.OnMapLongClickListener | Antarmuka callback saat pengguna menekan lama pada peta. | |
antarmuka | GoogleMap.OnMarkerClickListener | Menentukan tanda tangan untuk metode yang dipanggil saat penanda diklik atau diketuk. | |
antarmuka | GoogleMap.OnMarkerDragListener | Antarmuka callback untuk peristiwa tarik pada penanda. | |
antarmuka | GoogleMap.OnMyLocationButtonClickListener | Antarmuka callback saat tombol Lokasiku diklik. | |
antarmuka | GoogleMap.OnMyLocationChangeListener | Antarmuka ini tidak digunakan lagi. Sebagai gantinya, gunakan com.google.android.gms.location.FusedLocationProviderApi. FusedLocationProviderApi memberikan penemuan lokasi dan penggunaan daya yang lebih baik, serta digunakan oleh titik biru "Lokasiku". Lihat tutorial Memilih Tempat Saat Ini, yang menggunakan FusedLocationProviderApi, atau Panduan Developer Lokasi. | |
antarmuka | GoogleMap.OnMyLocationClickListener | Antarmuka callback saat titik Lokasiku (yang menandakan lokasi pengguna) diklik. | |
antarmuka | GoogleMap.OnPoiClickListener | Pemroses untuk ketukan POI. | |
antarmuka | GoogleMap.OnPolygonClickListener | Antarmuka callback saat poligon diklik. | |
antarmuka | GoogleMap.OnPolylineClickListener | Antarmuka callback saat polyline diklik. | |
antarmuka | GoogleMap.SnapshotReadyCallback | Antarmuka callback untuk memberi tahu saat snapshot telah diambil. |
Ringkasan Konstanta
int | MAP_TYPE_HYBRID | Peta satelit dengan lapisan transparan jalan-jalan utama. |
int | MAP_TYPE_NONE | Tidak ada ubin peta dasar. |
int | MAP_TYPE_NORMAL | Peta dasar. |
int | MAP_TYPE_SATELLITE | Peta satelit tanpa label. |
int | MAP_TYPE_TERRAIN | Peta medan. |
Ringkasan Metode Publik
Circle | |
GroundOverlay | |
Marker | |
Polygon | |
Polyline | |
TileOverlay | |
void |
animateCamera(update CameraUpdate)
Menganimasikan gerakan kamera dari posisi saat ini ke posisi yang ditentukan dalam
update.
|
void |
animateCamera(update CameraUpdate, callback GoogleMap.CancelableCallback)
Menganimasikan pergerakan kamera dari posisi saat ini ke posisi yang ditentukan dalam
update dan memanggil callback opsional saat selesai.
|
void |
animateCamera(update CameraUpdate, int durationMs, callback GoogleMap.CancelableCallback)
Menggerakkan peta sesuai dengan pembaruan dengan animasi selama durasi yang ditentukan, dan memanggil callback opsional setelah selesai.
|
void |
clear()
Menghapus semua penanda, polyline, poligon, overlay, dll dari peta.
|
CameraPosition |
getCameraPosition()
Mendapatkan posisi kamera saat ini.
|
IndoorBuilding |
getFocusedBuilding()
Mendapatkan fokus bangunan saat ini.
|
int |
getMapType()
Mendapatkan jenis peta yang saat ini ditampilkan.
|
float |
getMaxZoomLevel()
Menampilkan tingkat zoom maksimum untuk posisi kamera saat ini.
|
float |
getMinZoomLevel()
Menampilkan tingkat zoom minimum.
|
Lokasi |
getMyLocation()
Metode ini tidak digunakan lagi.
use com.google.android.gms.location.FusedLocationProviderApi instead.
FusedLocationProviderApi memberikan penemuan lokasi dan penggunaan daya yang lebih baik, serta digunakan oleh titik biru "Lokasiku". Lihat MyLocationDemoActivity di folder aplikasi contoh untuk kode contoh, atau Panduan Developer Lokasi.
|
Proyeksi |
getProjection()
Menampilkan objek
Projection yang dapat Anda gunakan untuk mengonversi antara koordinat layar dan koordinat lintang/bujur. |
UiSettings |
getUiSettings()
Mendapatkan setelan antarmuka pengguna untuk peta.
|
boolean |
isBuildingsEnabled()
Menampilkan apakah lapisan bangunan 3D diaktifkan.
|
boolean |
isIndoorEnabled()
Mendapatkan apakah peta lantai saat ini diaktifkan.
|
boolean |
isMyLocationEnabled()
Mendapatkan status lapisan my-location.
|
boolean |
isTrafficEnabled()
Memeriksa apakah peta menggambar data lalu lintas.
|
void |
moveCamera(update CameraUpdate)
Mengubah posisi kamera sesuai dengan petunjuk yang ditentukan dalam update.
|
void |
resetMinMaxZoomPreference()
Menghapus batas zoom atas dan bawah yang ditentukan sebelumnya.
|
void |
setBuildingsEnabled(boolean diaktifkan)
Mengaktifkan atau menonaktifkan lapisan bangunan 3D.
|
void |
setContentDescription(Deskripsi string)
Menetapkan contentDescription untuk peta.
|
boolean |
setIndoorEnabled(boolean diaktifkan)
Menetapkan apakah peta lantai harus diaktifkan.
|
void |
setInfoWindowAdapter(adaptor GoogleMap.InfoWindowAdapter)
Menyetel perender kustom untuk konten jendela info.
|
void |
setLatLngBoundsForCameraTarget(batas LatLngBounds)
Menentukan LatLngBounds untuk membatasi target kamera, sehingga saat pengguna men-scroll dan menggeser
peta, target kamera tidak akan bergerak di luar batas ini.
|
void | |
boolean | |
void |
setMapType(int type)
Menetapkan jenis ubin peta yang harus ditampilkan.
|
void |
setMaxZoomPreference(float maxZoomPreference)
Menetapkan batas atas yang diinginkan untuk zoom kamera.
|
void |
setMinZoomPreference(float minZoomPreference)
Menetapkan batas bawah pilihan untuk zoom kamera.
|
void |
setMyLocationEnabled(boolean diaktifkan)
Mengaktifkan atau menonaktifkan lapisan my-location.
|
void |
setOnCameraChangeListener(pemroses GoogleMap.OnCameraChangeListener)
Metode ini tidak digunakan lagi.
Diganti dengan
setOnCameraMoveStartedListener(GoogleMap.OnCameraMoveStartedListener) , setOnCameraMoveListener(GoogleMap.OnCameraMoveListener) , setOnCameraMoveCanceledListener(GoogleMap.OnCameraMoveCanceledListener) , dan setOnCameraIdleListener(GoogleMap.OnCameraIdleListener) .
|
void |
setOnCameraIdleListener(pemroses GoogleMap.OnCameraIdleListener)
Menetapkan callback yang dipanggil saat gerakan kamera berakhir.
|
void |
setOnCameraMoveCanceledListener(pemroses GoogleMap.OnCameraMoveCanceledListener)
Menetapkan callback yang dipanggil saat gerakan kamera dihentikan atau diganggu oleh jenis animasi baru.
|
void |
setOnCameraMoveListener(pemroses GoogleMap.OnCameraMoveListener)
Menetapkan callback yang dipanggil berulang kali saat kamera sedang bergerak.
|
void |
setOnCameraMoveStartedListener(pemroses GoogleMap.OnCameraMoveStartedListener)
Menetapkan callback yang dipanggil saat kamera mulai bergerak atau alasan gerakan kamera telah berubah.
|
void |
setOnCircleClickListener(pemroses GoogleMap.OnCircleClickListener)
Menetapkan callback yang dipanggil saat lingkaran diklik.
|
void |
setOnGroundOverlayClickListener(pemroses GoogleMap.OnGroundOverlayClickListener)
Menetapkan callback yang dipanggil saat overlay bumi diklik.
|
void |
setOnIndoorStateChangeListener(pemroses GoogleMap.OnIndoorStateChangeListener)
Menetapkan atau menghapus pemroses untuk peristiwa dalam ruangan.
|
void |
setOnInfoWindowClickListener(pemroses GoogleMap.OnInfoWindowClickListener)
Menetapkan callback yang dipanggil saat jendela info penanda diklik.
|
void |
setOnInfoWindowCloseListener(pemroses GoogleMap.OnInfoWindowCloseListener)
Menetapkan callback yang dipanggil saat jendela info penanda ditutup.
|
void |
setOnInfoWindowLongClickListener(pemroses GoogleMap.OnInfoWindowLongClickListener)
Menetapkan callback yang dipanggil saat jendela info penanda ditekan lama.
|
void |
setOnMapClickListener(pemroses GoogleMap.OnMapClickListener)
Menetapkan callback yang dipanggil saat peta diketuk.
|
void |
setOnMapLoadedCallback(callback GoogleMap.OnMapLoadedCallback)
Menetapkan callback yang dipanggil saat peta ini selesai dirender.
|
void |
setOnMapLongClickListener(pemroses GoogleMap.OnMapLongClickListener)
Menetapkan callback yang dipanggil saat peta ditekan lama.
|
void |
setOnMarkerClickListener(pemroses GoogleMap.OnMarkerClickListener)
Menetapkan callback yang dipanggil saat penanda diklik.
|
void |
setOnMarkerDragListener(pemroses GoogleMap.OnMarkerDragListener)
Menetapkan callback yang dipanggil saat penanda ditarik.
|
void |
setOnMyLocationButtonClickListener(pemroses GoogleMap.OnMyLocationButtonClickListener)
Menetapkan callback yang dipanggil saat tombol lokasi saya diklik.
|
void |
setOnMyLocationChangeListener(pemroses GoogleMap.OnMyLocationChangeListener)
Metode ini tidak digunakan lagi.
use com.google.android.gms.location.FusedLocationProviderApi instead.
FusedLocationProviderApi memberikan penemuan lokasi dan penggunaan daya yang lebih baik, serta digunakan oleh titik biru "Lokasiku". Lihat MyLocationDemoActivity di folder aplikasi contoh untuk kode contoh, atau Panduan Developer Lokasi.
|
void |
setOnMyLocationClickListener(pemroses GoogleMap.OnMyLocationClickListener)
Menetapkan callback yang dipanggil saat titik Lokasiku (yang menandakan lokasi pengguna) diklik.
|
void |
setOnPoiClickListener(pemroses GoogleMap.OnPoiClickListener)
Menetapkan pemroses yang akan dipicu saat POI diklik atau diketuk.
|
void |
setOnPolygonClickListener(pemroses GoogleMap.OnPolygonClickListener)
Menetapkan callback yang dipanggil saat poligon diklik.
|
void |
setOnPolylineClickListener(pemroses GoogleMap.OnPolylineClickListener)
Menetapkan callback yang dipanggil saat polyline diklik.
|
void |
setPadding(int left, int top, int right, int bottom)
Menetapkan padding pada peta.
|
void |
setTrafficEnabled(boolean diaktifkan)
Mengaktifkan atau menonaktifkan lapisan lalu lintas.
|
void | |
void | |
void |
stopAnimation()
Menghentikan animasi kamera jika ada animasi yang sedang berlangsung.
|
Ringkasan Metode Turunan
Konstanta
public static final int MAP_TYPE_HYBRID
Peta satelit dengan lapisan transparan jalan-jalan utama.
public static final int MAP_TYPE_NONE
Tidak ada ubin peta dasar.
public static final int MAP_TYPE_NORMAL
Peta dasar.
public static final int MAP_TYPE_SATELLITE
Peta satelit tanpa label.
public static final int MAP_TYPE_TERRAIN
Peta medan.
Metode Publik
publik Lingkaran addCircle (CircleOptions)
Tambahkan lingkaran ke peta ini.
Parameter
opsi | Objek opsi lingkaran yang menentukan cara merender Lingkaran |
---|
Hasil
- Objek
Circle
yang ditambahkan ke peta
publik GroundOverlay addGroundOverlay (GroundOverlayOptions)
Menambahkan gambar ke peta ini.
Parameter
opsi | Objek opsi overlay bumi yang menentukan cara merender overlay. Opsi harus memiliki gambar (AnchoredBitmap) dan posisi yang ditentukan. |
---|
Hasil
GroundOverlay
yang ditambahkan ke peta.
Menampilkan
IllegalArgumentException | jika gambar atau posisi tidak ditentukan dalam opsi. |
---|
publik Penanda addMarker (MarkerOptions)
Menambahkan penanda ke peta ini.
Ikon penanda dirender pada peta di lokasi Marker.position. Mengklik penanda akan memusatkan kamera pada penanda. Jika Marker.title ditentukan, peta akan menampilkan kotak info dengan judul dan cuplikan penanda. Jika penanda dapat ditarik, mengklik lama penanda akan memindahkannya.
Parameter
opsi | Objek opsi penanda yang menentukan cara merender penanda. |
---|
Hasil
Marker
yang ditambahkan ke peta.
publik Polygon addPolygon (PolygonOptions)
Menambahkan poligon ke peta ini.
Parameter
opsi | Objek opsi poligon yang mendefinisikan cara merender Poligon. |
---|
Hasil
- Objek
Polygon
yang ditambahkan ke peta.
publik Polyline addPolyline (PolylineOptions)
Menambahkan polyline ke peta ini.
Parameter
opsi | Objek opsi polyline yang mendefinisikan cara merender Polyline. |
---|
Hasil
- Objek
Polyline
yang ditambahkan ke peta.
publik TileOverlay addTileOverlay (TileOverlayOptions)
Menambahkan overlay ubin ke peta ini. Lihat TileOverlay
untuk mengetahui informasi selengkapnya.
Perhatikan bahwa tidak seperti overlay lain, jika peta dibuat ulang, overlay ubin tidak otomatis dipulihkan dan harus ditambahkan kembali secara manual.
Parameter
opsi | Objek opsi overlay ubin yang menentukan cara merender overlay. Opsi harus memiliki TileProvider yang ditentukan. Jika tidak, IllegalArgumentException akan ditampilkan. |
---|
Hasil
TileOverlay
yang ditambahkan ke peta.
Menampilkan
IllegalArgumentException | jika TileProvider tidak ditentukan dalam opsi.
|
---|
public void animateCamera (update CameraUpdate)
Menganimasikan gerakan kamera dari posisi saat ini ke posisi yang ditentukan dalam
update. Selama animasi, panggilan ke getCameraPosition()
akan menampilkan lokasi perantara kamera.
Lihat CameraUpdateFactory
untuk melihat serangkaian update.
Parameter
ubah | Perubahan yang harus diterapkan ke kamera. |
---|
public void animateCamera (Update CameraUpdate, callback GoogleMap.CancelableCallback)
Menganimasikan pergerakan kamera dari posisi saat ini ke posisi yang ditentukan dalam
update dan memanggil callback opsional saat selesai. Lihat CameraUpdateFactory
untuk melihat serangkaian update.
Selama animasi, panggilan ke getCameraPosition()
akan menampilkan lokasi perantara kamera.
Parameter
ubah | Perubahan yang harus diterapkan ke kamera. |
---|---|
callback | Callback yang akan dipanggil dari UI thread Android saat animasi berhenti. Jika animasi selesai secara normal, onFinish() akan dipanggil; jika tidak, onCancel() akan dipanggil. Jangan mengupdate atau menganimasikan kamera dari dalam onCancel() .
|
public void animateCamera (Update CameraUpdate, int durationMs, GoogleMap.CancelableCallback callback)
Menggerakkan peta sesuai dengan pembaruan dengan animasi selama durasi yang ditentukan, dan memanggil callback opsional setelah selesai. Lihat CameraUpdateFactory
untuk melihat serangkaian update.
Jika getCameraPosition()
dipanggil selama animasi, fungsi ini akan menampilkan lokasi kamera saat ini dalam penerbangan.
Parameter
ubah | |
---|---|
durationMs | Durasi animasi dalam milidetik. Nilai ini harus benar-benar positif. Jika tidak, IllegalArgumentException akan ditampilkan.
|
callback | Callback opsional yang akan diberi tahu dari UI thread Android saat animasi berhenti. Jika animasi berhenti karena penyelesaian alami, callback akan diberi tahu dengan onFinish() . Jika animasi berhenti karena gangguan oleh gerakan kamera berikutnya atau gestur pengguna, onCancel() akan dipanggil. Callback tidak boleh berupaya memindahkan atau
menganimasikan kamera dalam metode pembatalannya. Jika callback tidak diperlukan, biarkan sebagai
null . |
public void clear ()
Menghapus semua penanda, polyline, poligon, overlay, dll dari peta.
public CameraPosition getCameraPosition ()
Mendapatkan posisi kamera saat ini.
CameraPosition
yang ditampilkan adalah snapshot dari posisi saat ini, dan tidak akan otomatis diperbarui saat kamera bergerak.
Untuk informasi selengkapnya tentang mengubah posisi kamera, lihat Kamera dan Tampilan.
Hasil
- Posisi Kamera saat ini.
publik IndoorBuilding getFocusedBuilding ()
Mendapatkan fokus bangunan saat ini.
Hasil
- Gedung yang difokuskan saat ini atau
null
jika tidak ada bangunan yang difokuskan.
public int getMapType ()
Mendapatkan jenis peta yang saat ini ditampilkan. Lihat MAP_TYPE_NORMAL
, MAP_TYPE_SATELLITE
, MAP_TYPE_TERRAIN
untuk nilai yang memungkinkan.
Hasil
- Jenis peta.
float publik getMaxZoomLevel ()
Menampilkan tingkat zoom maksimum untuk posisi kamera saat ini. Hal ini memperhitungkan jenis peta yang sedang digunakan, misalnya, satelit atau medan yang mungkin memiliki tingkat zoom maksimum yang lebih rendah daripada ubin peta dasar.
Untuk mengetahui informasi selengkapnya tentang cara mengubah tingkat zoom kamera, lihat Kamera dan Tampilan.
Hasil
- Tingkat zoom maksimum yang tersedia pada posisi kamera saat ini.
float publik getMinZoomLevel ()
Menampilkan tingkat zoom minimum. Hal ini sama untuk setiap lokasi (tidak seperti tingkat zoom maksimum), tetapi dapat bervariasi antara perangkat dan ukuran peta.
Untuk mengetahui informasi selengkapnya tentang cara mengubah tingkat zoom kamera, lihat Kamera dan Tampilan.
Hasil
- Tingkat zoom minimum yang tersedia.
publik Lokasi getMyLocation ()
Metode ini tidak digunakan lagi.
sebagai gantinya, gunakan com.google.android.gms.location.FusedLocationProviderApi.
FusedLocationProviderApi memberikan penemuan lokasi dan penggunaan daya yang lebih baik, serta digunakan oleh titik biru "Lokasiku". Lihat MyLocationDemoActivity dalam folder aplikasi contoh untuk kode contoh, atau Panduan Developer Lokasi.
Menampilkan lokasi pengguna yang saat ini ditampilkan, atau null
jika tidak ada data lokasi yang tersedia.
Hasil
user location
yang saat ini ditampilkan.
Menampilkan
IllegalStateException | jika lapisan {i>my-location<i} tidak diaktifkan. |
---|
publik Proyeksi getProjection ()
Menampilkan objek Projection
yang dapat Anda gunakan untuk mengonversi antara koordinat layar dan koordinat lintang/bujur.
Projection
yang ditampilkan adalah snapshot proyeksi saat ini, dan tidak akan
diperbarui secara otomatis saat kamera bergerak. Karena operasi ini mahal, Anda seharusnya hanya mendapatkan
proyeksi sekali per layar. Google Maps menggunakan proyeksi Mercator untuk membuat peta dari data geografis dan mengonversi titik-titik pada peta menjadi koordinat geografis.
Hasil
Projection
peta dalam status saat ini.
publik UiSettings getUiSettings ()
Mendapatkan setelan antarmuka pengguna untuk peta.
Hasil
UiSettings
untuk peta ini.
boolean publik isBuildingsEnabled ()
Menampilkan apakah lapisan bangunan 3D diaktifkan.
Hasil
true
jika gedung diaktifkan;false
jika tidak.
boolean publik isIndoorEnabled ()
Mendapatkan apakah peta lantai saat ini diaktifkan.
Hasil
true
jika peta lantai diaktifkan;false
jika peta lantai dinonaktifkan;
boolean publik isMyLocationEnabled ()
Mendapatkan status lapisan my-location.
Hasil
true
jika lapisan my-location diaktifkan;false
jika tidak.
boolean publik isTrafficEnabled ()
Memeriksa apakah peta menggambar data lalu lintas. Hal ini bergantung pada ketersediaan data traffic.
Hasil
true
jika data traffic diaktifkan;false
jika tidak.
public void moveCamera (Update CameraUpdate)
Mengubah posisi kamera sesuai dengan petunjuk yang ditentukan dalam update. Pemindahan terjadi
seketika, dan getCameraPosition()
berikutnya akan mencerminkan posisi baru. Lihat CameraUpdateFactory
untuk melihat serangkaian update.
Parameter
ubah | Perubahan yang harus diterapkan ke kamera. |
---|
public void resetMinMaxZoomPreference ()
Menghapus batas zoom atas dan bawah yang ditentukan sebelumnya.
publik void setBuildingsEnabled (boolean enabled)
Mengaktifkan atau menonaktifkan lapisan bangunan 3D.
Parameter
diaktifkan | true untuk mengaktifkan lapisan bangunan 3D; false untuk menonaktifkan bangunan 3D.
|
---|
public void setContentDescription (Deskripsi string)
Menetapkan contentDescription untuk peta.
Ini digunakan untuk memberikan deskripsi lisan tentang peta dalam mode aksesibilitas. Nilai defaultnya adalah "Google Maps"
Parameter
deskripsi | sebuah {i>string<i} untuk digunakan sebagai deskripsi. |
---|
boolean publik setIndoorEnabled (boolean enabled)
Menetapkan apakah peta lantai harus diaktifkan. Saat ini, peta lantai hanya dapat ditampilkan pada satu peta dalam satu waktu dan secara default, ini adalah peta pertama yang ditambahkan ke aplikasi Anda. Untuk mengaktifkan peta lantai pada peta lain, Anda harus terlebih dahulu menonaktifkan peta lantai pada peta aslinya. Jika Anda mencoba mengaktifkan peta lantai saat diaktifkan di peta lain, tidak akan terjadi apa-apa dan tindakan ini akan menampilkan false
. Jika Dalam Ruangan tidak diaktifkan untuk peta, semua metode yang terkait dengan dalam ruangan akan menampilkan null
, atau false
.
Parameter
diaktifkan | true untuk mencoba mengaktifkan peta lantai; false untuk menonaktifkan peta lantai. |
---|
Hasil
- apakah peta lantai dapat diaktifkan atau tidak.
public void setInfoWindowAdapter (GoogleMap.InfoWindowAdapter)
Menyetel perender kustom untuk konten jendela info.
Seperti pemroses peristiwa peta, status ini tidak diserialisasi dengan peta. Jika peta dibuat ulang (misalnya, karena perubahan konfigurasi), Anda harus memastikan bahwa metode ini dipanggil lagi untuk mempertahankan penyesuaian.
Parameter
adaptor | Adaptor yang digunakan untuk konten jendela info, atau null untuk menggunakan rendering konten default di jendela info.
|
---|
publik void setLatLngBoundsForCameraTarget (LatLngBounds batas)
Menentukan LatLngBounds untuk membatasi target kamera, sehingga saat pengguna men-scroll dan menggeser peta, target kamera tidak akan bergerak di luar batas ini.
Setel ke null untuk menghapus seluruh kotak pembatas. Batas baru menggantikan kotak pembatas yang telah ditentukan sebelumnya.
Saat LatLngBounds berubah, SDK menyesuaikan semua update kamera berikutnya untuk mengikuti batas tersebut jika memungkinkan. Perhatikan bahwa ada pertimbangan teknis yang dapat mencegah SDK menjaga target kamera secara ketat. Misalnya, error pembulatan presisi floating point atau tingkat zoom yang sangat rendah.
Parameter
batas | Batas untuk membatasi target kamera di dalamnya. |
---|
public void setLocationSource (LocationSource source)
Mengganti sumber lokasi lapisan my-location.
Parameter
source | Sumber lokasi untuk digunakan di lapisan my-location. Tetapkan ke null untuk menggunakan
sumber lokasi default.
|
---|
boolean publik setMapStyle (MapStyleOptions)
Menetapkan gaya visual peta dasar.
Dengan menggunakan opsi gaya, Anda dapat menerapkan gaya kustom pada fitur dan elemen pada peta.
Lihat MapStyleOptions
untuk mengetahui detail definisi gaya.
Tetapkan ke null untuk menghapus gaya kustom sebelumnya.
Parameter
gaya |
---|
Hasil
true
jika gaya berhasil diuraikan;false
jika masalah terdeteksi padaMapStyleOptions
, termasuk, misalnya JSON gaya yang tidak dapat diuraikan, jenis fitur yang tidak dikenali, jenis elemen yang tidak dikenali, atau kunci styler yang tidak valid. Jika nilai yang ditampilkan adalahfalse
, gaya saat ini tidak akan berubah.
public void setMapType (int type)
Menetapkan jenis ubin peta yang harus ditampilkan. Nilai yang diperbolehkan adalah:
MAP_TYPE_NORMAL
: Peta dasar.MAP_TYPE_SATELLITE
: Citra satelit.MAP_TYPE_HYBRID
: Citra satelit dengan jalan dan label.MAP_TYPE_TERRAIN
: Data topografi.MAP_TYPE_NONE
: Tidak ada ubin peta dasar.
Parameter
tipe | Jenis peta yang akan ditampilkan. |
---|
publik void setMaxZoomPreference (float maxZoomPreference)
Menetapkan batas atas yang diinginkan untuk zoom kamera.
Saat zoom maksimum berubah, SDK menyesuaikan semua update kamera berikutnya untuk menerapkan zoom maksimum tersebut jika memungkinkan. Perhatikan, ada pertimbangan teknis yang dapat mencegah SDK mengizinkan pengguna melakukan zoom terlalu dalam pada peta. Misalnya, satelit atau medan mungkin memiliki zoom maksimum yang lebih rendah dari ubin peta dasar.
SDK menyelesaikan setiap konflik dalam nilai minimum dan maksimum. Jika Anda menetapkan zoom minimum ke tingkat zoom yang lebih tinggi dari zoom maksimum saat ini, SDK akan menggunakan nilai minimum yang baru untuk zoom minimum dan maksimum. Jika Anda menetapkan zoom maksimum ke tingkat zoom yang lebih rendah dari nilai minimum, SDK akan menggunakan nilai maksimum yang baru untuk minimum dan maksimum. Misalnya: Asumsikan zoom minimum saat ini adalah 8 dan zoom maksimumnya adalah 14. Lalu, tetapkan zoom maksimum ke 6. SDK menggunakan zoom minimum 6 dan zoom maksimum 6.
Parameter
maxZoomPreference | Batas atas yang diinginkan. |
---|
public void setMinZoomPreference (float minZoomPreference)
Menetapkan batas bawah pilihan untuk zoom kamera.
Saat zoom minimum berubah, SDK menyesuaikan semua update kamera berikutnya untuk menerapkan zoom minimum tersebut jika memungkinkan. Perhatikan, ada pertimbangan teknis yang dapat mencegah SDK mengizinkan pengguna melakukan zoom terlalu rendah.
SDK menyelesaikan setiap konflik dalam nilai minimum dan maksimum. Jika Anda menetapkan zoom minimum ke tingkat zoom yang lebih tinggi dari zoom maksimum saat ini, SDK akan menggunakan nilai minimum yang baru untuk zoom minimum dan maksimum. Jika Anda menetapkan zoom maksimum ke tingkat zoom yang lebih rendah dari nilai minimum, SDK akan menggunakan nilai maksimum yang baru untuk minimum dan maksimum. Misalnya: Asumsikan zoom minimum saat ini adalah 8 dan zoom maksimumnya adalah 14. Lalu, tetapkan zoom minimum ke 16. SDK menggunakan zoom minimum 16 dan zoom maksimum 16.
Parameter
minZoomPreference | Batas bawah yang diinginkan. |
---|
publik void setMyLocationEnabled (boolean enabled)
Mengaktifkan atau menonaktifkan lapisan my-location.
Saat diaktifkan dan lokasi tersedia, lapisan my-location terus-menerus menggambar indikasi lokasi pengguna saat ini dan bearing, serta menampilkan kontrol UI yang memungkinkan pengguna untuk berinteraksi dengan lokasinya (misalnya, untuk mengaktifkan atau menonaktifkan pelacakan kamera lokasi dan bearing mereka).
Untuk menggunakan fitur lapisan lokasi saya, Anda harus meminta izin untuk
ACCESS_COARSE_LOCATION
atau ACCESS_FINE_LOCATION
, kecuali jika Anda telah menetapkan sumber lokasi
kustom.
Jika Anda telah menetapkan sumber lokasi kustom melalui setLocationSource(LocationSource)
, Google Maps SDK for Android tidak akan memeriksa apakah izin di atas telah diberikan. Namun, Anda tetap harus memastikan bahwa pengguna telah memberikan semua izin yang diperlukan untuk sumber lokasi kustom Anda.
Parameter
diaktifkan | true untuk mengaktifkan; false untuk menonaktifkan. |
---|
Menampilkan
SecurityException | jika izin akses lokasi tidak diberikan. |
---|
public void setOnCameraChangeListener (GoogleMap.OnCameraChangeListener)
Metode ini tidak digunakan lagi.
Diganti dengan setOnCameraMoveStartedListener(GoogleMap.OnCameraMoveStartedListener)
, setOnCameraMoveListener(GoogleMap.OnCameraMoveListener)
, setOnCameraMoveCanceledListener(GoogleMap.OnCameraMoveCanceledListener)
, dan setOnCameraIdleListener(GoogleMap.OnCameraIdleListener)
.
Menetapkan callback yang dipanggil saat kamera berubah.
Parameter
pemroses | Callback yang dipanggil saat kamera berubah. Untuk membatalkan penetapan callback, gunakan
null . |
---|
public void setOnCameraIdleListener (GoogleMap.OnCameraIdleListener)
Menetapkan callback yang dipanggil saat gerakan kamera berakhir.
Parameter
pemroses | Callback yang dipanggil. Untuk membatalkan penetapan callback, gunakan null .
|
---|
public void setOnCameraMoveCanceledListener (GoogleMap.OnCameraMoveCanceledListener)
Menetapkan callback yang dipanggil saat gerakan kamera dihentikan atau diganggu oleh jenis animasi baru.
Parameter
pemroses | Callback yang dipanggil. Untuk membatalkan penetapan callback, gunakan null . Jangan
mengupdate atau menganimasikan kamera dari dalam onCameraMoveCanceled() .
|
---|
public void setOnCameraMoveListener (GoogleMap.OnCameraMoveListener)
Menetapkan callback yang dipanggil berulang kali saat kamera sedang bergerak. Callback dapat dipanggil sesering mungkin setiap frame dan tidak boleh melakukan operasi yang mahal.
Parameter
pemroses | Callback yang dipanggil. Untuk membatalkan penetapan callback, gunakan null .
|
---|
public void setOnCameraMoveStartedListener (GoogleMap.OnCameraMoveStartedListener)
Menetapkan callback yang dipanggil saat kamera mulai bergerak atau alasan gerakan kamera telah berubah.
Parameter
pemroses | Callback yang dipanggil. Untuk membatalkan penetapan callback, gunakan null . Jangan
mengupdate atau menganimasikan kamera dari dalam onCameraMoveStarted() .
|
---|
public void setOnCircleClickListener (GoogleMap.OnCircleClickListener)
Menetapkan callback yang dipanggil saat lingkaran diklik.
Parameter
pemroses | Callback yang dipanggil saat lingkaran diklik. Untuk membatalkan penetapan callback,
gunakan null .
|
---|
public void setOnGroundOverlayClickListener (GoogleMap.OnGroundOverlayClickListener)
Menetapkan callback yang dipanggil saat overlay bumi diklik.
Parameter
pemroses | Callback yang dipanggil saat overlay bumi diklik. Untuk membatalkan penetapan callback, gunakan null .
|
---|
public void setOnIndoorStateChangeListener (GoogleMap.OnIndoorStateChangeListener)
Menetapkan atau menghapus pemroses untuk peristiwa dalam ruangan. Hanya satu pemroses yang dapat ditetapkan. Menetapkan pemroses baru akan menghapus pemroses sebelumnya.
Parameter
pemroses | pemroses untuk peristiwa dalam ruangan jika non-null; jika tidak, menghapus pemroses |
---|
public void setOnInfoWindowClickListener (GoogleMap.OnInfoWindowClickListener)
Menetapkan callback yang dipanggil saat jendela info penanda diklik.
Parameter
pemroses | Callback yang dipanggil saat jendela info penanda diklik. Untuk membatalkan penetapan callback, gunakan null .
|
---|
public void setOnInfoWindowCloseListener (GoogleMap.OnInfoWindowCloseListener)
Menetapkan callback yang dipanggil saat jendela info penanda ditutup.
Parameter
pemroses | Callback yang dipanggil saat jendela info penanda ditutup. Untuk membatalkan penetapan callback, gunakan null .
|
---|
public void setOnInfoWindowLongClickListener (GoogleMap.OnInfoWindowLongClickListener)
Menetapkan callback yang dipanggil saat jendela info penanda ditekan lama.
Parameter
pemroses | Callback yang dipanggil saat jendela info penanda ditekan lama. Untuk
membatalkan penetapan callback, gunakan null .
|
---|
public void setOnMapClickListener (GoogleMap.OnMapClickListener)
Menetapkan callback yang dipanggil saat peta diketuk.
Parameter
pemroses | Callback yang dipanggil saat peta diketuk. Untuk membatalkan penetapan callback, gunakan
null .
|
---|
public void setOnMapLoadedCallback (GoogleMap.OnMapLoadedCallback)
Menetapkan callback yang dipanggil saat peta ini selesai dirender. Callback hanya akan dipanggil satu kali.
Jika metode ini dipanggil saat peta dirender sepenuhnya, callback akan segera dipanggil. Peristiwa ini tidak akan aktif jika peta tidak pernah dimuat karena masalah konektivitas, atau jika peta terus berubah dan tidak pernah selesai memuat karena pengguna terus berinteraksi dengan peta.
Parameter
callback | Callback dipanggil saat peta selesai dirender. Untuk membatalkan penetapan callback, gunakan null .
|
---|
public void setOnMapLongClickListener (GoogleMap.OnMapLongClickListener)
Menetapkan callback yang dipanggil saat peta ditekan lama.
Parameter
pemroses | Callback yang dipanggil saat peta ditekan lama. Untuk membatalkan penetapan callback, gunakan null .
|
---|
public void setOnMarkerClickListener (GoogleMap.OnMarkerClickListener)
Menetapkan callback yang dipanggil saat penanda diklik.
Parameter
pemroses | Callback yang dipanggil saat penanda diklik. Untuk membatalkan penetapan callback,
gunakan null .
|
---|
public void setOnMarkerDragListener (GoogleMap.OnMarkerDragListener)
Menetapkan callback yang dipanggil saat penanda ditarik.
Parameter
pemroses | Callback yang dipanggil pada peristiwa tarik penanda. Untuk membatalkan penetapan callback, gunakan
null .
|
---|
public void setOnMyLocationButtonClickListener (GoogleMap.OnMyLocationButtonClickListener)
Menetapkan callback yang dipanggil saat tombol lokasi saya diklik.
Jika listener
menampilkan true
, peristiwa tersebut akan digunakan dan perilaku default tidak akan terjadi. Jika mengembalikan false
, perilaku default akan terjadi (yaitu Kamera bergerak sedemikian rupa sehingga berpusat pada lokasi pengguna).
Parameter
pemroses | Callback yang dipanggil saat tombol Lokasiku diklik. |
---|
public void setOnMyLocationChangeListener (GoogleMap.OnMyLocationChangeListener)
Metode ini tidak digunakan lagi.
sebagai gantinya, gunakan com.google.android.gms.location.FusedLocationProviderApi.
FusedLocationProviderApi memberikan penemuan lokasi dan penggunaan daya yang lebih baik, serta digunakan oleh titik biru "Lokasiku". Lihat MyLocationDemoActivity dalam folder aplikasi contoh untuk kode contoh, atau Panduan Developer Lokasi.
Menetapkan callback yang dipanggil saat titik Lokasiku mengubah lokasi.
Parameter
pemroses | Callback yang dipanggil saat titik Lokasiku berubah. |
---|
public void setOnMyLocationClickListener (GoogleMap.OnMyLocationClickListener)
Menetapkan callback yang dipanggil saat titik Lokasiku (yang menandakan lokasi pengguna) diklik.
Parameter
pemroses | Callback yang dipanggil saat titik Lokasiku diklik. |
---|
public void setOnPoiClickListener (GoogleMap.OnPoiClickListener)
Menetapkan pemroses yang akan dipicu saat POI diklik atau diketuk.
Teruskan null
untuk menghapus pemroses.
Parameter
pemroses |
---|
public void setOnPolygonClickListener (GoogleMap.OnPolygonClickListener)
Menetapkan callback yang dipanggil saat poligon diklik.
Parameter
pemroses | Callback yang dipanggil saat poligon diklik. Untuk membatalkan penetapan callback,
gunakan null .
|
---|
publik void setOnPolylineClickListener (GoogleMap.OnPolylineClickListener)
Menetapkan callback yang dipanggil saat polyline diklik.
Parameter
pemroses | Callback yang dipanggil saat polyline diklik. Untuk membatalkan penetapan callback,
gunakan null .
|
---|
public void setPadding (int left, int top, int right, int bottom)
Menetapkan padding pada peta.
Metode ini memungkinkan Anda menentukan wilayah yang terlihat pada peta, untuk memberi sinyal pada peta bahwa bagian peta di sekitar tepi mungkin terhalang, dengan menetapkan padding di masing-masing dari keempat tepi peta. Fungsi peta akan disesuaikan dengan padding. Misalnya, kontrol zoom, kompas, pemberitahuan hak cipta, dan logo Google akan dipindahkan agar pas di dalam wilayah yang ditentukan, gerakan kamera akan sesuai dengan pusat wilayah yang terlihat, dll.
Parameter
left | jumlah piksel padding yang akan ditambahkan di sebelah kiri peta. |
---|---|
paruh pertama inning | jumlah piksel padding yang akan ditambahkan di bagian atas peta. |
right | jumlah piksel padding yang akan ditambahkan di sebelah kanan peta. |
paruh kedua inning | jumlah piksel padding yang akan ditambahkan di bagian bawah peta. |
publik void setTrafficEnabled (boolean enabled)
Mengaktifkan atau menonaktifkan lapisan lalu lintas.
Parameter
diaktifkan |
---|
public void snapshot (callback GoogleMap.SnapshotReadyCallback)
Mengambil snapshot peta.
Anda dapat menggunakan snapshot dalam aplikasi saat peta interaktif sulit, atau
tidak mungkin, digunakan. Misalnya, gambar yang dihasilkan dengan metode snapshot()
dapat digunakan untuk menampilkan thumbnail peta di aplikasi Anda, atau snapshot di pusat notifikasi.
Catatan: Gambar peta tidak boleh ditransmisikan ke server Anda, atau digunakan di luar aplikasi. Jika Anda perlu mengirim peta ke aplikasi atau pengguna lain, kirim data yang memungkinkan mereka merekonstruksi peta untuk pengguna baru tersebut, bukan snapshot.
Parameter
callback | Metode callback dipanggil saat snapshot diambil. |
---|
public void snapshot (callback GoogleMap.SnapshotReadyCallback, bitmap Bitmap)
Mengambil snapshot peta.
Metode ini setara dengan snapshot(SnapshotReadyCallback)
, tetapi memungkinkan Anda memberikan
Bitmap
yang telah dialokasikan sebelumnya. Jika bitmap tidak cocok dengan dimensi peta saat ini,
bitmap lain akan dialokasikan yang sesuai dengan dimensi peta.
Meskipun pada sebagian besar kasus, objek yang diteruskan oleh metode callback sama dengan objek yang diberikan dalam parameter ke metode ini, dalam beberapa kasus, objek yang ditampilkan bisa berbeda (misalnya, jika dimensi tampilan telah berubah saat snapshot benar-benar diambil). Dengan demikian, sebaiknya Anda hanya memercayai konten bitmap yang diteruskan oleh metode callback.
Parameter
callback | Metode callback dipanggil saat snapshot diambil. |
---|---|
bitmap | Bitmap yang telah dialokasikan sebelumnya. Jika null , berperilaku seperti snapshot(SnapshotReadyCallback) .
|
public void stopAnimation ()
Menghentikan animasi kamera jika ada animasi yang sedang berlangsung. Saat metode itu dipanggil, kamera langsung berhenti bergerak dan tetap di posisinya.