Method: searchAlongRoute

Menelusuri tempat di sepanjang rute perjalanan.

Permintaan HTTP

POST https://mapstools.googleapis.com/v1:searchAlongRoute

URL ini menggunakan sintaksis gRPC Transcoding.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "textQuery": string,
  "languageCode": string,
  "regionCode": string,
  "routingPreference": enum (RoutingPreference),
  "includeExtendedDetails": boolean,
  "travelMode": enum (RouteTravelMode),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "encodedPolyline": string,
  "retrievalToken": string,
  "routeEndpoints": {
    object (RouteEndpoints)
  }
  // End of mutually exclusive fields.
}
Kolom
textQuery

string

Wajib. Kueri penelusuran bahasa alami (misalnya, "pengisi daya kendaraan listrik", "kopi").
languageCode

string

Opsional. Bahasa untuk ringkasan dan detail tempat. Default-nya adalah "en-US".
regionCode

string

Opsional. Kode negara/wilayah (CLDR) lokasi (misalnya, "US").
routingPreference

enum (RoutingPreference)

Opsional. Preferensi pemilihan rute opsional yang menentukan cara penggunaan data lalu lintas. Nilai defaultnya adalah TRAFFIC_UNAWARE.
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 dapat menimbulkan latensi yang lebih tinggi.
travelMode

enum (RouteTravelMode)

Opsional. Menentukan mode perjalanan yang digunakan untuk menghitung rute dan rute memutar. Default-nya adalah DRIVE. WALK dan BICYCLE hanya didukung dengan routeEndpoints. TRANSIT tidak didukung.
Spesifikasi rute: rute yang ada, token rute, atau endpoint asal/tujuan. Berikut adalah daftar kolom yang saling eksklusif. Maksimal satu kolom akan ditetapkan dalam respons:
encodedPolyline

string

String polyline yang dienkode yang mewakili rute. Lihat https://developers.google.com/maps/documentation/utilities/polylinealgorithm
retrievalToken

string

Token pengambilan yang ditampilkan dari panggilan v1.computeRoutes sebelumnya yang mewakili rute.
routeEndpoints

object (RouteEndpoints)

Endpoint rute eksplisit (asal dan tujuan).
Akhir kolom yang saling eksklusif.

Isi respons

Jika berhasil, isi respons memuat instance SearchAlongRouteResponse.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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