Places Widgets

Class BasicPlaceAutocompleteElement

Class google.maps.places.BasicPlaceAutocompleteElement

BasicPlaceAutocompleteElement adalah subclass HTMLElement yang menyediakan komponen UI untuk Places Autocomplete API.

Elemen kustom:
<gmp-basic-place-autocomplete included-primary-types="type1 type2 type3..." included-region-codes="c1 c2 c3..." name="string" origin="lat,lng" requested-language="string" requested-region="string" unit-system="metric"></gmp-basic-place-autocomplete>

Class ini memperluas HTMLElement.

Class ini mengimplementasikan BasicPlaceAutocompleteElementOptions.

Akses dengan memanggil const {BasicPlaceAutocompleteElement} = await google.maps.importLibrary("places").
Lihat Library di Maps JavaScript API.

BasicPlaceAutocompleteElement
BasicPlaceAutocompleteElement(options)
Parameter: 
includedPrimaryTypes
Jenis:  Array<string> optional
Mencakup Jenis tempat utama (misalnya, "restaurant" atau "gas_station").

Tempat hanya ditampilkan jika jenis utamanya disertakan dalam daftar ini. Maksimal 5 nilai dapat ditentukan. Jika tidak ada jenis yang ditentukan, semua jenis Tempat akan ditampilkan.
Atribut HTML:
  • <gmp-basic-place-autocomplete included-primary-types="type1 type2 type3..."></gmp-basic-place-autocomplete>
includedRegionCodes
Jenis:  Array<string> optional
Hanya menyertakan hasil di wilayah yang ditentukan, yang ditentukan sebagai hingga 15 kode wilayah dua karakter CLDR. Set kosong tidak akan membatasi hasil. Jika locationRestriction dan includedRegionCodes ditetapkan, hasilnya akan berada di area persimpangan.
Atribut HTML:
  • <gmp-basic-place-autocomplete included-region-codes="c1 c2 c3..."></gmp-basic-place-autocomplete>
locationBias
Jenis:  LocationBias optional
Petunjuk atau batas lunak yang 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 ini adalah nama yang akan digunakan saat formulir dikirimkan. Lihat https://developer.mozilla.org/en-US/docs/Web/HTML/Element/form untuk mengetahui detailnya.
Atribut HTML:
  • <gmp-basic-place-autocomplete name="string"></gmp-basic-place-autocomplete>
origin
Asal untuk menghitung jarak. Jika tidak ditentukan, jarak tidak dihitung. Ketinggian, jika diberikan, tidak digunakan dalam penghitungan.
Atribut HTML:
  • <gmp-basic-place-autocomplete origin="lat,lng"></gmp-basic-place-autocomplete>
  • <gmp-basic-place-autocomplete origin="lat,lng,altitude"></gmp-basic-place-autocomplete>
requestedLanguage
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 pada bahasa ini. Lihat daftar bahasa yang didukung.
Atribut HTML:
  • <gmp-basic-place-autocomplete requested-language="string"></gmp-basic-place-autocomplete>
requestedRegion
Jenis:  string optional
Kode wilayah yang digunakan untuk pemformatan hasil dan untuk pemfilteran hasil. Hal ini tidak membatasi saran ke 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 "The United Kingdom of Great Britain and Northern Ireland").
Atribut HTML:
  • <gmp-basic-place-autocomplete requested-region="string"></gmp-basic-place-autocomplete>
unitSystem
Jenis:  UnitSystem optional
Sistem satuan yang digunakan untuk menampilkan jarak. Jika tidak ditentukan, sistem unit ditentukan oleh requestedRegion.
Atribut HTML:
  • <gmp-basic-place-autocomplete unit-system="metric"></gmp-basic-place-autocomplete>
  • <gmp-basic-place-autocomplete unit-system="imperial"></gmp-basic-place-autocomplete>
prediction-item-icon
Slot ini menerima tepat satu elemen <template> untuk dirender sebagai ikon yang ditampilkan di samping item prediksi.
prediction-item
Item dalam 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 item prediksi yang merupakan teks utama prediksi. Untuk lokasi geografis, isinya adalah nama tempat, seperti 'Sydney', atau nama jalan dan nomor rumah, seperti '10 King Street'. Secara default, prediction-item-main-text berwarna hitam. Jika ada teks tambahan dalam prediction-item, teks tersebut berada di luar prediction-item-main-text dan mewarisi gayanya dari prediction-item. Secara default, warnanya abu-abu. Teks tambahan biasanya berupa alamat.
prediction-item-match
Bagian dari prediksi yang dikembalikan sesuai dengan masukan pengguna. Secara default, teks yang cocok ini disorot dalam teks tebal. Perhatikan bahwa teks yang cocok dapat berada di mana saja dalam prediction-item. Class ini belum tentu bagian dari prediction-item-main-text.
prediction-item-selected
Item saat pengguna menavigasi ke item tersebut melalui keyboard. Catatan: Item yang dipilih akan terpengaruh oleh gaya bagian 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.
background-color
Mengganti warna latar belakang elemen.
border
Menggantikan batas elemen.
border-radius
Mengganti radius batas elemen.
color-scheme
Menunjukkan skema warna yang dapat digunakan untuk merender elemen ini. Lihat dokumentasi color-scheme untuk mengetahui detail selengkapnya. Default-nya adalah color-scheme: light dark.
addEventListener
addEventListener(type, listener[, options])
Parameter: 
  • typestring String peka huruf besar/kecil yang mewakili jenis peristiwa yang akan diproses.
  • listenerEventListener|EventListenerObject Objek yang menerima notifikasi. Ini harus berupa fungsi atau objek dengan metode handleEvent
  • optionsboolean|AddEventListenerOptions optional Lihat opsi. Peristiwa kustom hanya mendukung capture dan passive.
Nilai yang Ditampilkan:  void
Menyiapkan fungsi yang akan dipanggil setiap kali peristiwa yang ditentukan dikirimkan ke target. Lihat addEventListener.
removeEventListener
removeEventListener(type, listener[, options])
Parameter: 
  • typestring String yang menentukan jenis peristiwa yang pemroses peristiwanya akan dihapus.
  • listenerEventListener|EventListenerObject Pemroses peristiwa dari pengendali peristiwa yang akan dihapus dari target peristiwa.
  • optionsboolean|EventListenerOptions optional Lihat opsi.
Nilai yang Ditampilkan:  void
Menghapus pemroses peristiwa yang sebelumnya didaftarkan dengan addEventListener dari target. Lihat removeEventListener.
gmp-error
function(errorEvent)
Argumen: 
Peristiwa ini dipicu saat permintaan ke backend ditolak (misalnya, kunci API salah). Peristiwa ini tidak menggelembung.
gmp-select
function(placeSelectEvent)
Argumen: 
Peristiwa ini diaktifkan saat pengguna memilih prediksi tempat. Berisi objek Place.

Antarmuka BasicPlaceAutocompleteElementOptions

google.maps.places.BasicPlaceAutocompleteElementOptions interface

Opsi untuk membuat BasicPlaceAutocompleteElement.

includedPrimaryTypes optional
Jenis:  Array<string> optional
includedRegionCodes optional
Jenis:  Array<string> optional
locationBias optional
Jenis:  LocationBias optional
locationRestriction optional
Jenis:  LocationRestriction optional
name optional
Jenis:  string optional
origin optional
requestedLanguage optional
Jenis:  string optional
requestedRegion optional
Jenis:  string optional
unitSystem optional
Jenis:  UnitSystem optional

PlaceAutocompleteElement class

Class google.maps.places.PlaceAutocompleteElement

PlaceAutocompleteElement adalah subclass HTMLElement yang menyediakan komponen UI untuk Places Autocomplete API.

PlaceAutocompleteElement otomatis menggunakan AutocompleteSessionToken secara internal untuk mengelompokkan fase kueri dan pemilihan dari penelusuran pelengkapan otomatis pengguna.

Panggilan pertama ke Place.fetchFields pada Place yang ditampilkan oleh PlacePrediction.toPlace akan otomatis menyertakan token sesi yang digunakan untuk mengambil PlacePrediction.

Lihat https://developers.google.com/maps/documentation/places/web-service/place-session-tokens untuk mengetahui detail selengkapnya tentang cara kerja sesi.

Elemen kustom:
<gmp-place-autocomplete included-primary-types="type1 type2 type3..." included-region-codes="c1 c2 c3..." name="string" origin="lat,lng" requested-language="string" requested-region="string" unit-system="metric"></gmp-place-autocomplete>

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: 
includedPrimaryTypes
Jenis:  Array<string> optional
Mencakup Jenis tempat utama (misalnya, "restaurant" atau "gas_station").

Tempat hanya ditampilkan jika jenis utamanya disertakan dalam daftar ini. Maksimal 5 nilai dapat ditentukan. Jika tidak ada jenis yang ditentukan, semua jenis Tempat akan ditampilkan.
Atribut HTML:
  • <gmp-place-autocomplete included-primary-types="type1 type2 type3..."></gmp-place-autocomplete>
