Autocomplete Data (new)

Antarmuka AutocompleteRequest

Antarmuka google.maps.places.AutocompleteRequest

Meminta antarmuka untuk AutocompleteSuggestion.fetchAutocompleteSuggestions.
input
Jenis:  string
String teks yang akan ditelusuri.
includedPrimaryTypes optional
Jenis:  Array<string> optional
Menyertakan Jenis tempat utama (misalnya, "restaurant" atau "gas_station").

Tempat hanya ditampilkan jika jenis utamanya disertakan dalam daftar ini. Maksimal 5 nilai yang dapat ditentukan. Jika tidak ada jenis yang ditentukan, semua jenis Tempat akan ditampilkan.
includedRegionCodes optional
Jenis:  Array<string> optional
Hanya sertakan hasil di wilayah yang ditentukan, yang ditetapkan sebagai maksimum 15 kode wilayah dua karakter CLDR. Kumpulan 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, panjang defaultnya adalah input.
language optional
Jenis:  string optional
Bahasa yang digunakan untuk menampilkan hasil. Akan ditetapkan secara default ke preferensi bahasa browser. Hasilnya mungkin dalam bahasa campuran jika bahasa yang digunakan dalam 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 satu dari locationBias atau locationRestriction harus disetel. Jika keduanya tidak ditetapkan, hasilnya akan dibiaskan oleh alamat IP, yang berarti alamat IP akan dipetakan ke lokasi yang tidak akurat dan digunakan sebagai sinyal pembiasan.
locationRestriction optional
Jenis:  LocationRestriction optional
Membatasi hasil ke lokasi tertentu.

Maksimal satu dari locationBias atau locationRestriction harus disetel. Jika keduanya tidak ditetapkan, hasilnya akan dibiaskan oleh alamat IP, yang berarti alamat IP akan dipetakan ke lokasi yang tidak akurat dan digunakan sebagai sinyal pembiasan.
origin optional
Jenis:  LatLng|LatLngLiteral optional
Titik asal untuk menghitung jarak geodesi ke tujuan (ditampilkan sebagai PlacePrediction.distanceMeters). Jika nilai ini dihilangkan, jarak geodesi tidak akan ditampilkan.
region optional
Jenis:  string optional
Kode wilayah, ditetapkan sebagai kode wilayah dua karakter CLDR. Hal ini memengaruhi pemformatan alamat, peringkat hasil, dan dapat memengaruhi hasil yang ditampilkan. Hal ini tidak membatasi hasil pada wilayah yang ditentukan.
sessionToken optional
Jenis:  AutocompleteSessionToken optional
Token yang mengidentifikasi sesi Autocomplete untuk tujuan penagihan. Buat token sesi baru melalui AutocompleteSessionToken.

Sesi dimulai saat pengguna mulai mengetik kueri, dan berakhir saat mereka 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 sebuah sesi harus berasal dari project Konsol Google Cloud yang sama. Setelah sesi selesai, token tidak lagi valid; aplikasi Anda harus menghasilkan token baru untuk setiap sesi. Jika parameter sessionToken dihapus, atau jika Anda menggunakan kembali token sesi, sesi tersebut dikenai biaya seolah-olah tidak ada token sesi yang diberikan (setiap permintaan ditagih secara terpisah).

Kami merekomendasikan 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 Anda menggunakan token yang sama untuk lebih dari satu sesi, setiap permintaan akan ditagih satu per satu.

Class AutocompleteSessionToken

Class google.maps.places.AutocompleteSessionToken

Merepresentasikan 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.
AutocompleteSessionToken
AutocompleteSessionToken()
Parameter: Tidak ada
Membuat instance baru AutocompleteSessionToken.

AutocompleteSuggestion

Class google.maps.places.AutocompleteSuggestion

Hasil saran Autocomplete.

Akses dengan memanggil const {AutocompleteSuggestion} = await google.maps.importLibrary("places"). Lihat Library di Maps JavaScript API.
fetchAutocompleteSuggestions
fetchAutocompleteSuggestions(autocompleteRequest)
Parameter: 
Nilai Hasil:  Promise<{suggestions:Array<AutocompleteSuggestion>}>
Mengambil daftar Saran Autocomplete.
placePrediction
Jenis:  PlacePrediction optional
Berisi nama yang dapat dibaca manusia untuk hasil yang ditampilkan. Untuk hasil bisnis, biasanya ini adalah nama dan alamat bisnis.

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.
distanceMeters
Jenis:  number optional
Panjang geodesi dalam meter dari origin jika origin ditentukan.
mainText
Jenis:  FormattableText optional
Menampilkan 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
Menampilkan fitur tambahan yang membedakan (seperti kota atau wilayah) untuk mengidentifikasi Tempat lebih lanjut.
text
Berisi nama yang dapat dibaca manusia untuk hasil yang ditampilkan. Untuk hasil bisnis, 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 saling berkaitan, dapat menggunakan PlacePrediction.mainText dan PlacePrediction.secondaryText.
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.
toPlace
toPlace()
Parameter: Tidak ada
Nilai Hasil:  Place
Menampilkan representasi Tempat dari PlacePrediction ini. Panggilan berikutnya ke Place.fetchFields diperlukan untuk mendapatkan Place Details lengkap.

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.
endOffset
Jenis:  number
Offset berbasis nol dari karakter Unicode terakhir dari substring (eksklusif).
startOffset
Jenis:  number
Offset berbasis nol dari karakter Unicode pertama dari substring (inklusif).

Class FormattableText

Class google.maps.places.FormattableText

Teks yang merepresentasikan prediksi Tempat. Teks dapat digunakan sebagaimana adanya atau dalam formatnya.

Akses dengan memanggil const {FormattableText} = await google.maps.importLibrary("places"). Lihat Library di Maps JavaScript API.
matches
Jenis:  Array<StringRange>
Daftar rentang string yang mengidentifikasi tempat permintaan input cocok di FormattableText.text. Rentang ini dapat digunakan untuk memformat bagian tertentu dari text. Substring mungkin tidak sama persis dengan AutocompleteRequest.input jika kecocokan tersebut ditentukan oleh kriteria selain pencocokan string (misalnya, koreksi ejaan atau transliterasi). Nilai ini adalah offset karakter Unicode FormattableText.text. Rentang tersebut dijamin akan diurutkan dalam nilai offset yang meningkat.
text
Jenis:  string
Teks yang dapat digunakan sebagaimana adanya atau diformat dengan FormattableText.matches.