Menghitung tarif tol

Developer Wilayah Ekonomi Eropa (EEA)

Jika alamat penagihan Anda berada di Wilayah Ekonomi Eropa, mulai 8 Juli 2025, Persyaratan Layanan Google Maps Platform EEA akan berlaku untuk penggunaan Layanan oleh Anda. Fungsi bervariasi menurut wilayah. Pelajari lebih lanjut.

Saat menghitung rute atau matriks rute, Anda mungkin ingin mempertimbangkan biaya tol di rute tersebut. Untuk kota tertentu, Anda dapat menghitung estimasi biaya tol untuk rute dalam mata uang yang sesuai.

Untuk mengetahui daftar lokasi jalan tol yang didukung, lihat referensi untuk TollPass.

Catatan: Permintaan yang menghitung biaya tol akan ditagih dengan tarif yang lebih tinggi. Pelajari lebih lanjut penagihan untuk Routes API.

Cara penghitungan tarif tol

Routes API menghitung perkiraan biaya tol, dengan mempertimbangkan diskon atau kartu tol yang tersedia untuk pengemudi atau kendaraan, dan metode pembayaran yang paling nyaman. Jika tidak ada harga tol yang tersedia untuk rute tertentu, Routes API menunjukkan keberadaan tol dengan biaya yang tidak diketahui.

Catatan: Routes API menghitung tarif tol pada rute secara berbeda dengan Google Maps:

• Routes API hanya menampilkan harga tol (kartu atau tunai) yang sebenarnya akan dikenakan untuk perjalanan, dengan asumsi permintaan Anda secara akurat merepresentasikan jenis kartu yang dimiliki setiap pengemudi dan/atau kendaraan. Jika Anda tidak menentukan kartu tol, API akan menampilkan harga tunai, yang biasanya merupakan tarif tol tertinggi.
• Google Maps biasanya menampilkan harga termurah yang tersedia untuk kendaraan. Pengguna tidak dapat menentukan kartu tol yang mereka miliki; sebagai gantinya, untuk melihat tarif tol tunai, pengguna dapat menonaktifkan opsi Lihat harga kartu tol di Google Maps, yang diaktifkan secara default.

Untuk mendapatkan perkiraan tarif tol yang akurat, pastikan Anda menyertakan informasi berikut dalam permintaan Anda:

• Jenis emisi kendaraan yang digunakan untuk rute (VehicleEmissionType). Jika tidak ada jenis emisi yang diberikan, tarif tol untuk kendaraan berbahan bakar bensin akan ditampilkan.
• Semua kartu tol yang dimiliki kendaraan dan pengemudi menggunakan tollPasses. API menggunakan kartu tol untuk menentukan biaya tol yang akurat, dan menampilkan harga tunai jika kartu tol dalam permintaan tidak berlaku untuk rute tersebut.
• Tentukan hindari jalan tol, jika perlu. Jika Anda ingin menghindari jalan tol jika memungkinkan, tambahkan avoidTolls sebagai RouteModifier.

Menghitung biaya tol menggunakan kartu tol

Untuk menghitung biaya tol menggunakan kartu tol, Anda menentukan kartu tol sebagai bagian dari permintaan. Kemudian, API akan menampilkan harga kartu.

• Jika Anda menentukan kartu tol yang tidak valid, kartu tersebut akan diabaikan.
• Jika Anda menentukan beberapa kartu tol sebagai array, API akan mencoba menghitung harga rute untuk setiap kartu.

Catatan: Anda hanya dapat menentukan kartu tol untuk mode perjalanan DRIVING dan TWO_WHEELER.

Cara kerja kartu tol dapat bervariasi menurut wilayah.

• Tarif mungkin lebih rendah dengan kartu tol: Di beberapa wilayah, pengemudi atau kendaraan dengan kartu tol membayar tarif tol yang berbeda dengan mereka yang tidak memiliki kartu tol. Misalnya, jika Anda memiliki Siap! kartu tol di Seattle, WA, AS, Anda membayar tol yang lebih rendah daripada jika Anda tidak memiliki kartu.
• Beberapa jalan mungkin memerlukan kartu tol: Beberapa wilayah, seperti Indonesia, memiliki jalan yang memerlukan kartu tol. Jika Anda tidak menentukan kartu tol untuk rute yang memerlukan kartu tol, API tidak akan menampilkan harga tol.

Menghitung biaya tol untuk rute

Untuk menghitung biaya tol untuk rute, lakukan langkah-langkah berikut:

• Tetapkan properti extraComputations ke TOLLS.
• Tentukan jenis kendaraan dan jenis kartu tol menggunakan properti routeModifiers.
• Untuk menghitung biaya tol untuk seluruh rute, minta travelAdvisory di properti fields permintaan; lihat info tol untuk seluruh rute dengan membaca route.travelAdvisory.tollInfo.
• Untuk menghitung biaya tol untuk setiap segmen rute, minta legs di properti fields permintaan; lihat info tol untuk setiap segmen dengan membaca route.legs[i].travelAdvisory.tollInfo.

Contoh

Contoh permintaan berikut menunjukkan cara meminta biaya tol untuk rute:

const requestWithTolls = {
  origin: 'Kirkland, WA',
  destination: 'University of Washington',
  travelMode: 'DRIVING',
  extraComputations: ['TOLLS'],
  routeModifiers: {
    vehicleInfo: {
      emissionType: 'GASOLINE',
    },
    tollPasses: ['US_WA_GOOD_TO_GO'],
  },
  fields: ['path', 'legs', 'distanceMeters', 'durationMillis', 'travelAdvisory'],
};