Places Widgets

Class PlaceAutocompleteElement

Class google.maps.places.PlaceAutocompleteElement

Pemberitahuan: Hanya tersedia di saluran v=alpha.

• 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></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:  Hari options:  PlaceAutocompleteElementOptions

Properti
inputElement	Jenis:  HTMLInputElement Elemen input yang akan ditampilkan pelengkapan otomatis.
Diwariskan: componentRestrictions, locationBias, locationRestriction, requestedLanguage, requestedRegion, types

Metode
addEventListener	Pemberitahuan: Hanya tersedia di saluran v=beta. addEventListener(type, listener[, options]) Parameter:  type:  string String yang peka huruf besar/kecil yang mewakili jenis peristiwa yang akan diproses. listener:  EventListener|EventListenerObject Objek yang menerima notifikasi. String ini harus berupa fungsi atau objek dengan metode handleEvent options:  boolean|AddEventListenerOptions optional Lihat opsi. Peristiwa kustom hanya mendukung capture dan passive. Nilai Hasil:  void Menyiapkan fungsi yang akan dipanggil setiap kali peristiwa yang ditentukan dikirimkan ke target. Lihat addEventListener
removeEventListener	Pemberitahuan: Hanya tersedia di saluran v=beta. removeEventListener(type, listener[, options]) Parameter:  type:  string String yang menentukan jenis peristiwa yang pemroses peristiwanya akan dihapus. listener:  EventListener|EventListenerObject Pemroses peristiwa dari pengendali peristiwa yang akan dihapus dari target peristiwa. options:  boolean|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

Pemberitahuan: Hanya tersedia di saluran v=alpha.

Opsi untuk membuat PlaceAutocompleteElement.

Properti
inputElement	Jenis:  HTMLInputElement Elemen input yang akan ditampilkan pelengkapan otomatis.
componentRestrictions optional	Jenis:  ComponentRestrictions optional Batasan komponen. Pembatasan komponen digunakan untuk membatasi prediksi hanya pada komponen induk. Misalnya, negara.
locationBias optional	Jenis:  LocationBias optional Batas yang jelas atau petunjuk untuk digunakan saat menelusuri tempat.
locationRestriction optional	Jenis:  LocationRestriction optional Batas untuk membatasi hasil penelusuran.
requestedLanguage optional	Jenis:  string optional ID bahasa untuk bahasa yang digunakan untuk menampilkan hasil, jika memungkinkan. Hasil dalam bahasa yang dipilih mungkin diberi peringkat yang lebih tinggi, tetapi saran tidak terbatas untuk bahasa ini. Lihat daftar bahasa yang didukung.
requestedRegion optional	Jenis:  string optional Kode wilayah yang digunakan untuk pemformatan hasil dan pemfilteran hasil. Tindakan ini tidak membatasi saran di negara ini. Kode wilayah menerima nilai dua karakter ccTLD ("domain level teratas"). 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

Pemberitahuan: Hanya tersedia di saluran v=alpha.

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.

Properti
place	Pemberitahuan: Hanya tersedia di saluran v=alpha. Jenis:  Place

Class PlaceAutocompleteRequestErrorEvent

Class google.maps.places.PlaceAutocompleteRequestErrorEvent

Pemberitahuan: Hanya tersedia di saluran v=alpha.

Peristiwa ini ditampilkan 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 dilampirkan ke 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:  inputField:  HTMLInputElement Kolom teks <input> tempat Autocomplete harus dilampirkan. opts:  AutocompleteOptions optional Opsi. 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 bias. Menampilkan batas yang mana 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 ditetapkan ke nilai kolom input saat ini.
setBounds	setBounds(bounds) Parameter:  bounds:  LatLngBounds|LatLngBoundsLiteral optional Batas bias. Nilai Hasil: Tidak ada Menetapkan area pilihan untuk menampilkan hasil Place. Hasilnya dibiaskan terhadap, tetapi tidak terbatas pada, area ini.
setComponentRestrictions	setComponentRestrictions(restrictions) Parameter:  restrictions:  ComponentRestrictions optional Batasan penggunaan. Nilai Hasil: Tidak ada Menetapkan batasan komponen. Pembatasan komponen digunakan untuk membatasi prediksi hanya pada komponen induk. Misalnya, negara.
setFields	setFields(fields) Parameter:  Hari fields:  Array<string> optional Nilai Hasil: Tidak ada Menetapkan kolom yang akan disertakan untuk Tempat dalam respons detail saat detail berhasil diambil. Untuk mengetahui daftar kolom, lihat PlaceResult.
setOptions	setOptions(options) Parameter:  Hari options:  AutocompleteOptions optional 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 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

Peristiwa
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 dalam properti name, tanpa properti lain yang ditentukan.

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. Pembatasan komponen digunakan untuk membatasi prediksi hanya pada 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 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"). Defaultnya adalah ['ALL'].
placeIdOnly optional	Tidak digunakan lagi: placeIdOnly tidak digunakan lagi mulai 15 Januari 2019, dan akan dinonaktifkan pada 15 Januari 2020. Sebagai gantinya, gunakan AutocompleteOptions.fields: fields: ['place_id', 'name', 'types']. Jenis:  boolean optional Apakah akan mengambil ID Tempat saja. 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 hasilnya dicondongkan ke, tetapi tidak terbatas pada, tempat yang berada dalam batas.
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 dilampirkan ke 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:  Hari inputField:  HTMLInputElement Hari opts:  SearchBoxOptions optional 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 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:  Hari bounds:  LatLngBounds|LatLngBoundsLiteral optional Nilai Hasil: Tidak ada Menetapkan region yang akan digunakan untuk membiaskan prediksi kueri. Hasilnya hanya akan bias terhadap area ini dan tidak sepenuhnya dibatasi.
Diwariskan: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Peristiwa
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 dicondongkan ke, tetapi tidak terbatas pada, kueri yang menargetkan batas ini.