Places Autocomplete Service

Class AutocompleteService

Class google.maps.places.AutocompleteService

Berisi metode yang terkait dengan pengambilan prediksi Autocomplete.

Muat menggunakan parameter URL &libraries=places. Lihat Library di Maps JavaScript API.

Saat menggunakan v=beta, dapat diakses dengan memanggil const {AutocompleteService} = await google.map.importLibrary("places"). Lihat Library di Maps JavaScript API.

AutocompleteService
AutocompleteService()
Parameter: Tidak ada
Membuat instance AutocompleteService yang baru.
getPlacePredictions
getPlacePredictions(request[, callback])
Parameter:
Mengambil prediksi pelengkapan otomatis tempat berdasarkan permintaan pelengkapan otomatis yang disediakan.
getQueryPredictions
getQueryPredictions(request, callback)
Parameter:
Nilai Hasil: Tidak Ada
Mengambil prediksi pelengkapan otomatis kueri berdasarkan permintaan pelengkapan otomatis kueri yang diberikan.

Antarmuka AutocompletionRequest

Antarmuka google.maps.places.AutocompletionRequest

Permintaan Pelengkapan otomatis yang akan dikirim ke AutocompleteService.getPlacePredictions.

Muat menggunakan parameter URL &libraries=places. Lihat Library di Maps JavaScript API.

input
Jenis: string
Pengguna memasukkan string input.
bounds optional
Batas untuk bias prediksi. Prediksi akan dibiaskan terhadap, namun tidak terbatas pada, bounds yang ditentukan. location dan radius akan diabaikan jika bounds ditetapkan.
componentRestrictions optional
Jenis: ComponentRestrictions optional
Pembatasan komponen. Pembatasan komponen digunakan untuk membatasi prediksi hanya pada prediksi di dalam komponen induk. Misalnya, negara.
language optional
Jenis: string optional
ID bahasa untuk bahasa tempat hasil harus ditampilkan, 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.
location optional
Jenis: LatLng optional
Lokasi untuk bias prediksi. Prediksi akan bias terhadap location dan radius yang ditentukan. Atau, bounds dapat digunakan.
offset optional
Jenis: number optional
Posisi karakter dalam istilah input tempat layanan menggunakan teks untuk prediksi (posisi kursor dalam kolom input).
origin optional
Jenis: LatLng|LatLngLiteral optional
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.
region optional
Jenis: string optional
Kode wilayah yang digunakan untuk pemformatan hasil dan untuk pemfilteran hasil. Hal ini tidak membatasi saran 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 "Inggris Raya dan Irlandia Utara").
sessionToken optional
Jenis: AutocompleteSessionToken optional
Referensi unik yang digunakan untuk menggabungkan 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 dikembalikan.

Antarmuka AutocompleteResponse

Antarmuka google.maps.places.AutocompleteResponse

Respons Autocomplete yang ditampilkan oleh panggilan ke AutocompleteService.getPlacePredictions yang berisi daftar AutocompletePrediction.

Muat menggunakan parameter URL &libraries=places. Lihat Library di Maps JavaScript API.

predictions

Antarmuka QueryAutocompletionRequest

Antarmuka google.maps.places.QueryAutocompletionRequest

Permintaan QueryAutocompletion yang dikirim ke QueryAutocompleteService.

Muat menggunakan parameter URL &libraries=places. Lihat Library di Maps JavaScript API.

input
Jenis: string
Pengguna memasukkan string input.
bounds optional
Batas untuk bias prediksi. Prediksi akan dibiaskan terhadap, namun 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 yang ditentukan. Atau, bounds dapat digunakan.
offset optional
Jenis: number optional
Posisi karakter dalam istilah input tempat layanan menggunakan teks untuk prediksi (posisi kursor dalam 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

Merepresentasikan token sesi yang digunakan untuk melacak sesi pelengkapan otomatis, yang dapat berupa serangkaian panggilan AutocompleteService.getPlacePredictions yang diikuti dengan satu panggilan PlacesService.getDetails.

Muat menggunakan parameter URL &libraries=places. Lihat Library di Maps JavaScript API.

Saat menggunakan v=beta, dapat diakses dengan memanggil const {AutocompleteSessionToken} = await google.map.importLibrary("places"). Lihat Library di Maps JavaScript API.

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

Antarmuka ComponentRestrictions

Antarmuka google.maps.places.ComponentRestrictions

Menentukan batasan komponen yang dapat digunakan dengan layanan pelengkapan otomatis.

Muat menggunakan parameter URL &libraries=places. Lihat Library di Maps JavaScript API.

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 kode, atau array hingga lima string kode negara.

Antarmuka AutocompletePrediction

Antarmuka google.maps.places.AutocompletePrediction

Mewakili satu prediksi pelengkapan otomatis.

Muat menggunakan parameter URL &libraries=places. Lihat Library di Maps JavaScript API.

description
Jenis: string
Ini adalah versi kueri yang tidak diformat yang disarankan oleh layanan Places.
matched_substrings
Kumpulan substring dalam deskripsi tempat 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.
place_id
Jenis: string
ID tempat yang dapat digunakan untuk mengambil detail tentang tempat ini menggunakan layanan detail tempat (lihat PlacesService.getDetails).
structured_formatting
Informasi terstruktur tentang deskripsi tempat, yang 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
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 berasal dari prediksi, misalnya 'establishment' atau 'geocode'.
distance_meters optional
Jenis: number optional
Jarak dalam meter dari tempat dari AutocompletionRequest.origin.

Antarmuka QueryAutocompletePrediction

Antarmuka google.maps.places.QueryAutocompletePrediction

Merepresentasikan prediksi Pelengkapan Otomatis Kueri.

Muat menggunakan parameter URL &libraries=places. Lihat Library di Maps JavaScript API.

description
Jenis: string
Ini adalah versi kueri yang tidak diformat yang disarankan oleh layanan Places.
matched_substrings
Kumpulan substring dalam deskripsi tempat 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.
terms
Informasi tentang istilah individual dalam deskripsi di atas. Istilah kategoris lebih diutamakan (misalnya, "restoran"). Istilah alamat muncul dari yang paling spesifik hingga yang paling tidak spesifik. Misalnya, "Semarang", dan "Kanada".
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

Merepresentasikan istilah prediksi.

Muat menggunakan parameter URL &libraries=places. Lihat Library di Maps JavaScript API.

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

Merepresentasikan substring prediksi.

Muat menggunakan parameter URL &libraries=places. Lihat Library di Maps JavaScript API.

length
Jenis: number
Panjang substring.
offset
Jenis: number
Offset ke substring dimulai dalam string deskripsi.

Antarmuka StructuredFormat

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 dengan offset dan panjang, yang dinyatakan dalam karakter unicode.

Muat menggunakan parameter URL &libraries=places. Lihat Library di Maps JavaScript API.

main_text
Jenis: string
Ini adalah bagian teks utama dari deskripsi tempat yang tidak diformat yang disarankan oleh layanan Places. Biasanya nama tempat.
main_text_matched_substrings
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 tempat yang tidak diformat yang disarankan oleh layanan Places. Biasanya lokasi tempat.