Places Autocomplete Service (deprecated)

Class AutocompleteService

google.maps.places.AutocompleteService class
library "places"

Tidak digunakan lagi: Mulai 1 Maret 2025, google.maps.places.AutocompleteService tidak tersedia untuk pelanggan baru. Sebagai gantinya, gunakan AutocompleteSuggestion. Saat ini, google.maps.places.AutocompleteService tidak dijadwalkan untuk dihentikan, tetapi sebaiknya gunakan AutocompleteSuggestion, bukan google.maps.places.AutocompleteService. Meskipun google.maps.places.AutocompleteService akan terus menerima perbaikan bug untuk regresi besar, bug yang ada di google.maps.places.AutocompleteService tidak akan diatasi. Pemberitahuan akan diberikan setidaknya 12 bulan sebelum dukungan dihentikan. Lihat https://developers.google.com/maps/legacy untuk mengetahui detail tambahan dan https://developers.google.com/maps/documentation/javascript/places-migration-overview untuk panduan migrasi.

Berisi metode yang terkait dengan pengambilan prediksi Pelengkapan Otomatis.

const {AutocompleteService} = await google.maps.importLibrary("places");

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

Metode
getPlacePredictions	getPlacePredictions(request[, callback]) Parameter: request: AutocompletionRequest Permintaan pelengkapan otomatis. callback: function(Array<AutocompletePrediction> optional, PlacesServiceStatus): void optional Callback yang menerima array objek AutocompletePrediction dan nilai PlacesServiceStatus sebagai argumen. Nilai Hasil: Promise<AutocompleteResponse> Mengambil prediksi pelengkapan otomatis tempat berdasarkan permintaan pelengkapan otomatis yang diberikan.
getQueryPredictions	getQueryPredictions(request, callback) Parameter: request: QueryAutocompletionRequest Permintaan pelengkapan otomatis kueri. callback: function(Array<QueryAutocompletePrediction> optional, PlacesServiceStatus): void Callback yang menerima array objek QueryAutocompletePrediction dan nilai PlacesServiceStatus sebagai argumen. 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.

Properti
input	Jenis: string String input yang dimasukkan pengguna.
bounds opsional	Tidak digunakan lagi: bounds tidak digunakan lagi mulai Mei 2023. Sebagai gantinya, gunakan AutocompletionRequest.locationBias dan AutocompletionRequest.locationRestriction. Jenis: LatLngBounds|LatLngBoundsLiteral optional Batas untuk bias prediksi. Prediksi akan dibiaskan terhadap, tetapi tidak terbatas pada, bounds yang diberikan. location dan radius akan diabaikan jika bounds ditetapkan.
componentRestrictions opsional	Jenis: ComponentRestrictions optional Batasan komponen. Batasan komponen digunakan untuk membatasi prediksi hanya pada prediksi yang ada dalam komponen induk. Misalnya, negara.
language opsional	Jenis: string optional ID bahasa untuk bahasa yang akan digunakan untuk menampilkan 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.
location opsional	Tidak digunakan lagi: location tidak digunakan lagi mulai Mei 2023. Sebagai gantinya, gunakan AutocompletionRequest.locationBias dan AutocompletionRequest.locationRestriction. Jenis: LatLng optional Lokasi untuk bias prediksi. Prediksi akan bias terhadap location dan radius yang diberikan. Atau, bounds dapat digunakan.
locationBias opsional	Jenis: LocationBias optional Batas atau petunjuk yang tidak ketat untuk digunakan saat menelusuri tempat.
locationRestriction opsional	Jenis: LocationRestriction optional Batas untuk membatasi hasil penelusuran.
offset opsional	Jenis: number optional Posisi karakter dalam istilah input tempat layanan menggunakan teks untuk prediksi (posisi kursor di kolom input).
origin opsional	Jenis: LatLng|LatLngLiteral optional Lokasi tempat AutocompletePrediction.distance_meters dihitung.
radius opsional	Tidak digunakan lagi: radius tidak digunakan lagi mulai Mei 2023. Sebagai gantinya, gunakan AutocompletionRequest.locationBias dan AutocompletionRequest.locationRestriction. Jenis: number optional Radius area yang digunakan untuk pembiasan prediksi. radius ditentukan dalam meter, dan harus selalu disertai dengan properti location. Atau, bounds dapat digunakan.
region opsional	Jenis: string optional Kode wilayah yang digunakan untuk pemformatan hasil dan pemfilteran hasil. Parameter ini tidak membatasi saran hanya 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 "The United Kingdom of Great Britain and Northern Ireland").
sessionToken opsional	Jenis: AutocompleteSessionToken optional Referensi unik yang digunakan untuk menggabungkan permintaan individual ke dalam sesi.
types opsional	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 QueryAutocompletionRequest