includedRegionCodes
Jenis:  Array<string> optional
Hanya menyertakan hasil di wilayah yang ditentukan, yang ditentukan sebagai hingga 15 kode wilayah dua karakter CLDR. Set kosong tidak akan membatasi hasil. Jika locationRestriction dan includedRegionCodes ditetapkan, hasilnya akan berada di area persimpangan.
Atribut HTML:
  • <gmp-place-autocomplete included-region-codes="c1 c2 c3..."></gmp-place-autocomplete>
locationBias
Jenis:  LocationBias optional
Petunjuk atau batas lunak yang 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 ini adalah nama yang akan digunakan saat formulir dikirimkan. Lihat https://developer.mozilla.org/en-US/docs/Web/HTML/Element/form untuk mengetahui detailnya.
Atribut HTML:
  • <gmp-place-autocomplete name="string"></gmp-place-autocomplete>
origin
Asal untuk menghitung jarak. Jika tidak ditentukan, jarak tidak dihitung. Ketinggian, jika diberikan, tidak digunakan dalam penghitungan.
Atribut HTML:
  • <gmp-place-autocomplete origin="lat,lng"></gmp-place-autocomplete>
  • <gmp-place-autocomplete origin="lat,lng,altitude"></gmp-place-autocomplete>
requestedLanguage
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 pada bahasa ini. Lihat daftar bahasa yang didukung.
Atribut HTML:
  • <gmp-place-autocomplete requested-language="string"></gmp-place-autocomplete>
requestedRegion
Jenis:  string optional
Kode wilayah yang digunakan untuk pemformatan hasil dan untuk pemfilteran hasil. Hal ini tidak membatasi saran ke 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 "The United Kingdom of Great Britain and Northern Ireland").
Atribut HTML:
  • <gmp-place-autocomplete requested-region="string"></gmp-place-autocomplete>
unitSystem
Jenis:  UnitSystem optional
Sistem satuan yang digunakan untuk menampilkan jarak. Jika tidak ditentukan, sistem unit ditentukan oleh requestedRegion.
Atribut HTML:
  • <gmp-place-autocomplete unit-system="metric"></gmp-place-autocomplete>
  • <gmp-place-autocomplete unit-system="imperial"></gmp-place-autocomplete>
prediction-item-icon
Slot ini menerima tepat satu elemen <template> untuk dirender sebagai ikon yang ditampilkan di samping item prediksi.
prediction-item
Item dalam 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 item prediksi yang merupakan teks utama prediksi. Untuk lokasi geografis, isinya adalah nama tempat, seperti 'Sydney', atau nama jalan dan nomor rumah, seperti '10 King Street'. Secara default, prediction-item-main-text berwarna hitam. Jika ada teks tambahan dalam prediction-item, teks tersebut berada di luar prediction-item-main-text dan mewarisi gayanya dari prediction-item. Secara default, warnanya abu-abu. Teks tambahan biasanya berupa alamat.
prediction-item-match
Bagian dari prediksi yang dikembalikan sesuai dengan masukan pengguna. Secara default, teks yang cocok ini disorot dalam teks tebal. Perhatikan bahwa teks yang cocok dapat berada di mana saja dalam prediction-item. Class ini belum tentu bagian dari prediction-item-main-text.
prediction-item-selected
Item saat pengguna menavigasi ke item tersebut melalui keyboard. Catatan: Item yang dipilih akan terpengaruh oleh gaya bagian 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.
background-color
Mengganti warna latar belakang elemen.
border
Menggantikan batas elemen.
border-radius
Mengganti radius batas elemen.
color-scheme
Menunjukkan skema warna yang dapat digunakan untuk merender elemen ini. Lihat dokumentasi color-scheme untuk mengetahui detail selengkapnya. Default-nya adalah color-scheme: light dark.
addEventListener
addEventListener(type, listener[, options])
Parameter: 
  • typestring String peka huruf besar/kecil yang mewakili jenis peristiwa yang akan diproses.
  • listenerEventListener|EventListenerObject Objek yang menerima notifikasi. Ini harus berupa fungsi atau objek dengan metode handleEvent
  • optionsboolean|AddEventListenerOptions optional Lihat opsi. Peristiwa kustom hanya mendukung capture dan passive.
Nilai yang Ditampilkan:  void
Menyiapkan fungsi yang akan dipanggil setiap kali peristiwa yang ditentukan dikirimkan ke target. Lihat addEventListener.
removeEventListener
removeEventListener(type, listener[, options])
Parameter: 
  • typestring String yang menentukan jenis peristiwa yang pemroses peristiwanya akan dihapus.
  • listenerEventListener|EventListenerObject Pemroses peristiwa dari pengendali peristiwa yang akan dihapus dari target peristiwa.
  • optionsboolean|EventListenerOptions optional Lihat opsi.
Nilai yang Ditampilkan:  void
Menghapus pemroses peristiwa yang sebelumnya didaftarkan dengan addEventListener dari target. Lihat removeEventListener.
gmp-error
function(errorEvent)
Argumen: 
Peristiwa ini dipicu saat permintaan ke backend ditolak (misalnya, kunci API salah). Peristiwa ini tidak menggelembung.
gmp-select
function(placePredictionSelectEvent)
Argumen: 
Peristiwa ini diaktifkan saat pengguna memilih prediksi tempat. Berisi objek PlacePrediction yang dapat dikonversi menjadi objek Place.

PlaceAutocompleteElementOptions interface

google.maps.places.PlaceAutocompleteElementOptions interface

Opsi untuk membuat PlaceAutocompleteElement. Untuk deskripsi setiap properti, lihat properti dengan nama yang sama di class PlaceAutocompleteElement.

includedPrimaryTypes optional
Jenis:  Array<string> optional
includedRegionCodes optional
Jenis:  Array<string> optional
locationBias optional
Jenis:  LocationBias optional
locationRestriction optional
Jenis:  LocationRestriction optional
name optional
Jenis:  string optional
origin optional
requestedLanguage optional
Jenis:  string optional
requestedRegion optional
Jenis:  string optional
unitSystem optional
Jenis:  UnitSystem optional

PlacePredictionSelectEvent class

Class google.maps.places.PlacePredictionSelectEvent

Peristiwa ini dibuat setelah pengguna memilih item prediksi dengan PlaceAutocompleteElement. Akses pilihan dengan event.placePrediction.

Konversi placePrediction menjadi Place dengan memanggil PlacePrediction.toPlace.

Class ini memperluas Event.

Akses dengan memanggil const {PlacePredictionSelectEvent} = await google.maps.importLibrary("places").
Lihat Library di Maps JavaScript API.

placePrediction
Konversikan ini menjadi Place dengan memanggil PlacePrediction.toPlace.

PlaceContextualElement class

Class google.maps.places.PlaceContextualElement

Widget yang menggunakan token konteks untuk menampilkan tampilan kontekstual respons Perujukan dengan Google Maps.

Elemen kustom:
<gmp-place-contextual context-token="string"></gmp-place-contextual>

Class ini memperluas HTMLElement.

Class ini mengimplementasikan PlaceContextualElementOptions.

Akses dengan memanggil const {PlaceContextualElement} = await google.maps.importLibrary("places").
Lihat Library di Maps JavaScript API.

PlaceContextualElement
PlaceContextualElement([options])
Parameter: 
contextToken
Jenis:  string optional
Token konteks.
Atribut HTML:
  • <gmp-place-contextual context-token="string"></gmp-place-contextual>
addEventListener
addEventListener(type, listener[, options])
Parameter: 
  • typestring String peka huruf besar/kecil yang mewakili jenis peristiwa yang akan diproses.
  • listenerEventListener|EventListenerObject Objek yang menerima notifikasi. Ini harus berupa fungsi atau objek dengan metode handleEvent
  • optionsboolean|AddEventListenerOptions optional Lihat opsi. Peristiwa kustom hanya mendukung capture dan passive.
Nilai yang Ditampilkan:  void
Menyiapkan fungsi yang akan dipanggil setiap kali peristiwa yang ditentukan dikirimkan ke target. Lihat addEventListener.
removeEventListener
removeEventListener(type, listener[, options])
Parameter: 
  • typestring String yang menentukan jenis peristiwa yang pemroses peristiwanya akan dihapus.
  • listenerEventListener|EventListenerObject Pemroses peristiwa dari pengendali peristiwa yang akan dihapus dari target peristiwa.
  • optionsboolean|EventListenerOptions optional Lihat opsi.
Nilai yang Ditampilkan:  void
Menghapus pemroses peristiwa yang sebelumnya didaftarkan dengan addEventListener dari target. Lihat removeEventListener.

PlaceContextualElementOptions interface

google.maps.places.PlaceContextualElementOptions interface

Opsi untuk PlaceContextualElement.

contextToken optional
Jenis:  string optional
Token konteks yang diberikan oleh respons Perujukan dengan Google Maps.

PlaceContextualListConfigElement class

Class google.maps.places.PlaceContextualListConfigElement

Elemen HTML yang mengonfigurasi opsi untuk tampilan daftar Elemen Kontekstual Tempat.

Elemen kustom:
<gmp-place-contextual-list-config layout="compact" map-hidden map-mode="none"></gmp-place-contextual-list-config>

Class ini memperluas HTMLElement.

Class ini mengimplementasikan PlaceContextualListConfigElementOptions.

