RoutingParameters

พารามิเตอร์ในการกําหนดค่าการคํานวณเส้นทางไปยังสถานที่ในการตอบกลับ ทั้งตามเส้นทาง (ซึ่งจะมีผลต่อการจัดอันดับผลการค้นหา) และเพื่อคํานวณเวลาเดินทางในผลการค้นหา

การแสดง JSON 
{
  "origin": {
    object (LatLng)
  },
  "travelMode": enum (TravelMode),
  "routeModifiers": {
    object (RouteModifiers)
  },
  "routingPreference": enum (RoutingPreference)
}
ช่อง
origin

object (LatLng)

ไม่บังคับ ต้นทางการกำหนดเส้นทางที่ชัดเจนซึ่งลบล้างต้นทางที่กำหนดไว้ในเส้นประกอบ ระบบจะใช้ต้นทางเส้นประกอบโดยค่าเริ่มต้น
travelMode

enum (TravelMode)

ไม่บังคับ วิธีการเดินทาง
routeModifiers

object (RouteModifiers)

ไม่บังคับ ตัวปรับแต่งเส้นทาง
routingPreference

enum (RoutingPreference)

ไม่บังคับ ระบุวิธีคํานวณสรุปการกำหนดเส้นทาง เซิร์ฟเวอร์พยายามใช้ค่ากำหนดการกำหนดเส้นทางที่เลือกเพื่อคํานวณเส้นทาง ค่ากำหนดการกำหนดเส้นทางเพื่อการรับรู้การรับส่งข้อมูลจะใช้ได้กับ travelMode DRIVE หรือ TWO_WHEELER เท่านั้น

TravelMode

ตัวเลือกโหมดการเดินทาง ตัวเลือกเหล่านี้จะเชื่อมโยงกับสิ่งที่ Routes API นำเสนอ

Enum
TRAVEL_MODE_UNSPECIFIED ไม่ได้ระบุวิธีการเดินทาง ค่าเริ่มต้นคือ DRIVE
DRIVE เดินทางโดยรถยนต์นั่งส่วนบุคคล
BICYCLE การเดินทางด้วยจักรยาน ไม่รองรับ searchAlongRouteParameters
WALK เดินทางด้วยการเดิน ไม่รองรับ searchAlongRouteParameters
TWO_WHEELER ยานพาหนะ 2 ล้อทุกประเภทที่ขับเคลื่อนด้วยเครื่องยนต์ เช่น สกูตเตอร์และจักรยานยนต์ โปรดทราบว่ารูปแบบการเดินทางนี้แตกต่างจากBICYCLEรูปแบบการเดินทางซึ่งครอบคลุมการขนส่งที่ขับเคลื่อนโดยมนุษย์ ไม่รองรับ searchAlongRouteParameters รองรับเฉพาะในประเทศที่ระบุไว้ในประเทศและภูมิภาคที่รองรับยานพาหนะ 2 ล้อ

RouteModifiers

บรรจุชุดเงื่อนไขที่ไม่บังคับเพื่อตอบสนองเมื่อคำนวณเส้นทาง

การแสดง JSON 
{
  "avoidTolls": boolean,
  "avoidHighways": boolean,
  "avoidFerries": boolean,
  "avoidIndoor": boolean
}
ช่อง
avoidTolls

boolean

ไม่บังคับ เมื่อตั้งค่าเป็น "จริง" ระบบจะหลีกเลี่ยงถนนที่มีค่าผ่านทางตามความเหมาะสม โดยให้ความสำคัญกับเส้นทางที่ไม่มีถนนที่มีค่าผ่านทาง มีผลกับ TravelMode ของ DRIVE และ TWO_WHEELER เท่านั้น
avoidHighways

boolean

ไม่บังคับ เมื่อตั้งค่าเป็น "จริง" ระบบจะเลี่ยงทางหลวงตามความเหมาะสม โดยให้ความสำคัญกับเส้นทางที่ไม่มีทางหลวง มีผลกับ TravelMode ของ DRIVE และ TWO_WHEELER เท่านั้น
avoidFerries

boolean

ไม่บังคับ เมื่อตั้งค่าเป็น "จริง" ระบบจะหลีกเลี่ยงเรือข้ามฟากตามความเหมาะสม โดยให้ความสำคัญกับเส้นทางที่ไม่มีเรือข้ามฟาก มีผลกับ DRIVE และ TWO_WHEELER TravelMode เท่านั้น
avoidIndoor

boolean

ไม่บังคับ เมื่อตั้งค่าเป็น "จริง" หลีกเลี่ยงการนำทางในอาคารเมื่อสมเหตุสมผล โดยให้ความสำคัญกับเส้นทางที่ไม่มีการนำทางในอาคาร มีผลกับ WALK TravelMode เท่านั้น

RoutingPreference

ชุดค่าที่ระบุปัจจัยที่ต้องพิจารณาเมื่อคำนวณเส้นทาง

Enum
ROUTING_PREFERENCE_UNSPECIFIED ไม่ได้ระบุค่ากำหนดการกำหนดเส้นทาง ค่าเริ่มต้นคือ TRAFFIC_UNAWARE
TRAFFIC_UNAWARE คํานวณเส้นทางโดยไม่คํานึงถึงสภาพการจราจรจริง เหมาะสำหรับกรณีที่สภาพการจราจรไม่สำคัญหรือไม่เกี่ยวข้อง การใช้ค่านี้จะทำให้เวลาในการตอบสนองต่ำที่สุด หมายเหตุ: สำหรับ TravelMode DRIVE และ TWO_WHEELER เส้นทางและระยะเวลาที่เลือกจะอิงตามเครือข่ายถนนและสภาพการจราจรโดยเฉลี่ยที่ไม่ขึ้นอยู่กับเวลา ไม่ใช่สภาพถนนปัจจุบัน เส้นทางนั้นอาจรวมถึงถนนที่ปิดชั่วคราวด้วย ผลลัพธ์ของคำขอหนึ่งๆ อาจแตกต่างกันไปเมื่อเวลาผ่านไปเนื่องจากการเปลี่ยนแปลงในเครือข่ายถนน สภาพการจราจรเฉลี่ยที่อัปเดต และรูปแบบการกระจายตัวของบริการ ผลลัพธ์อาจแตกต่างกันไปตามเส้นทางที่เกือบเทียบเท่าในช่วงเวลาหรือความถี่
TRAFFIC_AWARE คำนวณเส้นทางที่จะนำสภาพการจราจรปัจจุบันมาพิจารณา แต่ตรงข้ามกับ TRAFFIC_AWARE_OPTIMAL ที่มีการนำการเพิ่มประสิทธิภาพบางอย่างมาใช้เพื่อลดเวลาในการตอบสนองลงได้อย่างมาก
TRAFFIC_AWARE_OPTIMAL คำนวณเส้นทางที่คำนึงถึงสภาพการจราจรแบบเรียลไทม์ โดยไม่ใช้การเพิ่มประสิทธิภาพส่วนใหญ่ การใช้ค่านี้จะทำให้เกิดเวลาในการตอบสนองสูงสุด