Places Widgets

Class PlaceAutocompleteElement

Class google.maps.places.PlaceAutocompleteElement

  • PlaceAutocompleteElement adalah subclass HTMLElement yang menyediakan komponen UI untuk Places Autocomplete API. Setelah memuat library places, input dengan fungsi pelengkapan otomatis dapat dibuat di HTML. Contoh:
    <gmp-placeautocomplete ></gmp-placeautocomplete>

Elemen kustom:
<gmp-placeautocomplete name="string" requested-language="string" requested-region="string" types="type1 type2 type3..."></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.

PlaceAutocompleteElement
PlaceAutocompleteElement(options)
Parameter: 
componentRestrictions
Jenis:  ComponentRestrictions optional
Batasan komponen. Batasan komponen digunakan untuk membatasi prediksi hanya untuk prediksi yang ada dalam komponen induk. Misalnya, negara.
locationBias
Jenis:  LocationBias optional
Batas halus atau petunjuk yang dapat digunakan saat menelusuri tempat.
locationRestriction
Jenis:  LocationRestriction optional
Batas untuk membatasi hasil penelusuran.
name
Jenis:  string optional
Nama yang akan digunakan untuk elemen input. Lihat https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#name untuk mengetahui detailnya. Mengikuti perilaku yang sama dengan atribut nama untuk input. Perhatikan bahwa nama ini akan digunakan saat formulir dikirimkan. Lihat https://developer.mozilla.org/en-US/docs/Web/HTML/Element/form untuk mengetahui detailnya.
Atribut HTML:
  • <gmp-placeautocomplete name="string"></gmp-placeautocomplete>
requestedLanguage
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.
Atribut HTML:
  • <gmp-placeautocomplete requested-language="string"></gmp-placeautocomplete>
requestedRegion
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").
Atribut HTML:
  • <gmp-placeautocomplete requested-region="string"></gmp-placeautocomplete>
types
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.
Atribut HTML:
  • <gmp-placeautocomplete types="type1 type2 type3..."></gmp-placeautocomplete>
prediction-item
Item di menu drop-down prediksi yang mewakili satu prediksi.
prediction-item-icon
Ikon yang ditampilkan di sebelah kiri setiap item dalam daftar prediksi.
prediction-item-main-text
Bagian dari item prediksi yang merupakan teks utama prediksi. Untuk lokasi geografis, isinya adalah nama tempat, seperti 'Sydney', atau nama jalan dan nomor jalan, seperti '10 King Street'. Secara default, prediksi-item-main-text berwarna hitam. Jika ada teks tambahan dalam item prediksi, teks tersebut berada di luar prediksi-item-main-text dan mewarisi gayanya dari item prediksi. Secara default, warnanya abu-abu. Teks tambahan biasanya berupa alamat.
prediction-item-match
Bagian dari prediksi yang ditampilkan sesuai dengan input pengguna. Secara default, teks yang cocok ini disorot dalam teks tebal. Perhatikan bahwa teks yang cocok dapat berada di mana saja dalam item prediksi. Ini belum tentu bagian dari prediksi-item-main-text.
prediction-item-selected
Item saat pengguna bernavigasi ke item tersebut melalui keyboard. Catatan: Item yang dipilih akan terpengaruh oleh gaya komponen ini dan juga gaya bagian item prediksi.
prediction-list
Elemen visual berisi daftar prediksi yang dikembalikan oleh layanan Place Autocomplete. Daftar ini muncul sebagai daftar dropdown di bawah PlaceAutocompleteElement.
BetaaddEventListener
addEventListener(type, listener[, options])
Parameter: 
  • typestring String yang peka huruf besar/kecil yang mewakili jenis peristiwa yang akan diproses.
  • listenerEventListener|EventListenerObject Objek yang menerima notifikasi. Objek ini harus berupa fungsi atau objek dengan metode handleEvent
  • optionsboolean|AddEventListenerOptions optional Lihat opsi. Peristiwa kustom hanya mendukung capture dan passive.
Nilai Hasil:  void
Menyiapkan fungsi yang akan dipanggil setiap kali peristiwa yang ditentukan dikirim ke target. Lihat addEventListener
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parameter: 
  • typestring String yang menentukan jenis peristiwa yang pemroses peristiwanya akan dihapus.
  • listenerEventListener|EventListenerObject Pemroses peristiwa pengendali peristiwa yang akan dihapus dari target peristiwa.
  • optionsboolean|EventListenerOptions optional Lihat opsi
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.

componentRestrictions optional
Jenis:  ComponentRestrictions optional
locationBias optional
Jenis:  LocationBias optional
locationRestriction optional
Jenis:  LocationRestriction optional
requestedLanguage optional
Jenis:  string optional
requestedRegion optional
Jenis:  string optional
types optional
Jenis:  Array<string> optional

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.

Betaplace
Jenis:  Place

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.

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 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: 
  • fieldsArray<string> optional
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: 
  • typesArray<string> optional Jenis prediksi yang akan disertakan.
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
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.

bounds 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'].
placeIdOnly optional
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.

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.

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

bounds optional
Area yang menjadi tujuan untuk membiaskan prediksi kueri. Prediksi dibiaskan terhadap, tetapi tidak terbatas pada, kueri yang menargetkan batas-batas ini.