Akses dengan memanggil const {PlaceContextualListConfigElement} = await google.maps.importLibrary("places").
Lihat Library di Maps JavaScript API.

PlaceContextualListConfigElement
PlaceContextualListConfigElement([options])
Parameter: 
layout
Jenis:  PlaceContextualListLayout optional
Tata letak.
Atribut HTML:
  • <gmp-place-contextual-list-config layout="compact"></gmp-place-contextual-list-config>
  • <gmp-place-contextual-list-config layout="vertical"></gmp-place-contextual-list-config>
mapHidden
Jenis:  boolean optional
Apakah peta disembunyikan.
Atribut HTML:
  • <gmp-place-contextual-list-config map-hidden></gmp-place-contextual-list-config>
mapMode
Jenis:  PlaceContextualListMapMode optional
Mode peta yang digunakan dalam Elemen Kontekstual Tempat untuk daftar tempat.
Atribut HTML:
  • <gmp-place-contextual-list-config map-mode="none"></gmp-place-contextual-list-config>
  • <gmp-place-contextual-list-config map-mode="roadmap"></gmp-place-contextual-list-config>
  • <gmp-place-contextual-list-config map-mode="hybrid"></gmp-place-contextual-list-config>
addEventListener
addEventListener(type, listener[, options])
Parameter: 
  • typestring String peka huruf besar/kecil yang mewakili jenis peristiwa yang akan diproses.
  • listenerEventListener|EventListenerObject Objek yang menerima notifikasi. Ini harus berupa fungsi atau objek dengan metode handleEvent
  • optionsboolean|AddEventListenerOptions optional Lihat opsi. Peristiwa kustom hanya mendukung capture dan passive.
Nilai yang Ditampilkan:  void
Menyiapkan fungsi yang akan dipanggil setiap kali peristiwa yang ditentukan dikirimkan ke target. Lihat addEventListener.
removeEventListener
removeEventListener(type, listener[, options])
Parameter: 
  • typestring String yang menentukan jenis peristiwa yang pemroses peristiwanya akan dihapus.
  • listenerEventListener|EventListenerObject Pemroses peristiwa dari pengendali peristiwa yang akan dihapus dari target peristiwa.
  • optionsboolean|EventListenerOptions optional Lihat opsi.
Nilai yang Ditampilkan:  void
Menghapus pemroses peristiwa yang sebelumnya didaftarkan dengan addEventListener dari target. Lihat removeEventListener.

PlaceContextualListConfigElementOptions interface

google.maps.places.PlaceContextualListConfigElementOptions interface

Opsi untuk PlaceContextualListConfigElement.

layout optional
Jenis:  PlaceContextualListLayout optional
Tata letak.
mapHidden optional
Jenis:  boolean optional
Default: false
Benar jika peta harus disembunyikan.
mapMode optional
Jenis:  PlaceContextualListMapMode optional
Mode peta yang digunakan dalam Elemen Kontekstual Tempat untuk daftar tempat.

Konstanta PlaceContextualListLayout

google.maps.places.PlaceContextualListLayout konstanta

Daftar tata letak yang didukung Elemen Kontekstual Tempat untuk tampilan daftar.

Akses dengan memanggil const {PlaceContextualListLayout} = await google.maps.importLibrary("places").
Lihat Library di Maps JavaScript API.

COMPACT Tata letak daftar ringkas: item daftar dirender sebagai link di satu baris, dengan item yang tidak muat dalam daftar dropdown.
VERTICAL Tata letak daftar vertikal: item daftar dirender sebagai kartu dalam daftar vertikal.

PlaceContextualListMapMode constants

google.maps.places.PlaceContextualListMapMode konstanta

Mode peta yang digunakan dalam Elemen Kontekstual Tempat untuk daftar tempat.

Akses dengan memanggil const {PlaceContextualListMapMode} = await google.maps.importLibrary("places").
Lihat Library di Maps JavaScript API.

HYBRID Lapisan transparan jalan utama di satelit, atau gambar fotorealistik dalam 3D.
NONE Tidak ada peta.
ROADMAP Peta jalan 2D normal.

Kelas PlaceDetailsElement

Class google.maps.places.PlaceDetailsElement

Menampilkan detail tempat dalam tata letak penuh. Tambahkan PlaceDetailsPlaceRequestElement atau PlaceDetailsLocationRequestElement untuk menentukan tempat yang akan dirender. Tambahkan PlaceContentConfigElement, PlaceStandardContentElement, atau PlaceAllContentElement untuk menentukan konten yang akan dirender.

Contoh:

 <gmp-place-details>
  <gmp-place-details-place-request
    place="PLACE_ID"
  ></gmp-place-details-place-request>
  <gmp-place-content-config>
    <gmp-place-media lightbox-preferred></gmp-place-media>
  </gmp-place-content-config>
</gmp-place-details>

Untuk menggunakan elemen ini, aktifkan Places UI Kit API untuk project Anda di konsol Google Cloud.

Elemen kustom:
<gmp-place-details></gmp-place-details>

Class ini memperluas HTMLElement.

Class ini mengimplementasikan PlaceDetailsElementOptions.

Akses dengan memanggil const {PlaceDetailsElement} = await google.maps.importLibrary("places").
Lihat Library di Maps JavaScript API.

PlaceDetailsElement
PlaceDetailsElement([options])
Parameter: 
place
Jenis:  Place optional
Hanya baca. Objek tempat yang berisi ID, lokasi, dan area tampilan tempat yang saat ini dirender.
--gmp-button-border-color
Warna batas tombol "Buka di Maps".
--gmp-button-border-radius
Radius batas tombol "Buka di Maps".
--gmp-button-border-width
Lebar batas tombol "Buka di Maps".
--gmp-collage-border-radius-outer
Radius batas sudut luar kolase media.
--gmp-dialog-border-radius
Radius batas dialog pengungkapan Google Maps.
--gmp-mat-color-disabled-surface
Warna permukaan yang dimaksudkan untuk menyampaikan status dinonaktifkan atau tidak ada. Digunakan untuk bintang ulasan kosong.
--gmp-mat-color-info
Warna elemen UI dengan sentimen informasi. Digunakan untuk ikon kursi roda.
--gmp-mat-color-negative
Warna elemen UI dengan sentimen negatif. Digunakan untuk teks "Tutup" dalam status buka sekarang.
--gmp-mat-color-neutral-container
Warna penampung untuk elemen UI yang diisi netral. Digunakan untuk placeholder gambar dan badge tanggal publikasi ulasan.
--gmp-mat-color-on-neutral-container
Warna teks dan ikon terhadap warna penampung netral. Digunakan untuk badge tanggal publikasi ulasan dan badge ketersediaan pengisi daya EV jika tidak tersedia.
--gmp-mat-color-on-positive-container
Warna teks dan ikon terhadap warna penampung positif. Digunakan untuk badge ketersediaan pengisi daya EV jika tersedia.
--gmp-mat-color-on-secondary-container
Warna teks dan ikon terhadap warna penampung sekunder. Digunakan untuk teks dan ikon pada tombol "Buka di Maps".
--gmp-mat-color-on-surface
Warna untuk teks dan ikon terhadap warna platform apa pun. Digunakan untuk teks biasa.
--gmp-mat-color-on-surface-variant
Warna dengan penekanan lebih rendah untuk teks dan ikon dengan warna permukaan apa pun. Digunakan untuk teks yang kurang ditekankan.
--gmp-mat-color-outline-decorative
Warna garis batas elemen non-interaktif. Digunakan untuk batas elemen.
--gmp-mat-color-positive
Warna elemen UI dengan sentimen positif. Digunakan untuk teks "Buka" dalam status buka sekarang.
--gmp-mat-color-positive-container
Warna penampung untuk elemen UI yang menyampaikan sentimen positif. Digunakan untuk badge ketersediaan pengisi daya EV jika tersedia.
--gmp-mat-color-primary
Warna teks dan ikon interaktif terhadap warna permukaan. Digunakan untuk jumlah ulasan, link dalam dialog pengungkapan Google Maps, link situs, ikon di tab ringkasan, dan (warna teks / fokus / saat kursor diarahkan) pada judul tab.
--gmp-mat-color-secondary-container
Warna pengisi yang kurang terlihat dibandingkan dengan permukaan, untuk komponen resesif seperti tombol tonal. Digunakan untuk latar belakang tombol "Buka di Maps".
--gmp-mat-color-surface
Warna untuk latar belakang. Digunakan untuk latar belakang elemen dan dialog pengungkapan Google Maps.
--gmp-mat-font-body-medium
Digunakan untuk alamat tempat, rating, jenis, harga, status buka sekarang, jam buka, ulasan, nomor telepon, situs, kode plus, fitur teratas, dan teks isi dalam dialog pengungkapan Google Maps.
--gmp-mat-font-body-small
Digunakan untuk teks isi dalam daftar fitur di tab 'Tentang'.
--gmp-mat-font-display-small
Digunakan untuk nama tempat dan teks untuk setiap judul fitur di tab 'Tentang'.
--gmp-mat-font-family
Jenis font dasar yang digunakan untuk semua teks.
--gmp-mat-font-headline-medium
Digunakan untuk teks judul dalam dialog pengungkapan Google Maps.
--gmp-mat-font-label-large
Digunakan untuk judul tab, tombol "Buka di Maps", teks atribusi pengulas di galeri foto, teks atribusi pengulas di bagian ulasan, dan link dalam dialog pengungkapan Google Maps.
--gmp-mat-font-label-medium
Digunakan untuk badge jumlah foto dan badge tanggal publikasi ulasan.
--gmp-mat-font-title-small
Digunakan untuk judul setiap bagian di tab 'Tentang'.
--gmp-mat-spacing-extra-large
Digunakan untuk penspasian dalam elemen, seperti margin dan padding di sekitar teks.
--gmp-mat-spacing-extra-small
Digunakan untuk penspasian dalam elemen, seperti margin dan padding di sekitar teks.
--gmp-mat-spacing-large
Digunakan untuk penspasian dalam elemen, seperti margin dan padding di sekitar teks.
--gmp-mat-spacing-medium
Digunakan untuk penspasian dalam elemen, seperti margin dan padding di sekitar teks.
--gmp-mat-spacing-small
Digunakan untuk penspasian dalam elemen, seperti margin dan padding di sekitar teks.
--gmp-mat-spacing-two-extra-large
Digunakan untuk penspasian dalam elemen, seperti margin dan padding di sekitar teks.
--gmp-star-rating-color
Warna bintang yang terisi dalam rating.
background-color
Mengganti warna latar belakang elemen.
border
Menggantikan batas elemen.
border-radius
Mengganti radius batas elemen.
color-scheme
Menunjukkan skema warna yang dapat digunakan untuk merender elemen ini. Lihat dokumentasi color-scheme untuk mengetahui detail selengkapnya. Default-nya adalah color-scheme: light dark.
font-size
Menskalakan semua teks dan ikon dalam elemen, yang ditentukan secara internal dalam em. Default-nya adalah 16px.
addEventListener
addEventListener(type, listener[, options])
Parameter: 
  • typestring String peka huruf besar/kecil yang mewakili jenis peristiwa yang akan diproses.
  • listenerEventListener|EventListenerObject Objek yang menerima notifikasi. Ini harus berupa fungsi atau objek dengan metode handleEvent
  • optionsboolean|AddEventListenerOptions optional Lihat opsi. Peristiwa kustom hanya mendukung capture dan passive.
