Cari Teks

catatan

Jika hasil disimpan, mereka akan ditagih pada tingkat harga Penyimpanan yang lebih tinggi. Gunakan IntendedUse parameter untuk menentukan apakah hasilnya untuk penggunaan tunggal atau penyimpanan. Lihat implikasi Harga tempat biaya yang terkait dengan hasil yang disimpan.

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.

Kasus penggunaan

• 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

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 mencakup parameter kunci berikut:

Autentikasi

KeyParameter ini opsional jika metode otentikasi lain digunakan.

• Key: Kunci API untuk otorisasi.

Untuk informasi selengkapnya, lihat Autentikasi dengan Amazon Location Service.

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.

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 Penyaringan.

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.

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.

Pahami tanggapannya

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 terkait dengan tempat, seperti yang diminta.

• Contacts: Menyediakan email, nomor telepon, dan situs web.

• OpeningHours: Jam operasional tempat.

• AccessPointsKoordinat geografis yang terkait dengan tempat tersebut.

• Phonemes: Representasi fonetik dari komponen alamat.

• TimeZone: Informasi zona waktu, termasuk offset.