Merencanakan rute

Terkadang, Anda mungkin ingin merencanakan rute yang disediakan aplikasi kepada pengemudi. Menggunakan token rute dari Routes API (atau Routes Preferred API) dapat membantu Anda menentukan dua hal untuk rute yang direncanakan:

• Polyline untuk rute

• Tujuan rute Anda

Misalnya, berikut adalah beberapa contoh tujuan perutean yang mungkin Anda miliki:

• Meminimalkan waktu pengiriman: Bisnis yang mengirim makanan mungkin ingin meminimalkan waktu yang diperlukan untuk mengirimkan makanan.

• Meminimalkan waktu perjalanan atau konsumsi bahan bakar: Bisnis logistik sebaiknya meningkatkan efisiensi pengemudi dan mengurangi biaya bahan bakar.

• Meminimalkan waktu ke tujuan: Operasi pengiriman layanan mungkin ingin meminimalkan waktu yang diperlukan untuk mengarahkan operator ke permintaan tugas.

• Menurunkan biaya dan meningkatkan keselamatan: Bisnis transportasi online mungkin ingin menemukan rute yang lebih hemat untuk penumpang dan menghindari area tertentu karena alasan keamanan.

Penting: Rute sebenarnya yang ditempuh dapat berbeda dari rute terencana yang disediakan oleh token. Perubahan lalu lintas, kondisi jalan, atau kendaraan yang menyimpang dari rute tertentu dapat menyebabkan perubahan rute. Saat perubahan terjadi, Navigation SDK akan terus mencoba kembali ke rute yang direncanakan, atau jika proses pengembalian tidak memungkinkan, mengikuti tujuan rute di token rute.

Untuk mengetahui informasi selengkapnya tentang perencanaan rute menggunakan token rute, lihat Meminta token rute.

Alasan menggunakan token rute untuk tujuan rute

Dengan token rute dari Routes atau Routes Preferred API, Anda memiliki kontrol lebih besar atas rute yang diberikan:

• Rencanakan rute terlebih dahulu yang akan digunakan Navigation SDK jika memungkinkan.

• Memilih rute terbaik yang akan digunakan oleh Navigation SDK. Jika Anda meminta token rute saat membuat rute di Routes API, Anda akan mendapatkan token rute untuk setiap rute yang dihasilkan. Selanjutnya, Anda dapat memilih token untuk rute yang ingin digunakan saat meneruskannya ke Navigation SDK.

• Perkirakan harga di muka, termasuk perkiraan PWT dan jarak. Meskipun biaya dan waktu sebenarnya dapat bervariasi, estimasi ini mengurangi kesenjangan antara biaya rute yang diharapkan dan yang sebenarnya.

• Tentukan tujuan rute yang lebih canggih, seperti pemilihan rute ramah lingkungan atau rute terpendek.

Tips: Token rute adalah untuk satu tempat asal dan tujuan tertentu dan pada waktu tertentu. Anda harus membuat permintaan Routes API baru untuk token rute baru.

Cara kerja token rute Routes API

Anda dapat menggunakan Routes API atau Routes Preferred API untuk merencanakan rute menggunakan tujuan rute. Routes API menampilkan token rute yang dapat Anda teruskan ke Navigation SDK untuk memberikan panduan cara merutekan kendaraan Anda.

Berikut yang terjadi saat Anda meminta dan menggunakan token rute dari Routes API:

1. Routes API menampilkan token rute terenkripsi yang menyertakan polyline rute dan tujuan rute.

2. Anda meneruskan token rute ke Navigation SDK.

3. Navigation SDK mengambil rute, atau jika rute tidak tersedia karena perubahan kondisi, Navigation SDK akan mengambil rute terbaik yang cocok.

4. Saat berkendara pada rute, jika kondisi lalu lintas atau jalan lainnya berubah, atau jika kendaraan menyimpang dari rute yang direncanakan, rute yang diubah akan terus mencoba mencocokkan rute terbaik berdasarkan tujuan rute dalam token.

Proses ini memaksimalkan seberapa dekat rute sebenarnya dengan rute yang Anda rencanakan.

Mengapa rute yang direncanakan mungkin tidak diikuti dengan tepat

Pikirkan tujuan rute dan rute yang Anda rencanakan sebagai pedoman yang harus diikuti: keduanya tidak bersifat preskriptif. Anda mungkin melihat perbedaan antara rute yang direncanakan dan rute yang disediakan oleh navigasi terpandu karena perbedaan kondisi jalan, lokasi awal, atau parameter lain yang telah berubah sejak Anda membuat rute yang direncanakan. Perbedaan ini dapat menyebabkan ketidakcocokan antara sasaran yang direncanakan dan yang sebenarnya untuk jarak dan PWT, di antara kualitas perjalanan penting lainnya.

Tips: Sebagai praktik terbaik, selalu minta token rute baru setiap kali Anda menetapkan tujuan di Navigation SDK, dan rencanakan beberapa variasi untuk menghindari dampak apa pun terhadap bisnis Anda.

