Ringkasan penelusuran di sepanjang rute

Fitur penelusuran di sepanjang rute tersedia di Places (New) API berikut:

  • Khusus Text Search (Baru): Menelusuri tempat di sepanjang rute perjalanan yang telah ditentukan.
  • Text Search (Baru) dan Nearby Search (Baru): Menghitung ringkasan rute dari lokasi asal rute yang ditentukan ke setiap tempat dalam hasil penelusuran.
  • Khusus Penelusuran Teks (Baru): Menghitung ringkasan pemilihan rute untuk setiap tempat di sepanjang rute perjalanan yang telah ditentukan.

Menelusuri sepanjang rute

Anda menggunakan Routes API untuk menghitung rute perjalanan antara dua lokasi. Routes API dapat menghitung rute untuk mobil, sepeda, kendaraan roda dua, sistem transportasi umum, atau untuk berjalan kaki.

Text Search (Baru) memungkinkan Anda menggunakan rute yang dihitung ini untuk melakukan penelusuran di sepanjang rute. Dengan opsi ini, Anda meneruskan rute yang telah dihitung sebelumnya dari Routes API ke permintaan Text Search (New). Respons kemudian berisi tempat yang cocok dengan kriteria penelusuran dan juga terletak di dekat rute yang ditentukan.

Menelusuri sepanjang rute mirip dengan menggunakan opsi permintaan locationRestriction atau locationBias untuk membiaskan hasil penelusuran. locationRestriction menampilkan hasil penelusuran yang berada dalam batas area pandang, sedangkan locationBias dapat menampilkan hasil penelusuran di luar area pandang. Namun, meskipun opsi locationBias dan locationRestriction memungkinkan Anda menentukan wilayah untuk membiaskan hasil penelusuran, fitur penelusuran di sepanjang rute di Text Search juga memungkinkan Anda memiringkan hasil penelusuran untuk menyertakan hasil dengan waktu pengalihan minimal dari asal rute ke tujuan rute. Anda dapat membiaskan hasil penelusuran menggunakan locationBias atau locationRestriction dalam kombinasi dengan polyline.

Misalnya, pertimbangkan rute dari asal, yang disebut sebagai titik jalan di Routes API, ke tujuan seperti yang dihitung oleh Routes API:

Rute dari titik jalan asal ke tujuan dengan hasil penelusuran.

Saat Anda menelusuri di sepanjang rute, penelusuran akan dibiaskan untuk menampilkan tempat di dekat rute dengan waktu pengalihan minimal dari asal ke tujuan. Dalam contoh ini, titik A, B, dan C adalah tempat yang ditampilkan oleh penelusuran.

Menghitung ringkasan perutean

Text Search (Baru) dan Nearby Search (Baru) dapat menghitung ringkasan pemilihan rute, yang berarti durasi dan jarak, ke setiap tempat dalam respons berdasarkan lokasi asal pemilihan rute yang ditentukan dalam permintaan. Saat Anda menentukan asal pemilihan rute, respons tidak hanya berisi daftar tempat yang cocok dengan penelusuran, tetapi juga durasi dan jarak perjalanan dari asal pemilihan rute ke setiap tempat.

Pada gambar berikut, titik A, B, dan C adalah tempat yang ditampilkan dalam respons penelusuran:

Titik A, B, dan C adalah tempat yang ditampilkan dalam respons penelusuran.

Untuk setiap tempat dalam hasil, respons berisi durasi perjalanan dan jarak dari asal perutean ke tempat, jika tersedia.

Secara default, durasi dan jarak perjalanan dihitung menggunakan opsi TRAFFIC_UNAWARE di Routes API. Secara opsional, Anda dapat menetapkan preferensi pemilihan rute untuk mempertimbangkan kondisi lalu lintas live TRAFFIC_AWARE_OPTIMAL atau kondisi lalu lintas live dengan latensi yang dikurangi TRAFFIC_AWARE selama penghitungan.

Tentang rute, segmen, dan titik jalan

Beberapa komponen membentuk rute, seperti yang dihitung oleh Routes API:

Komponen yang membentuk rute.

