Rota için geçiş ücretlerini hesaplayın

Avrupa Ekonomik Alanı'ndaki (AEA) geliştiriciler

Bir rota veya rota matrisi hesaplarken rotadaki tüm geçiş ücretlerini göz önünde bulundurmak isteyebilirsiniz. Belirli şehirlerde, bir rotanın tahmini geçiş ücretini uygun para biriminde hesaplayabilirsiniz.

Rota matrisi için ücretleri öğrenmek istiyorsanız Rota matrisi için ücretleri hesaplama başlıklı makaleyi inceleyin.

Desteklenen ücretli geçiş noktalarının listesi için TollPass referansına bakın.

Ücretler nasıl hesaplanır?

Routes API, sürücü veya araç için geçerli olan tüm geçiş ücreti indirimlerini ya da geçiş kartlarını ve en uygun ödeme yöntemlerini dikkate alarak tahmini geçiş ücretini hesaplar. Belirli bir rota için kullanılabilir ücretli yol fiyatı yoksa Routes API, ücretli yolun varlığını bilinmeyen bir ücretle belirtir.

Doğru geçiş ücreti tahminleri almak için isteğinize aşağıdaki bilgileri eklediğinizden emin olun:

  • Rota için kullanılan aracın emisyon türü (VehicleEmissionType). Emisyon türü sağlanmazsa benzinle çalışan bir araç için geçiş ücreti döndürülür.
  • Aracın ve sürücünün sahip olduğu tüm otoyol geçiş kartları (TollPass) kullanılarak. API, doğru geçiş ücretlerini belirlemek için otoyol geçiş kartlarını kullanır ve istekteki otoyol geçiş kartları rotaya özgü olmadığında nakit fiyatları döndürür.
  • Gerekirse ücretli geçişleri kullanma seçeneğini belirtin. Mümkün olduğunda paralı yolları kullanmak istemiyorsanız avoidTolls seçeneğini RouteModifier olarak ekleyin.

Otoyol geçiş kartı kullanarak ücretleri hesaplama

Ücretleri otoyol geçiş kartı kullanarak hesaplamak için isteğin bir parçası olarak otoyol geçiş kartlarını belirtirsiniz. Ardından API, kart fiyatlarını döndürür.

  • Geçersiz bir otoyol geçiş kartı belirtirseniz bu kart yoksayılır.

  • Birden fazla otoyol geçiş kartını dizi olarak belirtirseniz API, her otoyol geçiş kartı için rotanın fiyatını hesaplamaya çalışır.

Otoyol geçiş kartlarının işleyiş şekli bölgeye göre değişebilir.

  • Otoyol geçiş kartıyla ücretler daha düşük olabilir: Bazı bölgelerde, otoyol geçiş kartı olan bir sürücü veya araç, kartı olmayanlara göre farklı bir ücret öder. Örneğin, Seattle, Washington, ABD'de Good To Go! otoyol geçiş kartınız varsa kartınızın olmadığı duruma kıyasla daha düşük bir ücret ödersiniz.

  • Bazı yollarda otoyol geçiş kartı gerekebilir: Endonezya gibi bazı bölgelerde otoyol geçiş kartı gerektiren yollar vardır. Otoyol geçiş kartı gerektiren bir rota için otoyol geçiş kartı belirtmezseniz API, ücret fiyatı döndürmez.

Bir rota için geçiş ücretlerini hesaplama

Aşağıdaki örnekte, otoyol geçiş kartı kullanıldığında tahmini fiyatla birlikte ücret bilgilerini döndürmek için computeRoutes yöntemi kullanılmaktadır. Bu örnekte:

  • Ücret bilgilerinin hesaplanmasını etkinleştirmek için extraComputations dizi alanını TOLLS olarak ayarlayın.

  • İsteğin routeModifiers alanını kullanarak araç türünü ve otoyol geçiş kartı türünü belirtin. Döndürülen geçiş ücreti, belirtilen araç türü ve geçiş kartı tarafından kullanılan fiyatlandırmaya göre belirlenir. Birden fazla kart belirtilirse en ucuz fiyatlandırma döndürülür.

  • Yanıtın ücretli geçiş bilgilerini döndürme yöntemini yapılandırmak için yanıt alanı maskesini kullanın. Bu örnekte istek, yanıt alanı maskesinde aşağıdaki özellikleri içeriyordu:

    • routes.travelAdvisory.tollInfo alanını kullanın.

    • routes.legs.travelAdvisory.tollInfo her ayak için bilgi döndürür.

Ücret bilgisi isteği

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'

Ücretli geçiş bilgisi içeren yanıt

Yanıt, TollInfo (REST) veya TollInfo (gRPC) nesnesinde ücretlerle ilgili bilgiler içerir. Bu örnekte, rotanın tamamı ve rotanın her ayağı için ücretli yol bilgilerini döndürüyorsunuz.

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