Class AutocompleteService
Class
google.maps.places.AutocompleteService
Berisi metode yang terkait dengan pengambilan prediksi Pelengkapan Otomatis.
Akses dengan memanggil const {AutocompleteService} = await google.maps.importLibrary("places")
. Lihat Library di Maps JavaScript API.
Konstruktor | |
---|---|
AutocompleteService |
AutocompleteService() Parameter: Tidak ada
Membuat instance AutocompleteService yang baru. |
Metode | |
---|---|
getPlacePredictions |
getPlacePredictions(request[, callback]) Parameter:
Nilai Hasil:
Promise<AutocompleteResponse> Mengambil prediksi pelengkapan otomatis berdasarkan permintaan pelengkapan otomatis yang diberikan. |
getQueryPredictions |
getQueryPredictions(request, callback) Parameter:
Nilai Hasil: Tidak ada
Mengambil prediksi pelengkapan otomatis kueri berdasarkan permintaan pelengkapan otomatis kueri yang diberikan. |
Antarmuka AutoAutocompleteRequest
Antarmuka
google.maps.places.AutocompletionRequest
Permintaan Pelengkapan Otomatis yang akan dikirim ke AutocompleteService.getPlacePredictions
.
Properti | |
---|---|
input |
Jenis:
string Pengguna memasukkan string input. |
|
Jenis:
LatLngBounds|LatLngBoundsLiteral optional Batas untuk bias prediksi. Prediksi akan bias, tetapi tidak terbatas pada, bounds yang ditentukan. location dan radius akan diabaikan jika bounds ditetapkan. |
componentRestrictions optional |
Jenis:
ComponentRestrictions optional Pembatasan komponen. Batasan komponen digunakan untuk membatasi prediksi hanya pada prediksi di dalam komponen induk. Misalnya, negara. |
language optional |
Jenis:
string optional ID bahasa untuk bahasa yang akan ditampilkan 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. |
|
Jenis:
LatLng optional Lokasi untuk bias prediksi. Prediksi akan bias terhadap location dan radius tertentu. Atau, bounds dapat digunakan. |
locationBias optional |
Jenis:
LocationBias optional Batas atau petunjuk lembut yang digunakan saat menelusuri tempat. |
locationRestriction optional |
Jenis:
LocationRestriction optional Batas untuk membatasi hasil penelusuran. |
offset optional |
Jenis:
number optional Posisi karakter dalam istilah input tempat layanan menggunakan teks untuk prediksi (posisi kursor di kolom input). |
origin optional |
Jenis:
LatLng|LatLngLiteral optional Lokasi tempat AutocompletePrediction.distance_meters dihitung. |
|
Jenis:
number optional Radius area yang digunakan untuk bias prediksi. radius ditentukan dalam meter, dan harus selalu disertai dengan properti location . Atau, bounds dapat digunakan. |
region optional |
Jenis:
string optional Kode wilayah yang digunakan untuk pemformatan hasil dan untuk pemfilteran hasil. Tindakan ini tidak membatasi saran hanya 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 "Inggris Raya dan Irlandia Utara"). |
sessionToken optional |
Jenis:
AutocompleteSessionToken optional Referensi unik yang digunakan untuk memaketkan permintaan individual ke dalam sesi. |
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. |
Antarmuka AutocompleteResponse
Antarmuka
google.maps.places.AutocompleteResponse
Respons Autocomplete yang ditampilkan oleh panggilan ke AutocompleteService.getPlacePredictions
yang berisi daftar AutocompletePrediction
.
Properti | |
---|---|
predictions |
Jenis:
Array<AutocompletePrediction> Daftar AutocompletePrediction . |
Antarmuka QueryAutoAutocompleteRequest
Antarmuka
google.maps.places.QueryAutocompletionRequest
Permintaan QueryAutoPelengkapan yang akan dikirim ke QueryAutocompleteService
.
Properti | |
---|---|
input |
Jenis:
string Pengguna memasukkan string input. |
bounds optional |
Jenis:
LatLngBounds|LatLngBoundsLiteral optional Batas untuk bias prediksi. Prediksi akan bias, tetapi tidak terbatas pada, bounds yang ditentukan. location dan radius akan diabaikan jika bounds ditetapkan. |
location optional |
Jenis:
LatLng optional Lokasi untuk bias prediksi. Prediksi akan bias terhadap location dan radius tertentu. Atau, bounds dapat digunakan. |
offset optional |
Jenis:
number optional Posisi karakter dalam istilah input tempat layanan menggunakan teks untuk prediksi (posisi kursor di kolom input). |
radius optional |
Jenis:
number optional Radius area yang digunakan untuk bias prediksi. radius ditentukan dalam meter, dan harus selalu disertai dengan properti location . Atau, bounds dapat digunakan. |
Class AutocompleteSessionToken
Class
google.maps.places.AutocompleteSessionToken
Mewakili token sesi yang digunakan untuk melacak sesi pelengkapan otomatis, yang dapat berupa rangkaian panggilan AutocompleteService.getPlacePredictions
yang diikuti dengan satu panggilan PlacesService.getDetails
.
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 . |
Antarmuka ComponentRestrictions
Antarmuka
google.maps.places.ComponentRestrictions
Menentukan pembatasan komponen yang dapat digunakan dengan layanan pelengkapan otomatis.
Properti | |
---|---|
country optional |
Jenis:
string|Array<string> optional Membatasi prediksi ke negara yang ditentukan (kode negara ISO 3166-1 Alpha-2, tidak peka huruf besar/kecil). Misalnya, 'us' , 'br' , atau 'au' . Anda dapat memberikan satu string tunggal, atau array hingga lima string kode negara. |
Antarmuka AutocompletePrediction
Antarmuka
google.maps.places.AutocompletePrediction
Mewakili satu prediksi pelengkapan otomatis.
Properti | |
---|---|
description |
Jenis:
string Ini adalah versi kueri yang tidak diformat yang disarankan oleh layanan Places. |
matched_substrings |
Jenis:
Array<PredictionSubstring> Serangkaian substring dalam deskripsi tempat yang cocok dengan elemen dalam input pengguna, cocok untuk digunakan dalam menandai substring tersebut. Setiap substring diidentifikasi dengan offset dan panjang, yang dinyatakan dalam karakter unicode. |
place_id |
Jenis:
string ID tempat yang dapat digunakan untuk mengambil detail tentang tempat ini menggunakan layanan detail tempat (lihat PlacesService.getDetails ). |
structured_formatting |
Jenis:
StructuredFormatting Informasi terstruktur tentang deskripsi tempat, dibagi menjadi teks utama dan teks sekunder, termasuk array substring yang cocok dari input pelengkapan otomatis, yang diidentifikasi dengan offset dan panjang, yang dinyatakan dalam karakter unicode. |
terms |
Jenis:
Array<PredictionTerm> Informasi tentang istilah individual dalam deskripsi di atas, dari yang paling spesifik hingga yang paling tidak spesifik. Misalnya, "Taco Bell", " Willitis", dan "CA". |
types |
Jenis:
Array<string> Array jenis yang mencakup prediksi, misalnya 'establishment' atau 'geocode' . |
distance_meters optional |
Jenis:
number optional Jarak tempat dalam meter dari AutocompletionRequest.origin . |
Antarmuka QueryAutocompletePrediction
Antarmuka
google.maps.places.QueryAutocompletePrediction
Mewakili satu prediksi Query Autocomplete.
Properti | |
---|---|
description |
Jenis:
string Ini adalah versi kueri yang tidak diformat yang disarankan oleh layanan Places. |
matched_substrings |
Jenis:
Array<PredictionSubstring> Serangkaian substring dalam deskripsi tempat yang cocok dengan elemen dalam input pengguna, cocok untuk digunakan dalam menandai substring tersebut. Setiap substring diidentifikasi dengan offset dan panjang, yang dinyatakan dalam karakter unicode. |
terms |
Jenis:
Array<PredictionTerm> Informasi tentang masing-masing istilah dalam deskripsi di atas. Istilah kategorisasi diutamakan (misalnya, "restoran"). Istilah alamat muncul dari yang paling spesifik hingga yang paling tidak spesifik. Misalnya, "Jakarta", dan "Jakarta". |
place_id optional |
Jenis:
string optional Hanya tersedia jika prediksi adalah tempat. ID tempat yang dapat digunakan untuk mengambil detail tentang tempat ini menggunakan layanan detail tempat (lihat PlacesService.getDetails ). |
Antarmuka PredictionTerms
Antarmuka
google.maps.places.PredictionTerm
Menunjukkan istilah prediksi.
Properti | |
---|---|
offset |
Jenis:
number Offset, dalam karakter unicode, dari awal istilah ini dalam deskripsi tempat. |
value |
Jenis:
string Nilai istilah ini, misalnya, "Taco Bell". |
Antarmuka PredictionSubstring
Antarmuka
google.maps.places.PredictionSubstring
Mewakili substring prediksi.
Properti | |
---|---|
length |
Jenis:
number Panjang substring. |
offset |
Jenis:
number Offset ke awal substring dalam string deskripsi. |
Antarmuka StructuredPemformatan
Antarmuka
google.maps.places.StructuredFormatting
Berisi informasi terstruktur tentang deskripsi tempat, yang dibagi menjadi teks utama dan teks sekunder, termasuk array substring yang cocok dari input pelengkapan otomatis, yang diidentifikasi oleh offset dan panjang, yang dinyatakan dalam karakter unicode.
Properti | |
---|---|
main_text |
Jenis:
string Ini adalah bagian teks utama dari deskripsi yang tidak diformat dari tempat yang disarankan oleh layanan Places. Biasanya nama tempat. |
main_text_matched_substrings |
Jenis:
Array<PredictionSubstring> Kumpulan substring dalam teks utama yang cocok dengan elemen dalam input pengguna, cocok untuk digunakan dalam menyoroti substring tersebut. Setiap substring diidentifikasi dengan offset dan panjang, yang dinyatakan dalam karakter unicode. |
secondary_text |
Jenis:
string Ini adalah bagian teks sekunder dari deskripsi yang tidak diformat dari tempat yang disarankan oleh layanan Places. Biasanya lokasi tempat. |