AutocompleteSuggestion
google.maps.places.AutocompleteSuggestion
class
library "places"
Hasil saran Pelengkapan Otomatis.
const {AutocompleteSuggestion} = await google.maps.importLibrary("places");
Metode Statis | |
|---|---|
fetchAutocompleteSuggestions |
fetchAutocompleteSuggestions(autocompleteRequest)Parameter:
Nilai Hasil:
Promise<{suggestions:Array<AutocompleteSuggestion>}>Mengambil daftar AutocompleteSuggestions. Jika AutocompleteRequest.sessionToken diberikan dalam permintaan, token sesi tersebut akan otomatis disertakan saat memanggil Place.fetchFields untuk pertama kalinya, pada setiap Place yang ditampilkan oleh PlacePrediction.toPlace pada PlacePrediction yang dihasilkan. |
Properti | |
|---|---|
placePrediction
readonly |
Jenis:
PlacePrediction optionalBerisi nama yang dapat dibaca manusia untuk hasil yang ditampilkan. Untuk hasil tempat usaha, biasanya ini adalah nama dan alamat bisnis. Jika AutocompleteRequest.sessionToken diberikan dalam AutocompleteRequest yang digunakan untuk mengambil AutocompleteSuggestion ini, token yang sama akan otomatis disertakan saat memanggil Place.fetchFields untuk pertama kalinya di Place yang ditampilkan oleh panggilan ke PlacePrediction.toPlace. |
Antarmuka AutocompleteRequest
Antarmuka
google.maps.places.AutocompleteRequest
Antarmuka permintaan untuk AutocompleteSuggestion.fetchAutocompleteSuggestions.
Properti | |
|---|---|
input |
Jenis:
stringString teks yang akan ditelusuri. |
futureOpeningBusinessesIncluded
opsional |
Jenis:
boolean optionalSertakan prediksi tempat untuk bisnis yang belum buka, tetapi diperkirakan akan buka pada masa mendatang. |
includedPrimaryTypes
opsional |
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. |
includedRegionCodes
opsional |
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. |
inputOffset
opsional |
Jenis:
number optionalOffset karakter Unicode berbasis nol dari input yang menunjukkan posisi kursor di input. Posisi kursor dapat memengaruhi prediksi yang ditampilkan. Jika tidak ditentukan, setelan defaultnya adalah panjang input. |
language
opsional |
Jenis:
string optionalBahasa yang digunakan untuk menampilkan hasil. Akan ditetapkan secara default ke preferensi bahasa browser. Hasilnya mungkin dalam bahasa campuran jika bahasa yang digunakan di input berbeda dengan language, atau jika Tempat yang ditampilkan tidak memiliki terjemahan dari bahasa lokal ke language. |
locationBias
opsional |
Jenis:
LocationBias optionalMembiaskan hasil ke lokasi yang ditentukan. Maksimal satu dari locationBias atau locationRestriction yang harus ditetapkan. Jika keduanya tidak ditetapkan, hasil akan dibiaskan berdasarkan alamat IP, yang berarti alamat IP akan dipetakan ke lokasi yang tidak akurat dan digunakan sebagai sinyal pembiasan. |
locationRestriction
opsional |
Jenis:
LocationRestriction optionalMembatasi hasil ke lokasi yang ditentukan. Maksimal satu dari locationBias atau locationRestriction yang harus ditetapkan. Jika keduanya tidak ditetapkan, hasil akan dibiaskan berdasarkan alamat IP, yang berarti alamat IP akan dipetakan ke lokasi yang tidak akurat dan digunakan sebagai sinyal pembiasan. |
origin
opsional |
Jenis:
LatLng|LatLngLiteral optionalTitik awal untuk menghitung jarak geodesi ke tujuan (ditampilkan sebagai PlacePrediction.distanceMeters). Jika nilai ini dihilangkan, jarak geodesi tidak akan ditampilkan. |
pureServiceAreaBusinessesIncluded
opsional |
Jenis:
boolean optionalSertakan bisnis jasa sistem panggilan murni jika kolom ditetapkan ke true. Bisnis jasa sistem panggilan murni adalah bisnis yang melakukan kunjungan atau pengiriman ke pelanggan secara langsung, tetapi tidak melayani pelanggan di alamat bisnisnya. Misalnya, bisnis seperti layanan kebersihan atau tukang leding mungkin tidak memiliki alamat atau lokasi fisik di Google Maps. |
region
opsional |
Jenis:
string optionalKode wilayah, yang ditentukan sebagai kode wilayah dua karakter CLDR. Hal ini memengaruhi pemformatan alamat, peringkat hasil, dan dapat memengaruhi hasil yang ditampilkan. Tindakan ini tidak membatasi hasil ke wilayah yang ditentukan. |
sessionToken
opsional |
Jenis:
AutocompleteSessionToken optionalToken yang mengidentifikasi sesi Autocomplete untuk tujuan penagihan. Buat token sesi baru melalui AutocompleteSessionToken. Sesi dimulai saat pengguna mulai mengetik kueri, dan berakhir saat pengguna memilih tempat dan memanggil Place.fetchFields. Setiap sesi dapat memiliki beberapa kueri, yang diikuti dengan satu panggilan fetchFields. Kredensial yang digunakan untuk setiap permintaan dalam sesi harus berasal dari project Konsol Google Cloud yang sama. Setelah sesi selesai, token tidak lagi valid; aplikasi Anda harus membuat token baru untuk setiap sesi. Jika parameter sessionToken dihilangkan, atau jika Anda menggunakan kembali token sesi, sesi tersebut dikenai biaya seolah-olah tidak ada token sesi yang diberikan (setiap permintaan ditagih secara terpisah). Jika token sesi diberikan dalam permintaan ke AutocompleteSuggestion.fetchAutocompleteSuggestions, token yang sama akan otomatis disertakan dalam panggilan pertama ke fetchFields pada Place yang ditampilkan dengan memanggil PlacePrediction.toPlace di salah satu AutocompleteSuggestion yang dihasilkan. Sebaiknya ikuti panduan berikut:
|
Class AutocompleteSessionToken
google.maps.places.AutocompleteSessionToken
class
library "places"
Mewakili token sesi yang digunakan untuk melacak sesi pelengkapan otomatis.
const {AutocompleteSessionToken} = await google.maps.importLibrary("places");
Konstruktor | |
|---|---|
AutocompleteSessionToken |
AutocompleteSessionToken()Parameter: Tidak ada
Membuat instance baru AutocompleteSessionToken. |
Class PlacePrediction
google.maps.places.PlacePrediction
class
library "places"
Hasil prediksi pelengkapan otomatis untuk Place Autocomplete.
const {PlacePrediction} = await google.maps.importLibrary("places");
Properti | |
|---|---|
distanceMeters
readonly |
Jenis:
number optionalPanjang geodesi dalam meter dari origin jika origin ditentukan. |
mainText
readonly |
Jenis:
FormattableText optionalMenampilkan nama Tempat. |
placeId
readonly |
Jenis:
stringID unik Tempat yang disarankan. ID ini dapat digunakan di API lain yang menerima ID Tempat. |
secondaryText
readonly |
Jenis:
FormattableText optionalMenampilkan fitur disambiguasi tambahan (seperti kota atau wilayah) untuk mengidentifikasi Tempat lebih lanjut. |
text
readonly |
Jenis:
FormattableTextBerisi nama yang dapat dibaca manusia untuk hasil yang ditampilkan. Untuk hasil tempat usaha, biasanya ini adalah nama dan alamat bisnis. text direkomendasikan untuk developer yang ingin menampilkan satu elemen UI. Developer yang ingin menampilkan dua elemen UI yang terpisah, tetapi terkait, dapat menggunakan PlacePrediction.mainText dan PlacePrediction.secondaryText. |
types
readonly |
Jenis:
Array<string>Daftar jenis yang berlaku untuk Tempat ini dari Tabel A atau Tabel B di https://developers.google.com/maps/documentation/places/web-service/place-types. |
Metode | |
|---|---|
|
fetchAddressValidation(request)Parameter:
Nilai Hasil:
Promise<AddressValidation>Mengirim permintaan Validasi Alamat yang terkait dengan sesi pelengkapan otomatis ini (mengisi permintaan secara internal dengan token sesi pelengkapan otomatis). Tidak ada informasi tempat dari PlacePrediction yang disertakan secara otomatis - ini adalah metode praktis untuk membantu pengelolaan sesi pelengkapan otomatis. |
toPlace |
toPlace()Parameter: Tidak ada
Nilai Hasil:
PlaceMenampilkan representasi Place dari PlacePrediction ini. Panggilan berikutnya ke Place.fetchFields diperlukan untuk mendapatkan detail Tempat lengkap. Jika AutocompleteRequest.sessionToken diberikan dalam AutocompleteRequest yang digunakan untuk mengambil PlacePrediction ini, token yang sama akan otomatis disertakan saat memanggil fetchFields. Atau, saat menggunakan PlaceAutocompleteElement, panggilan pertama ke Place.fetchFields pada Place yang ditampilkan oleh PlacePrediction.toPlace akan otomatis menyertakan token sesi. |
Class StringRange
google.maps.places.StringRange
class
library "places"
Mengidentifikasi substring dalam teks tertentu.
const {StringRange} = await google.maps.importLibrary("places");
Properti | |
|---|---|
endOffset
readonly |
Jenis:
numberOffset berbasis nol dari karakter Unicode terakhir substring (eksklusif). |
startOffset
readonly |
Jenis:
numberOffset berbasis nol dari karakter Unicode pertama substring (inklusif). |
Class FormattableText
google.maps.places.FormattableText
class
library "places"
Teks yang merepresentasikan prediksi Tempat. Teks dapat digunakan apa adanya atau diformat.
const {FormattableText} = await google.maps.importLibrary("places");
Properti | |
|---|---|
matches
readonly |
Jenis:
Array<StringRange>Daftar rentang string yang mengidentifikasi tempat permintaan input cocok di FormattableText.text. Rentang dapat digunakan untuk memformat bagian tertentu dari text. Substring mungkin bukan pencocokan persis dari AutocompleteRequest.input jika pencocokan ditentukan oleh kriteria selain pencocokan string (misalnya, koreksi ejaan atau transliterasi). Nilai ini adalah offset karakter Unicode dari FormattableText.text. Rentang dijamin akan diurutkan dalam nilai offset yang meningkat. |
text
readonly |
Jenis:
stringTeks yang dapat digunakan apa adanya atau diformat dengan FormattableText.matches. |