GoogleMap

class final publik 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 mendapatkannya dari metode getMapAsync() pada MapFragment atau MapView yang telah Anda tambahkan ke aplikasi.

Catatan: Serupa dengan objek View, GoogleMap hanya dapat dibaca dan diubah dari UI thread Android. Pemanggilan 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 melaporkan saat tugas selesai atau dibatalkan. 
antarmuka GoogleMap.InfoWindowAdapter . Menyediakan tampilan untuk rendering kustom dari jendela info. 
antarmuka GoogleMap.OnCameraChangeListener Antarmuka ini tidak digunakan lagi. Diganti dengan GoogleMap.OnCameraMoveStartedListener, GoogleMap.OnCameraMoveListener, dan GoogleMap.OnCameraIdleListener. Urutan pemanggilan metode onCameraChange yang sudah tidak digunakan lagi sehubungan dengan metode dalam pemroses perubahan kamera baru tidak ditentukan.  
antarmuka GoogleMap.OnCameraIdleListener Antarmuka callback saat gerakan kamera berakhir. 
antarmuka GoogleMap.OnCameraMoveCancelledListener Antarmuka callback saat gerakan kamera dihentikan atau saat kamera mulai bergerak karena alasan baru. 
antarmuka GoogleMap.OnCameraMoveListener Antarmuka callback saat kamera berubah 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 status dalam ruangan berubah. 
antarmuka GoogleMap.OnInfoWindowClickListener Antarmuka callback untuk peristiwa klik/ketuk pada jendela info penanda. 
antarmuka GoogleMap.OnInfoWindowCloseListener Antarmuka callback untuk peristiwa penutupan 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 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. Gunakan com.google.android.gms.location.FusedLocationProviderApi sebagai gantinya. FusedLocationProviderApi menyediakan penemuan lokasi yang ditingkatkan serta penggunaan daya dan digunakan oleh "My Location" titik biru. Lihat tutorial Pilih Current Place, 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 kapan snapshot telah diambil. 

Ringkasan Konstanta

int MAP_TYPE_HYBRID Peta satelit dengan lapisan jalan utama yang transparan.
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(pembaruan CameraUpdate)
Menganimasikan gerakan kamera dari posisi saat ini ke posisi yang ditentukan dalam pembaruan.
void
animateCamera(Pembaruan CameraUpdate, callback GoogleMap.CancelableCallback)
Menganimasikan gerakan kamera dari posisi saat ini ke posisi yang ditentukan dalam update dan memanggil callback opsional setelah selesai.
void
animateCamera(pembaruan CameraUpdate, int durasiMs, callback GoogleMap.CancelableCallback)
Memindahkan 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.
Gedung Dalam Ruangan
getFocusedBuilding()
Mendapatkan bangunan yang saat ini difokuskan.
int
getTextView()
Mendapatkan jenis peta yang saat ini ditampilkan.
float
getMaxZoomLevel()
Menampilkan tingkat zoom maksimum untuk posisi kamera saat ini.
float
getMinZoomLevel()
Menampilkan tingkat zoom minimum.
Location
getMyLocation()
Metode ini tidak digunakan lagi. sebagai gantinya, gunakan com.google.android.gms.location.FusedLocationProviderApi. FusedLocationProviderApi menyediakan penemuan lokasi yang ditingkatkan serta penggunaan daya dan digunakan oleh "My Location" titik biru. Lihat MyLocationDemoActivity dalam folder aplikasi contoh untuk kode contoh, atau Panduan Developer Lokasi.
Proyeksi
getProyeksi()
Menampilkan objek Projection yang dapat Anda gunakan untuk melakukan konversi 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 lokasiku.
boolean
isTrafficEnabled()
Memeriksa apakah peta menggambar data lalu lintas.
void
moveCamera(update CameraUpdate)
Ubah 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)
Menetapkan 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 lokasiku.
boolean
setMapStyle(gaya MapStyleOptions)
Menetapkan gaya visual peta dasar.
void
set∧(int type)
Menetapkan jenis ubin peta yang harus ditampilkan.
void
setMaxZoomPreference(float maxZoomPreference)
Menetapkan batas atas pilihan untuk zoom kamera.
void
setMinZoomPreference(float minZoomPreference)
Menetapkan batas bawah pilihan untuk zoom kamera.
void
setMyLocationEnabled(boolean diaktifkan)
Mengaktifkan atau menonaktifkan lapisan lokasiku.
void
void
setOnCameraIdleListener(pemroses GoogleMap.OnCameraIdleListener)
Menetapkan callback yang dipanggil saat gerakan kamera berakhir.
void
setOnCameraMoveCancelledListener(pemroses GoogleMap.OnCameraMoveCancelledListener)
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 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 telah 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. sebagai gantinya, gunakan com.google.android.gms.location.FusedLocationProviderApi. FusedLocationProviderApi menyediakan penemuan lokasi yang ditingkatkan serta penggunaan daya dan digunakan oleh "My Location" titik biru. Lihat MyLocationDemoActivity dalam 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 jalan utama yang transparan.