Nilai yang Ditampilkan:  void
Menyiapkan fungsi yang akan dipanggil setiap kali peristiwa yang ditentukan dikirimkan ke target. Lihat addEventListener.
removeEventListener
removeEventListener(type, listener[, options])
Parameter: 
  • typestring String yang menentukan jenis peristiwa yang pemroses peristiwanya akan dihapus.
  • listenerEventListener|EventListenerObject Pemroses peristiwa dari pengendali peristiwa yang akan dihapus dari target peristiwa.
  • optionsboolean|EventListenerOptions optional Lihat opsi.
Nilai yang Ditampilkan:  void
Menghapus pemroses peristiwa yang sebelumnya didaftarkan dengan addEventListener dari target. Lihat removeEventListener.
gmp-error
function(event)
Argumen: 
Peristiwa ini dipicu saat permintaan ke backend ditolak (misalnya, kunci API salah). Peristiwa ini tidak menggelembung.
gmp-load
function(event)
Argumen: 
Peristiwa ini dipicu saat elemen memuat dan merender kontennya. Peristiwa ini tidak menggelembung.

PlaceDetailsElementOptions interface

google.maps.places.PlaceDetailsElementOptions interface

Opsi untuk PlaceDetailsElement.

Kelas PlaceDetailsCompactElement

Class google.maps.places.PlaceDetailsCompactElement

Menampilkan detail tempat dalam tata letak ringkas. Tambahkan PlaceDetailsPlaceRequestElement atau PlaceDetailsLocationRequestElement untuk menentukan tempat yang akan dirender. Tambahkan PlaceContentConfigElement, PlaceStandardContentElement, atau PlaceAllContentElement untuk menentukan konten yang akan dirender.

Contoh:

 <gmp-place-details-compact>
  <gmp-place-details-place-request
    place="PLACE_ID"
  ></gmp-place-details-place-request>
  <gmp-place-content-config>
    <gmp-place-media lightbox-preferred></gmp-place-media>
  </gmp-place-content-config>
</gmp-place-details-compact>

Untuk menggunakan elemen ini, aktifkan Places UI Kit API untuk project Anda di konsol Google Cloud.

Elemen kustom:
<gmp-place-details-compact orientation="vertical" truncation-preferred></gmp-place-details-compact>

Class ini memperluas HTMLElement.

Class ini mengimplementasikan PlaceDetailsCompactElementOptions.

Akses dengan memanggil const {PlaceDetailsCompactElement} = await google.maps.importLibrary("places").
Lihat Library di Maps JavaScript API.

PlaceDetailsCompactElement
PlaceDetailsCompactElement([options])
Parameter: 
orientation
Jenis:  PlaceDetailsOrientation optional
Default: PlaceDetailsOrientation.VERTICAL
Varian orientasi (vertikal atau horizontal) elemen.
Atribut HTML:
  • <gmp-place-details-compact orientation="vertical"></gmp-place-details-compact>
  • <gmp-place-details-compact orientation="horizontal"></gmp-place-details-compact>
place
Jenis:  Place optional
Hanya baca. Objek tempat yang berisi ID, lokasi, dan area tampilan tempat yang saat ini dirender.
truncationPreferred
Jenis:  boolean
Default: false
Jika benar (true), memangkas nama dan alamat tempat agar muat dalam satu baris, bukan dilipat.
Atribut HTML:
  • <gmp-place-details-compact truncation-preferred></gmp-place-details-compact>
--gmp-button-border-color
Warna batas tombol "Buka di Maps".
--gmp-button-border-radius
Radius batas tombol "Buka di Maps".
--gmp-button-border-width
Lebar batas tombol "Buka di Maps".
--gmp-dialog-border-radius
Radius batas dialog pengungkapan Google Maps.
--gmp-mat-color-info
Warna elemen UI dengan sentimen informasi. Digunakan untuk ikon kursi roda.
--gmp-mat-color-negative
Warna elemen UI dengan sentimen negatif. Digunakan untuk teks "Tutup" dalam status buka sekarang.
--gmp-mat-color-neutral-container
Warna penampung untuk elemen UI yang diisi netral. Digunakan untuk placeholder gambar.
--gmp-mat-color-on-secondary-container
Warna teks dan ikon terhadap warna penampung sekunder. Digunakan untuk teks dan ikon pada tombol "Buka di Maps".
--gmp-mat-color-on-surface
Warna untuk teks dan ikon terhadap warna platform apa pun. Digunakan untuk teks biasa.
--gmp-mat-color-on-surface-variant
Warna dengan penekanan lebih rendah untuk teks dan ikon dengan warna permukaan apa pun. Digunakan untuk teks yang kurang ditekankan.
--gmp-mat-color-outline-decorative
Warna garis batas elemen non-interaktif. Digunakan untuk batas elemen.
--gmp-mat-color-positive
Warna elemen UI dengan sentimen positif. Digunakan untuk teks "Buka" dalam status buka sekarang.
--gmp-mat-color-primary
Warna teks dan ikon interaktif terhadap warna permukaan. Digunakan untuk jumlah ulasan, serta link dalam dialog pengungkapan Google Maps.
--gmp-mat-color-secondary-container
Warna pengisi yang kurang terlihat dibandingkan dengan permukaan, untuk komponen resesif seperti tombol tonal. Digunakan untuk latar belakang tombol "Buka di Maps".
--gmp-mat-color-surface
Warna untuk latar belakang. Digunakan untuk latar belakang elemen dan dialog pengungkapan Google Maps.
--gmp-mat-font-body-medium
Digunakan untuk teks isi dalam dialog pengungkapan Google Maps.
--gmp-mat-font-body-small
Digunakan untuk alamat tempat, rating, jenis, harga, dan status buka sekarang.
--gmp-mat-font-family
Jenis font dasar yang digunakan untuk semua teks.
--gmp-mat-font-headline-medium
Digunakan untuk teks judul dalam dialog pengungkapan Google Maps.
--gmp-mat-font-label-large
Digunakan untuk tombol "Buka di Maps" serta link dalam dialog pengungkapan Google Maps dan teks atribusi pengulas di galeri foto.
--gmp-mat-font-label-medium
Digunakan untuk badge jumlah foto.
--gmp-mat-font-title-small
Digunakan untuk nama tempat.
--gmp-mat-spacing-extra-small
Digunakan untuk penspasian dalam elemen, seperti margin dan padding di sekitar teks.
--gmp-mat-spacing-large
Digunakan untuk penspasian dalam elemen, seperti margin dan padding di sekitar teks.
--gmp-mat-spacing-medium
Digunakan untuk penspasian dalam elemen, seperti margin dan padding di sekitar teks.
--gmp-mat-spacing-small
Digunakan untuk penspasian dalam elemen, seperti margin dan padding di sekitar teks.
--gmp-star-rating-color
Warna bintang yang terisi dalam rating.
--gmp-thumbnail-border-radius
Radius batas gambar thumbnail tempat.
background-color
Mengganti warna latar belakang elemen.
border
Menggantikan batas elemen.
border-radius
Mengganti radius batas elemen.
color-scheme
Menunjukkan skema warna yang dapat digunakan untuk merender elemen ini. Lihat dokumentasi color-scheme untuk mengetahui detail selengkapnya. Default-nya adalah color-scheme: light dark.
font-size
Menskalakan semua teks dan ikon dalam elemen, yang ditentukan secara internal dalam em. Default-nya adalah 16px.
addEventListener
addEventListener(type, listener[, options])
Parameter: 
  • typestring String peka huruf besar/kecil yang mewakili jenis peristiwa yang akan diproses.
  • listenerEventListener|EventListenerObject Objek yang menerima notifikasi. Ini harus berupa fungsi atau objek dengan metode handleEvent
  • optionsboolean|AddEventListenerOptions optional Lihat opsi. Peristiwa kustom hanya mendukung capture dan passive.
