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

ไม่บังคับ เมื่อตั้งค่าเป็น "จริง" จะหลีกเลี่ยงเส้นทางเรือที่สมเหตุสมผล โดยให้ความสำคัญกับเส้นทางที่ไม่มีเรือข้ามฟาก มีผลกับ TravelMode ของ DRIVE และ TWO_WHEELER เท่านั้น
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 คำนวณเส้นทางที่คำนึงถึงสภาพการจราจรแบบเรียลไทม์ โดยไม่ใช้การเพิ่มประสิทธิภาพส่วนใหญ่ การใช้ค่านี้จะทำให้เกิดเวลาในการตอบสนองสูงสุด