Method: searchText

Menelusuri tempat dengan kueri teks.

Permintaan HTTP

POST https://mapstools.googleapis.com/v1alpha:searchText

URL ini menggunakan sintaksis gRPC Transcoding.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "textQuery": string,
  "languageCode": string,
  "regionCode": string,
  "pageSize": integer,
  "includeExtendedDetails": boolean,
  "locationBias": {
    object (LocationBias)
  }
}
Kolom
textQuery

string

Wajib. Kueri teks.
languageCode

string

Opsional. Bahasa yang diminta untuk menampilkan ringkasan. Jika kode bahasa tidak ditentukan atau tidak dikenali, ringkasan dengan preferensi untuk bahasa Inggris akan ditampilkan.

Misalnya, "en" untuk bahasa Inggris.

Daftar bahasa yang saat ini didukung: https://developers.google.com/maps/faq#languagesupport.
regionCode

string

Opsional. Kode negara/wilayah Unicode (CLDR) lokasi asal permintaan. Parameter ini digunakan untuk menampilkan detail tempat, seperti nama tempat khusus wilayah, jika tersedia. Parameter ini dapat memengaruhi hasil berdasarkan hukum yang berlaku.

Misalnya, "US" untuk Amerika Serikat.

Untuk mengetahui informasi selengkapnya, lihat https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html.

Perhatikan bahwa kode wilayah 3 digit saat ini tidak didukung.
pageSize

integer

Opsional. Jumlah maksimum tempat yang akan ditampilkan, hingga 10. Layanan mungkin menampilkan lebih sedikit dari nilai ini. Nilai defaultnya adalah 5.

Meminta lebih dari 5 Tempat akan memicu paket Pro dan menimbulkan biaya yang ditagih dan latensi yang lebih tinggi.
includeExtendedDetails

boolean

Opsional. Menyertakan detail tempat yang diperluas dalam respons.

Tetapkan kolom ini ke true jika permintaan pengguna memerlukan insight kualitatif yang lengkap, dinamika real-time, atau atribut entitas khusus: - Ulasan kualitatif, sentimen pelanggan, dan masukan. - Penawaran spesifik seperti item menu, hidangan, makanan khas, minuman, atau keunggulan bisnis. - Suasana, dekorasi interior, estetika, nuansa, atau mood kualitatif. - Data real-time dan spesifikasi fasilitas khusus, kebijakan/tips pengunjung, waktu tunggu.

Biarkan false (default) untuk penelusuran penemuan standar (misalnya, masakan, jenis toko), pencarian lokasi/alamat, info kontak, jam buka, dan metadata/fasilitas standar.

Mengaktifkan kolom ini akan memicu paket Pro dan menimbulkan biaya penagihan yang lebih tinggi serta latensi yang lebih tinggi.
locationBias

object (LocationBias)

Wilayah opsional untuk membiaskan hasil penelusuran. Jika lokasi eksplisit ada di textQuery, lokasi tersebut akan digunakan untuk membiaskan hasil penelusuran, bukan kolom ini.

Isi respons

Jika berhasil, isi respons memuat instance SearchTextResponse.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/maps-platform.mapstools