Class PlaceAutocompleteElement
Class
google.maps.places.PlaceAutocompleteElement
- PlaceAutocompleteElement adalah subclass
HTMLElement
yang menyediakan komponen UI untuk Places Autocomplete API. Setelah memuat libraryplaces
, input dengan fungsi pelengkapan otomatis dapat dibuat di HTML. Contoh:<gmp-placeautocomplete ></gmp-placeautocomplete>
Elemen kustom:
<gmp-placeautocomplete></gmp-placeautocomplete>
Class ini memperluas
HTMLElement
.
Class ini mengimplementasikan
PlaceAutocompleteElementOptions
.
Akses dengan memanggil const {PlaceAutocompleteElement} = await google.maps.importLibrary("places")
. Lihat Library di Maps JavaScript API.
Konstruktor | |
---|---|
PlaceAutocompleteElement |
PlaceAutocompleteElement(options) Parameter:
|
Properti | |
---|---|
inputElement |
Jenis:
HTMLInputElement Elemen input yang pelengkapan otomatisnya akan ditampilkan. |
Diwariskan:
componentRestrictions ,
locationBias ,
locationRestriction ,
requestedLanguage ,
requestedRegion ,
types
|
Metode | |
---|---|
addEventListener |
addEventListener(type, listener[, options]) Parameter:
Nilai Hasil:
void Menyiapkan fungsi yang akan dipanggil setiap kali peristiwa yang ditentukan dikirim ke target. Lihat addEventListener |
removeEventListener |
removeEventListener(type, listener[, options]) Parameter:
Nilai Hasil:
void Menghapus pemroses peristiwa yang sebelumnya terdaftar dengan addEventListener dari target. Lihat removeEventListener |
Antarmuka PlaceAutocompleteElementOptions
Antarmuka
google.maps.places.PlaceAutocompleteElementOptions
Opsi untuk membuat PlaceAutocompleteElement.
Properti | |
---|---|
inputElement |
Jenis:
HTMLInputElement Elemen input yang pelengkapan otomatisnya akan ditampilkan. |
componentRestrictions optional |
Jenis:
ComponentRestrictions optional Batasan komponen. Batasan komponen digunakan untuk membatasi prediksi hanya untuk prediksi yang ada dalam komponen induk. Misalnya, negara. |
locationBias optional |
Jenis:
LocationBias optional Batas halus atau petunjuk yang dapat digunakan saat menelusuri tempat. |
locationRestriction optional |
Jenis:
LocationRestriction optional Batas untuk membatasi hasil penelusuran. |
requestedLanguage optional |
Jenis:
string optional ID bahasa untuk bahasa tempat hasil akan ditampilkan, jika memungkinkan. Hasil dalam bahasa yang dipilih mungkin diberikan peringkat yang lebih tinggi, tetapi saran tidak dibatasi pada bahasa ini. Lihat daftar bahasa yang didukung. |
requestedRegion optional |
Jenis:
string optional Kode wilayah yang digunakan untuk pemformatan hasil dan pemfilteran hasil. Hal ini tidak membatasi saran untuk negara ini. Kode wilayah menerima nilai yang berisi dua karakter ccTLD ("top-level domain"). Umumnya kode ccTLD identik dengan kode ISO 3166-1, dengan beberapa pengecualian. Misalnya, ccTLD Inggris Raya adalah "uk" ( .co.uk ) sedangkan kode ISO 3166-1-nya adalah "gb" (secara teknis untuk entitas "Inggris Raya dan Irlandia Utara"). |
types optional |
Jenis:
Array<string> optional Jenis prediksi yang akan ditampilkan. Untuk mengetahui jenis yang didukung, lihat panduan developer. Jika tidak ada jenis yang ditentukan, semua jenis akan ditampilkan. |
Class PlaceAutocompletePlaceSelectEvent
Class
google.maps.places.PlaceAutocompletePlaceSelectEvent
Peristiwa ini dibuat setelah pengguna memilih tempat dengan Elemen Place Autocomplete. Akses pilihan dengan event.place
.
Class ini memperluas
Event
.
Akses dengan memanggil const {PlaceAutocompletePlaceSelectEvent} = await google.maps.importLibrary("places")
. Lihat Library di Maps JavaScript API.
Class PlaceAutocompleteRequestErrorEvent
Class
google.maps.places.PlaceAutocompleteRequestErrorEvent
Peristiwa ini dikeluarkan oleh PlaceAutocompleteElement saat ada masalah dengan permintaan jaringan.
Class ini memperluas
Event
.
Akses dengan memanggil const {PlaceAutocompleteRequestErrorEvent} = await google.maps.importLibrary("places")
. Lihat Library di Maps JavaScript API.
Class Autocomplete
Class
google.maps.places.Autocomplete
Widget yang memberikan prediksi Tempat berdasarkan input teks pengguna. Fungsi ini melekat pada elemen input jenis text
, dan memproses entri teks di kolom tersebut. Daftar prediksi ditampilkan sebagai menu drop-down, dan diperbarui saat teks dimasukkan.
Class ini memperluas
MVCObject
.
Akses dengan memanggil const {Autocomplete} = await google.maps.importLibrary("places")
. Lihat Library di Maps JavaScript API.
Konstruktor | |
---|---|
Autocomplete |
Autocomplete(inputField[, opts]) Parameter:
Membuat instance Autocomplete baru yang dilampirkan ke kolom teks input yang ditentukan dengan opsi yang diberikan. |
Metode | |
---|---|
getBounds |
getBounds() Parameter: Tidak ada
Nilai Hasil:
LatLngBounds|undefined Batas pembiasan.Menampilkan batas prediksi dibiaskan. |
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 mengetahui 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, tampilkan objek Place stub, dengan properti name yang disetel ke nilai kolom input saat ini. |
setBounds |
setBounds(bounds) Parameter:
Nilai Hasil: Tidak ada
Menetapkan area pilihan untuk menampilkan hasil Tempat. Hasil dibiaskan terhadap, tetapi tidak terbatas pada, area ini. |
setComponentRestrictions |
setComponentRestrictions(restrictions) Parameter:
Nilai Hasil: Tidak ada
Menetapkan batasan komponen. Batasan komponen digunakan untuk membatasi prediksi hanya untuk prediksi yang ada dalam komponen induk. Misalnya, negara. |
setFields |
setFields(fields) Parameter:
Nilai Hasil: Tidak ada
Menetapkan kolom yang akan disertakan untuk Place dalam respons detail saat detail berhasil diambil. Untuk mengetahui daftar kolom, lihat PlaceResult . |
setOptions |
setOptions(options) Parameter:
Nilai Hasil: Tidak ada
|
setTypes |
setTypes(types) Parameter:
Nilai Hasil: Tidak ada
Menetapkan jenis prediksi yang akan ditampilkan. Untuk mengetahui jenis yang didukung, lihat panduan developer. Jika tidak ada jenis yang ditentukan, semua jenis akan ditampilkan. |
Diwariskan:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Acara | |
---|---|
place_changed |
function() Argumen: Tidak ada
Peristiwa ini diaktifkan 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 menentukan properti lain. |
Antarmuka AutocompleteOptions
Antarmuka
google.maps.places.AutocompleteOptions
Opsi yang dapat ditetapkan pada objek Autocomplete
.
Properti | |
---|---|
bounds optional |
Jenis:
LatLngBounds|LatLngBoundsLiteral optional Area untuk menelusuri tempat. |
componentRestrictions optional |
Jenis:
ComponentRestrictions optional Batasan komponen. Batasan komponen digunakan untuk membatasi prediksi hanya untuk prediksi yang ada dalam komponen induk. Misalnya, negara. |
fields optional |
Jenis:
Array<string> optional Kolom yang akan disertakan untuk Place dalam respons detail saat detail berhasil diambil, yang akan dikenai biaya. Jika ['ALL'] diteruskan, semua kolom yang tersedia akan ditampilkan dan ditagih (hal ini tidak direkomendasikan untuk deployment produksi). Untuk mengetahui daftar kolom, lihat PlaceResult . Kolom bertingkat dapat ditentukan dengan jalur titik (misalnya, "geometry.location" ). Nilai defaultnya adalah ['ALL'] . |
|
Jenis:
boolean optional Apakah hanya akan mengambil ID Tempat. PlaceResult yang tersedia saat peristiwa place_Changes diaktifkan hanya akan memiliki kolom place_id, jenis, dan nama, 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 menampilkan tempat yang berada dalam batas widget Autocomplete pada saat kueri dikirim. Menetapkan strictBounds ke false (yang merupakan default) akan membuat hasil dicondongkan ke, tetapi tidak terbatas pada, tempat yang berada dalam batas tersebut. |
types optional |
Jenis:
Array<string> optional Jenis prediksi yang akan ditampilkan. Untuk mengetahui jenis yang didukung, lihat panduan developer. Jika tidak ada jenis yang ditentukan, semua jenis akan ditampilkan. |
SearchBox
Class
google.maps.places.SearchBox
Widget yang memberikan prediksi kueri berdasarkan input teks pengguna. Fungsi ini melekat pada elemen input jenis text
, dan memproses entri teks di kolom tersebut. Daftar prediksi ditampilkan sebagai menu drop-down, dan diperbarui saat teks dimasukkan.
Class ini memperluas
MVCObject
.
Akses dengan memanggil const {SearchBox} = await google.maps.importLibrary("places")
. Lihat Library di Maps JavaScript API.
Konstruktor | |
---|---|
SearchBox |
SearchBox(inputField[, opts]) Parameter:
Membuat instance SearchBox baru yang dilampirkan ke kolom teks input yang ditentukan dengan opsi yang diberikan. |
Metode | |
---|---|
getBounds |
getBounds() Parameter: Tidak ada
Nilai Hasil:
LatLngBounds|undefined Menampilkan batas prediksi kueri yang dibiaskan. |
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 region yang akan digunakan untuk membiaskan prediksi kueri. Hasilnya hanya akan bias terhadap area ini dan tidak sepenuhnya dibatasi pada area tersebut. |
Diwariskan:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Acara | |
---|---|
places_changed |
function() Argumen: Tidak ada
Peristiwa ini diaktifkan 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
.
Properti | |
---|---|
bounds optional |
Jenis:
LatLngBounds|LatLngBoundsLiteral optional Area yang menjadi tujuan untuk membiaskan prediksi kueri. Prediksi dibiaskan terhadap, tetapi tidak terbatas pada, kueri yang menargetkan batas-batas ini. |