Nilai yang Ditampilkan:  void
Menyiapkan fungsi yang akan dipanggil setiap kali peristiwa yang ditentukan dikirimkan ke target. Lihat addEventListener.
removeEventListener
removeEventListener(type, listener[, options])
Parameter: 
  • typestring String yang menentukan jenis peristiwa yang pemroses peristiwanya akan dihapus.
  • listenerEventListener|EventListenerObject Pemroses peristiwa dari pengendali peristiwa yang akan dihapus dari target peristiwa.
  • optionsboolean|EventListenerOptions optional Lihat opsi.
Nilai yang Ditampilkan:  void
Menghapus pemroses peristiwa yang sebelumnya didaftarkan dengan addEventListener dari target. Lihat removeEventListener.
gmp-error
function(event)
Argumen: 
Peristiwa ini dipicu saat permintaan ke backend ditolak (misalnya, kunci API salah). Peristiwa ini tidak menggelembung.
gmp-load
function(event)
Argumen: 
Peristiwa ini dipicu saat elemen memuat dan merender kontennya. Peristiwa ini tidak menggelembung.

PlaceDetailsCompactElementOptions interface

google.maps.places.PlaceDetailsCompactElementOptions interface

Opsi untuk PlaceDetailsCompactElement.

orientation optional
Jenis:  PlaceDetailsOrientation optional
truncationPreferred optional
Jenis:  boolean optional

Konstanta PlaceDetailsOrientation

google.maps.places.PlaceDetailsOrientation konstanta

Varian orientasi untuk PlaceDetailsCompactElement.

Akses dengan memanggil const {PlaceDetailsOrientation} = await google.maps.importLibrary("places").
Lihat Library di Maps JavaScript API.

HORIZONTAL Orientasi horizontal.
VERTICAL Orientasi vertikal.

Class PlaceDetailsPlaceRequestElement

Class google.maps.places.PlaceDetailsPlaceRequestElement

Mengonfigurasi PlaceDetailsCompactElement atau PlaceDetailsElement untuk memuat data berdasarkan objek tempat, ID, atau nama resource. Tambahkan elemen ini sebagai turunan PlaceDetailsCompactElement atau PlaceDetailsElement untuk memuat data tempat yang ditentukan. Contoh:

 <gmp-place-details>
  <gmp-place-details-place-request
    place="PLACE_ID"
  ></gmp-place-details-place-request>
</gmp-place-details>

Elemen kustom:
<gmp-place-details-place-request place="some-place-id"></gmp-place-details-place-request>

Class ini memperluas HTMLElement.

Class ini mengimplementasikan PlaceDetailsPlaceRequestElementOptions.

Akses dengan memanggil const {PlaceDetailsPlaceRequestElement} = await google.maps.importLibrary("places").
Lihat Library di Maps JavaScript API.

PlaceDetailsPlaceRequestElement
PlaceDetailsPlaceRequestElement([options])
Parameter: 
place
Jenis:  Place optional
Default: null
Objek tempat, ID, atau nama resource untuk merender detail di elemen Ringkas Detail Tempat. Properti ini mencerminkan atribut sebagai nama resource.
Atribut HTML:
  • <gmp-place-details-place-request place="some-place-id"></gmp-place-details-place-request>
addEventListener
addEventListener(type, listener[, options])
Parameter: 
  • typestring String peka huruf besar/kecil yang mewakili jenis peristiwa yang akan diproses.
  • listenerEventListener|EventListenerObject Objek yang menerima notifikasi. Ini harus berupa fungsi atau objek dengan metode handleEvent
  • optionsboolean|AddEventListenerOptions optional Lihat opsi. Peristiwa kustom hanya mendukung capture dan passive.
Nilai yang Ditampilkan:  void
Menyiapkan fungsi yang akan dipanggil setiap kali peristiwa yang ditentukan dikirimkan ke target. Lihat addEventListener.
removeEventListener
removeEventListener(type, listener[, options])
Parameter: 
  • typestring String yang menentukan jenis peristiwa yang pemroses peristiwanya akan dihapus.
  • listenerEventListener|EventListenerObject Pemroses peristiwa dari pengendali peristiwa yang akan dihapus dari target peristiwa.
  • optionsboolean|EventListenerOptions optional Lihat opsi.
Nilai yang Ditampilkan:  void
Menghapus pemroses peristiwa yang sebelumnya didaftarkan dengan addEventListener dari target. Lihat removeEventListener.

PlaceDetailsPlaceRequestElementOptions interface

google.maps.places.PlaceDetailsPlaceRequestElementOptions interface

Opsi untuk PlaceDetailsPlaceRequestElement.

place optional
Jenis:  Place|string optional

PlaceDetailsLocationRequestElement class

Class google.maps.places.PlaceDetailsLocationRequestElement

Mengonfigurasi PlaceDetailsCompactElement atau PlaceDetailsElement untuk memuat data berdasarkan lokasi. Tambahkan elemen ini sebagai turunan PlaceDetailsCompactElement atau PlaceDetailsElement untuk memuat data untuk lokasi yang ditentukan. Contoh:

 <gmp-place-details>
  <gmp-place-details-location-request
    location="37.6207665,-122.4284806"
  ></gmp-place-details-location-request>
</gmp-place-details>

Elemen kustom:
<gmp-place-details-location-request location="lat,lng"></gmp-place-details-location-request>

Class ini memperluas HTMLElement.

Class ini mengimplementasikan PlaceDetailsLocationRequestElementOptions.

Akses dengan memanggil const {PlaceDetailsLocationRequestElement} = await google.maps.importLibrary("places").
Lihat Library di Maps JavaScript API.

PlaceDetailsLocationRequestElement
PlaceDetailsLocationRequestElement([options])
Parameter: 
location
Default: null
Lokasi untuk merender detail di elemen Place Details. Menormalisasi ke LatLngAltitude.
Atribut HTML:
  • <gmp-place-details-location-request location="lat,lng"></gmp-place-details-location-request>
addEventListener
addEventListener(type, listener[, options])
Parameter: 
  • typestring String peka huruf besar/kecil yang mewakili jenis peristiwa yang akan diproses.
  • listenerEventListener|EventListenerObject Objek yang menerima notifikasi. Ini harus berupa fungsi atau objek dengan metode handleEvent
  • optionsboolean|AddEventListenerOptions optional Lihat opsi. Peristiwa kustom hanya mendukung capture dan passive.
Nilai yang Ditampilkan:  void
Menyiapkan fungsi yang akan dipanggil setiap kali peristiwa yang ditentukan dikirimkan ke target. Lihat addEventListener.
removeEventListener
removeEventListener(type, listener[, options])
Parameter: 
  • typestring String yang menentukan jenis peristiwa yang pemroses peristiwanya akan dihapus.
  • listenerEventListener|EventListenerObject Pemroses peristiwa dari pengendali peristiwa yang akan dihapus dari target peristiwa.
  • optionsboolean|EventListenerOptions optional Lihat opsi.
Nilai yang Ditampilkan:  void
Menghapus pemroses peristiwa yang sebelumnya didaftarkan dengan addEventListener dari target. Lihat removeEventListener.

PlaceDetailsLocationRequestElementOptions interface

google.maps.places.PlaceDetailsLocationRequestElementOptions interface

Opsi untuk PlaceDetailsLocationRequestElement.

location optional
Lokasi untuk merender tempat.

Kelas PlaceSearchElement

Class google.maps.places.PlaceSearchElement

Menampilkan hasil penelusuran tempat dalam daftar. Tambahkan PlaceTextSearchRequestElement atau PlaceNearbySearchRequestElement untuk menentukan permintaan untuk merender hasil. Tambahkan PlaceContentConfigElement, PlaceStandardContentElement, atau PlaceAllContentElement untuk menentukan konten yang akan dirender.

Contoh:

 <gmp-place-search>
  <gmp-place-text-search-request
    text-query="QUERY"
  ></gmp-place-text-search-request>
  <gmp-place-content-config>
    <gmp-place-media lightbox-preferred></gmp-place-media>
  </gmp-place-content-config>
</gmp-place-search>

Untuk menggunakan Elemen Penelusuran Tempat, aktifkan Places UI Kit API untuk project Anda di konsol Google Cloud.

Elemen kustom:
<gmp-place-search attribution-position="top" orientation="vertical" selectable truncation-preferred></gmp-place-search>

Class ini memperluas HTMLElement.

