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

# Cari Teks
<a name="search-text"></a>

Teks Pencarian memungkinkan Anda untuk menanyakan data lokasi menggunakan satu input teks bentuk bebas, mengembalikan hasil tempat dengan filter opsional seperti negara, lingkaran geografis, atau kotak pembatas. API juga memungkinkan pencarian dengan `QueryId` dikembalikan dari Suggest API. Tanggapan tersebut mencakup detail seperti nama tempat, alamat, nomor telepon, kategori, jenis makanan, informasi kontak, dan jam buka. Fitur opsional seperti fonem, zona waktu, dan lainnya juga tersedia berdasarkan parameter yang ditentukan.

**catatan**  
Jika hasil disimpan, mereka akan ditagih pada tingkat harga Storage yang lebih tinggi. Gunakan `IntendedUse` parameter untuk menentukan apakah hasilnya untuk penggunaan tunggal atau penyimpanan. Lihat [Harga tempat](places-pricing.md) untuk implikasi biaya yang terkait dengan hasil yang disimpan.

Untuk informasi selengkapnya, lihat [SearchText](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_SearchText.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/search-text-how-to.html) menggunakan Teks Pencarian.

## Kasus penggunaan
<a name="search-text-use-cases"></a>
+ **Pencarian lingkungan berdasarkan teks:** Bantu pelanggan menemukan tempat terdekat yang relevan. Pelanggan dapat menemukan alamat, bisnis, atau objek wisata terdekat seperti museum, toko, atau taman.
+ **Penemuan bisnis:** Memungkinkan pengguna menemukan bisnis atau jenis tempat tertentu dengan memasukkan kata kunci seperti “restoran Italia” atau “kedai kopi.” Fitur ini sangat berguna untuk pengiriman makanan atau aplikasi rekomendasi restoran.
+ **Tempatkan pencarian di aplikasi perjalanan:** Memungkinkan pengguna untuk mencari lokasi, landmark, atau bisnis menggunakan teks bentuk bebas, seperti “hotel di dekat Menara Eiffel,” untuk menerima saran yang relevan dengan cepat.
+ **Pencarian lembaga pendidikan:** Memungkinkan pengguna untuk mencari sekolah, perguruan tinggi, atau pusat pelatihan (misalnya, “sekolah dasar” atau “universitas”), alat yang berguna untuk orang tua atau siswa.

## Pahami permintaannya
<a name="search-text-request-parameters"></a>

**catatan**  
 Untuk pelanggan di `ap-southeast-1` dan`ap-southeast-5`, bidang permintaan dan respons yang didukung mungkin berbeda. Lihat [Referensi SearchText API](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_SearchText.html) untuk detailnya. 

Permintaan API Teks Pencarian memungkinkan berbagai parameter untuk menyempurnakan pencarian. Parameter opsional memungkinkan fitur tambahan, bias lokasi, kriteria pemfilteran, preferensi bahasa, dan batas hasil. Untuk detail selengkapnya, lihat Referensi API Teks Pencarian.

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**  
Parameter yang digunakan untuk menentukan pencarian teks dan bias lokasi.  
+ `QueryText`: Teks bentuk bebas untuk mencari tempat.
+ `QueryId`: Memungkinkan penyelesaian kueri yang disarankan dari Suggest API.
+ `BiasPosition`: Memprioritaskan hasil 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 data tambahan seperti detail zona waktu.
Untuk informasi selengkapnya, lihat [Fitur tambahan](additional-features.md).

## Pahami responsnya
<a name="search-text-response-details"></a>

Respons dari API Teks Pencarian mencakup hasil terperinci yang cocok dengan kueri, dengan informasi tentang lokasi, detail alamat, rantai bisnis, kontak, fonem, zona waktu, dan jam buka. Untuk detail selengkapnya, lihat Referensi API Teks Pencarian.

Tanggapan tersebut mencakup data kunci berikut:

**Alamat dan Detail Terkait**  
Informasi alamat yang komprehensif untuk lokasi yang dikembalikan.  
+ `Address`: Termasuk rincian negara, jalan, dan alamat lainnya.

**Jenis dan Kategori Tempat**  
Menjelaskan jenis dan kategori tempat.  
+ `Categories`: Daftar kategori yang menggambarkan tempat, seperti *Restoran* atau *Sekolah*.
+ `PlaceType`: Menentukan jenis tempat, seperti kota, alamat, atau wilayah.
+ `BusinessChains`: Menunjukkan rantai bisnis terkait.

**Detail Tambahan**  
Data tambahan yang terkait dengan tempat, seperti yang diminta.  
+ `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.