Ringkasan penelusuran di sepanjang rute

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

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

Telusuri sepanjang rute

Anda menggunakan Routes API untuk menghitung rute perjalanan di 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 telusuri di sepanjang rute. Dengan opsi ini, Anda meneruskan rute yang telah dihitung sebelumnya dari Routes API ke permintaan Text Search (Baru). Responsnya kemudian berisi tempat yang cocok dengan kriteria penelusuran dan juga terletak di dekat lokasi rute perjalanan.

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:

Saat Anda melakukan penelusuran di sepanjang rute, penelusuran akan dicondongkan untuk menampilkan tempat di dekat rute dengan waktu putar balik minimal dari tempat asal ke tujuan. Di sini misalnya, titik A, B, dan C adalah tempat yang dikembalikan oleh penelusuran.

Hitung ringkasan pemilihan rute

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

Pada gambar berikut, titik A, B, dan C adalah tempat yang dikembalikan dalam pencarian respons:

Untuk setiap tempat dalam hasil, respons berisi durasi perjalanan dan jarak dari asal {i>routing<i} ke tempat tersebut, jika tersedia.

Catatan: Ini hanya estimasi informasi pemilihan rute. Untuk mendapatkan detail rute, termasuk petunjuk langkah demi langkah, gunakan Rute API.

Secara default, durasi dan jarak perjalanan dihitung menggunakan opsi TRAFFIC_UNAWARE di Routes API. Anda dapat secara opsional mengatur preferensi {i>routing<i} untuk mengambil kondisi lalu lintas real time TRAFFIC_AWARE_OPTIMAL atau pengurangan latensi kondisi lalu lintas TRAFFIC_AWARE sebagai pertimbangan selama penghitungan.

Catatan: TRAFFIC_AWARE dan TRAFFIC_OPTIMAL hanya berlaku untuk mode perjalanan DRIVE dan TWO_WHEELER. Jika salah satu preferensi {i>routing<i} adalah ditetapkan dengan mode perjalanan yang tidak didukung, secara default penghitungan ringkasan pemilihan rute TRAFFIC_UNAWARE. Jika TWO_WHEELER ditentukan dalam wilayah yang tidak didukung, API akan menampilkan ringkasan pemilihan rute kosong.

Saat Anda menyetel TRAFFIC_AWARE preferensi {i>routing<i}, rute dihitung dengan memperhitungkan kondisi lalu lintas. Sebagai hasilnya, detail rute dan rute lebih akurat mencerminkan situasi aktual kondisi tertentu. Karena peningkatan kualitas data ini mengorbankan respons latensi, pengoptimalan performa diterapkan untuk mengurangi banyak latensi. Saat Anda menyetel TRAFFIC_AWARE_OPTIMAL preferensi {i>routing<i}, rute dihitung dengan memperhitungkan kondisi lalu lintas, tetapi pengoptimalan performa tidak diterapkan. Dalam mode ini, server melakukan penelusuran jaringan jalan yang lebih menyeluruh untuk menemukan rute yang optimal.

Tentang rute, segmen jalan, dan titik jalan

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

Rute terdiri dari komponen berikut:

• Titik jalan: 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 akan dilalui rute tersebut.

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

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

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

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

Untuk mengetahui informasi selengkapnya tentang rute dan penghitungan rute, lihat Rute Google Cloud API.

Hitung ringkasan pemilihan rute dengan penelusuran di sepanjang rute

Anda dapat menggabungkan penghitungan ringkasan perutean 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. Anggap kalkulasi ini seperti menyediakan perjalanan durasi dan jarak jika Anda memutar dari rute yang ditentukan untuk melakukan perjalanan ke 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 beserta kriteria penelusuran Anda.

Dalam contoh ini, lokasi A adalah tempat yang ditampilkan dalam hasil penelusuran dari Penelusuran (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 origin ke tempat A.
• Tahap kedua berisi durasi perjalanan dan jarak dari place ke tujuan rute. Di contoh ini, dari A ke tujuan.

Dari informasi dalam respons, Anda kemudian dapat menghitung jalan memutar durasi dan jarak, 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 tempat asal ke A; \(s_{OA}\) adalah jarak perjalanan dari tempat asal ke A
• \(t_{AD}\) adalah durasi perjalanan dari A ke tujuan; \(s_{AD}\) adalah jarak perjalanan dari A ke tujuan

Durasi putar 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 putar 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} $$