Routes API saat ini dalam Pratinjau (pra-GA). Produk dan fitur pra-GA mungkin memiliki dukungan terbatas, dan perubahan pada produk dan fitur pra-GA mungkin tidak kompatibel dengan versi pra-GA lainnya. Penawaran Pra-GA tercakup dalam Persyaratan Khusus Layanan Google Maps Platform. Untuk informasi selengkapnya, lihat deskripsi tahap peluncuran.

Menghitung tarif tol

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Saat menghitung rute atau matriks rute, Anda dapat mempertimbangkan biaya tol pada rute. Untuk kota tertentu, Anda dapat menghitung estimasi tarif tol untuk rute dalam mata uang yang sesuai.

Lihat daftar Lokasi tol yang didukung di bawah.

Cara penghitungan tarif tol

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

Untuk menghitung informasi tol secara akurat, Routes API memberi Anda opsi untuk menentukan:

  • Jenis emisi kendaraan yang digunakan untuk rute (VehicleEmissionType). Jika tidak ada jenis emisi yang diberikan, tarif untuk kendaraan berbahan bakar bensin akan dikembalikan.
  • Semua kartu tol untuk pengemudi atau kendaraan yang mungkin berlaku (TollPass). Jika tidak ada kartu tol yang ditentukan, API akan menampilkan harga tunai.
  • avoidTolls sebagai RouteModifier untuk menghindari jalan tol.

Menghitung tol saat menggunakan kartu tol

Di beberapa wilayah, pengemudi atau kendaraan dengan kartu tol membayar tol yang berbeda daripada orang yang tidak memiliki kartu. Misalnya, jika memiliki tol Good To Go! di Seattle, WA, AS, Anda akan membayar biaya tol yang lebih rendah daripada jika tidak memiliki tiket.

Beberapa wilayah, seperti Indonesia, memiliki jalan yang memerlukan kartu tol. Jika kartu tol tidak ditentukan untuk rute yang memerlukan kartu tol, tidak akan ada harga yang dikembalikan.

Jika Anda menetapkan tarif tol sebagai bagian dari permintaan, API akan mencoba menampilkan harga tiket:

  • Jika Anda menetapkan kartu tol yang tidak valid, kartu tersebut akan diabaikan.

  • Anda dapat menentukan beberapa kartu tol sebagai array. API mencoba menghitung harga tiket untuk setiap rute.

Menghitung tarif tol untuk rute

Contoh berikut menggunakan metode computeRoutes untuk menampilkan informasi tol dengan estimasi tarif saat kartu tol digunakan.

Tentukan jenis kendaraan dan jenis kartu tol menggunakan kolom routeModifiers permintaan. Harga tol yang ditampilkan didasarkan pada harga yang digunakan oleh jenis kendaraan dan kartu yang ditentukan. Jika lebih dari satu kartu ditetapkan, harga yang paling murah akan ditampilkan.

Meminta informasi tol

curl -X POST -d '{
  "origin":{
    "location":{
      "latLng":{
        "latitude":42.340173523716736,
        "longitude":-71.05997968330408
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude":42.075698891472804,
        "longitude": -72.59806562080408
      }
    }
  },
  "travelMode": "DRIVE",
  "routeModifiers":{
    "vehicleInfo":{
      "emissionType": "GASOLINE"
    },
    "tollPasses": [
      "US_MA_EZPASSMA",
      "US_WA_GOOD_TO_GO"
    ]
  }
}' \
-H 'Content-Type: application/json' \
-H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.travelAdvisory.tollInfo,routes.legs.travelAdvisory.tollInfo' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

Respons yang berisi informasi tol

Respons ini berisi informasi tentang tol dalam objek TollInfo (REST) atau TollInfo (gRPC).

Untuk mengonfigurasi metode agar menampilkan informasi tol, gunakan mask kolom respons. Tetapkan kolom routes.travelAdvisory.tollInfo agar menampilkan informasi untuk seluruh rute dan routes.legs.travelAdvisory.tollInfo untuk menampilkan informasi bagi setiap segmen.