Class ini mengimplementasikan PlaceSearchElementOptions.

Akses dengan memanggil const {PlaceSearchElement} = await google.maps.importLibrary("places").
Lihat Library di Maps JavaScript API.

PlaceSearchElement
PlaceSearchElement([options])
Parameter: 
attributionPosition
Default: PlaceSearchAttributionPosition.TOP
Posisi tombol pengungkapan hukum dan logo atribusi.
Atribut HTML:
  • <gmp-place-search attribution-position="top"></gmp-place-search>
  • <gmp-place-search attribution-position="bottom"></gmp-place-search>
orientation
Jenis:  PlaceSearchOrientation optional
Default: PlaceSearchOrientation.VERTICAL
Varian orientasi (vertikal atau horizontal) elemen.
Atribut HTML:
  • <gmp-place-search orientation="vertical"></gmp-place-search>
  • <gmp-place-search orientation="horizontal"></gmp-place-search>
places
Jenis:  Array<Place>
Hanya baca. Array objek Place yang berisi ID, lokasi, dan area tampilan tempat yang saat ini dirender.
selectable
Jenis:  boolean optional
Default: false
Apakah item daftar dapat dipilih atau tidak. Jika benar, item daftar akan menjadi tombol yang mengirimkan peristiwa gmp-select saat diklik. Navigasi dan pemilihan keyboard yang dapat diakses juga didukung.
Atribut HTML:
  • <gmp-place-search selectable></gmp-place-search>
truncationPreferred
Jenis:  boolean optional
Default: false
Jika benar, akan memotong baris konten tertentu agar pas dalam satu baris, bukan melipatnya.
Atribut HTML:
  • <gmp-place-search truncation-preferred></gmp-place-search>
--gmp-button-border-color
Warna batas untuk tombol "Buka di Maps".
--gmp-button-border-radius
Radius batas untuk tombol "Buka di Maps".
--gmp-button-border-width
Lebar batas untuk tombol "Buka di Maps".
--gmp-card-border-radius
Radius batas untuk kartu tempat.
--gmp-dialog-border-radius
Radius batas untuk dialog pengungkapan Google Maps.
--gmp-mat-color-info
Warna elemen UI dengan sentimen informasi. Digunakan untuk ikon pintu masuk yang dapat diakses.
--gmp-mat-color-negative
Warna elemen UI dengan sentimen negatif. Digunakan untuk label "Tutup" pada jam buka suatu tempat.
--gmp-mat-color-neutral-container
Warna penampung untuk elemen UI yang diisi netral. Digunakan untuk badge tanggal ulasan dan bentuk placeholder pemuatan.
--gmp-mat-color-on-neutral-container
Warna teks dan ikon pada penampung netral. Digunakan untuk teks tanggal ulasan dan teks error pemuatan.
--gmp-mat-color-on-secondary-container
Warna teks dan ikon terhadap warna penampung sekunder. Digunakan untuk teks dan ikon tombol.
--gmp-mat-color-on-surface
Warna untuk teks dan ikon dengan warna platform. Digunakan untuk judul dan konten dialog.
--gmp-mat-color-on-surface-variant
Warna dengan penekanan lebih rendah untuk teks dan ikon dengan warna permukaan. Digunakan untuk informasi tempat.
--gmp-mat-color-outline-decorative
Warna garis batas elemen non-interaktif. Digunakan untuk batas penampung.
--gmp-mat-color-positive
Warna elemen UI dengan sentimen positif. Digunakan untuk label "Buka" untuk jam buka suatu tempat.
--gmp-mat-color-primary
Warna teks dan ikon interaktif terhadap warna permukaan. Digunakan untuk link, indikator pemuatan, dan ikon ringkasan.
--gmp-mat-color-secondary-container
Warna pengisi yang kurang mencolok terhadap permukaan. Digunakan untuk latar belakang tombol.
--gmp-mat-color-surface
Warna untuk latar belakang. Digunakan untuk latar belakang penampung dan dialog.
--gmp-mat-font-body-small
Digunakan untuk informasi tempat.
--gmp-mat-font-family
Jenis font dasar untuk semua teks.
--gmp-mat-font-headline-medium
Digunakan untuk judul dialog.
--gmp-mat-font-label-large
Digunakan untuk konten tombol.
--gmp-mat-font-title-medium
Digunakan untuk nama tempat.
--gmp-mat-spacing-extra-small
Digunakan untuk penspasian dalam elemen, seperti margin dan padding di sekitar teks.
--gmp-mat-spacing-large
Digunakan untuk penspasian dalam elemen, seperti margin dan padding di sekitar teks.
--gmp-mat-spacing-medium
Digunakan untuk penspasian dalam elemen, seperti margin dan padding di sekitar teks.
--gmp-mat-spacing-small
Digunakan untuk penspasian dalam elemen, seperti margin dan padding di sekitar teks.
--gmp-star-rating-color
Warna bintang yang terisi dalam rating bintang.
--gmp-thumbnail-border-radius
Radius batas untuk gambar thumbnail tempat.
background-color
Mengganti warna latar belakang elemen.
border
Menggantikan batas elemen.
border-radius
Mengganti radius batas elemen.
color-scheme
Menunjukkan skema warna yang dapat digunakan untuk merender elemen ini. Lihat dokumentasi color-scheme untuk mengetahui detail selengkapnya. Default-nya adalah color-scheme: light dark.
font-size
Menskalakan semua teks dan ikon dalam elemen. Default-nya adalah 16px.
addEventListener
addEventListener(type, listener[, options])
Parameter: 
  • typestring String peka huruf besar/kecil yang mewakili jenis peristiwa yang akan diproses.
  • listenerEventListener|EventListenerObject Objek yang menerima notifikasi. Ini harus berupa fungsi atau objek dengan metode handleEvent
  • optionsboolean|AddEventListenerOptions optional Lihat opsi. Peristiwa kustom hanya mendukung capture dan passive.
Nilai yang Ditampilkan:  void
Menyiapkan fungsi yang akan dipanggil setiap kali peristiwa yang ditentukan dikirimkan ke target. Lihat addEventListener.
removeEventListener
removeEventListener(type, listener[, options])
Parameter: 
  • typestring String yang menentukan jenis peristiwa yang pemroses peristiwanya akan dihapus.
  • listenerEventListener|EventListenerObject Pemroses peristiwa dari pengendali peristiwa yang akan dihapus dari target peristiwa.
  • optionsboolean|EventListenerOptions optional Lihat opsi.
Nilai yang Ditampilkan:  void
Menghapus pemroses peristiwa yang sebelumnya didaftarkan dengan addEventListener dari target. Lihat removeEventListener.
gmp-error
function(event)
Argumen: 
Peristiwa ini dipicu saat permintaan ke backend ditolak (misalnya, kunci API salah). Peristiwa ini tidak menggelembung.
gmp-load
function(event)
Argumen: 
Peristiwa ini dipicu saat elemen memuat dan merender kontennya. Peristiwa ini tidak menggelembung.
gmp-select
function(event)
Argumen: 
Peristiwa ini diaktifkan saat tempat dipilih dari daftar. Berisi objek Place yang berisi ID, lokasi, dan area tampilan tempat yang dipilih.

PlaceSearchElementOptions interface

google.maps.places.PlaceSearchElementOptions interface

Opsi untuk PlaceSearchElement.

attributionPosition optional
orientation optional
Jenis:  PlaceSearchOrientation optional
selectable optional
Jenis:  boolean optional
truncationPreferred optional
Jenis:  boolean optional

Konstanta PlaceSearchAttributionPosition

google.maps.places.PlaceSearchAttributionPosition konstanta

Posisi atribusi untuk PlaceSearchElement.

Akses dengan memanggil const {PlaceSearchAttributionPosition} = await google.maps.importLibrary("places").
Lihat Library di Maps JavaScript API.

BOTTOM Atribusi di bagian bawah PlaceSearchElement
TOP Atribusi di bagian atas PlaceSearchElement

Konstanta PlaceSearchOrientation

google.maps.places.PlaceSearchOrientation konstanta

Varian orientasi untuk PlaceSearchElement.

Akses dengan memanggil const {PlaceSearchOrientation} = await google.maps.importLibrary("places").
Lihat Library di Maps JavaScript API.

HORIZONTAL Orientasi horizontal.
VERTICAL Orientasi vertikal.

Class PlaceSelectEvent

Class google.maps.places.PlaceSelectEvent

Peristiwa ini diaktifkan saat tempat dipilih dari daftar tempat. Akses pilihan dengan event.place.

Class ini memperluas Event.

Akses dengan memanggil const {PlaceSelectEvent} = await google.maps.importLibrary("places").
Lihat Library di Maps JavaScript API.

place
Jenis:  Place
Tempat yang dipilih.

Class PlaceNearbySearchRequestElement

Class google.maps.places.PlaceNearbySearchRequestElement

Mengonfigurasi PlaceSearchElement untuk memuat hasil berdasarkan permintaan penelusuran di sekitar. Properti locationRestriction diperlukan agar elemen penelusuran dimuat. Properti lain yang dikonfigurasi akan diabaikan jika locationRestriction tidak ditetapkan. Tambahkan elemen ini sebagai turunan PlaceSearchElement untuk memuat hasil. Contoh:

 <gmp-place-search>
  <gmp-place-nearby-search-request
    location-restriction="RADIUS@LAT,LNG"
  ></gmp-place-nearby-search-request>
  <gmp-place-content-config>
    <gmp-place-media lightbox-preferred></gmp-place-media>
  </gmp-place-content-config>
