Places Widgets

Class Autocomplete

Class google.maps.places.Autocomplete

Widget yang memberikan prediksi Tempat berdasarkan input teks pengguna. Fungsi ini melampirkan elemen input dari jenis text, dan memproses entri teks dalam kolom tersebut. Daftar prediksi ditampilkan sebagai menu drop-down, dan diperbarui saat teks dimasukkan.

Class ini memperluas MVCObject.

Muat menggunakan parameter URL &libraries=places. Lihat Library di Maps JavaScript API.

Saat menggunakan v=beta, dapat diakses dengan memanggil const {Autocomplete} = await google.map.importLibrary("places"). Lihat Library di Maps JavaScript API.
Autocomplete
Autocomplete(inputField[, opts])
Parameter:
Membuat instance Autocomplete baru yang dilampirkan ke kolom teks input yang ditentukan dengan opsi yang diberikan.
getBounds
getBounds()
Parameter: Tidak ada
Nilai Hasil: LatLngBounds|undefined Batas bias.
Menampilkan batas yang biasnya bias.
getFields
getFields()
Parameter: Tidak ada
Nilai Hasil: Array<string>|undefined
Menampilkan kolom yang akan disertakan untuk Tempat dalam respons detail saat detail berhasil diambil. Untuk daftar kolom, lihat PlaceResult.
getPlace
getPlace()
Parameter: Tidak ada
Nilai Hasil: PlaceResult Tempat yang dipilih oleh pengguna.
Menampilkan detail Tempat yang dipilih oleh pengguna jika detail berhasil diambil. Jika tidak, akan menampilkan objek Place stub, dengan properti name ditetapkan ke nilai kolom input saat ini.
setBounds
setBounds(bounds)
Parameter:
Nilai Hasil: Tidak Ada
Menetapkan area pilihan untuk menampilkan hasil Place. Hasilnya dibiaskan terhadap, namun tidak terbatas pada, area ini.
setComponentRestrictions
setComponentRestrictions(restrictions)
Parameter:
Nilai Hasil: Tidak Ada
Menetapkan batasan komponen. Pembatasan komponen digunakan untuk membatasi prediksi hanya pada prediksi di dalam komponen induk. Misalnya, negara.
setFields
setFields(fields)
Parameter:
  • fields: Array<string> optional
Nilai Hasil: Tidak Ada
Menetapkan kolom yang akan disertakan untuk Tempat dalam respons detail saat detail berhasil diambil. Untuk daftar kolom, lihat PlaceResult.
setOptions
setOptions(options)
Parameter:
Nilai Hasil: Tidak Ada
setTypes
setTypes(types)
Parameter:
  • types:  Array<string> optional Jenis prediksi yang akan disertakan.
Nilai Hasil: Tidak Ada
Menetapkan jenis prediksi yang akan ditampilkan. Untuk jenis yang didukung, lihat panduan developer. Jika tidak ada jenis yang ditentukan, semua jenis akan dikembalikan.
Diwariskan: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
place_changed
function()
Argumen: Tidak ada
Peristiwa ini dipicu saat PlaceResult tersedia untuk Tempat yang dipilih pengguna.
Jika pengguna memasukkan nama Tempat yang tidak disarankan oleh kontrol dan menekan tombol Enter, atau jika permintaan Place Details gagal, PlaceResult akan berisi input pengguna di properti name, tanpa properti lain yang ditentukan.

Antarmuka AutocompleteOptions

Antarmuka google.maps.places.AutocompleteOptions

Opsi yang dapat ditetapkan pada objek Autocomplete.

Muat menggunakan parameter URL &libraries=places. Lihat Library di Maps JavaScript API.
bounds optional
Area untuk menelusuri tempat.
componentRestrictions optional
Jenis: ComponentRestrictions optional
Pembatasan komponen. Pembatasan komponen digunakan untuk membatasi prediksi hanya pada prediksi di dalam komponen induk. Misalnya, negara.
fields optional
Jenis: Array<string> optional
Kolom yang akan disertakan untuk Tempat dalam respons detail saat detail berhasil diambil, yang akan ditagih. Jika ['ALL'] diteruskan, semua kolom yang tersedia akan dikembalikan dan ditagihkan (ini tidak direkomendasikan untuk deployment produksi). Untuk daftar kolom, lihat PlaceResult. Kolom bertingkat dapat ditentukan dengan jalur titik (misalnya, "geometry.location"). Nilai default-nya adalah ['ALL'].
placeIdOnly optional
Jenis: boolean optional
Apakah hanya akan mengambil ID Tempat. PlaceResult yang disediakan saat peristiwa place_changed diaktifkan hanya akan memiliki kolom place_id, type, dan name, dengan place_id, jenis, dan deskripsi yang ditampilkan oleh layanan Autocomplete. Dinonaktifkan secara default.
strictBounds optional
Jenis: boolean optional
Nilai boolean, yang menunjukkan bahwa widget Autocomplete hanya boleh mengembalikan tempat yang berada dalam batas-batas widget Autocomplete pada saat kueri dikirim. Menetapkan strictBounds ke false (yang merupakan default) akan membuat hasil dibiaskan terhadap, tetapi tidak terbatas pada, tempat yang berada dalam batas.
types optional
Jenis: Array<string> optional
Jenis prediksi yang akan ditampilkan. Untuk jenis yang didukung, lihat panduan developer. Jika tidak ada jenis yang ditentukan, semua jenis akan dikembalikan.

Class google.maps.places.SearchBox

Widget yang memberikan prediksi kueri berdasarkan input teks pengguna. Fungsi ini melampirkan elemen input dari jenis text, dan memproses entri teks dalam kolom tersebut. Daftar prediksi ditampilkan sebagai menu drop-down, dan diperbarui saat teks dimasukkan.

Class ini memperluas MVCObject.

Muat menggunakan parameter URL &libraries=places. Lihat Library di Maps JavaScript API.

Saat menggunakan v=beta, dapat diakses dengan memanggil const {SearchBox} = await google.map.importLibrary("places"). Lihat Library di Maps JavaScript API.
SearchBox
SearchBox(inputField[, opts])
Parameter:
Membuat instance SearchBox baru yang dilampirkan ke kolom teks input yang ditentukan dengan opsi yang diberikan.
getBounds
getBounds()
Parameter: Tidak ada
Nilai Hasil: LatLngBounds|undefined
Menampilkan batas yang membuat bias prediksi kueri menjadi bias.
getPlaces
getPlaces()
Parameter: Tidak ada
Nilai Hasil: Array<PlaceResult>|undefined
Menampilkan kueri yang dipilih oleh pengguna untuk digunakan dengan peristiwa places_changed.
setBounds
setBounds(bounds)
Parameter:
Nilai Hasil: Tidak Ada
Menetapkan wilayah yang akan digunakan untuk memprediksi prediksi kueri. Hasil hanya akan dibiaskan terhadap area ini dan tidak dibatasi sepenuhnya.
Diwariskan: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
places_changed
function()
Argumen: Tidak ada
Peristiwa ini dipicu saat pengguna memilih kueri, getPlaces harus digunakan untuk mendapatkan tempat baru.

Antarmuka SearchBoxOptions

Antarmuka google.maps.places.SearchBoxOptions

Opsi yang dapat ditetapkan pada objek SearchBox.

Muat menggunakan parameter URL &libraries=places. Lihat Library di Maps JavaScript API.
bounds optional
Area tujuan untuk membiaskan prediksi kueri. Prediksi bersifat bias terhadap, tetapi tidak terbatas pada, kueri yang menargetkan batas ini.