{
  "routes": [
    {
      "legs": [
        {
          "travelAdvisory": {
            "tollInfo": {
              "estimatedPrice": [
                {
                  "currencyCode": "USD",
                  "units": "4",
                  "nanos": 400000000
                }
              ]
            }
          }
        }
      ],
      "distanceMeters": 150338,
      "duration": "6650s",
      "travelAdvisory": {
        "tollInfo": {
          "estimatedPrice": [
            {
              "currencyCode": "USD",
              "units": "4",
              "nanos": 400000000
            }
          ]
        }
      }
    }
  ]
}

Menghitung biaya tol untuk matriks rute

Contoh berikut menggunakan metode computeRouteMatrix untuk menampilkan informasi tol di rute dengan perkiraan harga tol saat digunakan.

Tentukan jenis kendaraan dan jenis kartu tol menggunakan kolom routeModifiers permintaan. Harga tol yang ditampilkan didasarkan pada harga yang digunakan oleh jenis kendaraan dan kartu yang ditentukan. Jika lebih dari satu kartu ditetapkan, harga yang paling murah akan ditampilkan.

Meminta informasi tol matriks rute

curl -X POST -d '{
"origins": [
  {
    "waypoint": {
      "location": {
        "latLng": {
          "latitude":42.340173523716736,
          "longitude":-71.05997968330408
        }
      }
    },
    "routeModifiers": {
      "vehicleInfo":{
        "emissionType": "GASOLINE"
      },
      "tollPasses": [
        "US_MA_EZPASSMA",
        "US_WA_GOOD_TO_GO"
      ]
    }
  }
],
"destinations": [
  {
    "waypoint": {
      "location": {
        "latLng": {
          "latitude":42.075698891472804,
          "longitude": -72.59806562080408
        }
      }
    }
  }
],
"travelMode": "DRIVE",
"routingPreference": "TRAFFIC_AWARE"
}'
-H 'Content-Type: application/json'
-H 'X-Goog-Api-Key: YOUR_API_KEY'
-H 'X-Goog-FieldMask: originIndex,destinationIndex,travel_advisory.tollInfo,duration,distanceMeters,status' 'https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix'

Respons untuk informasi tol matriks rute

Respons ini berisi informasi tentang tol dalam objek TollInfo (REST) atau TollInfo (gRPC).

Untuk mengonfigurasi metode agar menampilkan informasi tol, gunakan mask kolom respons untuk menetapkan kolom travelAdvisory.tollInfo di mask.

[
  {
    "originIndex": 0,
    "destinationIndex": 0,
    "status": {},
    "distanceMeters": 150338,
    "duration": "5382s",
    "travelAdvisory": {
      "tollInfo": {
        "estimatedPrice": [
          {
            "currencyCode": "USD",
            "units": "4",
            "nanos": 400000000
           }
        ]
      }
    }
  }
]

Lokasi tol yang didukung

Informasi tol saat ini tersedia untuk lokasi berikut:

Kode WilayahNegara/WilayahNegara Bagian/Kota/Jalan Tol
AR Argentina Buenos Aires
AU Australia Brisbane
AU Australia Sydney
BR Brasil Seluruh negeri
ID Indonesia Seluruh negeri
India India Seluruh negeri
MX Meksiko Mexico City
ID Amerika Serikat Alabama
ID Amerika Serikat Alaska
ID Amerika Serikat California
ID Amerika Serikat Colorado
ID Amerika Serikat Delaware
ID Amerika Serikat Florida
ID Amerika Serikat Illinois
ID Amerika Serikat Iowa
ID Amerika Serikat Indiana
ID Amerika Serikat Kansas
ID Amerika Serikat Louisiana
ID Amerika Serikat Maine
ID Amerika Serikat Maryland
ID Amerika Serikat Massachusetts
ID Amerika Serikat Michigan
ID Amerika Serikat Minnesota
ID Amerika Serikat Missouri
ID Amerika Serikat New Hampshire
ID Amerika Serikat New Jersey
ID Amerika Serikat New York
ID Amerika Serikat North Carolina
ID Amerika Serikat Ohio
ID Amerika Serikat Pennsylvania
ID Amerika Serikat Rhode Island
ID Amerika Serikat South Carolina
ID Amerika Serikat Texas
ID Amerika Serikat Utah
ID Amerika Serikat Utara
ID Amerika Serikat Washington
ID Amerika Serikat West Virginia

Informasi ini akan diperbarui seiring tersedianya lebih banyak data tol.