</gmp-place-search>

Elemen kustom:
<gmp-place-nearby-search-request excluded-primary-types="excluded-primary-type1 excluded-primary-type2..." excluded-types="excluded-type1 excluded-type2..." included-primary-types="included-primary-type1 included-primary-type2..." included-types="included-type1 included-type2..." location-restriction="radius@lat,lng" max-result-count="number" rank-preference="preference"></gmp-place-nearby-search-request>

Class ini memperluas HTMLElement.

Class ini mengimplementasikan PlaceNearbySearchRequestElementOptions.

Akses dengan memanggil const {PlaceNearbySearchRequestElement} = await google.maps.importLibrary("places").
Lihat Library di Maps JavaScript API.

PlaceNearbySearchRequestElement
PlaceNearbySearchRequestElement([options])
Parameter: 
excludedPrimaryTypes
Jenis:  Array<string> optional
Default: null
Atribut HTML:
  • <gmp-place-nearby-search-request excluded-primary-types="excluded-primary-type1 excluded-primary-type2..."></gmp-place-nearby-search-request>
excludedTypes
Jenis:  Array<string> optional
Default: null
Atribut HTML:
  • <gmp-place-nearby-search-request excluded-types="excluded-type1 excluded-type2..."></gmp-place-nearby-search-request>
includedPrimaryTypes
Jenis:  Array<string> optional
Default: null
Atribut HTML:
  • <gmp-place-nearby-search-request included-primary-types="included-primary-type1 included-primary-type2..."></gmp-place-nearby-search-request>
includedTypes
Jenis:  Array<string> optional
Default: null
Atribut HTML:
  • <gmp-place-nearby-search-request included-types="included-type1 included-type2..."></gmp-place-nearby-search-request>
locationRestriction
Jenis:  Circle|CircleLiteral optional
Default: null
Atribut HTML:
  • <gmp-place-nearby-search-request location-restriction="radius@lat,lng"></gmp-place-nearby-search-request>
maxResultCount
Jenis:  number optional
Default: null
Atribut HTML:
  • <gmp-place-nearby-search-request max-result-count="number"></gmp-place-nearby-search-request>
rankPreference
Jenis:  SearchNearbyRankPreference optional
Default: null
Atribut HTML:
  • <gmp-place-nearby-search-request rank-preference="preference"></gmp-place-nearby-search-request>
addEventListener
addEventListener(type, listener[, options])
Parameter: 
  • typestring String peka huruf besar/kecil yang mewakili jenis peristiwa yang akan diproses.
  • listenerEventListener|EventListenerObject Objek yang menerima notifikasi. Ini harus berupa fungsi atau objek dengan metode handleEvent
  • optionsboolean|AddEventListenerOptions optional Lihat opsi. Peristiwa kustom hanya mendukung capture dan passive.
Nilai yang Ditampilkan:  void
Menyiapkan fungsi yang akan dipanggil setiap kali peristiwa yang ditentukan dikirimkan ke target. Lihat addEventListener.
removeEventListener
removeEventListener(type, listener[, options])
Parameter: 
  • typestring String yang menentukan jenis peristiwa yang pemroses peristiwanya akan dihapus.
  • listenerEventListener|EventListenerObject Pemroses peristiwa dari pengendali peristiwa yang akan dihapus dari target peristiwa.
  • optionsboolean|EventListenerOptions optional Lihat opsi.
Nilai yang Ditampilkan:  void
Menghapus pemroses peristiwa yang sebelumnya didaftarkan dengan addEventListener dari target. Lihat removeEventListener.

PlaceNearbySearchRequestElementOptions interface

google.maps.places.PlaceNearbySearchRequestElementOptions interface

Opsi untuk PlaceNearbySearchRequestElement.

excludedPrimaryTypes optional
Jenis:  Array<string> optional
Jenis tempat utama yang dikecualikan. Lihat PlaceNearbySearchRequestElement.excludedPrimaryTypes dan SearchNearbyRequest.excludedPrimaryTypes untuk mengetahui detail selengkapnya.
excludedTypes optional
Jenis:  Array<string> optional
Jenis tempat yang dikecualikan. Lihat PlaceNearbySearchRequestElement.excludedTypes dan SearchNearbyRequest.excludedTypes untuk mengetahui detail selengkapnya.
includedPrimaryTypes optional
Jenis:  Array<string> optional
Jenis tempat utama yang disertakan. Lihat PlaceNearbySearchRequestElement.includedPrimaryTypes dan SearchNearbyRequest.includedPrimaryTypes untuk mengetahui detail selengkapnya.
includedTypes optional
Jenis:  Array<string> optional
Jenis tempat yang disertakan. Lihat PlaceNearbySearchRequestElement.includedTypes dan SearchNearbyRequest.includedTypes untuk mengetahui detail selengkapnya.
locationRestriction optional
Jenis:  Circle|CircleLiteral optional
Wilayah yang akan ditelusuri. Lihat PlaceNearbySearchRequestElement.locationRestriction dan SearchNearbyRequest.locationRestriction untuk mengetahui detail selengkapnya.
maxResultCount optional
Jenis:  number optional
Jumlah hasil maksimum yang akan ditampilkan. Lihat PlaceNearbySearchRequestElement.maxResultCount dan SearchNearbyRequest.maxResultCount untuk mengetahui detail selengkapnya.
rankPreference optional
Jenis:  SearchNearbyRankPreference optional
Cara hasil akan diberi peringkat dalam respons. Lihat PlaceNearbySearchRequestElement.rankPreference dan SearchNearbyRankPreference untuk mengetahui detail selengkapnya.

PlaceTextSearchRequestElement class

Class google.maps.places.PlaceTextSearchRequestElement

Mengonfigurasi PlaceSearchElement untuk memuat hasil berdasarkan permintaan penelusuran teks. Properti textQuery diperlukan agar elemen penelusuran dimuat. Properti lain yang dikonfigurasi akan diabaikan jika textQuery tidak ditetapkan. Tambahkan elemen ini sebagai turunan PlaceSearchElement untuk memuat hasil. Contoh:

 <gmp-place-search>
  <gmp-place-text-search-request
    text-query="QUERY"
  ></gmp-place-text-search-request>
  <gmp-place-content-config>
    <gmp-place-media lightbox-preferred></gmp-place-media>
  </gmp-place-content-config>
</gmp-place-search>

Elemen kustom:
<gmp-place-text-search-request ev-connector-types="ev-connector-type1 ev-connector-type2..." ev-minimum-charging-rate-kw="rate" included-type="type" is-open-now="true" location-bias="lat,lng" location-restriction="swlat,swlng|nelat,nelng" max-result-count="number" min-rating="number" price-levels="price-level1 price-level2..." rank-preference="preference" text-query="string" use-strict-type-filtering></gmp-place-text-search-request>

Class ini memperluas HTMLElement.

Class ini mengimplementasikan PlaceTextSearchRequestElementOptions.

Akses dengan memanggil const {PlaceTextSearchRequestElement} = await google.maps.importLibrary("places").
Lihat Library di Maps JavaScript API.

PlaceTextSearchRequestElement
PlaceTextSearchRequestElement([options])
Parameter: 
evConnectorTypes
Jenis:  Array<EVConnectorType> optional
Default: null
Atribut HTML:
  • <gmp-place-text-search-request ev-connector-types="ev-connector-type1 ev-connector-type2..."></gmp-place-text-search-request>
evMinimumChargingRateKw
Jenis:  number optional
Default: null
Atribut HTML:
  • <gmp-place-text-search-request ev-minimum-charging-rate-kw="rate"></gmp-place-text-search-request>
includedType
Jenis:  string optional
Default: null
Atribut HTML:
  • <gmp-place-text-search-request included-type="type"></gmp-place-text-search-request>
isOpenNow
Jenis:  boolean optional
Default: null
Atribut HTML:
  • <gmp-place-text-search-request is-open-now="true"></gmp-place-text-search-request>
locationBias
Default: null
Atribut HTML:
  • <gmp-place-text-search-request location-bias="lat,lng"></gmp-place-text-search-request>
  • <gmp-place-text-search-request location-bias="lat,lng[,altitude]"></gmp-place-text-search-request>
  • <gmp-place-text-search-request location-bias="swlat,swlng|nelat,nelng"></gmp-place-text-search-request>
  • <gmp-place-text-search-request location-bias="radius@lat,lng"></gmp-place-text-search-request>
  • <gmp-place-text-search-request location-bias="IP_BIAS"></gmp-place-text-search-request>
locationRestriction
Default: null
Atribut HTML:
  • <gmp-place-text-search-request location-restriction="swlat,swlng|nelat,nelng"></gmp-place-text-search-request>
maxResultCount
Jenis:  number optional
Default: null
Atribut HTML:
  • <gmp-place-text-search-request max-result-count="number"></gmp-place-text-search-request>
