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.

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.

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 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
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.