Halaman ini diterjemahkan oleh Cloud Translation API.

Menghitung tarif tol

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. Dalam contoh ini, Anda:

Tetapkan kolom array extraComputations ke TOLLS untuk mengaktifkan penghitungan informasi tol.
Tentukan jenis kendaraan dan jenis kartu tol dengan menggunakan kolom routeModifiers dari permintaan. Harga tol yang ditampilkan didasarkan pada harga yang digunakan oleh jenis dan kartu kendaraan tertentu. Jika lebih dari satu kartu ditentukan, harga yang paling murah akan ditampilkan.
Gunakan mask kolom respons untuk mengonfigurasi metode agar menampilkan informasi tol dalam respons. Dalam contoh ini, permintaan menyertakan properti berikut dalam mask kolom respons:
- Kolom routes.travelAdvisory.tollInfo untuk menampilkan informasi rute keseluruhan.
- routes.legs.travelAdvisory.tollInfo untuk menampilkan informasi untuk setiap segmen.
Catatan: Rute ini hanya berisi satu segmen.

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",
  "extraComputations": ["TOLLS"],
  "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). Dalam contoh ini, Anda mengembalikan informasi tol untuk seluruh rute dan untuk setiap segmen rute.

{
  "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 pada rute dengan estimasi tarif kartu tol saat digunakan:

Tetapkan kolom array extraComputations ke TOLLS untuk mengaktifkan penghitungan informasi tol.
Tentukan jenis kendaraan dan jenis kartu tol dengan menggunakan kolom routeModifiers dari titik jalan origin permintaan. Harga tol yang dikembalikan didasarkan pada harga yang digunakan oleh jenis dan kartu kendaraan yang ditentukan. Jika lebih dari satu kartu ditentukan, harga yang paling murah akan ditampilkan.
Gunakan mask kolom respons untuk mengonfigurasi metode agar menampilkan informasi tol dalam respons. Tentukan routes.travelAdvisory.tollInfo untuk menampilkan informasi untuk seluruh rute.

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",
"extraComputations": ["TOLLS"]
}' \
-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 Wilayah	Negara/Wilayah	Negara 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
Amerika Serikat	Amerika Serikat	Alabama
Amerika Serikat	Amerika Serikat	Alaska
Amerika Serikat	Amerika Serikat	California
Amerika Serikat	Amerika Serikat	Colorado
Amerika Serikat	Amerika Serikat	Delaware
Amerika Serikat	Amerika Serikat	Florida
Amerika Serikat	Amerika Serikat	Illinois
Amerika Serikat	Amerika Serikat	Iowa
Amerika Serikat	Amerika Serikat	Indiana
Amerika Serikat	Amerika Serikat	Kansas
Amerika Serikat	Amerika Serikat	Louisiana
Amerika Serikat	Amerika Serikat	Maine
Amerika Serikat	Amerika Serikat	Maryland
Amerika Serikat	Amerika Serikat	Massachusetts
Amerika Serikat	Amerika Serikat	Michigan
Amerika Serikat	Amerika Serikat	Minnesota
Amerika Serikat	Amerika Serikat	Missouri
Amerika Serikat	Amerika Serikat	New Hampshire
Amerika Serikat	Amerika Serikat	New Jersey
Amerika Serikat	Amerika Serikat	New York
Amerika Serikat	Amerika Serikat	North Carolina
Amerika Serikat	Amerika Serikat	Ohio
Amerika Serikat	Amerika Serikat	Pennsylvania
Amerika Serikat	Amerika Serikat	Rhode Island
Amerika Serikat	Amerika Serikat	South Carolina
Amerika Serikat	Amerika Serikat	Texas
Amerika Serikat	Amerika Serikat	Utah
Amerika Serikat	Amerika Serikat	Utara
Amerika Serikat	Amerika Serikat	Washington
Amerika Serikat	Amerika Serikat	West Virginia

Informasi ini akan diperbarui seiring tersedianya lebih banyak data tol.