Rute terdiri dari komponen berikut:

  • Waypoint: Untuk menghitung rute, Anda harus menentukan minimal lokasi asal dan tujuan. Anda menentukan lokasi ini sebagai titik jalan di rute. Titik jalan perantara adalah lokasi di antara tempat asal dan tujuan yang ingin Anda lalui.

  • Rute: Seluruh perjalanan dari titik jalan asal, melalui titik jalan perantara, ke titik jalan tujuan. Rute terdiri dari satu atau beberapa segmen.

    Saat meneruskan rute ke Text Search, Anda meneruskan polyline rute yang dienkode seperti yang ditampilkan oleh Routes API. Polyline yang dienkode adalah daftar titik lintang dan bujur yang dienkode yang memungkinkan Anda merepresentasikan polyline rute sebagai string.

  • Segmen: Jalur dari satu titik jalan di rute ke titik jalan berikutnya di rute. Setiap segmen terdiri dari satu atau beberapa langkah terpisah.

    Rute berisi segmen terpisah untuk jalur dari setiap titik jalan ke titik jalan berikutnya. Misalnya, jika rute berisi satu titik jalan asal dan satu titik jalan tujuan, rute tersebut berisi satu segmen.

    Untuk setiap titik jalan tambahan yang Anda tambahkan ke rute setelah asal dan tujuan, yang disebut titik jalan perantara, API akan menambahkan segmen terpisah.

Untuk informasi selengkapnya tentang rute dan penghitungan rute, lihat Routes API.

Menghitung ringkasan pemilihan rute dengan penelusuran di sepanjang rute

Anda dapat menggabungkan penghitungan ringkasan pemilihan rute dengan penelusuran di sepanjang rute. Dalam hal ini, Text Search (Baru) menampilkan durasi perjalanan dan jarak ke setiap tempat dalam respons, lalu dari setiap tempat ke tujuan akhir rute. Anggaplah penghitungan ini sebagai penghitungan durasi dan jarak perjalanan jika Anda berbelok dari rute yang ditentukan untuk melakukan perjalanan ke tempat dalam hasil penelusuran, lalu melanjutkan ke tujuan akhir.

Misalnya, pertimbangkan rute berikut dari asal ke tujuan seperti yang dihitung oleh Routes API. Teruskan rute ini ke Text Search (New) API bersama dengan kriteria penelusuran Anda.

Rute dari titik jalan asal ke tujuan dengan pengalihan ke hasil penelusuran.

Dalam contoh ini, lokasi A adalah tempat yang ditampilkan dalam hasil penelusuran dari Text Search (Baru). Untuk setiap tempat dalam respons, penelusuran menyertakan durasi dan jarak yang diperlukan untuk berputar balik ke tempat tersebut sebagai perjalanan dua segmen:

  • Segmen pertama berisi durasi dan jarak perjalanan dari asal rute ke tempat. Dalam contoh ini, dari asal ke tempat A.
  • Segmen kedua berisi durasi dan jarak perjalanan dari tempat ke tujuan rute. Dalam contoh ini, dari A ke tujuan.

Dari informasi dalam respons, Anda dapat menghitung durasi dan jarak pengalihan, dengan:

  • \(t_{OD}\) adalah durasi perjalanan dari asal ke tujuan, \(s_{OD}\) adalah jarak perjalanan dari asal ke tujuan
  • \(t_{OA}\) adalah durasi perjalanan dari asal ke A; \(s_{OA}\) adalah jarak perjalanan dari asal ke A
  • \(t_{AD}\) adalah durasi perjalanan dari A ke tujuan; \(s_{AD}\) adalah jarak perjalanan dari A ke tujuan

Durasi pengalihan adalah perbedaan durasi antara perjalanan asli (dari asal ke tujuan) dan perjalanan baru (dari asal ke tujuan melalui A):

$$ t_{detour} = t_{OA} + t_{AD} - t_{OD} $$

Jarak pengalihan adalah perbedaan jarak antara perjalanan asli (dari asal ke tujuan) dan perjalanan baru (dari asal ke tujuan melalui A):

$$ s_{detour} = s_{OA} + s_{AD} - s_{OD} $$
Berikutnya
Telusuri sepanjang rute