Antarmuka google.maps.places.QueryAutocompletionRequest

Permintaan QueryAutocompletion yang akan dikirim ke QueryAutocompleteService.

Properti
input	Jenis: string String input yang dimasukkan pengguna.
bounds opsional	Jenis: LatLngBounds|LatLngBoundsLiteral optional Batas untuk bias prediksi. Prediksi akan dibiaskan terhadap, tetapi tidak terbatas pada, bounds yang diberikan. location dan radius akan diabaikan jika bounds ditetapkan.
location opsional	Jenis: LatLng optional Lokasi untuk bias prediksi. Prediksi akan bias terhadap location dan radius yang diberikan. Atau, bounds dapat digunakan.
offset opsional	Jenis: number optional Posisi karakter dalam istilah input tempat layanan menggunakan teks untuk prediksi (posisi kursor di kolom input).
radius opsional	Jenis: number optional Radius area yang digunakan untuk pembiasan prediksi. radius ditentukan dalam meter, dan harus selalu disertai dengan properti location. Atau, bounds dapat digunakan.

Antarmuka ComponentRestrictions

Antarmuka google.maps.places.ComponentRestrictions

Menentukan batasan komponen yang dapat digunakan dengan layanan pelengkapan otomatis.

Properti
country opsional	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 kode negara, atau array yang berisi hingga lima string kode negara.

Antarmuka AutocompletePrediction

Antarmuka google.maps.places.AutocompletePrediction

Menampilkan 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> Kumpulan substring dalam deskripsi tempat yang cocok dengan elemen dalam input pengguna, yang cocok untuk digunakan dalam menandai substring tersebut. Setiap substring diidentifikasi oleh 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, yang dibagi menjadi teks utama dan teks sekunder, termasuk array substring yang cocok dari input pelengkapan otomatis, yang diidentifikasi berdasarkan offset dan panjang, yang dinyatakan dalam karakter unicode.
terms	Jenis: Array<PredictionTerm> Informasi tentang setiap istilah 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 dimiliki prediksi, misalnya 'establishment' atau 'geocode'.
distance_meters opsional	Jenis: number optional Jarak tempat dalam meter dari AutocompletionRequest.origin.

Antarmuka QueryAutocompletePrediction

Antarmuka google.maps.places.QueryAutocompletePrediction

Mewakili satu prediksi pelengkapan otomatis kueri.

Properti
description	Jenis: string Ini adalah versi kueri yang tidak diformat yang disarankan oleh layanan Places.
matched_substrings	Jenis: Array<PredictionSubstring> Kumpulan substring dalam deskripsi tempat yang cocok dengan elemen dalam input pengguna, yang cocok untuk digunakan dalam menandai substring tersebut. Setiap substring diidentifikasi oleh offset dan panjang, yang dinyatakan dalam karakter unicode.
terms	Jenis: Array<PredictionTerm> Informasi tentang setiap istilah dalam deskripsi di atas. Istilah kategoris muncul terlebih dahulu (misalnya, "restoran"). Istilah alamat muncul dari yang paling spesifik hingga yang paling tidak spesifik. Misalnya, "San Francisco", dan "CA".
place_id opsional	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 PredictionTerm

Antarmuka google.maps.places.PredictionTerm

Merepresentasikan 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

Merepresentasikan substring prediksi.

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

Antarmuka StructuredFormatting

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

Properti
main_text	Jenis: string Ini adalah bagian teks utama dari deskripsi tempat yang tidak diformat yang disarankan oleh layanan Places. Biasanya berupa nama tempat.
main_text_matched_substrings	Jenis: Array<PredictionSubstring> Kumpulan substring dalam teks utama yang cocok dengan elemen dalam input pengguna, yang cocok untuk digunakan dalam menandai substring tersebut. Setiap substring diidentifikasi oleh offset dan panjang, yang dinyatakan dalam karakter unicode.
secondary_text	Jenis: string Ini adalah bagian teks sekunder dari deskripsi tanpa format untuk tempat yang disarankan oleh layanan Places. Biasanya lokasi tempat.