Merencanakan rute menggunakan token rute

Anda dapat merencanakan rute dengan membuat token rute, lalu meneruskannya ke Navigation SDK, seperti yang dijelaskan pada langkah-langkah berikut:

Langkah 1: Buat token rute menggunakan Routes atau Routes Preferred API

1. Minta token rute dengan salah satu metode berikut:

   • Routes API: computeRoutes. Untuk mengetahui informasi selengkapnya tentang meminta token rute di Routes API, lihat Menghitung rute dan Meminta token rute.

   • Routes Preferred API: computeCustomRoutes. Untuk mengetahui informasi selengkapnya tentang meminta token rute di Routes Preferred API, lihat Merencanakan rute.

2. Siapkan permintaan rute untuk memenuhi persyaratan penggunaan token rute:

   • Tetapkan travel_mode ke DRIVING
   • Tetapkan routing_preference ke TRAFFIC_AWARE atau TRAFFIC_AWARE_OPTIMAL
   • JANGAN gunakan titik jalan Via

Langkah 2: Teruskan token rute ke Navigation SDK

1. Simpan token rute: Di Navigation SDK, siapkan string untuk menyimpan token rute. Contoh:

   let routeToken = "route token returned by Routes API"

   Contoh token rute yang ditampilkan:

   {
   // Other fields
   "routeToken": "CqMBCjoKCJQOor5DHcwiEhBon3XpHXFnVvDeWMwd9PpAGgz6wtnFDKIBrAHTARpCApUDSggAAAAACjcrP3gBEAQaTApKChgKDQoCCAERAAAAAACAZkAR3SQGgZUXdUASEggAEAMQBhATEBIYAkIEGgIIBSIYChZ2VEJiWlBPSkk1aU5wUVRzNTV5d0FRKAEiFQBcJuds-Efh-2QZhOMTtUCCxEVL_g",
   }
   

2. Teruskan token rute ke Navigation SDK menggunakan metode mapView.navigator setDestinations, dengan menentukan titik jalan tujuan yang sama dengan yang Anda gunakan saat membuat token rute:

   mapView.navigator?.setDestinations([waypoint1, waypoint2], routeToken: routeToken, callback: {...})

Catatan: Jika Anda perlu kembali melalui rute yang sama, minta token rute baru.

Metode Navigator.setDestinations akan menampilkan status permintaan. Jika rute ditemukan dari lokasi pengguna ke tujuan yang ditentukan, rute tersebut akan menampilkan RouteStatus.OK.

Untuk mengetahui informasi selengkapnya tentang metode ini, lihat Navigator.setDestinations.

Contoh

Contoh kode berikut menunjukkan cara mengambil rute yang direncanakan.

Swift

let location = CLLocationCoordinate2D(latitude: 47.67, longitude: -122.20)
let waypoint1 = GMSNavigationWaypoint(location: location, title: "waypoint from location")!
let waypoint2 = GMSNavigationWaypoint(placeID: "samplePlaceID", title: "waypoint from Place ID")!

let routeToken = "route token returned by Routes API"
mapView.navigator?.setDestinations([waypoint1, waypoint2], routeToken: routeToken, callback: {...})

Objective-C

CLLocationCoordinate2D location = CLLocationCoordinate2DMake(47.67, -122.20);
GMSNavigationWaypoint *waypoint1 = [[GMSNavigationWaypoint alloc] initWithLocation:coordinate title:@"waypoint from location"];
GMSNavigationWaypoint *waypoint2 = [[GMSNavigationWaypoint alloc] initWithPlaceID:@"samplePlaceID"
                                                                            title:@"waypoint from Place ID"];
NSString *routeToken = @"route token returned by Routes API";

[mapView.navigator setDestinations:@[waypoint1, waypoint2]
                         routeToken:routeToken
                           callback:^(GMSRouteStatus routeStatus){...}];

Cara token rute dan Navigation SDK berinteraksi

Berikut cara rute yang dihasilkan oleh Navigation SDK dan rute yang direncanakan dalam token rute berinteraksi:

• Mengganti tujuan yang ditetapkan sebelumnya.

• Menggunakan lokasi awal kendaraan.

• Menyesuaikan dengan kondisi jalan dan lalu lintas. Lihat Alasan rute yang direncanakan mungkin tidak diikuti dengan tepat.

• Mengabaikan opsi terkait pemilihan rute berikut jika tidak diperlukan:

  • avoidsHighways
  • avoidsTolls
  • avoidsFerries
  • licensePlateRestriction

• Mengikuti:

  • Opsi terkait titik jalan, seperti preferensi sisi jalan.

  • Tujuan rute. Jika Navigation SDK harus menyesuaikan rute yang ditampilkan, Navigation SDK akan menggunakan tujuan rute yang Anda tentukan saat meminta token rute. Karena itu, Anda harus menggunakan opsi terkait titik jalan yang sama dengan yang Anda tetapkan di Routes API.