Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Sarankan
Sarankan memberikan prediksi atau rekomendasi berdasarkan masukan atau konteks pengguna, seperti tempat yang relevan, tempat menarik, istilah kueri, atau kategori pencarian. Ini membantu pengguna dalam menemukan tempat, tempat menarik, atau mengidentifikasi kueri tindak lanjut berdasarkan masukan yang tidak lengkap atau salah eja. API mengembalikan daftar kemungkinan kecocokan atau penyempurnaan, yang dapat digunakan untuk merumuskan kueri yang lebih akurat. Pengguna dapat memilih saran yang sesuai untuk pencarian lebih lanjut. API mendukung hasil pemfilteran berdasarkan lokasi dan atribut lainnya dan menawarkan fitur tambahan seperti fonem dan zona waktu. Tanggapan tersebut mencakup istilah kueri yang disempurnakan dan informasi tempat terperinci.
**catatan**
Secara default, API Suggest hanya mengembalikan `ID` dan `Title` bidang, menyediakan opsi hemat biaya. Komponen dan sorotan alamat tambahan dapat diminta dengan menyetel `additionalFeatures` ke`Core`. Lihat implikasi [Harga tempat](places-pricing.md) biaya yang terkait dengan hasil yang disimpan.
Untuk informasi selengkapnya, lihat [Menyarankan](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_Suggest.html) di *Referensi API Amazon Location Service*.
Misalnya perintah request, response, cURL, dan CLI untuk API ini, lihat [Cara](https://docs.aws.amazon.com/location/latest/developerguide/suggest-how-to.html) menggunakan Suggest.
## Kasus penggunaan
+ **Layanan Ride-Hailing:** Berikan saran waktu nyata untuk menyelesaikan alamat lokasi penjemputan dan pengantaran dengan cepat, memastikan akurasi dan pemesanan perjalanan yang lebih cepat.
+ **Layanan Perjalanan dan Navigasi:** Menawarkan prediksi waktu nyata untuk lokasi atau landmark, bahkan untuk istilah yang salah eja atau dimasukkan sebagian, seperti “Eifel” untuk “Menara Eiffel.” API menyempurnakan saran untuk menawarkan tempat menarik terdekat yang relevan, membantu pengguna menemukan tempat secara akurat.
+ **Bantuan Pencarian Restoran:** Antisipasi minat pengguna di restoran dan sarankan pilihan bersantap terdekat, meningkatkan pengalaman pencarian.
## Pahami permintaannya
**catatan**
Untuk pelanggan di `ap-southeast-1` dan`ap-southeast-5`, bidang permintaan dan respons yang didukung mungkin berbeda. Lihat [Referensi API Sarankan](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_Suggest.html) untuk detailnya.
Permintaan Suggest API menggunakan parameter untuk menghasilkan saran berdasarkan masukan pengguna. Parameter opsional memungkinkan hasil pencarian yang disempurnakan menggunakan bias lokasi dan kriteria penyaringan. Untuk detail selengkapnya, lihat Referensi API Sarankan.
Permintaan tersebut mencakup parameter kunci berikut:
**Autentikasi**
`Key`Parameter ini opsional jika metode otentikasi lain digunakan.
+ `Key`: Kunci API untuk otorisasi.
Untuk informasi selengkapnya, lihat [Autentikasi dengan Amazon Location Service](access.md)
**Meminta**
Mendefinisikan pencarian teks bebas dan bias lokasi.
+ `QueryText`: Teks bentuk bebas untuk menghasilkan saran. (Diperlukan)
+ `BiasPosition`: Memprioritaskan saran di dekat garis bujur dan garis lintang tertentu.
Untuk informasi selengkapnya, lihat [Query dan bias](places-querying-biasing.md)
**Hasil penyempurnaan**
Memfilter hasil untuk mempersempit kriteria pencarian.
+ `Filter`: Memungkinkan penyaringan dengan membatasi kotak atau area melingkar untuk membatasi hasil pencarian.
Untuk detail selengkapnya, lihat [Pemfilteran](places-filtering.md)
**Internasionalisasi dan Lokalisasi**
Opsi untuk menyesuaikan bahasa dan menerapkan pandangan politik pada hasil.
+ `Language`: Menentukan bahasa hasil.
+ `PoliticalView`: Menerapkan pandangan politik yang mencerminkan klaim teritorial.
Untuk informasi selengkapnya, lihat [Lokalisasi dan internasionalisasi](places-localization-internationalization.md)
**Fitur tambahan**
Meminta data tambahan, seperti informasi zona waktu.
+ `AdditionalFeatures`: Opsi untuk meminta detail tambahan seperti zona waktu atau data fonetik.
Untuk informasi selengkapnya, lihat [Fitur tambahan](additional-features.md)
**Membatasi hasil**
Menetapkan batas jumlah hasil atau penyempurnaan kueri yang dikembalikan.
+ `MaxQueryRefinements`: Membatasi jumlah persyaratan penyempurnaan kueri yang dikembalikan.
+ `MaxResults`: Membatasi jumlah saran yang dikembalikan.
## Pahami responsnya
Respons menyediakan alamat atau tempat yang disarankan berdasarkan kueri masukan, dengan atribut seperti lokasi, detail alamat, rantai bisnis, kontak, fonem, zona waktu, dan jam buka. API kembali`ResultItems`, mewakili kemungkinan kecocokan untuk menyelesaikan kueri masukan. Ada dua jenis hasil, diidentifikasi oleh`SuggestResultItemType`: hasil dari jenis `Query` menyarankan kategori tindak lanjut atau kueri rantai, yang dapat digunakan untuk mendapatkan hasil terfokus untuk kategori tertentu dengan meneruskan `QueryID` ke SearchText API. Hasil jenis `Place` memberikan hasil akhir dengan alamat dan informasi tambahan tentang tempat itu. Untuk detail lebih lanjut, lihat Referensi API untuk Suggest API.
Tanggapan tersebut mencakup data kunci berikut:
**Analisis hasil**
Memberikan informasi tentang menyempurnakan kueri input.
+ `QueryRefinements`: Istilah yang dapat digunakan untuk menyempurnakan permintaan pencarian.
+ `Highlights`: Menyoroti bagian alamat atau judul yang cocok dengan kueri.
**Jenis dan kategori tempat**
Menjelaskan jenis dan kategori tempat.
+ `Categories`Kategori yang menggambarkan tempat, seperti *Restoran* atau *Sekolah*.
+ `PlaceType`: Menentukan jenis tempat, seperti kota, alamat, atau wilayah.
+ `BusinessChains`: Menunjukkan rantai bisnis terkait.
**Detail tambahan**
Informasi tambahan tentang tempat itu, sebagaimana ditentukan dalam permintaan.
+ `Contacts`: Menyediakan email, nomor telepon, dan situs web.
+ `OpeningHours`: Jam operasional tempat itu.
+ `AccessPoints`Koordinat geografis yang terkait dengan tempat tersebut.
+ `Phonemes`: Representasi fonetik dari komponen alamat.
+ `TimeZone`: Informasi zona waktu, termasuk offset.