Layanan pelengkapan otomatis di Places SDK for Android menampilkan prediksi tempat sebagai respons terhadap kueri penelusuran pengguna. Saat pengguna mengetik, layanan pelengkapan otomatis akan menampilkan saran untuk tempat seperti bisnis, alamat, Plus Codes, dan lokasi menarik.
Anda bisa menambahkan pelengkapan otomatis ke aplikasi dengan cara berikut:
- Tambahkan widget pelengkapan otomatis untuk menghemat waktu pengembangan dan memastikan pengalaman pengguna yang konsisten.
- Dapatkan prediksi tempat secara terprogram untuk menciptakan pengalaman pengguna yang disesuaikan.
Menambahkan widget pelengkapan otomatis
Widget pelengkapan otomatis adalah dialog penelusuran dengan fungsi pelengkapan otomatis bawaan. Saat pengguna memasukkan istilah penelusuran, widget akan menampilkan daftar tempat yang diprediksi untuk dipilih. Saat pengguna membuat pilihan, instance
Place
akan ditampilkan, yang kemudian dapat digunakan aplikasi Anda untuk mendapatkan detail tentang
tempat yang dipilih.
Ada dua opsi untuk menambahkan widget pelengkapan otomatis ke aplikasi Anda:
- Opsi 1: Sematkan
AutocompleteSupportFragment
. - Opsi 2: Menggunakan intent untuk meluncurkan aktivitas pelengkapan otomatis.
Opsi 1: Sematkan AutocompleteSupportFragment
Untuk menambahkan AutocompleteSupportFragment
ke aplikasi Anda, lakukan langkah-langkah berikut:
- Tambahkan fragmen ke tata letak XML aktivitas Anda.
- Tambahkan pemroses ke aktivitas atau fragmen Anda.
Menambahkan AutocompleteSupportFragment ke aktivitas
Untuk menambahkan AutocompleteSupportFragment
ke aktivitas, tambahkan fragmen baru ke tata letak XML. Contoh:
<fragment android:id="@+id/autocomplete_fragment"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:name="com.google.android.libraries.places.widget.AutocompleteSupportFragment"
/>
- Secara default, fragmen tidak memiliki border atau latar belakang. Untuk memberikan tampilan visual yang konsisten, susun fragmen dalam elemen tata letak lain seperti CardView.
- Jika Anda menggunakan fragmen Autocomplete, dan perlu mengganti
onActivityResult
, Anda harus memanggilsuper.onActivityResult
, jika tidak, fragmen tidak akan berfungsi dengan benar.
Menambahkan PlaceSelectionListener ke aktivitas
PlaceSelectionListener
menangani pengembalian tempat sebagai respons terhadap pilihan
pengguna. Kode berikut menunjukkan cara membuat referensi ke fragmen dan menambahkan pemroses ke AutocompleteSupportFragment
Anda:
Kotlin
// Initialize the AutocompleteSupportFragment. val autocompleteFragment = supportFragmentManager.findFragmentById(R.id.autocomplete_fragment) as AutocompleteSupportFragment // Specify the types of place data to return. autocompleteFragment.setPlaceFields(listOf(Place.Field.ID, Place.Field.NAME)) // Set up a PlaceSelectionListener to handle the response. autocompleteFragment.setOnPlaceSelectedListener(object : PlaceSelectionListener { override fun onPlaceSelected(place: Place) { // TODO: Get info about the selected place. Log.i(TAG, "Place: ${place.name}, ${place.id}") } override fun onError(status: Status) { // TODO: Handle the error. Log.i(TAG, "An error occurred: $status") } })
Java
// Initialize the AutocompleteSupportFragment. AutocompleteSupportFragment autocompleteFragment = (AutocompleteSupportFragment) getSupportFragmentManager().findFragmentById(R.id.autocomplete_fragment); // Specify the types of place data to return. autocompleteFragment.setPlaceFields(Arrays.asList(Place.Field.ID, Place.Field.NAME)); // Set up a PlaceSelectionListener to handle the response. autocompleteFragment.setOnPlaceSelectedListener(new PlaceSelectionListener() { @Override public void onPlaceSelected(@NonNull Place place) { // TODO: Get info about the selected place. Log.i(TAG, "Place: " + place.getName() + ", " + place.getId()); } @Override public void onError(@NonNull Status status) { // TODO: Handle the error. Log.i(TAG, "An error occurred: " + status); } });
Opsi 2: Menggunakan intent untuk meluncurkan aktivitas pelengkapan otomatis
Jika Anda ingin aplikasi menggunakan alur navigasi yang berbeda (misalnya, untuk memicu pengalaman pelengkapan otomatis dari ikon, bukan kolom penelusuran), aplikasi Anda dapat meluncurkan pelengkapan otomatis menggunakan intent.
Untuk meluncurkan widget pelengkapan otomatis dengan menggunakan maksud, ikuti langkah-langkah ini:
- Gunakan
Autocomplete.IntentBuilder
untuk membuat maksud, dengan meneruskan modeAutocomplete
yang diinginkan. - Tentukan peluncur hasil aktivitas
registerForActivityResult
yang dapat digunakan untuk meluncurkan intent dan menangani prediksi tempat yang dipilih pengguna dalam hasil.
Membuat intent pelengkapan otomatis
Contoh di bawah menggunakan
Autocomplete.IntentBuilder
untuk membuat intent guna meluncurkan widget pelengkapan otomatis sebagai intent:
Kotlin
// Set the fields to specify which types of place data to // return after the user has made a selection. val fields = listOf(Place.Field.ID, Place.Field.NAME) // Start the autocomplete intent. val intent = Autocomplete.IntentBuilder(AutocompleteActivityMode.FULLSCREEN, fields) .build(this) startAutocomplete.launch(intent)
Java
// Set the fields to specify which types of place data to // return after the user has made a selection. List<Place.Field> fields = Arrays.asList(Place.Field.ID, Place.Field.NAME); // Start the autocomplete intent. Intent intent = new Autocomplete.IntentBuilder(AutocompleteActivityMode.FULLSCREEN, fields) .build(this); startAutocomplete.launch(intent);
Saat menggunakan intent untuk meluncurkan widget pelengkapan otomatis, Anda dapat memilih dari mode tampilan overlay atau layar penuh. Screenshot berikut menunjukkan setiap mode tampilan:


