GoogleMap

public final class GoogleMap memperluas Object

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
addCircle(opsi CircleOptions)
Tambahkan lingkaran ke peta ini.
GroundOverlay
addGroundOverlay(opsi GroundOverlayOptions)
Menambahkan gambar ke peta ini.
Marker
addMarker(opsi MarkerOptions)
Menambahkan penanda ke peta ini.
Polygon
addPolygon(opsi PolygonOptions)
Menambahkan poligon ke peta ini.
Polyline
addPolyline(opsi PolylineOptions)
Menambahkan polyline ke peta ini.
TileOverlay
addTileOverlay(opsi TileOverlayOptions)
Menambahkan overlay ubin ke peta ini.
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
setLocationSource(sumber LocationSource)
Mengganti sumber lokasi lapisan my-location.
boolean
setMapStyle(gaya MapStyleOptions)
Menetapkan gaya visual peta dasar.
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
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
snapshot(callback GoogleMap.SnapshotReadyCallback)
Mengambil snapshot peta.
void
snapshot(callback GoogleMap.SnapshotReadyCallback, bitmap Bitmap)
Mengambil snapshot peta.
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.

Nilai Konstanta: 4

public static final int MAP_TYPE_NONE

Tidak ada ubin peta dasar.

Nilai Konstanta: 0

public static final int MAP_TYPE_NORMAL

Peta dasar.

Nilai Konstanta: 1

public static final int MAP_TYPE_SATELLITE

Peta satelit tanpa label.

Nilai Konstanta: 2

public static final int MAP_TYPE_TERRAIN

Peta medan.

Nilai Konstanta: 3

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

publik UiSettings getUiSettings ()

Mendapatkan setelan antarmuka pengguna untuk peta.

Hasil

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 pada MapStyleOptions, 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 adalah false, gaya saat ini tidak akan berubah.

public void setMapType (int type)

Menetapkan jenis ubin peta yang harus ditampilkan. Nilai yang diperbolehkan adalah:

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.