minRating
Jenis:  number optional
Default: null
Atribut HTML:
  • <gmp-place-text-search-request min-rating="number"></gmp-place-text-search-request>
priceLevels
Jenis:  Array<PriceLevel> optional
Default: null
Atribut HTML:
  • <gmp-place-text-search-request price-levels="price-level1 price-level2..."></gmp-place-text-search-request>
rankPreference
Jenis:  SearchByTextRankPreference optional
Default: null
Atribut HTML:
  • <gmp-place-text-search-request rank-preference="preference"></gmp-place-text-search-request>
textQuery
Jenis:  string optional
Default: null
Atribut HTML:
  • <gmp-place-text-search-request text-query="string"></gmp-place-text-search-request>
useStrictTypeFiltering
Jenis:  boolean optional
Default: null
Atribut HTML:
  • <gmp-place-text-search-request use-strict-type-filtering></gmp-place-text-search-request>
addEventListener
addEventListener(type, listener[, options])
Parameter: 
  • typestring String peka huruf besar/kecil yang mewakili jenis peristiwa yang akan diproses.
  • listenerEventListener|EventListenerObject Objek yang menerima notifikasi. Ini harus berupa fungsi atau objek dengan metode handleEvent
  • optionsboolean|AddEventListenerOptions optional Lihat opsi. Peristiwa kustom hanya mendukung capture dan passive.
Nilai yang Ditampilkan:  void
Menyiapkan fungsi yang akan dipanggil setiap kali peristiwa yang ditentukan dikirimkan ke target. Lihat addEventListener.
removeEventListener
removeEventListener(type, listener[, options])
Parameter: 
  • typestring String yang menentukan jenis peristiwa yang pemroses peristiwanya akan dihapus.
  • listenerEventListener|EventListenerObject Pemroses peristiwa dari pengendali peristiwa yang akan dihapus dari target peristiwa.
  • optionsboolean|EventListenerOptions optional Lihat opsi.
Nilai yang Ditampilkan:  void
Menghapus pemroses peristiwa yang sebelumnya didaftarkan dengan addEventListener dari target. Lihat removeEventListener.

PlaceTextSearchRequestElementOptions interface

google.maps.places.PlaceTextSearchRequestElementOptions interface

Opsi untuk PlaceTextSearchRequestElement.

evConnectorTypes optional
Jenis:  Array<EVConnectorType> optional
Daftar jenis konektor EV pilihan. Lihat SearchByTextRequest.evSearchOptions dan PlaceTextSearchRequestElement.evConnectorTypes untuk mengetahui detail selengkapnya.
evMinimumChargingRateKw optional
Jenis:  number optional
Kecepatan pengisian daya minimum yang diperlukan dalam kilowatt. Lihat SearchByTextRequest.evSearchOptions dan PlaceTextSearchRequestElement.evMinimumChargingRateKw untuk mengetahui detail selengkapnya.
includedType optional
Jenis:  string optional
Jenis tempat yang diminta. Lihat SearchByTextRequest.includedType dan PlaceTextSearchRequestElement.includedType untuk mengetahui detail selengkapnya.
isOpenNow optional
Jenis:  boolean optional
Digunakan untuk membatasi penelusuran ke tempat yang saat ini buka. Lihat SearchByTextRequest.isOpenNow dan PlaceTextSearchRequestElement.isOpenNow untuk mengetahui detail selengkapnya.
locationBias optional
Bias lokasi untuk penelusuran. Lihat SearchByTextRequest.locationBias dan PlaceTextSearchRequestElement.locationBias untuk mengetahui detail selengkapnya.
locationRestriction optional
Pembatasan lokasi untuk penelusuran. Lihat SearchByTextRequest.locationRestriction dan PlaceTextSearchRequestElement.locationRestriction untuk mengetahui detail selengkapnya.
maxResultCount optional
Jenis:  number optional
Jumlah hasil maksimum yang akan ditampilkan. Lihat SearchByTextRequest.maxResultCount dan PlaceTextSearchRequestElement.maxResultCount untuk mengetahui detail selengkapnya.
minRating optional
Jenis:  number optional
Memfilter hasil yang rating pengguna rata-ratanya kurang dari batas ini. Lihat SearchByTextRequest.minRating dan PlaceTextSearchRequestElement.minRating untuk mengetahui detail selengkapnya.
priceLevels optional
Jenis:  Array<PriceLevel> optional
Digunakan untuk membatasi penelusuran ke tempat yang ditandai sebagai tingkat harga tertentu. Lihat SearchByTextRequest.priceLevels dan PlaceTextSearchRequestElement.priceLevels untuk mengetahui detail selengkapnya.
rankPreference optional
Jenis:  SearchByTextRankPreference optional
Cara hasil akan diberi peringkat dalam respons. Lihat SearchByTextRequest.rankPreference dan PlaceTextSearchRequestElement.rankPreference untuk mengetahui detail selengkapnya.
textQuery optional
Jenis:  string optional
Kueri teks untuk penelusuran tekstual. Lihat SearchByTextRequest.textQuery dan PlaceTextSearchRequestElement.textQuery untuk mengetahui detail selengkapnya.
useStrictTypeFiltering optional
Jenis:  boolean optional
Digunakan untuk menyetel pemfilteran jenis ketat untuk SearchByTextRequest.includedType. Lihat SearchByTextRequest.useStrictTypeFiltering dan PlaceTextSearchRequestElement.useStrictTypeFiltering untuk mengetahui detail selengkapnya.

Autocomplete class

Class google.maps.places.Autocomplete

Widget yang memberikan prediksi Tempat berdasarkan input teks pengguna. Objek ini dilampirkan ke elemen input jenis text, dan memproses entri teks di kolom tersebut. Daftar prediksi ditampilkan sebagai daftar 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 yang Ditampilkan:  LatLngBounds|undefined Batas bias.
Menampilkan batas tempat prediksi dibiaskan.
getFields
getFields()
Parameter:  Tidak ada
Nilai yang Ditampilkan:  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 yang Ditampilkan:  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 yang ditetapkan ke nilai kolom input saat ini.
setBounds
setBounds(bounds)
Parameter: 
Nilai yang Ditampilkan:  Tidak Ada
Menetapkan area pilihan untuk menampilkan hasil Tempat. Hasilnya dicondongkan ke, tetapi tidak terbatas pada, area ini.
setComponentRestrictions
setComponentRestrictions(restrictions)
Parameter: 
Nilai yang Ditampilkan:  Tidak Ada
Menetapkan batasan komponen. Pembatasan komponen digunakan untuk membatasi prediksi hanya pada prediksi dalam komponen induk. Misalnya, negara.
setFields
setFields(fields)
Parameter: 
  • fieldsArray<string> optional
Nilai yang Ditampilkan:  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: 
Nilai yang Ditampilkan:  Tidak Ada
setTypes
setTypes(types)
Parameter: 
  • typesArray<string> optional Jenis prediksi yang akan disertakan.
Nilai yang Ditampilkan:  Tidak Ada
Menetapkan jenis prediksi yang akan ditampilkan. Untuk 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 telah dipilih pengguna.
Jika pengguna memasukkan nama Tempat yang tidak disarankan oleh kontrol dan menekan tombol Enter, atau jika permintaan Detail Tempat gagal, PlaceResult akan berisi input pengguna dalam properti name, tanpa properti lain yang ditentukan.

Antarmuka AutocompleteOptions

google.maps.places.AutocompleteOptions interface

Opsi yang dapat ditetapkan pada objek Autocomplete.

bounds optional
Area untuk menelusuri tempat.
componentRestrictions optional
Jenis:  ComponentRestrictions optional
Batasan komponen. Pembatasan komponen digunakan untuk membatasi prediksi hanya pada prediksi 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 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
Jenis:  boolean optional
Apakah hanya mengambil ID Tempat. PlaceResult yang tersedia saat peristiwa place_changed diaktifkan hanya akan memiliki kolom place_id, types, dan name, dengan place_id, types, dan description 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.
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 ditampilkan.

Class google.maps.places.SearchBox

Widget yang memberikan prediksi kueri berdasarkan input teks pengguna. Objek ini dilampirkan ke elemen input jenis text, dan memproses entri teks di kolom tersebut. Daftar prediksi ditampilkan sebagai daftar 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 yang Ditampilkan:  LatLngBounds|undefined
Menampilkan batas yang menjadi bias prediksi kueri.
getPlaces
getPlaces()
Parameter:  Tidak ada
Nilai yang Ditampilkan:  Array<PlaceResult>|undefined
Menampilkan kueri yang dipilih oleh pengguna untuk digunakan dengan peristiwa places_changed.
setBounds
setBounds(bounds)
Parameter: 
Nilai yang Ditampilkan:  Tidak Ada
Menetapkan region yang akan digunakan untuk memengaruhi prediksi kueri. Hasil hanya akan dicondongkan ke area ini dan tidak sepenuhnya dibatasi untuk area ini.
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.

SearchBoxOptions interface

google.maps.places.SearchBoxOptions interface

Opsi yang dapat ditetapkan pada objek SearchBox.

bounds optional
Area yang akan memengaruhi prediksi kueri. Prediksi dibiaskan terhadap, tetapi tidak terbatas pada, kueri yang menargetkan batas ini.