Autocomplete Data (new)

AutocompleteSuggestion class

Class google.maps.places.AutocompleteSuggestion

Hasil saran pelengkapan otomatis.

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

Metode Statis

fetchAutocompleteSuggestions

fetchAutocompleteSuggestions(autocompleteRequest) Parameter:  autocompleteRequest:  AutocompleteRequest Nilai yang Ditampilkan:  Promise<{suggestions:Array<AutocompleteSuggestion>}> Mengambil daftar AutocompleteSuggestion. 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

Jenis:  PlacePrediction optional Berisi nama yang mudah dibaca untuk hasil yang ditampilkan. Untuk hasil tempat, 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

google.maps.places.AutocompleteRequest interface

Antarmuka permintaan untuk AutocompleteSuggestion.fetchAutocompleteSuggestions.

Properti
input	Jenis:  string String teks yang akan ditelusuri.
includedPrimaryTypes optional	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.
includedRegionCodes optional	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.
inputOffset optional	Jenis:  number optional Offset karakter Unicode berbasis nol dari input yang menunjukkan posisi kursor di input. Posisi kursor dapat memengaruhi prediksi yang ditampilkan. Jika tidak ditentukan, nilai defaultnya adalah panjang input.
language optional	Jenis:  string optional Bahasa yang digunakan untuk menampilkan hasil. Secara default akan menggunakan 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 optional	Jenis:  LocationBias optional Membiaskan hasil ke lokasi yang ditentukan. Maksimal salah satu dari locationBias atau locationRestriction harus ditetapkan. Jika keduanya tidak ditetapkan, hasilnya akan dipengaruhi oleh alamat IP, yang berarti alamat IP akan dipetakan ke lokasi yang tidak akurat dan digunakan sebagai sinyal bias.
locationRestriction optional	Jenis:  LocationRestriction optional Membatasi hasil ke lokasi tertentu. Maksimal salah satu dari locationBias atau locationRestriction harus ditetapkan. Jika keduanya tidak ditetapkan, hasilnya akan dipengaruhi oleh alamat IP, yang berarti alamat IP akan dipetakan ke lokasi yang tidak akurat dan digunakan sebagai sinyal bias.
origin optional	Jenis:  LatLng|LatLngLiteral optional Titik asal untuk menghitung jarak geodetik ke tujuan (ditampilkan sebagai PlacePrediction.distanceMeters). Jika nilai ini tidak ada, jarak geodetik tidak akan ditampilkan.
region optional	Jenis:  string optional Kode wilayah, yang ditentukan sebagai kode wilayah dua karakter CLDR. Hal ini memengaruhi pemformatan alamat, peringkat hasil, dan dapat memengaruhi hasil yang ditampilkan. Hal ini tidak membatasi hasil ke wilayah yang ditentukan.
sessionToken optional	Jenis:  AutocompleteSessionToken optional Token yang mengidentifikasi sesi Pelengkapan Otomatis 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 pada salah satu AutocompleteSuggestion yang dihasilkan. Sebaiknya ikuti panduan berikut: Gunakan token sesi untuk semua panggilan Place Autocomplete. Buat token baru untuk setiap sesi. Pastikan untuk meneruskan token sesi yang unik untuk setiap sesi baru. Jika menggunakan token yang sama untuk lebih dari satu sesi, setiap permintaan akan ditagih satu per satu.

Class AutocompleteSessionToken

Class google.maps.places.AutocompleteSessionToken

Mewakili token sesi yang digunakan untuk melacak sesi pelengkapan otomatis.

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

Konstruktor
AutocompleteSessionToken	AutocompleteSessionToken() Parameter:  Tidak ada Membuat instance baru AutocompleteSessionToken.

Class PlacePrediction

Class google.maps.places.PlacePrediction

Hasil prediksi untuk prediksi Place Autocomplete.

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

Properti
distanceMeters	Jenis:  number optional Panjang geodesi dalam meter dari origin jika origin ditentukan.
mainText	Jenis:  FormattableText optional Mewakili nama Tempat.
placeId	Jenis:  string ID unik Tempat yang disarankan. ID ini dapat digunakan di API lain yang menerima ID Tempat.
secondaryText	Jenis:  FormattableText optional Mewakili fitur tambahan yang memperjelas (seperti kota atau wilayah) untuk mengidentifikasi Tempat lebih lanjut.
text	Jenis:  FormattableText Berisi nama yang mudah dibaca untuk hasil yang ditampilkan. Untuk hasil tempat, 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, mungkin ingin menggunakan PlacePrediction.mainText dan PlacePrediction.secondaryText sebagai gantinya.
types	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	Pemberitahuan: Hanya tersedia di saluran v=beta. fetchAddressValidation(request) Parameter:  request:  AddressValidationRequest Nilai yang Ditampilkan:  Tidak Ada Mengirim permintaan Validasi Alamat yang terkait dengan sesi pelengkapan otomatis ini (secara internal mengisi permintaan dengan token sesi pelengkapan otomatis). Tidak ada informasi tempat dari PlacePrediction yang disertakan secara otomatis - ini adalah metode praktis untuk membantu pengelolaan sesi autocomplete.
toPlace	toPlace() Parameter:  Tidak ada Nilai yang Ditampilkan:  Place Menampilkan representasi Place dari PlacePrediction ini. Panggilan selanjutnya 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

Class google.maps.places.StringRange

Mengidentifikasi substring dalam teks tertentu.

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

Properti
endOffset	Jenis:  number Offset berbasis nol dari karakter Unicode terakhir substring (eksklusif).
startOffset	Jenis:  number Offset berbasis nol dari karakter Unicode pertama substring (inklusif).

Class FormattableText

Class google.maps.places.FormattableText

Teks yang merepresentasikan prediksi Tempat. Teks dapat digunakan apa adanya atau diformat.

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

Properti
matches	Jenis:  Array<StringRange> Daftar rentang string yang mengidentifikasi tempat permintaan input cocok dalam 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 diurutkan dalam nilai offset yang meningkat.
text	Jenis:  string Teks yang dapat digunakan apa adanya atau diformat dengan FormattableText.matches.