Mendaftarkan callback untuk hasil intent
Untuk menerima notifikasi saat pengguna telah memilih tempat, tentukan peluncur
registerForActivityResult()
, yang meluncurkan aktivitas dan juga menangani
hasil seperti yang ditunjukkan dalam contoh berikut. Jika pengguna memilih prediksi, prediksi akan ditampilkan dalam intent yang terdapat di objek hasil. Karena intent
dibuat oleh Autocomplete.IntentBuilder
, metode
Autocomplete.getPlaceFromIntent()
dapat mengekstrak objek Place darinya.
Kotlin
private val startAutocomplete = registerForActivityResult(ActivityResultContracts.StartActivityForResult()) { result: ActivityResult -> if (result.resultCode == Activity.RESULT_OK) { val intent = result.data if (intent != null) { val place = Autocomplete.getPlaceFromIntent(intent) Log.i( TAG, "Place: ${place.name}, ${place.id}" ) } } else if (result.resultCode == Activity.RESULT_CANCELED) { // The user canceled the operation. Log.i(TAG, "User canceled autocomplete") } }
Java
private final ActivityResultLauncher<Intent> startAutocomplete = registerForActivityResult( new ActivityResultContracts.StartActivityForResult(), result -> { if (result.getResultCode() == Activity.RESULT_OK) { Intent intent = result.getData(); if (intent != null) { Place place = Autocomplete.getPlaceFromIntent(intent); Log.i(TAG, "Place: ${place.getName()}, ${place.getId()}"); } } else if (result.getResultCode() == Activity.RESULT_CANCELED) { // The user canceled the operation. Log.i(TAG, "User canceled autocomplete"); } });
Mendapatkan prediksi tempat secara terprogram
Anda dapat membuat UI penelusuran kustom sebagai alternatif dari UI yang disediakan oleh
widget pelengkapan otomatis. Untuk melakukannya, aplikasi Anda harus mendapatkan prediksi tempat secara terprogram. Aplikasi Anda dapat memperoleh daftar nama dan/atau alamat tempat yang diprediksi dari API autocomplete dengan memanggil
PlacesClient.findAutocompletePredictions()
,
meneruskan objek
FindAutocompletePredictionsRequest
dengan parameter berikut:
- Wajib: String
query
yang berisi teks yang diketik oleh pengguna. - Direkomendasikan: A
AutocompleteSessionToken
, yang mengelompokkan fase kueri dan pemilihan dari penelusuran pengguna ke dalam sesi terpisah untuk tujuan penagihan. Sesi dimulai saat pengguna mulai mengetik kueri, dan berakhir saat memilih tempat. - Direkomendasikan: Objek
RectangularBounds
yang menentukan batas lintang dan bujur untuk membatasi hasil ke wilayah yang ditentukan. - Opsional: Satu atau beberapa kode negara dua huruf (ISO 3166-1 Alpha-2), yang menunjukkan negara atau negara tempat hasil harus dibatasi.
Opsional: A
TypeFilter
, yang dapat Anda gunakan untuk membatasi hasil ke jenis tempat yang ditentukan. Jenis tempat berikut didukung:TypeFilter.GEOCODE
– Hanya menampilkan hasil geocoding, bukan bisnis. Gunakan permintaan ini untuk memperjelas hasil saat lokasi yang ditentukan mungkin tidak jelas.TypeFilter.ADDRESS
– Hanya menampilkan hasil pelengkapan otomatis dengan alamat yang akurat. Gunakan jenis ini jika Anda tahu pengguna sedang mencari alamat lengkap yang telah ditetapkan.TypeFilter.ESTABLISHMENT
– Hanya menampilkan tempat yang merupakan bisnis.TypeFilter.REGIONS
– Hanya menampilkan tempat yang cocok dengan salah satu jenis berikut:LOCALITY
SUBLOCALITY
POSTAL_CODE
COUNTRY
ADMINISTRATIVE_AREA_LEVEL_1
ADMINISTRATIVE_AREA_LEVEL_2
TypeFilter.CITIES
– Hanya menampilkan hasil yang cocok denganLOCALITY
atauADMINISTRATIVE_AREA_LEVEL_3
.
Opsional:
LatLng
yang menentukan lokasi asal permintaan. Saat Anda memanggilsetOrigin()
, layanan akan menampilkan jarak dalam meter (distanceMeters
) dari asal yang ditentukan untuk setiap prediksi pelengkapan otomatis dalam respons.
Untuk mengetahui informasi tentang jenis tempat, lihat panduan jenis tempat.
Contoh di bawah menunjukkan panggilan lengkap ke
PlacesClient.findAutocompletePredictions()
.
Kotlin
// Create a new token for the autocomplete session. Pass this to FindAutocompletePredictionsRequest, // and once again when the user makes a selection (for example when calling fetchPlace()). val token = AutocompleteSessionToken.newInstance() // Create a RectangularBounds object. val bounds = RectangularBounds.newInstance( LatLng(-33.880490, 151.184363), LatLng(-33.858754, 151.229596) ) // Use the builder to create a FindAutocompletePredictionsRequest. val request = FindAutocompletePredictionsRequest.builder() // Call either setLocationBias() OR setLocationRestriction(). .setLocationBias(bounds) //.setLocationRestriction(bounds) .setOrigin(LatLng(-33.8749937, 151.2041382)) .setCountries("AU", "NZ") .setTypesFilter(listOf(PlaceTypes.ADDRESS)) .setSessionToken(token) .setQuery(query) .build() placesClient.findAutocompletePredictions(request) .addOnSuccessListener { response: FindAutocompletePredictionsResponse -> for (prediction in response.autocompletePredictions) { Log.i(TAG, prediction.placeId) Log.i(TAG, prediction.getPrimaryText(null).toString()) } }.addOnFailureListener { exception: Exception? -> if (exception is ApiException) { Log.e(TAG, "Place not found: ${exception.statusCode}") } }
Java
// Create a new token for the autocomplete session. Pass this to FindAutocompletePredictionsRequest, // and once again when the user makes a selection (for example when calling fetchPlace()). AutocompleteSessionToken token = AutocompleteSessionToken.newInstance(); // Create a RectangularBounds object. RectangularBounds bounds = RectangularBounds.newInstance( new LatLng(-33.880490, 151.184363), new LatLng(-33.858754, 151.229596)); // Use the builder to create a FindAutocompletePredictionsRequest. FindAutocompletePredictionsRequest request = FindAutocompletePredictionsRequest.builder() // Call either setLocationBias() OR setLocationRestriction(). .setLocationBias(bounds) //.setLocationRestriction(bounds) .setOrigin(new LatLng(-33.8749937, 151.2041382)) .setCountries("AU", "NZ") .setTypesFilter(Arrays.asList(PlaceTypes.ADDRESS)) .setSessionToken(token) .setQuery(query) .build(); placesClient.findAutocompletePredictions(request).addOnSuccessListener((response) -> { for (AutocompletePrediction prediction : response.getAutocompletePredictions()) { Log.i(TAG, prediction.getPlaceId()); Log.i(TAG, prediction.getPrimaryText(null).toString()); } }).addOnFailureListener((exception) -> { if (exception instanceof ApiException) { ApiException apiException = (ApiException) exception; Log.e(TAG, "Place not found: " + apiException.getStatusCode()); } });
API menampilkan
FindAutocompletePredictionsResponse
dalam
Task
. FindAutocompletePredictionsResponse
berisi daftar objek
AutocompletePrediction
yang mewakili tempat yang diprediksi. Daftar mungkin kosong, jika tidak ada
tempat yang diketahui sesuai dengan kueri dan kriteria filter.
Untuk setiap tempat yang diprediksi, Anda dapat memanggil metode berikut untuk mengambil detail tempat:
getFullText(CharacterStyle)
menampilkan teks lengkap deskripsi tempat. Ini adalah kombinasi dari teks utama dan sekunder. Contoh: "Menara Eiffel, Avenue Anatole France, Paris, Prancis". Selain itu, metode ini memungkinkan Anda menandai bagian deskripsi yang cocok dengan penelusuran menggunakan gaya pilihan Anda, denganCharacterStyle
. ParameterCharacterStyle
bersifat opsional. Setel ke null jika Anda tidak memerlukan penyorotan.getPrimaryText(CharacterStyle)
menampilkan teks utama yang mendeskripsikan suatu tempat. Ini biasanya adalah nama tempat. Contoh: "Menara Eiffel", dan "123 Pitt Street".getSecondaryText(CharacterStyle)
menampilkan teks tambahan dari deskripsi tempat. Hal ini berguna, misalnya, sebagai baris kedua saat menampilkan prediksi pelengkapan otomatis. Contoh: "Avenue Anatole France, Paris, Prancis", dan "Sydney, New South Wales".getPlaceId()
menampilkan ID tempat dari tempat yang diprediksi. ID tempat adalah ID tekstual yang secara unik mengidentifikasi tempat, yang dapat Anda gunakan untuk mengambil objekPlace
lagi nanti. Untuk mengetahui informasi selengkapnya tentang ID tempat di Places SDK for Android, lihat Detail Tempat. Untuk informasi umum tentang ID tempat, lihat Ringkasan ID tempat.getPlaceTypes()
menampilkan daftar jenis tempat yang terkait dengan tempat ini.getDistanceMeters()
menampilkan jarak garis lurus dalam meter antara tempat ini dan asal yang ditentukan dalam permintaan.
Token sesi
Token sesi mengelompokkan fase kueri dan pemilihan dari penelusuran pelengkapan otomatis pengguna ke dalam sesi terpisah untuk tujuan penagihan. Sesi dimulai saat pengguna mulai mengetik kueri, dan berakhir saat memilih tempat. Setiap sesi dapat memiliki beberapa kueri, yang diikuti dengan satu pilihan tempat. Setelah sesi selesai, token tidak lagi valid; aplikasi Anda harus membuat token baru untuk setiap sesi. Sebaiknya gunakan token sesi untuk semua sesi pelengkapan otomatis terprogram (saat Anda menyematkan fragmen, atau meluncurkan pelengkapan otomatis menggunakan intent, API akan menanganinya secara otomatis).
Places SDK for Android menggunakan
AutocompleteSessionToken
untuk mengidentifikasi setiap sesi. Aplikasi Anda harus meneruskan token sesi baru saat
memulai setiap sesi baru, lalu meneruskan token yang sama, beserta ID Tempat, dalam
panggilan berikutnya ke
fetchPlace()
untuk mengambil Detail Tempat untuk tempat yang dipilih oleh pengguna.
Pelajari lebih lanjut token sesi.
Membatasi hasil pelengkapan otomatis
Anda dapat membatasi hasil pelengkapan otomatis ke wilayah geografis tertentu, dan/atau memfilter hasil ke satu atau beberapa jenis tempat, atau hingga lima negara. Anda
dapat menerapkan batasan ini ke aktivitas pelengkapan otomatis,
AutocompleteSupportFragment
, dan API pelengkapan otomatis terprogram.
Untuk membatasi hasil, lakukan langkah-langkah berikut:
- Untuk mengutamakan hasil dalam wilayah yang ditentukan, panggil
setLocationBias()
(beberapa hasil dari luar wilayah yang ditentukan mungkin masih ditampilkan). - Untuk hanya menampilkan hasil dalam wilayah yang ditentukan, panggil
setLocationRestriction()
(hanya hasil dalam wilayah yang ditentukan yang akan ditampilkan). - Untuk hanya menampilkan hasil yang sesuai dengan jenis tempat tertentu, panggil
setTypesFilter()
(misalnya, menentukanTypeFilter.ADDRESS
hanya akan menampilkan hasil dengan alamat yang akurat). - Untuk hanya menampilkan hasil dalam hingga lima negara yang ditentukan, panggil
setCountries()
. Negara harus diteruskan berupa dua karakter kode negara yang kompatibel dengan ISO 3166-1 Alpha-2.
Membiaskan hasil ke wilayah tertentu
Untuk membiaskan hasil pelengkapan otomatis ke wilayah geografis tertentu, panggil
setLocationBias()
, dengan meneruskan
RectangularBounds
.
Contoh kode berikut menunjukkan panggilan setLocationBias()
pada instance
fragmen untuk memengaruhi saran pelengkapan otomatisnya ke wilayah Sydney, Australia.
Kotlin
autocompleteFragment.setLocationBias( RectangularBounds.newInstance( LatLng(-33.880490, 151.184363), LatLng(-33.858754, 151.229596) ) )
Java
autocompleteFragment.setLocationBias(RectangularBounds.newInstance( new LatLng(-33.880490, 151.184363), new LatLng(-33.858754, 151.229596)));
Membatasi hasil ke wilayah tertentu
Untuk membatasi hasil pelengkapan otomatis ke wilayah geografis tertentu, panggil
setLocationRestriction()
, dengan meneruskan
RectangularBounds
.
Contoh kode berikut menunjukkan cara memanggil setLocationRestriction()
pada instance
fragmen untuk memengaruhi saran pelengkapan otomatisnya ke wilayah Sydney, Australia.
Kotlin
autocompleteFragment.setLocationRestriction( RectangularBounds.newInstance( LatLng(-33.880490, 151.184363), LatLng(-33.858754, 151.229596) ) )
Java
autocompleteFragment.setLocationRestriction(RectangularBounds.newInstance( new LatLng(-33.880490, 151.184363), new LatLng(-33.858754, 151.229596)));
Catatan: Pembatasan ini hanya diterapkan ke seluruh rute, hasil sintetis yang terletak di luar batas persegi panjang dapat ditampilkan berdasarkan rute yang tumpang-tindih dengan pembatasan lokasi.
Memfilter hasil menurut jenis tempat atau koleksi jenis
Anda dapat membatasi hasil dari permintaan pelengkapan otomatis sehingga hanya menampilkan jenis tempat tertentu. Tentukan filter menggunakan jenis tempat atau kumpulan jenis yang tercantum dalam Tabel 1, 2, dan 3 di Jenis Tempat. Jika tidak ada yang ditentukan, semua jenis akan ditampilkan.
Untuk memfilter hasil pelengkapan otomatis, panggil
setTypesFilter()
untuk menyetel filter.
Untuk menentukan filter jenis atau koleksi jenis:
Panggil
setTypesFilter()
dan tentukan hingga lima nilai type dari Tabel 1 dan Tabel 2 yang ditampilkan di Jenis Tempat. Nilai jenis ditentukan oleh konstanta di PlaceTypes.Panggil
setTypesFilter()
dan tentukan kumpulan jenis dari Tabel 3 yang ditampilkan di Jenis Tempat. Nilai kumpulan ditentukan oleh konstanta di PlaceTypes.Hanya satu jenis dari Tabel 3 yang diizinkan dalam permintaan. Jika Anda menentukan nilai dari Tabel 3, Anda tidak dapat menentukan nilai dari Tabel 1 atau Tabel 2. Jika Anda melakukannya, akan terjadi error.
Contoh kode berikut memanggil setTypesFilter()
pada
AutocompleteSupportFragment
dan menentukan beberapa nilai jenis.
Kotlin
autocompleteFragment.setTypesFilter(listOf("landmark", "restaurant", "store"))
Java
autocompleteFragment.setTypesFilter(Arrays.asList("landmark", "restaurant", "store"));
Contoh kode berikut menunjukkan panggilan setTypesFilter()
di
AutocompleteSupportFragment
untuk menyetel filter yang hanya menampilkan hasil dengan
alamat yang akurat dengan menentukan kumpulan jenis.
Kotlin
autocompleteFragment.setTypesFilter(listOf(PlaceTypes.ADDRESS))
Java
autocompleteFragment.setTypesFilter(Arrays.asList(PlaceTypes.ADDRESS, PlaceTypes.ESTABLISHMENT));
Contoh kode berikut menunjukkan cara memanggil setTypesFilter()
di
IntentBuilder
untuk menetapkan filter yang hanya menampilkan hasil dengan alamat yang akurat dengan
menentukan kumpulan jenis.
Kotlin
val intent = Autocomplete.IntentBuilder(AutocompleteActivityMode.FULLSCREEN, fields) .setTypesFilter(listOf(PlaceTypes.ADDRESS)) .build(this)
Java
Intent intent = new Autocomplete.IntentBuilder( AutocompleteActivityMode.FULLSCREEN, fields) .setTypesFilter(Arrays.asList(PlaceTypes.ADDRESS)) .build(this);
Memfilter hasil menurut negara
Untuk memfilter hasil pelengkapan otomatis hingga lima negara, panggil
setCountries()
untuk menetapkan kode negara.
Kemudian, teruskan filter ke fragmen atau maksud. Negara harus diteruskan berupa kode negara dua karakter yang kompatibel dengan ISO 3166-1 Alpha-2.
Contoh kode berikut menunjukkan cara memanggil setCountries()
pada
AutocompleteSupportFragment
, untuk menetapkan filter yang hanya menampilkan hasil dalam
negara yang ditentukan.
Kotlin
autocompleteFragment.setCountries("AU", "NZ")
Java
autocompleteFragment.setCountries("AU", "NZ");
Batas penggunaan
Penggunaan Places API, termasuk Places SDK for Android, tidak lagi dibatasi hingga jumlah permintaan maksimum per hari (QPD). Namun, batas penggunaan berikut masih berlaku:
- Batas kapasitas adalah 6.000 QPM (permintaan per menit). Jumlah ini dihitung sebagai jumlah permintaan sisi klien dan sisi server untuk semua aplikasi yang menggunakan kredensial project yang sama.
Menampilkan atribusi dalam aplikasi Anda
- Jika aplikasi Anda menggunakan layanan pelengkapan otomatis secara terprogram, UI Anda harus menampilkan atribusi 'Didukung oleh Google', atau muncul dalam peta bermerek Google.
- Jika aplikasi Anda menggunakan widget pelengkapan otomatis, tidak ada tindakan tambahan yang diperlukan (atribusi yang diperlukan ditampilkan secara default).
- Jika Anda mengambil dan menampilkan informasi tempat tambahan setelah mendapatkan tempat menurut ID, Anda juga harus menampilkan atribusi pihak ketiga.
Untuk mengetahui detail selengkapnya, lihat dokumentasi tentang atribusi.
Pengoptimalan Place Autocomplete (Lama)
Bagian ini menjelaskan praktik terbaik untuk membantu Anda memaksimalkan layanan Place Autocomplete (Lama).
Berikut ini beberapa pedoman umum:
- Cara tercepat untuk mengembangkan antarmuka pengguna yang berfungsi baik adalah dengan menggunakan widget Pelengkapan Otomatis Tempat (Lama) Maps JavaScript API, widget Pelengkapan Otomatis Tempat (Lama) Places SDK for Android, atau kontrol UI Pelengkapan Otomatis Tempat (Lama) Places SDK for iOS
- Kembangkan pemahaman tentang kolom data Place Autocomplete (Legacy) yang penting sejak awal.
- Kolom pembiasan lokasi dan pembatasan lokasi bersifat opsional, tetapi dapat memberikan dampak signifikan terhadap performa pelengkapan otomatis.
- Gunakan penanganan error untuk memastikan aplikasi Anda terdegrasi secara halus jika API menampilkan error.
- Pastikan aplikasi Anda menanganinya jika tidak ada pilihan dan menawarkan cara kepada pengguna untuk melanjutkan.
Praktik terbaik pengoptimalan biaya
Pengoptimalan biaya dasar
Untuk mengoptimalkan biaya penggunaan layanan Place Autocomplete (Legacy), gunakan mask kolom dalam widget Place Details (Legacy) dan Place Autocomplete (Legacy) agar hanya menampilkan kolom data tempat yang Anda butuhkan.
Pengoptimalan biaya lanjutan
Pertimbangkan implementasi Place Autocomplete (Lama) yang terprogram untuk mengakses Harga Per Permintaan dan meminta hasil Geocoding API tentang tempat yang dipilih, bukan Place Details (Lama). Harga Per Permintaan yang dipasangkan dengan Geocoding API lebih hemat biaya daripada harga Per Sesi (berbasis sesi) jika kondisi berikut terpenuhi:
- Jika Anda hanya memerlukan lintang/bujur atau alamat tempat yang dipilih pengguna, Geocoding API akan mengirimkan informasi ini dengan biaya yang lebih murah daripada panggilan Place Details (Legacy).
- Jika pengguna memilih prediksi pelengkapan otomatis dalam rata-rata empat permintaan prediksi Place Autocomplete (Legacy) atau kurang, harga Per Permintaan mungkin lebih hemat biaya daripada harga Per Sesi.
Apakah aplikasi Anda memerlukan informasi selain alamat dan lintang/bujur dari prediksi yang dipilih?
Ya, memerlukan informasi lebih detail
Gunakan Place Autocomplete berbasis sesi (Lama) dengan Place Details (Lama).
Karena aplikasi Anda memerlukan Place Details (Legacy) seperti nama tempat, status bisnis, atau jam buka, penerapan Place Autocomplete (Legacy) Anda harus menggunakan token sesi (secara terprogram atau bawaan di widget JavaScript, Android, atau iOS). per session ditambah SKU Data Place yang berlaku, bergantung pada kolom data tempat yang Anda minta.1
Penerapan widget
Pengelolaan sesi secara otomatis terintegrasi ke dalam widget JavaScript, Android, atau iOS. Ini mencakup permintaan Place Autocomplete (Legacy) dan permintaan Place Details (Legacy) pada prediksi yang dipilih. Pastikan untuk menentukan parameter fields
untuk memastikan Anda hanya meminta
kolom data tempat yang Anda butuhkan.
Penerapan terprogram
Gunakan token sesi dengan permintaan Place Autocomplete (Legacy) Anda. Saat meminta Place Details (Legacy) tentang prediksi yang dipilih, sertakan parameter berikut:
- ID tempat dari respons Place Autocomplete (Lama)
- Token sesi yang digunakan dalam permintaan Place Autocomplete (Legacy)
- Parameter
fields
yang menentukan kolom data tempat yang Anda perlukan
Tidak, hanya memerlukan alamat dan lokasi
Geocoding API dapat menjadi opsi yang lebih hemat biaya daripada Place Details (Lama) untuk aplikasi Anda, bergantung pada performa penggunaan Place Autocomplete (Lama). Efisiensi Place Autocomplete (Legacy) setiap aplikasi bervariasi bergantung pada apa yang dimasukkan oleh pengguna, tempat aplikasi digunakan, dan apakah praktik terbaik pengoptimalan performa telah diterapkan.
Untuk menjawab pertanyaan berikut, analisis rata-rata jumlah karakter yang diketik pengguna sebelum memilih prediksi Place Autocomplete (Legacy) di aplikasi Anda.
Apakah pengguna Anda rata-rata memilih prediksi Place Autocomplete (Legacy) dalam empat permintaan atau kurang?
Ya
Terapkan Place Autocomplete (Legacy) secara terprogram tanpa token sesi dan panggil Geocoding API di prediksi tempat yang dipilih.
Geocoding API memberikan alamat dan koordinat lintang/bujur. Membuat empat permintaan Place Autocomplete (Legacy) - Per Request ditambah panggilan Geocoding API tentang prediksi tempat yang dipilih lebih murah daripada biaya Place Autocomplete (Legacy) - Per Session per sesi.1
Pertimbangkan untuk menerapkan praktik terbaik performa guna membantu pengguna mendapatkan prediksi yang mereka cari dengan lebih sedikit karakter.
Tidak
Gunakan Place Autocomplete berbasis sesi (Lama) dengan Place Details (Lama).
Karena rata-rata jumlah permintaan yang Anda harapkan sebelum pengguna memilih prediksi Place Autocomplete (Legacy) melebihi biaya harga Per Sesi, penerapan Place Autocomplete (Legacy) Anda harus menggunakan token sesi untuk permintaan Place Autocomplete (Legacy) dan permintaan Place Details (Legacy) terkait per sesi.1
Penerapan widget
Pengelolaan sesi secara otomatis terintegrasi ke dalam widget JavaScript, Android, atau iOS. Ini mencakup permintaan Place Autocomplete (Legacy) dan permintaan Place Details (Legacy) pada prediksi yang dipilih. Pastikan untuk menentukan parameter fields
untuk memastikan Anda hanya meminta kolom Basic Data.
Penerapan terprogram
Gunakan token sesi dengan permintaan Place Autocomplete (Legacy) Anda. Saat meminta Place Details (Legacy) tentang prediksi yang dipilih, sertakan parameter berikut:
- ID tempat dari respons Place Autocomplete (Lama)
- Token sesi yang digunakan dalam permintaan Place Autocomplete (Legacy)
- Parameter
fields
yang menentukan kolom Basic Data seperti alamat dan geometri
Pertimbangkan untuk menunda permintaan Place Autocomplete (Legacy)
Anda dapat menggunakan strategi seperti menunda permintaan Place Autocomplete (Legacy) hingga pengguna mengetik tiga atau empat karakter pertama, sehingga aplikasi Anda membuat lebih sedikit permintaan. Misalnya, membuat permintaan Place Autocomplete (Lama) untuk setiap karakter setelah pengguna mengetik karakter ketiga berarti jika pengguna mengetik tujuh karakter, lalu memilih prediksi yang Anda buat satu permintaan Geocoding API-nya, total biaya yang dikenakan adalah untuk 4 Place Autocomplete (Lama) Per Permintaan + Geocoding.1
Jika permintaan yang tertunda dapat menghasilkan permintaan terprogram rata-rata di bawah empat, Anda dapat mengikuti panduan ini untuk penerapan Place Autocomplete (Legacy) yang berperforma dengan Geocoding API. Perhatikan bahwa permintaan yang tertunda dapat dianggap sebagai latensi oleh pengguna yang mungkin berharap melihat prediksi dengan setiap karakter baru yang mereka ketik.
Pertimbangkan untuk menerapkan praktik terbaik performa guna membantu pengguna Anda mendapatkan prediksi yang mereka cari dengan lebih sedikit karakter.
-
Untuk mengetahui biaya, lihat daftar harga Google Maps Platform.
Praktik terbaik performa
Panduan berikut menjelaskan cara mengoptimalkan performa Place Autocomplete (Legacy):
- Tambahkan pembatasan negara, pembiasan lokasi, dan (untuk penerapan terprogram) preferensi bahasa ke penerapan Place Autocomplete (Legacy) Anda. Preferensi bahasa tidak diperlukan dengan widget karena widget tersebut memilih preferensi bahasa dari browser atau perangkat seluler pengguna.
- Jika Place Autocomplete (Lama) disertai sebuah peta, Anda dapat membiaskan lokasi berdasarkan area pandang peta.
- Jika pengguna tidak memilih salah satu prediksi Place Autocomplete (Legacy), umumnya karena tidak satu pun prediksi tersebut yang merupakan alamat hasil yang diinginkan, Anda dapat menggunakan kembali input pengguna yang asli untuk mendapatkan hasil yang lebih relevan:
- Jika Anda mengharapkan pengguna hanya memasukkan informasi alamat, gunakan kembali input pengguna yang asli dalam panggilan ke Geocoding API.
- Jika Anda memperkirakan pengguna akan memasukkan kueri untuk tempat tertentu berdasarkan nama atau alamat, gunakan permintaan Find Place (Legacy). Jika hasil hanya diharapkan di wilayah tertentu, gunakan pembiasan lokasi.
- Pengguna memasukkan alamat sub-tempat, seperti alamat untuk unit atau apartemen tertentu dalam sebuah gedung. Misalnya, alamat Ceko "Stroupežnického 3191/17, Praha" akan menghasilkan prediksi parsial di Place Autocomplete (Lama).
- Pengguna memasukkan alamat dengan awalan segmen jalan seperti "23-30 29th St, Queens" di New York City atau "47-380 Kamehameha Hwy, Kaneohe" di pulau Kauai di Hawai'i.
Pemecahan masalah
Meskipun berbagai macam error dapat terjadi, sebagian besar error yang mungkin dialami aplikasi Anda biasanya disebabkan oleh error konfigurasi (misalnya, kunci API yang salah digunakan, atau kunci API dikonfigurasi dengan tidak benar), atau error kuota (aplikasi Anda telah melampaui kuotanya). Lihat Batas Penggunaan untuk mengetahui informasi selengkapnya tentang kuota.
Error yang terjadi saat menggunakan kontrol pelengkapan otomatis ditampilkan di callback
onActivityResult()
. Panggil Autocomplete.getStatus()
untuk mendapatkan pesan status
untuk hasilnya.