Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Pelengkapan otomatis
`Autocomplete`mengembalikan alamat lengkap dan komponen alamat berdasarkan masukan sebagian. Kasus penggunaan utama termasuk pengisian otomatis formulir alamat dan penyelesaian alamat typeahead (melengkapi alamat secara interaktif saat pengguna akhir mengetiknya).
**catatan**
Secara default, hanya ID tempat, tipe tempat, dan atribut label yang dikembalikan untuk setiap hasil. Detail tambahan yang kaya, termasuk rincian alamat lengkap dan rentang sorotan masukan untuk kasus penggunaan interaktif dapat diperoleh dengan menyetel atribut `AdditionalFeatures` input, tetapi perhatikan bahwa meminta fitur tambahan dapat berdampak [Harga tempat](places-pricing.md)
**catatan**
Alamat Jepang tidak didukung.
Hasil selalu alamat, atau komponen alamat seperti jalan, kode pos, dan negara. Tempat menarik tidak pernah dikembalikan. Hasil tidak termasuk geocode, karena `Autocomplete` difokuskan pada penyelesaian alamat, bukan geocoding. Untuk mendapatkan koordinat geocode alamat, gunakan operasi [Geocode](https://docs.aws.amazon.com/location/latest/developerguide/geocode.html). Hasil dapat disaring berdasarkan wilayah geografis. Mereka juga dapat disaring berdasarkan jenis tempat, misalnya untuk hanya menyertakan lokalitas atau hanya kode pos.
Untuk detail selengkapnya tentang semua atribut permintaan dan respons Pelengkapan Otomatis, lihat [Pelengkapan Otomatis](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_Autocomplete.html) di Referensi *API Amazon Location Service*.
Misalnya permintaan, tanggapan, cURL, dan perintah CLI untuk API ini, lihat [Cara](https://docs.aws.amazon.com/location/latest/developerguide/autocomplete-how-to.html) menggunakan Pelengkapan Otomatis.
## Kasus penggunaan
+ **Tingkatkan pengalaman checkout:** Berikan penyelesaian alamat waktu nyata saat pelanggan memasukkan alamat mereka dalam pengalaman checkout e-commerce dan pengalaman entri alamat lainnya di situs web atau aplikasi. Pastikan lokasi pengiriman atau penjemputan sesuai dengan alamat yang diketahui, mengurangi kesalahan yang mahal dan meningkatkan kepuasan pelanggan.
+ **Support Customer Services:** Berikan saran alamat real-time kepada perwakilan layanan pelanggan di bidang-bidang seperti pusat kontak dan pengiriman layanan darurat, merampingkan proses pengumpulan informasi alamat yang akurat dan meningkatkan kepuasan pengguna dengan mengurangi waktu yang dibutuhkan untuk mendapatkan informasi alamat yang benar.
## Pahami permintaannya
`Autocomplete`Operasi ini mendukung banyak atribut permintaan opsional untuk menyempurnakan hasil pencarian. Untuk daftar lengkap atribut permintaan, lihat [Pelengkapan Otomatis](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_Autocomplete.html) di *Referensi API Amazon Location Service*.
Permintaan menerima parameter kunci berikut:
**Autentikasi**
Operasi Autocomplete API mendukung dua mode otentikasi alternatif. [Anda dapat mengautentikasi baik dengan menandatangani permintaan dengan tanda [tangan SigV4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html) atau dengan menyediakan Kunci API.](https://docs.aws.amazon.com/location/latest/developerguide/access.html)
+ Jika Anda membuat permintaan menggunakan AWS SDK khusus bahasa atau menggunakan AWS CLI, permintaan Anda biasanya akan ditandatangani dengan SigV4 secara default.
+ Dalam beberapa kasus penggunaan, misalnya, membuat permintaan dari browser web atau menggunakan klien SDK non-AWS lainnya, kunci API adalah bentuk otentikasi yang lebih tepat. Gunakan atribut Permintaan Kunci opsional untuk menyediakan kunci API untuk `Autocomplete` mengautentikasi.
Untuk informasi selengkapnya, lihat [Autentikasi dengan Amazon Location Service](access.md) di *Referensi API Amazon Location Service*.
**Menentukan alamat untuk query**
+ Gunakan atribut `QueryText` permintaan wajib untuk menyediakan teks bentuk bebas untuk kueri.
+ `BiasPosition`: Gunakan atribut `BiasPosition` permintaan opsional untuk memberikan posisi pin, sebagai pasangan `[longitude, latitude]` koordinat, untuk meningkatkan relevansi hasil yang dikembalikan.
Untuk informasi selengkapnya, lihat [Query dan bias](places-querying-biasing.md) di *Referensi API Amazon Location Service*.
**Termasuk semua atribut respons**
Setel bidang opsional AdditionalFeatures ke nilai ["Core"] untuk menyertakan semua atribut hasil yang tersedia dalam respons, termasuk rincian alamat lengkap dan lokasi sorotan interaktif. [Perhatikan bahwa meminta atribut tambahan ini dapat memengaruhi harga](https://aws.amazon.com/location/pricing/)
**Perbaiki hasil**
Gunakan atribut Filter untuk memfilter hasil yang dikembalikan berdasarkan negara, jenis tempat, atau wilayah geografis tertentu. Untuk detail selengkapnya, lihat [Pemfilteran](places-filtering.md) di *Panduan Pengembang Layanan Lokasi Amazon*.
## Pahami tanggapannya
Objek respon berisi atribut array bernama `ResultItems` yang berisi daftar hasil peringkat dalam urutan menaik relevansi. Untuk daftar lengkap atribut item hasil, lihat [Pelengkapan Otomatis](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_Autocomplete.html) di *Referensi API Amazon Location Service*.
Berikut ini adalah daftar singkat dari beberapa atribut item hasil yang lebih penting.
**Alamat dan detail terkait**
+ `PlaceType`berisi jenis tempat hasil, yang memberi tahu kita apakah alamat tersebut mewakili alamat titik, jalan, dll. Hasil yang dikembalikan oleh `Autocomplete` akan selalu memiliki jenis tempat yang mewakili alamat lengkap atau komponen alamat, seperti kode jalan atau pos. Hasil tidak akan pernah menyertakan tempat menarik.
+ `Address`berisi label hasil dan, jika `["Core"]` ditentukan untuk`AdditionalFeatures`, itu juga berisi rincian lengkap alamat ke dalam bidang terstruktur termasuk nomor rumah, nama jalan, kode pos, negara, dan sejenisnya..
**Analisis hasil**
Menyediakan data analisis untuk setiap hasil dalam kaitannya dengan kueri input.
+ `Distance`: Jika a `BiasPosition` disediakan dalam permintaan, setiap item hasil berisi `Distance` atribut yang memberikan jarak, dalam meter, dari hasil itu dari`BiasPosition`. `AdditionalFeatures`Perlu diatur ke`["Core"]`.
+ `Highlights`menunjukkan di mana kata, frasa, dan substring dari input `QueryText` muncul persis di atribut hasil, memungkinkan aplikasi untuk memberikan pengalaman pengguna yang bermanfaat yang menyoroti kecocokan bagi penggunanya. `AdditionalFeatures`Perlu diatur ke`["Core"]`.