คํานวณค่าผ่านทางสําหรับเส้นทาง

เมื่อคำนวณเส้นทางหรือเมทริกซ์เส้นทาง คุณอาจต้องพิจารณาค่าธรรมเนียมค่าผ่านทางในเส้นทาง สำหรับบางเมือง คุณสามารถคำนวณค่าธรรมเนียม ทางด่วนโดยประมาณของเส้นทางในสกุลเงินที่เหมาะสมได้

หากต้องการดูค่าผ่านทางสำหรับเมทริกซ์เส้นทาง โปรดดู คำนวณค่าธรรมเนียมค่าผ่านทางสำหรับเมทริกซ์เส้นทาง

ดูรายการสถานที่ที่มีการเก็บค่าผ่านทางที่รองรับได้ในข้อมูลอ้างอิงสำหรับ TollPass

วิธีคำนวณค่าผ่านทาง

Routes API จะคำนวณค่าธรรมเนียมทางด่วนโดยประมาณ โดยพิจารณาส่วนลดหรือบัตรผ่านสำหรับค่าธรรมเนียมทางด่วนที่มี สำหรับผู้ขับขี่หรือยานพาหนะ รวมถึงวิธีการชำระเงินที่สะดวกที่สุด หากไม่มีราคาค่าผ่านทางสำหรับเส้นทางหนึ่งๆ Routes API จะระบุว่ามีค่าผ่านทาง ที่มีค่าธรรมเนียมที่ไม่รู้จัก

โปรดระบุข้อมูลต่อไปนี้ในคำขอเพื่อให้ได้ค่าประมาณค่าผ่านทางที่ถูกต้อง

• ประเภทการปล่อยก๊าซของยานพาหนะที่ใช้สำหรับเส้นทาง (VehicleEmissionType) หากไม่ได้ระบุประเภทการปล่อยก๊าซ ระบบจะแสดงค่าผ่านทางสำหรับยานพาหนะที่ใช้น้ำมันเบนซิน
• บัตรผ่านทางด่วนทั้งหมดที่ยานพาหนะและผู้ขับขี่มีโดยใช้ (TollPass) API ใช้ บัตรผ่านทางด่วนเพื่อกำหนดค่าธรรมเนียมทางด่วนที่ถูกต้อง และแสดงราคาเงินสด เมื่อบัตรผ่านทางด่วนในคำขอไม่ได้อยู่ในเส้นทาง
• ระบุว่าให้หลีกเลี่ยงค่าผ่านทาง หากจำเป็น หากต้องการหลีกเลี่ยงถนนที่มีค่าผ่านทางเมื่อเป็นไปได้ ให้เพิ่ม avoidTolls เป็นRouteModifier

คำนวณค่าผ่านทางโดยใช้บัตรผ่านทาง

หากต้องการคำนวณค่าผ่านทางโดยใช้บัตรผ่านทาง คุณต้องระบุบัตรผ่านทางเป็นส่วนหนึ่งของคำขอ จากนั้น API จะแสดงราคาบัตร

• หากคุณระบุบัตรผ่านทางที่ไม่ถูกต้อง ระบบจะเพิกเฉยต่อบัตรนั้น

• หากระบุบัตรผ่านทางหลายรายการเป็นอาร์เรย์ API จะพยายามคำนวณราคาสำหรับเส้นทางของบัตรผ่านแต่ละใบ

ลักษณะการทำงานของบัตรผ่านทางด่วนอาจแตกต่างกันไปตามภูมิภาค

• อัตราค่าผ่านทางอาจต่ำกว่าเมื่อใช้บัตรผ่านทาง: ในบางภูมิภาค ผู้ขับขี่หรือยานพาหนะ ที่มีบัตรผ่านทางจะจ่ายค่าผ่านทางแตกต่างจากผู้ที่ไม่มีบัตร ตัวอย่างเช่น หากคุณมีบัตรผ่านทางด่วน Good To Go! ในซีแอตเทิล รัฐวอชิงตัน สหรัฐอเมริกา คุณจะจ่ายค่าผ่านทางถูกกว่าในกรณีที่ไม่มีบัตรผ่าน

• ถนนบางสายอาจต้องใช้บัตรผ่านทางด่วน: บางภูมิภาค เช่น อินโดนีเซีย มีถนนที่ต้องใช้บัตรผ่านทางด่วน หากคุณไม่ได้ระบุบัตรผ่านทางสำหรับเส้นทางที่ต้องใช้บัตรผ่านทาง API จะไม่แสดงราคาค่าผ่านทาง

คำนวณค่าธรรมเนียมค่าผ่านทางสำหรับเส้นทาง

ตัวอย่างต่อไปนี้ใช้วิธี computeRoutes เพื่อแสดงข้อมูลค่าผ่านทางพร้อมราคาโดยประมาณ เมื่อใช้บัตรค่าผ่านทาง ในตัวอย่างนี้ คุณจะทำสิ่งต่อไปนี้

• ตั้งค่าฟิลด์อาร์เรย์ extraComputations เป็น TOLLS เพื่อเปิดใช้การคำนวณ ข้อมูลค่าผ่านทาง

• ระบุประเภทรถและประเภทบัตรผ่านทางโดยใช้ฟิลด์ routeModifiers ของคำขอ ราคาค่าผ่านทางที่แสดงจะอิงตาม การกำหนดราคาที่ใช้สำหรับประเภทรถและบัตรที่ระบุ หากระบุบัตรมากกว่า 1 ใบ ระบบจะแสดงผลราคาที่ถูกที่สุด

• ใช้มาสก์ฟิลด์การตอบกลับเพื่อกำหนดค่าเมธอดให้ แสดงข้อมูลค่าผ่านทางในการตอบกลับ ในตัวอย่างนี้ คำขอ มีพร็อพเพอร์ตี้ต่อไปนี้ในมาสก์ช่องการตอบกลับ

  • routes.travelAdvisory.tollInfo เพื่อแสดงข้อมูลสำหรับ ทั้งเส้นทาง

  • routes.legs.travelAdvisory.tollInfo เพื่อแสดงข้อมูล สำหรับแต่ละขา

คำขอข้อมูลค่าผ่านทาง

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'

การตอบกลับที่มีข้อมูลค่าผ่านทาง

การตอบกลับจะมีข้อมูลเกี่ยวกับค่าผ่านทางในออบเจ็กต์ TollInfo (REST) หรือ TollInfo (gRPC) ใน ตัวอย่างนี้ คุณจะแสดงข้อมูลค่าผ่านทางสำหรับทั้งเส้นทางและแต่ละช่วงของ เส้นทาง

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