Nilai Konstanta: 4

public static final int MAP_TYPE_NONE

Tidak ada ubin peta dasar.

Nilai Konstanta: 0

publik statis 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 (LingkaranOpsi)

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 (Opsi 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 posisinya tidak ditentukan dalam opsi.

publik Marker addMarker (MarkerOptions opsi)

Menambahkan penanda ke peta ini.

Ikon penanda dirender pada peta di lokasi Penanda. Mengklik penanda akan menempatkan kamera pada penanda. Jika Marker.title ditentukan, peta akan menampilkan kotak info dengan judul dan cuplikan penanda. Jika penanda dapat ditarik, klik lama lalu tarik penanda untuk memindahkannya.

Parameter
opsi Objek opsi penanda yang menentukan cara merender penanda.
Hasil
  • Marker yang ditambahkan ke peta.

publik Poligon addPolygon (PolygonOptions opsi)

Menambahkan poligon ke peta ini.

Parameter
opsi Objek opsi poligon yang menentukan cara merender Poligon.
Hasil
  • Objek Polygon yang ditambahkan ke peta.

publik Polyline addPolyline (Opsi Polyline)

Menambahkan polyline ke peta ini.

Parameter
opsi Objek opsi polyline yang menentukan cara merender Polyline.
Hasil
  • Objek Polyline yang ditambahkan ke peta.

publik TileOverlay addTileOverlay (OverlayOverlay opsi)

Menambahkan overlay ubin ke peta ini. Lihat TileOverlay untuk mengetahui informasi selengkapnya.

Perhatikan bahwa tidak seperti overlay lainnya, 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 pembaruan. Selama animasi, panggilan ke getCameraPosition() akan menampilkan lokasi perantara kamera.

Lihat CameraUpdateFactory untuk serangkaian update.

Parameter
update Perubahan yang harus diterapkan ke kamera.

publik void animateCamera (update CameraUpdate, callback GoogleMap.CancelableCallback)

Menganimasikan gerakan kamera dari posisi saat ini ke posisi yang ditentukan dalam update dan memanggil callback opsional setelah selesai. Lihat CameraUpdateFactory untuk sekumpulan update.

Selama animasi, panggilan ke getCameraPosition() akan menampilkan lokasi perantara kamera.

Parameter
update 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().

publik void animateCamera (update CameraUpdate, int durasiMs, callback GoogleMap.CancelableCallback)

Memindahkan peta sesuai dengan pembaruan dengan animasi selama durasi yang ditentukan, dan memanggil callback opsional setelah selesai. Lihat CameraUpdateFactory untuk serangkaian update.

Jika getCameraPosition() dipanggil selama animasi, tindakan tersebut akan menampilkan lokasi kamera saat ini yang sedang berlangsung.

Parameter
update
durasiM Durasi animasi dalam milidetik. Nilai ini harus sangat positif. Jika tidak, IllegalArgumentException akan ditampilkan.
callback Callback opsional yang akan diberi tahu dari UI thread Android saat animasi berhenti. Jika animasi berhenti karena penyelesaiannya yang alami, callback akan diberi tahu dengan onFinish(). Jika animasi berhenti karena gangguan akibat gerakan kamera berikutnya atau gestur pengguna, onCancel() akan dipanggil. Callback tidak boleh mencoba memindahkan atau menganimasikan kamera dalam metode pembatalannya. Jika callback tidak diperlukan, biarkan sebagai null.

publik void clear ()

Menghapus semua penanda, polyline, poligon, overlay, dll dari peta.

publik 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 mengetahui informasi selengkapnya tentang cara mengubah posisi kamera, lihat Kamera dan Tampilan.

Hasil
  • Posisi Kamera saat ini.

publik IndoorBuilding getFocusedBuilding ()

Mendapatkan bangunan yang saat ini difokuskan.

Hasil
  • Bangunan yang difokuskan saat ini atau null jika tidak ada bangunan yang difokuskan.

int publik getõ ()

Mendapatkan jenis peta yang saat ini ditampilkan. Lihat MAP_TYPE_NORMAL, MAP_TYPE_SATELLITE, MAP_TYPE_TERRAIN untuk mengetahui kemungkinan nilai.

Hasil
  • Jenis peta.

float publik getMaxZoomLevel ()

Menampilkan tingkat zoom maksimum untuk posisi kamera saat ini. Ini memperhitungkan jenis peta yang digunakan saat ini, misalnya, satelit atau medan mungkin memiliki tingkat zoom maksimal yang lebih rendah dari ubin peta dasar.

Untuk mengetahui informasi selengkapnya tentang cara mengubah tingkat zoom kamera, lihat Kamera dan Tampilan.

Hasil
  • Tingkat zoom maksimum yang tersedia di posisi kamera saat ini.

float publik getMinZoomLevel ()

Menampilkan tingkat zoom minimum. 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.
menggunakan com.google.android.gms.location.FusedLocationProviderApi sebagai gantinya. FusedLocationProviderApi menyediakan penemuan lokasi yang ditingkatkan serta penggunaan daya dan digunakan oleh "My Location" titik biru. 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 lokasi-saya tidak diaktifkan.

publik Proyeksi getProyeksi ()

Menampilkan objek Projection yang dapat Anda gunakan untuk melakukan konversi antara koordinat layar dan koordinat lintang/bujur.

Projection yang ditampilkan adalah snapshot dari proyeksi saat ini, dan tidak akan otomatis diperbarui saat kamera bergerak. Karena operasi ini mahal, Anda hanya boleh mendapatkan proyeksi satu kali 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 lokasiku.

Hasil
  • true jika lapisan lokasiku 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 sebaliknya.

publik void moveCamera (update CameraUpdate)

Ubah posisi kamera sesuai dengan petunjuk yang ditentukan dalam update. Pemindahan akan dilakukan seketika, dan getCameraPosition() berikutnya akan mencerminkan posisi yang baru. Lihat CameraUpdateFactory untuk serangkaian update.

Parameter
update Perubahan yang harus diterapkan ke kamera.

publik void resetMinMaxZoomPreference ()

Menghapus batas zoom atas dan bawah yang ditentukan sebelumnya.

publik void setBuildingsEnabled (boolean diaktifkan)

Mengaktifkan atau menonaktifkan lapisan bangunan 3D.

Parameter
diaktifkan true untuk mengaktifkan lapisan bangunan 3D; false untuk menonaktifkan bangunan 3D.

publik void setContentDescription (Deskripsi string)

Menetapkan contentDescription untuk peta.

Ini digunakan untuk memberikan deskripsi lisan ke peta dalam mode aksesibilitas. Nilai default adalah "Google Maps"

Parameter
deskripsi string yang akan digunakan sebagai deskripsi.

boolean publik setIndoorEnabled (boolean diaktifkan)

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 asli. Jika Anda mencoba mengaktifkan peta lantai saat diaktifkan di peta lain, tidak akan ada yang terjadi dan tindakan ini akan menampilkan false. Jika Indoor tidak diaktifkan untuk peta, semua metode yang terkait dengan indoor akan menampilkan null, atau false.

Parameter
diaktifkan true untuk mencoba mengaktifkan peta lantai; false untuk menonaktifkan peta lantai.
Hasil
  • apakah mungkin untuk mengaktifkan peta lantai.

publik void setInfoWindowAdapter (adaptor GoogleMap.InfoWindowAdapter)

Menetapkan perender kustom untuk konten jendela info.

Seperti pemroses peristiwa pada peta, status ini tidak diserialisasi dengan peta. Jika peta dibuat ulang (misalnya karena perubahan konfigurasi), Anda harus memastikan untuk memanggil metode ini lagi agar dapat mempertahankan penyesuaian.

Parameter
adaptor Adaptor yang akan digunakan untuk konten jendela info, atau null untuk menggunakan rendering konten default di jendela info.

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

Setel ke null untuk mengosongkan kotak pembatas sepenuhnya. Batas yang baru akan menggantikan kotak pembatas yang telah ditentukan sebelumnya.

Saat LatLngBounds berubah, SDK menyesuaikan semua pembaruan kamera selanjutnya untuk mematuhi batas tersebut jika memungkinkan. Perhatikan bahwa ada pertimbangan teknis yang dapat mencegah SDK menjaga target kamera secara ketat dalam batas-batas tersebut. Misalnya, error pembulatan presisi floating point atau tingkat zoom yang sangat rendah.

Parameter
batas Batas untuk membatasi target kamera di dalamnya.

publik void setLocationSource (sumber LocationSource)

Mengganti sumber lokasi lapisan lokasiku.

Parameter
source Sumber lokasi untuk digunakan di lapisan lokasiku. Tetapkan ke null untuk menggunakan sumber lokasi default.

boolean publik gaya MapMapStyle (gaya MapStyleOptions)

Menetapkan gaya visual peta dasar.

Dengan opsi gaya, Anda dapat menerapkan gaya khusus pada fitur dan elemen pada peta. Lihat MapStyleOptions untuk mengetahui detail definisi gaya.

Setel ke null untuk menghapus gaya kustom sebelumnya.

Parameter
gaya
Hasil
  • true jika gaya berhasil diurai; false jika masalah terdeteksi dengan MapStyleOptions, termasuk, mis. JSON gaya yang tidak dapat diurai, jenis fitur yang tidak dikenal, jenis elemen yang tidak dikenal, atau kunci styler yang tidak valid. Jika nilai yang ditampilkan adalah false, gaya saat ini tidak diubah.

publik void setServiceLogin (int type)

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

Parameter
jenis Jenis peta yang akan ditampilkan.

publik void setMaxZoomPreference (float maxZoomPreference)

Menetapkan batas atas pilihan untuk zoom kamera.

Saat zoom maksimum berubah, SDK menyesuaikan semua update kamera selanjutnya untuk mematuhi perubahan maksimum tersebut jika memungkinkan. Perhatikan bahwa ada pertimbangan teknis yang dapat mencegah SDK memungkinkan pengguna memperbesar terlalu dalam ke peta. Misalnya, satelit atau medan mungkin memiliki zoom maksimum yang lebih rendah daripada ubin peta dasar.

SDK menyelesaikan konflik apa pun di nilai minimum dan maksimum. Jika Anda menyetel zoom minimum ke tingkat zoom yang lebih tinggi dari tingkat zoom maksimum saat ini, SDK akan menggunakan nilai minimum baru untuk nilai minimum dan maksimum. Jika Anda menyetel zoom maksimum ke tingkat zoom yang lebih rendah dari nilai minimum, SDK akan menggunakan nilai maksimum baru untuk nilai minimum dan maksimum. Misalnya: Asumsikan zoom minimum saat ini adalah 8 dan maksimum adalah 14. Kemudian Anda menyetel zoom maksimum ke 6. SDK menggunakan zoom minimum 6 dan zoom maksimum 6.

Parameter
maxZoomPreference Batas atas pilihan.

publik void setMinZoomPreference (float minZoomPreference)

Menetapkan batas bawah pilihan untuk zoom kamera.

Saat zoom minimum berubah, SDK menyesuaikan semua update kamera selanjutnya untuk mematuhi batas minimum tersebut jika memungkinkan. Perhatikan bahwa ada pertimbangan teknis yang dapat mencegah SDK memungkinkan pengguna melakukan zoom terlalu rendah.

SDK menyelesaikan konflik apa pun di nilai minimum dan maksimum. Jika Anda menyetel zoom minimum ke tingkat zoom yang lebih tinggi dari tingkat zoom maksimum saat ini, SDK akan menggunakan nilai minimum baru untuk nilai minimum dan maksimum. Jika Anda menyetel zoom maksimum ke tingkat zoom yang lebih rendah dari nilai minimum, SDK akan menggunakan nilai maksimum baru untuk nilai minimum dan maksimum. Misalnya: Asumsikan zoom minimum saat ini adalah 8 dan maksimum adalah 14. Kemudian, Anda menetapkan zoom minimum ke 16. SDK menggunakan zoom minimum 16 dan zoom maksimum 16.

Parameter
minZoomPreference Batas bawah yang diinginkan.

publik void setMyLocationEnabled (boolean diaktifkan)

Mengaktifkan atau menonaktifkan lapisan lokasiku.

Saat diaktifkan dan lokasi tersedia, lapisan lokasi saya terus-menerus menggambar indikasi lokasi dan bearing pengguna saat ini, dan menampilkan kontrol UI yang memungkinkan pengguna berinteraksi dengan lokasi mereka (misalnya, untuk mengaktifkan atau menonaktifkan pelacakan kamera dari lokasi dan bearingnya).

Untuk menggunakan fitur lapisan lokasi-saya, Anda perlu meminta izin untuk ACCESS_COARSE_LOCATION atau ACCESS_FINE_LOCATION kecuali 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 masih perlu memastikan bahwa pengguna telah memberikan semua izin yang diperlukan untuk sumber lokasi kustom Anda.

Parameter
diaktifkan true untuk mengaktifkan; false untuk menonaktifkan.
Menampilkan
KeamananException jika izin akses lokasi tidak diberikan.

publik void setOnCameraChangeListener (pemrosesGoogleMap.OnCameraChangeListener)

Metode ini sudah 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 (pemroses GoogleMap.OnCameraIdleListener)

Menetapkan callback yang dipanggil saat gerakan kamera berakhir.

Parameter
pemroses Callback yang dipanggil. Untuk membatalkan penetapan callback, gunakan null.

publik void setOnCameraMoveCancelledListener (pemroses Google.OnCameraMoveCancelledListener)

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 memperbarui atau menganimasikan kamera dari dalam onCameraMoveCanceled().

publik void setOnCameraMoveListener (pemroses Google.OnCameraMoveListener)

Menetapkan callback yang dipanggil berulang kali saat kamera 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.

publik void setOnCameraMoveStartedListener (pemroses Google.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 memperbarui atau menganimasikan kamera dari dalam onCameraMoveStarted().

publik void setOnCircleClickListener (pemroses GoogleMap.OnCircleClickListener)

Menetapkan callback yang dipanggil saat lingkaran diklik.

Parameter
pemroses Callback yang dipanggil saat lingkaran diklik. Untuk membatalkan penetapan callback, gunakan null.

publik void setOnGroundOverlayClickListener (pemroses Google.OnGroundOverlayClickListener)

Menetapkan callback yang dipanggil saat overlay bumi diklik.

Parameter
pemroses Callback yang dipanggil saat overlay bumi diklik. Untuk membatalkan penetapan callback, gunakan null.

publik void setOnIndoorStateChangeListener (pemroses Google.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, akan menghapus pemroses

publik void setOnInfoWindowClickListener (pemroses Google.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.

publik void setOnInfoWindowCloseListener (pemroses Google.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.

publik void setOnInfoWindowLongClickListener (pemroses Google.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.

publik void setOnMapClickListener (pemroses GoogleGoogle.OnMapClickListener)

Menetapkan callback yang dipanggil saat peta diketuk.

Parameter
pemroses Callback yang dipanggil saat peta diketuk. Untuk membatalkan penetapan callback, gunakan null.

publik void setOnMapLoadedCallback (Callback GoogleMap.OnMapLoadedCallback)

Menetapkan callback yang dipanggil saat peta ini telah selesai dirender. Callback hanya akan dipanggil satu kali.

Jika metode ini dipanggil saat peta dirender sepenuhnya, callback akan segera dipanggil. Peristiwa ini tidak akan diaktifkan jika peta tidak pernah dimuat karena masalah konektivitas, atau jika peta terus berubah dan tidak pernah selesai dimuat karena pengguna terus berinteraksi dengan peta.

Parameter
callback Callback yang dipanggil saat peta telah selesai dirender. Untuk membatalkan penetapan callback, gunakan null.

publik void setOnMapLongClickListener (pemroses 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.

publik void setOnMarkerClickListener (pemroses GoogleMap.OnMarkerClickListener)

Menetapkan callback yang dipanggil saat penanda diklik.

Parameter
pemroses Callback yang dipanggil saat penanda diklik. Untuk membatalkan penetapan callback, gunakan null.

publik void setOnMarkerDragListener (pemroses Google.OnMarkerDragListener)

Menetapkan callback yang dipanggil saat penanda ditarik.

Parameter
pemroses Callback yang dipanggil pada peristiwa tarik penanda. Untuk membatalkan penetapan callback, gunakan null.

publik void setOnMyLocationButtonClickListener (pemroses GoogleMap.OnMyLocationButtonClickListener)

Menetapkan callback yang dipanggil saat tombol lokasi saya diklik.

Jika listener menampilkan true, peristiwa akan dipakai dan perilaku default tidak akan terjadi. Jika false ditampilkan, perilaku default akan terjadi (yaitu, kamera akan bergerak sedemikian rupa sehingga berada di tengah lokasi pengguna).

Parameter
pemroses Callback yang dipanggil saat tombol Lokasiku diklik.

publik void setOnMyLocationChangeListener (pemroses Google.OnMyLocationChangeListener)

Metode ini tidak digunakan lagi.
menggunakan com.google.android.gms.location.FusedLocationProviderApi sebagai gantinya. FusedLocationProviderApi menyediakan penemuan lokasi yang ditingkatkan serta penggunaan daya dan digunakan oleh "My Location" titik biru. 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.

publik void setOnMyLocationClickListener (pemroses GoogleGoogle.OnMyLocationClickListener)

Menetapkan callback yang dipanggil saat titik Lokasiku (yang menandakan lokasi pengguna) diklik.

Parameter
pemroses Callback yang dipanggil saat titik Lokasiku diklik.

publik void setOnPoiClickListener (pemroses Google.OnPoiClickListener)

Menetapkan pemroses yang akan dipicu saat POI diklik atau diketuk.

Teruskan null untuk menghapus pemroses.

Parameter
pemroses

publik void setOnPolygonClickListener (pemroses Google.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 (pemroses GoogleGoogle.OnPolylineClickListener)

Menetapkan callback yang dipanggil saat polyline diklik.

Parameter
pemroses Callback yang dipanggil saat polyline diklik. Untuk membatalkan penetapan callback, gunakan null.

publik 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 dapat terhalang, dengan menyetel padding pada masing-masing dari empat tepi peta. Fungsi peta akan disesuaikan dengan padding. Misalnya, kontrol zoom, kompas, pemberitahuan hak cipta, dan logo Google akan dipindahkan agar sesuai dengan wilayah yang ditentukan, gerakan kamera akan relatif ke bagian tengah wilayah yang terlihat, dll.

Parameter
left jumlah piksel padding yang akan ditambahkan di sebelah kiri peta.
paruh pertama babak jumlah piksel padding yang akan ditambahkan di bagian atas peta.
right jumlah piksel padding yang akan ditambahkan di sebelah kanan peta.
paruh kedua babak jumlah piksel padding yang akan ditambahkan di bagian bawah peta.

publik void setTrafficEnabled (boolean diaktifkan)

Mengaktifkan atau menonaktifkan lapisan lalu lintas.

Parameter
diaktifkan

public void snapshot (callback GoogleGoogle.SnapshotReadyCallback)

Mengambil snapshot peta.

Anda dapat menggunakan snapshot dalam aplikasi saat peta interaktif akan 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 dikirim 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, bukan snapshot.

Parameter
callback Metode callback dipanggil saat snapshot diambil.

public void snapshot (callback GoogleGoogle.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 dalam sebagian besar kasus, objek yang diteruskan oleh metode callback sama dengan yang diberikan dalam parameter ke metode ini, dalam beberapa kasus objek yang ditampilkan dapat berbeda (mis., jika dimensi tampilan telah berubah pada saat snapshot benar-benar diambil). Dengan demikian, Anda hanya perlu memercayai konten bitmap yang diteruskan dengan metode callback.

Parameter
callback Metode callback dipanggil saat snapshot diambil.
bitmap Bitmap yang telah ditetapkan sebelumnya. Jika null, berperilaku seperti snapshot(SnapshotReadyCallback).

publik void stopAnimation ()

Menghentikan animasi kamera jika ada animasi yang sedang berlangsung. Saat metode tersebut dipanggil, kamera akan segera berhenti bergerak dan tetap berada di posisi tersebut.