Class PlaceAutocompleteElement
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.
Konstruktor | |
|---|---|
PlaceAutocompleteElement |
PlaceAutocompleteElement(options)Parameter:
|
Properti | |
|---|---|
includedPrimaryTypes |
Jenis:
Array<string> optionalJenis tempat utama yang disertakan (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:
|
includedRegionCodes |
Jenis:
Array<string> optionalHanya menyertakan hasil di wilayah yang ditentukan, yang ditentukan sebagai maksimal 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:
|
locationBias |
Jenis:
LocationBias optionalBatas atau petunjuk yang tidak ketat untuk digunakan saat menelusuri tempat. |
locationRestriction |
Jenis:
LocationRestriction optionalBatas untuk membatasi hasil penelusuran. |
name |
Jenis:
string optionalNama 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:
|
origin |
Jenis:
LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optionalAsal untuk menghitung jarak. Jika tidak ditentukan, jarak tidak akan dihitung. Ketinggian, jika diberikan, tidak digunakan dalam penghitungan.
Atribut HTML:
|
placeholder |
Jenis:
stringTeks placeholder yang akan ditampilkan di elemen input. |
requestedLanguage |
Jenis:
string optionalID bahasa untuk bahasa yang akan digunakan untuk menampilkan hasil, jika memungkinkan. Hasil dalam bahasa yang dipilih mungkin diberi peringkat yang lebih tinggi, tetapi saran tidak dibatasi untuk bahasa ini. Lihat daftar bahasa yang didukung.
Atribut HTML:
|
requestedRegion |
Jenis:
string optionalKode wilayah yang digunakan untuk pemformatan hasil dan pemfilteran hasil. Parameter ini tidak membatasi saran hanya untuk 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:
|
unitSystem |
Jenis:
UnitSystem optionalSistem satuan yang digunakan untuk menampilkan jarak. Jika tidak ditentukan, sistem unit ditentukan oleh requestedRegion.
Atribut HTML:
|
value |
Jenis:
stringNilai elemen input. |
Slot | |
|---|---|
prediction-item-icon |
Slot ini menerima tepat satu elemen <template> untuk dirender sebagai ikon yang ditampilkan di samping item prediksi. |
Suku cadang | |
|---|---|
input |
Elemen input untuk elemen pelengkapan otomatis. |
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 dari prediction-item 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 membukanya melalui keyboard. Catatan: Item yang dipilih akan terpengaruh oleh gaya bagian ini dan juga gaya bagian prediction-item. |
prediction-list |
Elemen visual berisi daftar prediksi yang dikembalikan oleh layanan Place Autocomplete. Daftar ini muncul sebagai menu dropdown di bawah PlaceAutocompleteElement. |
Properti CSS | |
|---|---|
background-color |
Mengganti warna latar belakang elemen. |
border |
Mengganti batas elemen. |
border-radius |
Mengganti radius batas elemen. |
color |
Mengganti font 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 |
Mengganti font elemen. |
font-family |
Mengganti font elemen. |
font-size |
Mengganti font elemen. |
font-style |
Mengganti font elemen. |
font-weight |
Mengganti font elemen. |
line-height |
Mengganti font elemen. |
Metode | |
|---|---|
addEventListener |
addEventListener(type, listener[, options])Parameter:
Nilai Hasil:
voidMenyiapkan fungsi yang akan dipanggil setiap kali peristiwa yang ditentukan dikirim ke target. Lihat addEventListener. |
removeEventListener |
removeEventListener(type, listener[, options])Parameter:
Nilai Hasil:
voidMenghapus pemroses peristiwa yang sebelumnya didaftarkan dengan addEventListener dari target. Lihat removeEventListener. |
Acara | |
|---|---|
gmp-error |
function(errorEvent)Argumen:
Peristiwa ini diaktifkan 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. |
Antarmuka PlaceAutocompleteElementOptions
Antarmuka
google.maps.places.PlaceAutocompleteElementOptions
Opsi untuk membuat PlaceAutocompleteElement. Untuk deskripsi setiap properti, lihat properti dengan nama yang sama di class PlaceAutocompleteElement.
Properti | |
|---|---|
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 |
Jenis:
LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional |
requestedLanguage optional |
Jenis:
string optional |
requestedRegion optional |
Jenis:
string optional |
unitSystem optional |
Jenis:
UnitSystem optional |
value optional |
Jenis:
string optionalNilai elemen input. |
Class PlacePredictionSelectEvent
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.
Properti | |
|---|---|
placePrediction |
Jenis:
PlacePredictionKonversikan ini menjadi Place dengan memanggil PlacePrediction.toPlace. |
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.
Konstruktor | |
|---|---|
BasicPlaceAutocompleteElement |
BasicPlaceAutocompleteElement(options)Parameter:
|
Properti | |
|---|---|
includedPrimaryTypes |
Jenis:
Array<string> optionalJenis tempat utama yang disertakan (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:
|
includedRegionCodes |
Jenis:
Array<string> optionalHanya menyertakan hasil di wilayah yang ditentukan, yang ditentukan sebagai maksimal 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:
|
locationBias |
Jenis:
LocationBias optionalBatas atau petunjuk yang tidak ketat untuk digunakan saat menelusuri tempat. |
locationRestriction |
Jenis:
LocationRestriction optionalBatas untuk membatasi hasil penelusuran. |
name |
Jenis:
string optionalNama 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:
|
origin |
Jenis:
LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optionalAsal untuk menghitung jarak. Jika tidak ditentukan, jarak tidak akan dihitung. Ketinggian, jika diberikan, tidak digunakan dalam penghitungan.
Atribut HTML:
|
requestedLanguage |
Jenis:
string optionalID bahasa untuk bahasa yang akan digunakan untuk menampilkan hasil, jika memungkinkan. Hasil dalam bahasa yang dipilih mungkin diberi peringkat yang lebih tinggi, tetapi saran tidak dibatasi untuk bahasa ini. Lihat daftar bahasa yang didukung.
Atribut HTML:
|
requestedRegion |
Jenis:
string optionalKode wilayah yang digunakan untuk pemformatan hasil dan pemfilteran hasil. Parameter ini tidak membatasi saran hanya untuk 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:
|
unitSystem |
Jenis:
UnitSystem optionalSistem satuan yang digunakan untuk menampilkan jarak. Jika tidak ditentukan, sistem unit ditentukan oleh requestedRegion.
Atribut HTML:
|
Slot | |
|---|---|
prediction-item-icon |
Slot ini menerima tepat satu elemen <template> untuk dirender sebagai ikon yang ditampilkan di samping item prediksi. |
Suku cadang | |
|---|---|
input |
Elemen input untuk elemen pelengkapan otomatis. |
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 dari prediction-item 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 membukanya melalui keyboard. Catatan: Item yang dipilih akan terpengaruh oleh gaya bagian ini dan juga gaya bagian prediction-item. |
prediction-list |
Elemen visual berisi daftar prediksi yang dikembalikan oleh layanan Place Autocomplete. Daftar ini muncul sebagai menu dropdown di bawah PlaceAutocompleteElement. |
Properti CSS | |
|---|---|
background-color |
Mengganti warna latar belakang elemen. |
border |
Mengganti batas elemen. |
border-radius |
Mengganti radius batas elemen. |
color |
Mengganti font 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 |
Mengganti font elemen. |
font-family |
Mengganti font elemen. |
font-size |
Mengganti font elemen. |
font-style |
Mengganti font elemen. |
font-weight |
Mengganti font elemen. |
line-height |
Mengganti font elemen. |
Metode | |
|---|---|
addEventListener |
addEventListener(type, listener[, options])Parameter:
Nilai Hasil:
voidMenyiapkan fungsi yang akan dipanggil setiap kali peristiwa yang ditentukan dikirim ke target. Lihat addEventListener. |
removeEventListener |
removeEventListener(type, listener[, options])Parameter:
Nilai Hasil:
voidMenghapus pemroses peristiwa yang sebelumnya didaftarkan dengan addEventListener dari target. Lihat removeEventListener. |
Acara | |
|---|---|
gmp-error |
function(errorEvent)Argumen:
Peristiwa ini diaktifkan 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
Antarmuka
google.maps.places.BasicPlaceAutocompleteElementOptions
Opsi untuk membuat BasicPlaceAutocompleteElement.
Properti | |
|---|---|
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 |
Jenis:
LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional |
requestedLanguage optional |
Jenis:
string optional |
requestedRegion optional |
Jenis:
string optional |
unitSystem optional |
Jenis:
UnitSystem optional |
Class 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.
Konstruktor | |
|---|---|
PlaceDetailsElement |
PlaceDetailsElement([options])Parameter:
|
Properti | |
|---|---|
place |
Jenis:
Place optionalHanya baca. Objek Place yang berisi ID, lokasi, dan area pandang tempat yang saat ini dirender. |
Properti CSS | |
|---|---|
--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 nonaktif 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 warna 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 saat 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 yang kontras dengan warna penampung sekunder. Digunakan untuk teks dan ikon pada tombol "Buka di Maps". |
--gmp-mat-color-on-surface |
Warna untuk teks dan ikon yang kontras dengan warna permukaan apa pun. Digunakan untuk teks biasa. |
--gmp-mat-color-on-surface-variant |
Warna dengan penekanan lebih rendah untuk teks dan ikon pada warna permukaan apa pun. Digunakan untuk teks yang kurang ditekankan. |
--gmp-mat-color-outline-decorative |
Warna garis tepi 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 platform. Digunakan untuk jumlah ulasan, link dalam dialog pengungkapan Google Maps, link situs, ikon di tab ringkasan, dan (arahkan kursor/fokus/warna teks) pada judul bilah tab. |
--gmp-mat-color-secondary-container |
Warna pengisi yang kurang terlihat pada 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, rating, jenis, harga, status buka sekarang, jam buka, ulasan, nomor telepon, situs, plus code, fitur teratas, dan teks isi tempat di 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 ulasan dipublikasikan. |
--gmp-mat-font-title-small |
Digunakan untuk judul setiap bagian di tab 'Tentang'. |
--gmp-mat-spacing-extra-large |
Digunakan untuk pengaturan jarak dalam elemen, seperti margin dan padding di sekitar teks. |
--gmp-mat-spacing-extra-small |
Digunakan untuk pengaturan jarak dalam elemen, seperti margin dan padding di sekitar teks. |
--gmp-mat-spacing-large |
Digunakan untuk pengaturan jarak dalam elemen, seperti margin dan padding di sekitar teks. |
--gmp-mat-spacing-medium |
Digunakan untuk pengaturan jarak dalam elemen, seperti margin dan padding di sekitar teks. |
--gmp-mat-spacing-small |
Digunakan untuk pengaturan jarak dalam elemen, seperti margin dan padding di sekitar teks. |
--gmp-mat-spacing-two-extra-large |
Digunakan untuk pengaturan jarak 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 |
Mengganti 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. |
Metode | |
|---|---|
addEventListener |
addEventListener(type, listener[, options])Parameter:
Nilai Hasil:
voidMenyiapkan fungsi yang akan dipanggil setiap kali peristiwa yang ditentukan dikirim ke target. Lihat addEventListener. |
removeEventListener |
removeEventListener(type, listener[, options])Parameter:
Nilai Hasil:
voidMenghapus pemroses peristiwa yang sebelumnya didaftarkan dengan addEventListener dari target. Lihat removeEventListener. |
Acara | |
|---|---|
gmp-error |
function(event)Argumen:
Peristiwa ini diaktifkan saat permintaan ke backend ditolak (misalnya, kunci API salah). Peristiwa ini tidak menggelembung. |
gmp-load |
function(event)Argumen:
Peristiwa ini diaktifkan saat elemen memuat dan merender kontennya. Peristiwa ini tidak menggelembung. |
Antarmuka PlaceDetailsElementOptions
Antarmuka
google.maps.places.PlaceDetailsElementOptions
Opsi untuk PlaceDetailsElement.
Class PlaceDetailsCompactElement
Class
google.maps.places.PlaceDetailsCompactElement
Menampilkan detail tempat dalam tata letak yang 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.
Konstruktor | |
|---|---|
PlaceDetailsCompactElement |
PlaceDetailsCompactElement([options])Parameter:
|
Properti | |
|---|---|
orientation |
Jenis:
PlaceDetailsOrientation optionalDefault:
PlaceDetailsOrientation.VERTICALVarian orientasi (vertikal atau horizontal) elemen.
Atribut HTML:
|
place |
Jenis:
Place optionalHanya baca. Objek Place yang berisi ID, lokasi, dan area pandang tempat yang saat ini dirender. |
truncationPreferred |
Jenis:
booleanDefault:
falseJika benar, potong nama dan alamat tempat agar pas dalam satu baris, bukan digabungkan.
Atribut HTML:
|
Properti CSS | |
|---|---|
--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 warna netral. Digunakan untuk placeholder gambar. |
--gmp-mat-color-on-secondary-container |
Warna teks dan ikon yang kontras dengan warna penampung sekunder. Digunakan untuk teks dan ikon pada tombol "Buka di Maps". |
--gmp-mat-color-on-surface |
Warna untuk teks dan ikon yang kontras dengan warna permukaan apa pun. Digunakan untuk teks biasa. |
--gmp-mat-color-on-surface-variant |
Warna dengan penekanan lebih rendah untuk teks dan ikon pada warna permukaan apa pun. Digunakan untuk teks yang kurang ditekankan. |
--gmp-mat-color-outline-decorative |
Warna garis tepi 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 platform. Digunakan untuk jumlah ulasan, serta link dalam dialog pengungkapan Google Maps. |
--gmp-mat-color-secondary-container |
Warna pengisi yang kurang terlihat pada 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, rating, jenis, harga, dan status buka sekarang dari tempat. |
--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 pengaturan jarak dalam elemen, seperti margin dan padding di sekitar teks. |
--gmp-mat-spacing-large |
Digunakan untuk pengaturan jarak dalam elemen, seperti margin dan padding di sekitar teks. |
--gmp-mat-spacing-medium |
Digunakan untuk pengaturan jarak dalam elemen, seperti margin dan padding di sekitar teks. |
--gmp-mat-spacing-small |
Digunakan untuk pengaturan jarak 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 |
Mengganti 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. |
Metode | |
|---|---|
addEventListener |
addEventListener(type, listener[, options])Parameter:
Nilai Hasil:
voidMenyiapkan fungsi yang akan dipanggil setiap kali peristiwa yang ditentukan dikirim ke target. Lihat addEventListener. |
removeEventListener |
removeEventListener(type, listener[, options])Parameter:
Nilai Hasil:
voidMenghapus pemroses peristiwa yang sebelumnya didaftarkan dengan addEventListener dari target. Lihat removeEventListener. |
Acara | |
|---|---|
gmp-error |
function(event)Argumen:
Peristiwa ini diaktifkan saat permintaan ke backend ditolak (misalnya, kunci API salah). Peristiwa ini tidak menggelembung. |
gmp-load |
function(event)Argumen:
Peristiwa ini diaktifkan saat elemen memuat dan merender kontennya. Peristiwa ini tidak menggelembung. |
Antarmuka PlaceDetailsCompactElementOptions
Antarmuka
google.maps.places.PlaceDetailsCompactElementOptions
Opsi untuk PlaceDetailsCompactElement.
Properti | |
|---|---|
orientation optional |
Jenis:
PlaceDetailsOrientation optional |
truncationPreferred optional |
Jenis:
boolean optional |
Konstanta PlaceDetailsOrientation
Konstanta
google.maps.places.PlaceDetailsOrientation
Varian orientasi untuk PlaceDetailsCompactElement.
Akses dengan memanggil const {PlaceDetailsOrientation} = await google.maps.importLibrary("places").
Lihat Library di Maps JavaScript API.
Konstanta | |
|---|---|
HORIZONTAL |
Orientasi horizontal. |
VERTICAL |
Orientasi vertikal. |
PlaceDetailsPlaceRequestElement
Class
google.maps.places.PlaceDetailsPlaceRequestElement
Mengonfigurasi PlaceDetailsCompactElement atau PlaceDetailsElement untuk memuat data berdasarkan objek, ID, atau nama resource tempat. Tambahkan elemen ini sebagai turunan dari 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.
Konstruktor | |
|---|---|
PlaceDetailsPlaceRequestElement |
PlaceDetailsPlaceRequestElement([options])Parameter:
|
Properti | |
|---|---|
place |
Jenis:
Place optionalDefault:
nullObjek, ID, atau nama resource tempat untuk merender detail di elemen Place Details Compact. Properti ini mencerminkan atribut sebagai nama resource.
Atribut HTML:
|
Metode | |
|---|---|
addEventListener |
addEventListener(type, listener[, options])Parameter:
Nilai Hasil:
voidMenyiapkan fungsi yang akan dipanggil setiap kali peristiwa yang ditentukan dikirim ke target. Lihat addEventListener. |
removeEventListener |
removeEventListener(type, listener[, options])Parameter:
Nilai Hasil:
voidMenghapus pemroses peristiwa yang sebelumnya didaftarkan dengan addEventListener dari target. Lihat removeEventListener. |
Antarmuka PlaceDetailsPlaceRequestElementOptions
Antarmuka
google.maps.places.PlaceDetailsPlaceRequestElementOptions
Opsi untuk PlaceDetailsPlaceRequestElement.
Properti | |
|---|---|
place optional |
Jenis:
Place|string optional |
Class PlaceDetailsLocationRequestElement
Class
google.maps.places.PlaceDetailsLocationRequestElement
Mengonfigurasi PlaceDetailsCompactElement atau PlaceDetailsElement untuk memuat data berdasarkan lokasi. Tambahkan elemen ini sebagai turunan dari PlaceDetailsCompactElement atau PlaceDetailsElement untuk memuat data 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.
Konstruktor | |
|---|---|
PlaceDetailsLocationRequestElement |
PlaceDetailsLocationRequestElement([options])Parameter:
|
Properti | |
|---|---|
location |
Jenis:
LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optionalDefault:
nullLokasi yang akan dirender detailnya di elemen Place Details. Menormalisasi ke
LatLngAltitude.Atribut HTML:
|
Metode | |
|---|---|
addEventListener |
addEventListener(type, listener[, options])Parameter:
Nilai Hasil:
voidMenyiapkan fungsi yang akan dipanggil setiap kali peristiwa yang ditentukan dikirim ke target. Lihat addEventListener. |
removeEventListener |
removeEventListener(type, listener[, options])Parameter:
Nilai Hasil:
voidMenghapus pemroses peristiwa yang sebelumnya didaftarkan dengan addEventListener dari target. Lihat removeEventListener. |
PlaceDetailsLocationRequestElementOptions
Antarmuka
google.maps.places.PlaceDetailsLocationRequestElementOptions
Opsi untuk PlaceDetailsLocationRequestElement.
Properti | |
|---|---|
location optional |
Jenis:
LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optionalLokasi untuk merender tempat. |
Class PlaceSearchElement
Class
google.maps.places.PlaceSearchElement
Menampilkan hasil penelusuran tempat dalam daftar. Tambahkan PlaceTextSearchRequestElement atau PlaceNearbySearchRequestElement untuk menentukan permintaan yang akan dirender hasilnya. 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 Place Search, 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.
Konstruktor | |
|---|---|
PlaceSearchElement |
PlaceSearchElement([options])Parameter:
|
Properti | |
|---|---|
attributionPosition |
Jenis:
PlaceSearchAttributionPosition optionalDefault:
PlaceSearchAttributionPosition.TOPPosisi logo atribusi dan tombol pengungkapan informasi berdasarkan hukum.
Atribut HTML:
|
orientation |
Jenis:
PlaceSearchOrientation optionalDefault:
PlaceSearchOrientation.VERTICALVarian orientasi (vertikal atau horizontal) elemen.
Atribut HTML:
|
places |
Hanya baca. Array objek Place yang berisi ID, lokasi, dan area pandang tempat yang saat ini dirender. |
selectable |
Jenis:
boolean optionalDefault:
falseApakah item daftar dapat dipilih atau tidak. Jika benar, item daftar akan berupa tombol yang mengirimkan peristiwa
gmp-select saat diklik. Navigasi dan pemilihan keyboard yang mudah diakses juga didukung.Atribut HTML:
|
truncationPreferred |
Jenis:
boolean optionalDefault:
falseJika benar, memotong baris konten tertentu agar pas dalam satu baris, bukan menggulungnya.
Atribut HTML:
|
Properti CSS | |
|---|---|
--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 warna 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 yang kontras dengan warna platform. Digunakan untuk judul dan konten dialog. |
--gmp-mat-color-on-surface-variant |
Warna dengan penekanan lebih rendah untuk teks dan ikon pada warna platform. Digunakan untuk informasi tempat. |
--gmp-mat-color-outline-decorative |
Warna garis tepi elemen non-interaktif. Digunakan untuk batas penampung. |
--gmp-mat-color-positive |
Warna elemen UI dengan sentimen positif. Digunakan untuk label "Buka" pada jam buka suatu tempat. |
--gmp-mat-color-primary |
Warna teks dan ikon interaktif terhadap warna platform. Digunakan untuk link, indikator pemuatan, dan ikon ringkasan. |
--gmp-mat-color-secondary-container |
Warna pengisi yang kurang terlihat pada 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 pengaturan jarak dalam elemen, seperti margin dan padding di sekitar teks. |
--gmp-mat-spacing-large |
Digunakan untuk pengaturan jarak dalam elemen, seperti margin dan padding di sekitar teks. |
--gmp-mat-spacing-medium |
Digunakan untuk pengaturan jarak dalam elemen, seperti margin dan padding di sekitar teks. |
--gmp-mat-spacing-small |
Digunakan untuk pengaturan jarak 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 |
Mengganti 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. |
Metode | |
|---|---|
addEventListener |
addEventListener(type, listener[, options])Parameter:
Nilai Hasil:
voidMenyiapkan fungsi yang akan dipanggil setiap kali peristiwa yang ditentukan dikirim ke target. Lihat addEventListener. |
removeEventListener |
removeEventListener(type, listener[, options])Parameter:
Nilai Hasil:
voidMenghapus pemroses peristiwa yang sebelumnya didaftarkan dengan addEventListener dari target. Lihat removeEventListener. |
Acara | |
|---|---|
gmp-error |
function(event)Argumen:
Peristiwa ini diaktifkan saat permintaan ke backend ditolak (misalnya, kunci API salah). Peristiwa ini tidak menggelembung. |
gmp-load |
function(event)Argumen:
Peristiwa ini diaktifkan 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 pandang tempat yang dipilih. |
Antarmuka PlaceSearchElementOptions
Antarmuka
google.maps.places.PlaceSearchElementOptions
Opsi untuk PlaceSearchElement.
Properti | |
|---|---|
attributionPosition optional |
Jenis:
PlaceSearchAttributionPosition optional |
orientation optional |
Jenis:
PlaceSearchOrientation optional |
selectable optional |
Jenis:
boolean optional |
truncationPreferred optional |
Jenis:
boolean optional |
PlaceSearchAttributionPosition konstanta
Konstanta
google.maps.places.PlaceSearchAttributionPosition
Posisi atribusi untuk PlaceSearchElement.
Akses dengan memanggil const {PlaceSearchAttributionPosition} = await google.maps.importLibrary("places").
Lihat Library di Maps JavaScript API.
Konstanta | |
|---|---|
BOTTOM |
Atribusi di bagian bawah PlaceSearchElement |
TOP |
Atribusi di bagian atas PlaceSearchElement |
Konstanta PlaceSearchOrientation
Konstanta
google.maps.places.PlaceSearchOrientation
Varian orientasi untuk PlaceSearchElement.
Akses dengan memanggil const {PlaceSearchOrientation} = await google.maps.importLibrary("places").
Lihat Library di Maps JavaScript API.
Konstanta | |
|---|---|
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.
Properti | |
|---|---|
place |
Jenis:
PlaceTempat yang dipilih. |
Class PlaceNearbySearchRequestElement
Class
google.maps.places.PlaceNearbySearchRequestElement
Mengonfigurasi PlaceSearchElement untuk memuat hasil berdasarkan permintaan Nearby Search. Properti locationRestriction diperlukan agar elemen penelusuran dapat dimuat. Properti lain yang dikonfigurasi akan diabaikan jika locationRestriction tidak ditetapkan. Tambahkan elemen ini sebagai turunan dari 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.
Konstruktor | |
|---|---|
PlaceNearbySearchRequestElement |
PlaceNearbySearchRequestElement([options])Parameter:
|
Properti | |
|---|---|
excludedPrimaryTypes |
Jenis:
Array<string> optionalDefault:
nullJenis tempat utama yang dikecualikan.
Atribut HTML:
|
excludedTypes |
Jenis:
Array<string> optionalDefault:
nullJenis tempat yang dikecualikan.
Atribut HTML:
|
includedPrimaryTypes |
Jenis:
Array<string> optionalDefault:
nullJenis tempat utama yang disertakan.
Atribut HTML:
|
includedTypes |
Jenis:
Array<string> optionalDefault:
nullJenis tempat yang disertakan.
Atribut HTML:
|
locationRestriction |
Jenis:
Circle|CircleLiteral optionalDefault:
nullWilayah yang akan ditelusuri. Menormalisasi ke
Circle.Atribut HTML:
|
maxResultCount |
Jenis:
number optionalDefault:
nullJumlah hasil maksimum yang akan ditampilkan.
Atribut HTML:
|
rankPreference |
Jenis:
SearchNearbyRankPreference optionalDefault:
nullCara hasil akan diberi peringkat dalam respons.
Atribut HTML:
|
Metode | |
|---|---|
addEventListener |
addEventListener(type, listener[, options])Parameter:
Nilai Hasil:
voidMenyiapkan fungsi yang akan dipanggil setiap kali peristiwa yang ditentukan dikirim ke target. Lihat addEventListener. |
removeEventListener |
removeEventListener(type, listener[, options])Parameter:
Nilai Hasil:
voidMenghapus pemroses peristiwa yang sebelumnya didaftarkan dengan addEventListener dari target. Lihat removeEventListener. |
Antarmuka PlaceNearbySearchRequestElementOptions
Antarmuka
google.maps.places.PlaceNearbySearchRequestElementOptions
Opsi untuk PlaceNearbySearchRequestElement.
Properti | |
|---|---|
excludedPrimaryTypes optional |
Jenis:
Array<string> optionalJenis tempat utama yang dikecualikan. Lihat PlaceNearbySearchRequestElement.excludedPrimaryTypes dan SearchNearbyRequest.excludedPrimaryTypes untuk mengetahui detail selengkapnya. |
excludedTypes optional |
Jenis:
Array<string> optionalJenis tempat yang dikecualikan. Lihat PlaceNearbySearchRequestElement.excludedTypes dan SearchNearbyRequest.excludedTypes untuk mengetahui detail selengkapnya. |
includedPrimaryTypes optional |
Jenis:
Array<string> optionalJenis tempat utama yang disertakan. Lihat PlaceNearbySearchRequestElement.includedPrimaryTypes dan SearchNearbyRequest.includedPrimaryTypes untuk mengetahui detail selengkapnya. |
includedTypes optional |
Jenis:
Array<string> optionalJenis tempat yang disertakan. Lihat PlaceNearbySearchRequestElement.includedTypes dan SearchNearbyRequest.includedTypes untuk mengetahui detail selengkapnya. |
locationRestriction optional |
Jenis:
Circle|CircleLiteral optionalWilayah yang akan ditelusuri. Lihat PlaceNearbySearchRequestElement.locationRestriction dan SearchNearbyRequest.locationRestriction untuk mengetahui detail selengkapnya. |
maxResultCount optional |
Jenis:
number optionalJumlah hasil maksimum yang akan ditampilkan. Lihat PlaceNearbySearchRequestElement.maxResultCount dan SearchNearbyRequest.maxResultCount untuk mengetahui detail selengkapnya. |
rankPreference optional |
Jenis:
SearchNearbyRankPreference optionalCara hasil akan diberi peringkat dalam respons. Lihat PlaceNearbySearchRequestElement.rankPreference dan SearchNearbyRankPreference untuk mengetahui detail selengkapnya. |
Class PlaceTextSearchRequestElement
Class
google.maps.places.PlaceTextSearchRequestElement
Mengonfigurasi PlaceSearchElement untuk memuat hasil berdasarkan permintaan penelusuran teks. Properti textQuery diperlukan agar elemen penelusuran dapat dimuat. Properti lain yang dikonfigurasi akan diabaikan jika textQuery tidak ditetapkan. Tambahkan elemen ini sebagai turunan dari 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.
Konstruktor | |
|---|---|
PlaceTextSearchRequestElement |
PlaceTextSearchRequestElement([options])Parameter:
|
Properti | |
|---|---|
evConnectorTypes |
Jenis:
Array<EVConnectorType> optionalDefault:
nullDaftar jenis konektor EV yang diinginkan.
Atribut HTML:
|
evMinimumChargingRateKw |
Jenis:
number optionalDefault:
nullKecepatan pengisian daya minimum yang diperlukan dalam kilowatt.
Atribut HTML:
|
includedType |
Jenis:
string optionalDefault:
nullJenis tempat yang diminta.
Atribut HTML:
|
isOpenNow |
Jenis:
boolean optionalDefault:
nullDigunakan untuk membatasi penelusuran ke tempat-tempat yang saat ini buka.
Atribut HTML:
|
locationBias |
Jenis:
LocationBias optionalDefault:
nullBias lokasi untuk penelusuran. Menormalisasi ke
LatLngAltitude | LatLngBounds | Circle | string.Atribut HTML:
|
locationRestriction |
Jenis:
LatLngBounds|LatLngBoundsLiteral optionalDefault:
nullPembatasan lokasi untuk penelusuran. Menormalisasi ke
LatLngBounds.Atribut HTML:
|
maxResultCount |
Jenis:
number optionalDefault:
nullJumlah hasil maksimum yang akan ditampilkan.
Atribut HTML:
|
minRating |
Jenis:
number optionalDefault:
nullMemfilter hasil yang rating pengguna rata-ratanya benar-benar kurang dari batas ini.
Atribut HTML:
|
priceLevels |
Jenis:
Array<PriceLevel> optionalDefault:
nullDigunakan untuk membatasi penelusuran ke tempat yang ditandai sebagai tingkat harga tertentu.
Atribut HTML:
|
rankPreference |
Jenis:
SearchByTextRankPreference optionalDefault:
nullCara hasil akan diberi peringkat dalam respons.
Atribut HTML:
|
textQuery |
Jenis:
string optionalDefault:
nullKueri teks untuk penelusuran tekstual.
Atribut HTML:
|
useStrictTypeFiltering |
Jenis:
boolean optionalDefault:
nullDigunakan untuk menetapkan pemfilteran jenis yang ketat untuk 'includedType'.
Atribut HTML:
|
Metode | |
|---|---|
addEventListener |
addEventListener(type, listener[, options])Parameter:
Nilai Hasil:
voidMenyiapkan fungsi yang akan dipanggil setiap kali peristiwa yang ditentukan dikirim ke target. Lihat addEventListener. |
removeEventListener |
removeEventListener(type, listener[, options])Parameter:
Nilai Hasil:
voidMenghapus pemroses peristiwa yang sebelumnya didaftarkan dengan addEventListener dari target. Lihat removeEventListener. |
Antarmuka PlaceTextSearchRequestElementOptions
Antarmuka
google.maps.places.PlaceTextSearchRequestElementOptions
Opsi untuk PlaceTextSearchRequestElement.
Properti | |
|---|---|
evConnectorTypes optional |
Jenis:
Array<EVConnectorType> optionalDaftar jenis konektor EV yang diinginkan. Lihat SearchByTextRequest.evSearchOptions dan PlaceTextSearchRequestElement.evConnectorTypes untuk mengetahui detail selengkapnya. |
evMinimumChargingRateKw optional |
Jenis:
number optionalKecepatan pengisian daya minimum yang diperlukan dalam kilowatt. Lihat SearchByTextRequest.evSearchOptions dan PlaceTextSearchRequestElement.evMinimumChargingRateKw untuk mengetahui detail selengkapnya. |
includedType optional |
Jenis:
string optionalJenis tempat yang diminta. Lihat SearchByTextRequest.includedType dan PlaceTextSearchRequestElement.includedType untuk mengetahui detail selengkapnya. |
isOpenNow optional |
Jenis:
boolean optionalDigunakan untuk membatasi penelusuran ke tempat-tempat yang saat ini buka. Lihat SearchByTextRequest.isOpenNow dan PlaceTextSearchRequestElement.isOpenNow untuk mengetahui detail selengkapnya. |
locationBias optional |
Jenis:
LocationBias optionalBias lokasi untuk penelusuran. Lihat SearchByTextRequest.locationBias dan PlaceTextSearchRequestElement.locationBias untuk mengetahui detail selengkapnya. |
locationRestriction optional |
Jenis:
LatLngBounds|LatLngBoundsLiteral optionalPembatasan lokasi untuk penelusuran. Lihat SearchByTextRequest.locationRestriction dan PlaceTextSearchRequestElement.locationRestriction untuk mengetahui detail selengkapnya. |
maxResultCount optional |
Jenis:
number optionalJumlah hasil maksimum yang akan ditampilkan. Lihat SearchByTextRequest.maxResultCount dan PlaceTextSearchRequestElement.maxResultCount untuk mengetahui detail selengkapnya. |
minRating optional |
Jenis:
number optionalMemfilter hasil yang rating pengguna rata-ratanya benar-benar kurang dari batas ini. Lihat SearchByTextRequest.minRating dan PlaceTextSearchRequestElement.minRating untuk mengetahui detail selengkapnya. |
priceLevels optional |
Jenis:
Array<PriceLevel> optionalDigunakan 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 optionalCara hasil akan diberi peringkat dalam respons. Lihat SearchByTextRequest.rankPreference dan PlaceTextSearchRequestElement.rankPreference untuk mengetahui detail selengkapnya. |
textQuery optional |
Jenis:
string optionalKueri teks untuk penelusuran tekstual. Lihat SearchByTextRequest.textQuery dan PlaceTextSearchRequestElement.textQuery untuk mengetahui detail selengkapnya. |
useStrictTypeFiltering optional |
Jenis:
boolean optionalDigunakan untuk menetapkan pemfilteran jenis yang ketat untuk SearchByTextRequest.includedType. Lihat SearchByTextRequest.useStrictTypeFiltering dan PlaceTextSearchRequestElement.useStrictTypeFiltering untuk mengetahui detail selengkapnya. |
Class Autocomplete
Class
google.maps.places.Autocomplete
Widget yang memberikan prediksi Tempat berdasarkan input teks pengguna. Widget ini terhubung 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:
Membuat instance baru Autocomplete yang dilampirkan ke kolom teks input yang ditentukan dengan opsi yang diberikan. |
Metode | |
|---|---|
getBounds |
getBounds()Parameter: Tidak ada
Nilai yang Ditampilkan:
LatLngBounds|undefined Batas bias.Menampilkan batas yang menjadi bias prediksi. |
getFields |
getFields()Parameter: Tidak ada
Nilai Hasil:
Array<string>|undefinedMenampilkan 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, metode ini akan menampilkan objek Place stub, dengan properti name yang ditetapkan ke nilai kolom input saat ini. |
setBounds |
setBounds(bounds)Parameter:
Nilai Hasil: Tidak ada
Menetapkan area pilihan untuk menampilkan hasil Tempat. Hasilnya dicondongkan ke, tetapi tidak terbatas pada, area ini. |
setComponentRestrictions |
setComponentRestrictions(restrictions)Parameter:
Nilai Hasil: Tidak ada
Menetapkan batasan komponen. Batasan komponen digunakan untuk membatasi prediksi hanya pada prediksi yang ada dalam komponen induk. Misalnya, negara. |
setFields |
setFields(fields)Parameter:
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:
Nilai Hasil: Tidak ada
|
setTypes |
setTypes(types)Parameter:
Nilai Hasil: Tidak ada
Menetapkan jenis prediksi yang akan ditampilkan. Untuk jenis yang didukung, lihat panduan developer. Jika tidak ada jenis yang ditentukan, semua jenis akan ditampilkan. |
Diwarisi:
addListener,
bindTo,
get,
notify,
set,
setValues,
unbind,
unbindAll
| |
Acara | |
|---|---|
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 Place Details gagal, PlaceResult akan berisi input pengguna di properti name, tanpa properti lain yang ditentukan. |
Antarmuka AutocompleteOptions
Antarmuka
google.maps.places.AutocompleteOptions
Opsi yang dapat ditetapkan pada objek Autocomplete.
Properti | |
|---|---|
bounds optional |
Jenis:
LatLngBounds|LatLngBoundsLiteral optionalArea untuk menelusuri tempat. |
componentRestrictions optional |
Jenis:
ComponentRestrictions optionalBatasan komponen. Batasan komponen digunakan untuk membatasi prediksi hanya pada prediksi yang ada dalam komponen induk. Misalnya, negara. |
fields optional |
Jenis:
Array<string> optionalKolom 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']. |
|
Jenis:
boolean optionalApakah 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 optionalNilai 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 dibiaskan terhadap, tetapi tidak terbatas pada, tempat yang berada dalam batas. |
types optional |
Jenis:
Array<string> optionalJenis prediksi yang akan ditampilkan. Untuk jenis yang didukung, lihat panduan developer. Jika tidak ada jenis yang ditentukan, semua jenis akan ditampilkan. |
Class SearchBox
Class
google.maps.places.SearchBox
Widget yang memberikan prediksi kueri berdasarkan input teks pengguna. Widget ini terhubung 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:
Membuat instance baru SearchBox yang dilampirkan ke kolom teks input yang ditentukan dengan opsi yang diberikan. |
Metode | |
|---|---|
getBounds |
getBounds()Parameter: Tidak ada
Nilai Hasil:
LatLngBounds|undefinedMenampilkan batas yang menjadi bias prediksi kueri. |
getPlaces |
getPlaces()Parameter: Tidak ada
Nilai Hasil:
Array<PlaceResult>|undefinedMenampilkan 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. Hasil hanya akan dibiaskan ke area ini dan tidak sepenuhnya dibatasi ke area tersebut. |
Diwarisi:
addListener,
bindTo,
get,
notify,
set,
setValues,
unbind,
unbindAll
| |
Acara | |
|---|---|
places_changed |
function()Argumen: Tidak ada
Peristiwa ini diaktifkan saat pengguna memilih kueri, getPlaces harus digunakan untuk mendapatkan tempat baru. |
Antarmuka SearchBoxOptions
Antarmuka
google.maps.places.SearchBoxOptions
Opsi yang dapat ditetapkan pada objek SearchBox.
Properti | |
|---|---|
bounds optional |
Jenis:
LatLngBounds|LatLngBoundsLiteral optionalArea yang menjadi bias prediksi kueri. Prediksi akan dicondongkan ke, tetapi tidak terbatas pada, kueri yang menargetkan batas ini. |
Class PlaceContextualElement
Class
google.maps.places.PlaceContextualElement
Widget yang menggunakan token konteks untuk menampilkan Tampilan Kontekstual dari respons Grounding with 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.
Konstruktor | |
|---|---|
PlaceContextualElement |
PlaceContextualElement([options])Parameter:
|
Properti | |
|---|---|
contextToken |
Jenis:
string optionalToken konteks.
Atribut HTML:
|
Metode | |
|---|---|
addEventListener |
addEventListener(type, listener[, options])Parameter:
Nilai Hasil:
voidMenyiapkan fungsi yang akan dipanggil setiap kali peristiwa yang ditentukan dikirim ke target. Lihat addEventListener. |
removeEventListener |
removeEventListener(type, listener[, options])Parameter:
Nilai Hasil:
voidMenghapus pemroses peristiwa yang sebelumnya didaftarkan dengan addEventListener dari target. Lihat removeEventListener. |
Antarmuka PlaceContextualElementOptions
Antarmuka
google.maps.places.PlaceContextualElementOptions
Opsi untuk PlaceContextualElement.
Properti | |
|---|---|
contextToken optional |
Jenis:
string optionalToken konteks yang diberikan oleh respons Grounding with Google Maps. |
Class PlaceContextualListConfigElement
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></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.
Konstruktor | |
|---|---|
PlaceContextualListConfigElement |
PlaceContextualListConfigElement([options])Parameter:
|
Properti | |
|---|---|
layout |
Jenis:
PlaceContextualListLayout optionalTata letak.
Atribut HTML:
|
mapHidden |
Jenis:
boolean optionalApakah peta disembunyikan.
Atribut HTML:
|
Metode | |
|---|---|
addEventListener |
addEventListener(type, listener[, options])Parameter:
Nilai Hasil:
voidMenyiapkan fungsi yang akan dipanggil setiap kali peristiwa yang ditentukan dikirim ke target. Lihat addEventListener. |
removeEventListener |
removeEventListener(type, listener[, options])Parameter:
Nilai Hasil:
voidMenghapus pemroses peristiwa yang sebelumnya didaftarkan dengan addEventListener dari target. Lihat removeEventListener. |
Antarmuka PlaceContextualListConfigElementOptions
Antarmuka
google.maps.places.PlaceContextualListConfigElementOptions
Opsi untuk PlaceContextualListConfigElement.
Properti | |
|---|---|
layout optional |
Jenis:
PlaceContextualListLayout optionalDefault:
PlaceContextualListLayout.VERTICALTata letak. |
mapHidden optional |
Jenis:
boolean optionalDefault:
falseTrue jika peta harus disembunyikan. |
PlaceContextualListLayout
Konstanta
google.maps.places.PlaceContextualListLayout
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.
Konstanta | |
|---|---|
COMPACT |
Tata letak daftar rapat: item daftar dirender sebagai link di satu baris, dengan item tambahan dalam menu dropdown. |
VERTICAL |
Tata letak daftar vertikal: item daftar dirender sebagai kartu dalam daftar vertikal. |