Merencanakan rute

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

  • Polyline untuk rute

  • Tujuan rute Anda

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

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

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

  • Minimalkan waktu untuk mencapai tujuan: Operasi pengiriman layanan mungkin ingin meminimalkan waktu yang diperlukan untuk membawa operator ke permintaan tugas.

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

Untuk mengetahui informasi selengkapnya tentang merencanakan rute menggunakan token rute, lihat Meminta token rute di Routes API dan Transisi Polyline dan Token Rute di Route Optimization API.

Alasan menggunakan token rute untuk tujuan rute

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

  • Rencanakan rute terlebih dahulu agar Navigation SDK dapat menggunakannya jika memungkinkan.

  • Pilih rute terbaik yang akan digunakan Navigation SDK. Jika Anda meminta token rute saat membuat rute di Routes API, Anda akan mendapatkan token rute untuk setiap rute yang dibuat. Kemudian, Anda dapat memilih token untuk rute yang ingin digunakan saat meneruskannya ke Navigation SDK.

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

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

Cara kerja token rute

Anda dapat menggunakan Routes API, Routes Preferred API, atau Route Optimization API untuk merencanakan rute menggunakan tujuan rute. Anda dapat meneruskan token rute yang ditampilkan dari salah satu API ini ke Navigation SDK untuk memandu cara merutekan kendaraan Anda.

Berikut yang akan terjadi saat Anda meminta dan menggunakan token rute:

  1. Routes API, Routes Preferred API, atau Route Optimization API menampilkan token rute terenkripsi yang mencakup polyline rute dan tujuan rute.

  2. Anda meneruskan token rute ke Navigation SDK.

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

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

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

Alasan rute yang direncanakan mungkin tidak diikuti persis seperti yang ditampilkan

Anggap rute yang direncanakan dan tujuan rute Anda sebagai panduan yang harus diikuti: keduanya tidak bersifat preskriptif. Anda mungkin melihat perbedaan antara rute yang direncanakan dan rute yang diberikan 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 tujuan yang direncanakan dan tujuan sebenarnya untuk jarak dan perkiraan waktu tiba, serta kualitas perjalanan penting lainnya.

Merencanakan rute menggunakan token rute

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

Langkah 1: Buat token rute menggunakan Routes API, Routes Preferred API, atau Route Optimization API

  1. Minta token rute dengan salah satu metode berikut:

    • Routes API: computeRoutes. Untuk mengetahui informasi selengkapnya tentang cara 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.

    • Route Optimization API: optimizeTours atau batchOptimizeTours. Untuk mengetahui informasi selengkapnya tentang meminta token rute di Route Optimization API, lihat Transisi Polyline dan Token Rute.

  2. Siapkan permintaan Routes API atau Routes Preferred API Anda untuk memenuhi persyaratan penggunaan token rute:

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

Langkah 2: Teruskan token rute ke Navigation SDK

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

    String 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 Navigator.setDestinations, dengan menentukan titik jalan tujuan yang sama yang Anda gunakan saat membuat token rute:

    setDestinations(List destinations, CustomRoutesOptions customRoutesOptions, DisplayOptions displayOptions);

    Contoh:

    CustomRoutesOptions customRoutesOptions =
      CustomRoutesOptions.builder()
      .setRouteToken(routeToken)
      .setTravelMode(TravelMode.DRIVING)
      .build();

Metode Navigator.setDestinations menampilkan status permintaan. Jika menemukan rute dari lokasi kendaraan ke tujuan yang diberikan, maka akan menampilkanRouteStatus.OK.

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

Contoh

Contoh kode berikut menunjukkan cara menentukan rute yang direncanakan menggunakan token rute.

    ArrayList <Waypoint> destinations = Lists.newArrayList();
    Waypoint waypoint1 =
       Waypoint.builder()
          .setLatLng(10, 20)
          .setTitle("title")
          .setVehicleStopover(true)
          .build();
    destinations.add(waypoint1);
    Waypoint waypoint2 =
       Waypoint.builder()
          .setPlaceId("ChIJYV-J-ziuEmsRIMyoFaMedU4")
          .setTitle("title")
          .setVehicleStopover(true)
           .build()
    destinations.add(waypoint2);

    String routeToken = "route token returned by Routes API";

    CustomRoutesOptions customRoutesOptions =
       CustomRoutesOptions.builder()
          .setRouteToken(routeToken)
          .setTravelMode(TravelMode.DRIVING)
          .build();

    // Existing flow to get a Navigator.
    NavigationApi.getNavigator(...);

    // Existing flow for requesting routes.
    ListenableResultFuture<RouteStatus> routeStatusFuture =
        navigator.setDestinations(destinations, customRoutesOptions);

    // Or with display options.
    DisplayOptions displayOptions = new DisplayOptions();

    ListenableResultFuture<RouteStatus> routeStatusFuture =
        navigator.setDestinations(destinations, customRoutesOptions, displayOptions);

Cara interaksi token rute dan Navigation SDK

Berikut cara interaksi rute yang dibuat oleh Navigation SDK dan rute yang direncanakan dalam token rute:

  • Menggantikan 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 karena 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, SDK akan menggunakan tujuan rute yang Anda tentukan saat meminta token rute. Oleh karena itu, Anda harus menggunakan opsi terkait titik jalan yang sama dengan yang Anda tentukan di Routes API.