Pelengkapan otomatis - Amazon Location Service
Kasus penggunaanPahami permintaannyaPahami tanggapannya

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Pelengkapan otomatis

Autocompletemengembalikan 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

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. 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 di Referensi API Amazon Location Service.

Misalnya permintaan, tanggapan, cURL, dan perintah CLI untuk API ini, lihat Cara 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

AutocompleteOperasi ini mendukung banyak atribut permintaan opsional untuk menyempurnakan hasil pencarian. Untuk daftar lengkap atribut permintaan, lihat Pelengkapan Otomatis 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 atau dengan menyediakan Kunci API.

  • 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 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 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

Perbaiki hasil

Gunakan atribut Filter untuk memfilter hasil yang dikembalikan berdasarkan negara, jenis tempat, atau wilayah geografis tertentu. Untuk detail selengkapnya, lihat Pemfilteran 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 di Referensi API Amazon Location Service.

Berikut ini adalah daftar singkat dari beberapa atribut item hasil yang lebih penting.

Alamat dan detail terkait

  • PlaceTypeberisi 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.

  • Addressberisi label hasil dan, jika ["Core"] ditentukan untukAdditionalFeatures, 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 dariBiasPosition. AdditionalFeaturesPerlu diatur ke["Core"].

  • Highlightsmenunjukkan 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. AdditionalFeaturesPerlu diatur ke["Core"].