Ringkasan penelusuran sepanjang rute

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

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

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.

Catatan: Rute sistem transportasi umum tidak didukung oleh Places API.

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 (Baru). Respons kemudian berisi tempat yang cocok dengan kriteria penelusuran dan juga terletak di dekat rute yang ditentukan.

Penelusuran di sepanjang rute serupa dengan penggunaan opsi permintaan locationRestriction atau locationBias untuk memengaruhi hasil penelusuran. locationRestriction menampilkan hasil penelusuran yang berada dalam batas area pandang, sementara locationBias dapat menampilkan hasil penelusuran di luar area pandang. Namun, meskipun opsi locationBias dan locationRestriction memungkinkan Anda menentukan wilayah untuk memengaruhi hasil penelusuran, fitur penelusuran di sepanjang rute dalam Penelusuran Teks juga memungkinkan Anda memengaruhi hasil penelusuran untuk menyertakan hasil dengan waktu perjalanan yang paling singkat dari asal rute ke tujuan rute. Anda dapat memengaruhi hasil penelusuran menggunakan locationBias atau locationRestriction bersama dengan polyline.

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

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

Ringkasan penghitungan perutean

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

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

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

Catatan: Ini hanya perkiraan informasi perutean. Untuk mendapatkan detail rute sebenarnya, termasuk petunjuk langkah demi langkah, gunakan Routes API.

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

Catatan: TRAFFIC_AWARE dan TRAFFIC_OPTIMAL hanya berlaku untuk mode perjalanan DRIVE dan TWO_WHEELER. Jika preferensi perutean ditentukan dengan mode perjalanan yang tidak didukung, penghitungan ringkasan perutean akan menggunakan opsi TRAFFIC_UNAWARE secara default. Jika TWO_WHEELER ditentukan di wilayah yang tidak didukung, API akan menampilkan ringkasan perutean kosong.

Saat Anda menetapkan TRAFFIC_AWARE preferensi perutean, rute dihitung dengan memperhitungkan kondisi lalu lintas. Hasilnya, rute dan detail rute mencerminkan kondisi dunia nyata dengan lebih akurat. Karena peningkatan kualitas data ini mengorbankan latensi respons, pengoptimalan performa diterapkan untuk mengurangi sebagian besar latensi. Saat Anda menetapkan preferensi perutean TRAFFIC_AWARE_OPTIMAL, rute dihitung dengan memperhitungkan kondisi lalu lintas, tetapi tidak ada pengoptimalan performa yang diterapkan. Dalam mode ini, server melakukan penelusuran jaringan jalan yang lebih komprehensif untuk menemukan rute optimal.

Tentang rute, segmen, dan titik jalan

Beberapa komponen membentuk rute, sebagaimana dihitung oleh Routes API:

Rute terdiri dari komponen berikut:

• Titik jalan: Untuk menghitung rute, Anda harus menentukan setidaknya 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 dalam rute.

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

  Saat meneruskan rute ke Penelusuran Teks, Anda meneruskan polyline yang dienkode rute 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, maka rute tersebut berisi satu segmen.

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

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

Menghitung ringkasan perutean dengan penelusuran di sepanjang rute

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

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

Dalam contoh ini, lokasi A adalah tempat yang ditampilkan di hasil penelusuran dari Text Search (Baru). Untuk setiap tempat dalam respons, penelusuran mencakup durasi dan jarak yang diperlukan untuk memutar 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 kemudian dapat menghitung durasi dan jarak rute alternatif, 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 titik asal ke A; \(s_{OA}\) adalah jarak perjalanan dari titik asal ke A
• \(t_{AD}\) adalah durasi perjalanan dari A ke tujuan; \(s_{AD}\) adalah jarak perjalanan dari A ke tujuan

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

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

Jarak jalan memutar adalah perbedaan jarak antara perjalanan awal (dari tempat asal ke tujuan) dan perjalanan baru (dari tempat asal ke tujuan melalui A):

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