Package google.maps.routes.v1

ดัชนี

• RoutesPreferred (อินเทอร์เฟซ)
• ComputeCustomRoutesRequest (ข้อความ)
• ComputeCustomRoutesResponse (ข้อความ)
• ComputeCustomRoutesResponse.FallbackInfo (ข้อความ)
• ComputeCustomRoutesResponse.FallbackInfo.FallbackRouteObjective (enum)
• ComputeRouteMatrixRequest (ข้อความ)
• ComputeRoutesRequest (ข้อความ)
• ComputeRoutesResponse (ข้อความ)
• CustomRoute (ข้อความ)
• FallbackInfo (ข้อความ)
• FallbackReason (enum)
• FallbackRoutingMode (enum)
• Location (ข้อความ)
• Maneuver (enum)
• NavigationInstruction (ข้อความ)
• Polyline (ข้อความ)
• PolylineEncoding (enum)
• PolylineQuality (enum)
• Route (ข้อความ)
• RouteLeg (ข้อความ)
• RouteLegStep (ข้อความ)
• RouteLegStepTravelAdvisory (ข้อความ)
• RouteLegTravelAdvisory (ข้อความ)
• RouteMatrixDestination (ข้อความ)
• RouteMatrixElement (ข้อความ)
• RouteMatrixElementCondition (enum)
• RouteMatrixOrigin (ข้อความ)
• RouteModifiers (ข้อความ)
• RouteObjective (ข้อความ)
• RouteObjective.RateCard (ข้อความ)
• RouteObjective.RateCard.MonetaryCost (ข้อความ)
• RouteTravelAdvisory (ข้อความ)
• RouteTravelMode (enum)
• RoutingPreference (enum)
• SpeedReadingInterval (ข้อความ)
• SpeedReadingInterval.Speed (enum)
• TollInfo (ข้อความ)
• TollPass (enum)
• Units (enum)
• VehicleEmissionType (enum)
• VehicleInfo (ข้อความ)
• Waypoint (ข้อความ)

RoutesPreferred

Routes Preferred API

ComputeCustomRoutes

rpc ComputeCustomRoutes(ComputeCustomRoutesRequest) returns (ComputeCustomRoutesResponse) การคำนวณเส้นทางที่ดีที่สุดสำหรับวัตถุประสงค์ของเส้นทางโดยใช้ชุดของจุดสิ้นสุดและจุดระหว่างทาง และวัตถุประสงค์ของเส้นทาง รวมทั้งแสดงเส้นทางที่เร็วที่สุดและเส้นทางที่สั้นที่สุดเป็นเส้นทางอ้างอิง หมายเหตุ: วิธีนี้กำหนดให้คุณต้องระบุมาสก์ช่องคำตอบในอินพุต คุณระบุมาสก์ของช่องการตอบกลับได้โดยใช้พารามิเตอร์ของ URL $fields หรือ fields หรือใช้ส่วนหัว HTTP/gRPC X-Goog-FieldMask (ดูพารามิเตอร์และส่วนหัวของ URL ที่ใช้ได้ ค่านี้คือรายการเส้นทางช่องที่คั่นด้วยเครื่องหมายจุลภาค ดูเอกสารประกอบโดยละเอียดเกี่ยวกับวิธีสร้างเส้นทางภาคสนาม ตัวอย่างเช่น ในวิธีการนี้ มาสก์ของช่องทั้งหมดที่มี (สําหรับการตรวจสอบด้วยตนเอง): X-Goog-FieldMask: * ฟิลด์มาสก์ของระยะทาง ระยะเวลา โทเค็น และข้อมูลค่าผ่านทาง: X-Goog-FieldMask: routes.route.distanceMeters,routes.route.duration,routes.token,routes.route.travelAdvisory.tollInfo Google ไม่แนะนำให้ใช้มาสก์ช่องคำตอบที่มีไวลด์การ์ด (*) หรือระบุมาสก์ช่องที่ระดับบนสุด (routes) เนื่องจากสาเหตุต่อไปนี้ การเลือกเฉพาะช่องที่คุณต้องการจะช่วยให้เซิร์ฟเวอร์ของเราบันทึกรอบการคำนวณได้ ซึ่งทำให้เราสามารถส่งคืนผลลัพธ์ให้คุณได้โดยมีเวลาในการตอบสนองที่น้อยลง การเลือกเฉพาะช่องที่คุณต้องการในงานที่ใช้งานจริงจะช่วยให้ประสิทธิภาพของเวลาในการตอบสนองที่เสถียร เราอาจเพิ่มช่องคำตอบอีกในอนาคต และช่องใหม่เหล่านั้นอาจต้องใช้เวลาในการคำนวณเพิ่มเติม หากเลือกทุกช่องหรือเลือกช่องทั้งหมดที่ระดับบนสุด ประสิทธิภาพอาจลดลงเนื่องจากช่องใหม่ที่เราเพิ่มจะรวมอยู่ในคำตอบโดยอัตโนมัติ การเลือกเฉพาะฟิลด์ที่คุณต้องการจะส่งผลให้เกิดขนาดการตอบสนองที่เล็กลง ทำให้อัตราการส่งข้อมูลของเครือข่ายสูงขึ้น ขอบเขตการให้สิทธิ์ ต้องใช้ขอบเขต OAuth ต่อไปนี้ https://www.googleapis.com/auth/maps-platform.routespreferred ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมของ OAuth 2.0

ComputeRouteMatrix

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement) นำรายการต้นทางและปลายทางกลับมา แล้วแสดงผลสตรีมที่มีข้อมูลเส้นทางสำหรับชุดค่าผสมต้นทางและปลายทางแต่ละรายการ หมายเหตุ: วิธีนี้กำหนดให้คุณต้องระบุมาสก์ช่องคำตอบในอินพุต คุณระบุมาสก์ของช่องการตอบกลับได้โดยใช้พารามิเตอร์ของ URL $fields หรือ fields หรือใช้ส่วนหัว HTTP/gRPC X-Goog-FieldMask (ดูพารามิเตอร์และส่วนหัวของ URL ที่ใช้ได้ ค่านี้คือรายการเส้นทางช่องที่คั่นด้วยเครื่องหมายจุลภาค ดูเอกสารประกอบโดยละเอียดเกี่ยวกับวิธีสร้างเส้นทางภาคสนาม ตัวอย่างเช่น ในวิธีการนี้ มาสก์ของช่องทั้งหมดที่มี (สําหรับการตรวจสอบด้วยตนเอง): X-Goog-FieldMask: * มาสก์ของช่องของระยะเวลาเส้นทาง ระยะทาง สถานะองค์ประกอบ เงื่อนไข และดัชนีองค์ประกอบ (ตัวอย่างการตั้งค่าเวอร์ชันที่ใช้งานจริง): X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration คุณจำเป็นต้องใส่ status ในมาสก์ของช่อง ไม่เช่นนั้นข้อความทั้งหมดจะไม่มีปัญหา Google ไม่แนะนำให้ใช้มาสก์ช่องคำตอบที่มีไวลด์การ์ด (*) เนื่องจาก การเลือกเฉพาะช่องที่คุณต้องการจะช่วยให้เซิร์ฟเวอร์ของเราบันทึกรอบการคำนวณได้ ซึ่งทำให้เราสามารถส่งคืนผลลัพธ์ให้คุณได้โดยมีเวลาในการตอบสนองที่น้อยลง การเลือกเฉพาะช่องที่คุณต้องการในงานที่ใช้งานจริงจะช่วยให้ประสิทธิภาพของเวลาในการตอบสนองที่เสถียร เราอาจเพิ่มช่องคำตอบอีกในอนาคต และช่องใหม่เหล่านั้นอาจต้องใช้เวลาในการคำนวณเพิ่มเติม หากเลือกทุกช่องหรือเลือกช่องทั้งหมดที่ระดับบนสุด ประสิทธิภาพอาจลดลงเนื่องจากช่องใหม่ที่เราเพิ่มจะรวมอยู่ในคำตอบโดยอัตโนมัติ การเลือกเฉพาะฟิลด์ที่คุณต้องการจะส่งผลให้เกิดขนาดการตอบสนองที่เล็กลง ทำให้อัตราการส่งข้อมูลของเครือข่ายสูงขึ้น ขอบเขตการให้สิทธิ์ ต้องใช้ขอบเขต OAuth ต่อไปนี้ https://www.googleapis.com/auth/maps-platform.routespreferred ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมของ OAuth 2.0

ComputeRoutes

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse) แสดงเส้นทางหลักพร้อมกับเส้นทางสำรองที่เป็นตัวเลือก โดยพิจารณาจากชุดของจุดสิ้นสุดและจุดระหว่างทาง หมายเหตุ: วิธีนี้กำหนดให้คุณต้องระบุมาสก์ช่องคำตอบในอินพุต คุณระบุมาสก์ของช่องการตอบกลับได้โดยใช้พารามิเตอร์ของ URL $fields หรือ fields หรือใช้ส่วนหัว HTTP/gRPC X-Goog-FieldMask (ดูพารามิเตอร์และส่วนหัวของ URL ที่ใช้ได้ ค่านี้คือรายการเส้นทางช่องที่คั่นด้วยเครื่องหมายจุลภาค ดูเอกสารประกอบโดยละเอียดเกี่ยวกับวิธีสร้างเส้นทางภาคสนาม ตัวอย่างเช่น ในวิธีการนี้ มาสก์ของช่องทั้งหมดที่มี (สําหรับการตรวจสอบด้วยตนเอง): X-Goog-FieldMask: * มาสก์ของช่องของระยะเวลา ระยะทาง และโพลีไลน์ในระดับเส้นทาง (ตัวอย่างการตั้งค่าเวอร์ชันที่ใช้งานจริง): X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline Google ไม่แนะนำให้ใช้มาสก์ช่องคำตอบที่มีไวลด์การ์ด (*) หรือระบุมาสก์ช่องที่ระดับบนสุด (routes) เนื่องจากสาเหตุต่อไปนี้ การเลือกเฉพาะช่องที่คุณต้องการจะช่วยให้เซิร์ฟเวอร์ของเราบันทึกรอบการคำนวณได้ ซึ่งทำให้เราสามารถส่งคืนผลลัพธ์ให้คุณได้โดยมีเวลาในการตอบสนองที่น้อยลง การเลือกเฉพาะช่องที่คุณต้องการในงานที่ใช้งานจริงจะช่วยให้ประสิทธิภาพของเวลาในการตอบสนองที่เสถียร เราอาจเพิ่มช่องคำตอบอีกในอนาคต และช่องใหม่เหล่านั้นอาจต้องใช้เวลาในการคำนวณเพิ่มเติม หากเลือกทุกช่องหรือเลือกช่องทั้งหมดที่ระดับบนสุด ประสิทธิภาพอาจลดลงเนื่องจากช่องใหม่ที่เราเพิ่มจะรวมอยู่ในคำตอบโดยอัตโนมัติ การเลือกเฉพาะฟิลด์ที่คุณต้องการจะส่งผลให้เกิดขนาดการตอบสนองที่เล็กลง ทำให้อัตราการส่งข้อมูลของเครือข่ายสูงขึ้น ขอบเขตการให้สิทธิ์ ต้องใช้ขอบเขต OAuth ต่อไปนี้ https://www.googleapis.com/auth/maps-platform.routespreferred ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมของ OAuth 2.0

ComputeCustomRoutesRequest

ข้อความคำขอ ComputeCustomRoutes

ช่อง
origin	Waypoint ต้องระบุ จุดอ้างอิงเดิม
destination	Waypoint ต้องระบุ จุดอ้างอิงปลายทาง
intermediates[]	Waypoint ไม่บังคับ ชุดของจุดอ้างอิงระหว่างเส้นทาง (ไม่รวมจุดปลายทาง) สำหรับการหยุดหรือขับผ่าน รองรับจุดอ้างอิงระดับกลางสูงสุด 25 จุด
travel_mode	RouteTravelMode ไม่บังคับ ระบุรูปแบบการเดินทาง ขณะนี้รองรับเฉพาะไดรฟ์เท่านั้น
routing_preference	RoutingPreference ไม่บังคับ ระบุวิธีการคำนวณเส้นทาง เซิร์ฟเวอร์จะพยายามใช้ค่ากำหนดการกำหนดเส้นทางที่เลือกไว้เพื่อคำนวณเส้นทาง หากค่ากำหนดการกำหนดเส้นทางทำให้เกิดข้อผิดพลาดหรือใช้เวลาเวลาในการตอบสนองนานขึ้น ระบบจะแสดงข้อผิดพลาด ในอนาคต เราอาจใช้กลไกสำรองเพื่อใช้ตัวเลือกอื่นเมื่อตัวเลือกที่ต้องการไม่ได้ให้ผลลัพธ์ที่ถูกต้อง คุณจะระบุตัวเลือกนี้ได้เฉพาะเมื่อ travel_mode คือ DRIVE หรือ TWO_WHEELER มิเช่นนั้นคำขอจะไม่สำเร็จ
polyline_quality	PolylineQuality ไม่บังคับ ระบุค่ากำหนดของคุณสำหรับคุณภาพของโพลีไลน์
polyline_encoding	PolylineEncoding ไม่บังคับ ระบุการเข้ารหัสที่ต้องการสำหรับโพลีไลน์
departure_time	Timestamp ไม่บังคับ เวลาออกเดินทาง หากไม่ตั้งค่านี้ ค่าเริ่มต้นจะเป็นเวลาที่คุณส่งคำขอ หากตั้งค่านี้เป็นเวลาที่เกิดขึ้นแล้ว คำขอจะล้มเหลว
route_modifiers	RouteModifiers ไม่บังคับ ชุดเงื่อนไขที่จะแก้ไขเพื่อให้มีผลกับวิธีคำนวณเส้นทาง
route_objective	RouteObjective ต้องระบุ วัตถุประสงค์ของเส้นทางที่ควรเพิ่มประสิทธิภาพ
language_code	string ไม่บังคับ รหัสภาษา BCP-47 เช่น "en-US" หรือ "sr-Latn" ดูข้อมูลเพิ่มเติมได้ที่ http://www.unicode.org/reports/tr35/#Unicode_locale_identifier ดูการสนับสนุนภาษาสำหรับรายการภาษาที่รองรับ ถ้าคุณไม่ระบุค่านี้ ภาษาที่แสดงจะอนุมานจากตำแหน่งของคำขอเส้นทาง
units	Units ไม่บังคับ ระบุหน่วยวัดสำหรับช่องแสดงผล ซึ่งรวมถึงช่อง instruction ใน NavigationInstruction หน่วยวัดที่ใช้สำหรับเส้นทาง ระยะทางก้าว ก้าว และระยะเวลาจะไม่ได้รับผลกระทบจากค่านี้ หากคุณไม่ระบุค่านี้ ระบบจะอนุมานหน่วยที่แสดงจากตำแหน่งของคำขอ

ComputeCustomRoutesResponse

ข้อความตอบกลับ ComputeCustomRoutes

ช่อง
routes[]	CustomRoute เส้นทาง "ที่ดีที่สุด" สำหรับวัตถุประสงค์ของเส้นทางอินพุต
fastest_route	CustomRoute เส้นทางอ้างอิงที่เร็วที่สุด
shortest_route	CustomRoute เส้นทางอ้างอิงที่สั้นที่สุด
fallback_info	FallbackInfo ข้อมูลสำรองสำหรับเส้นทางที่กำหนดเอง

FallbackInfo

รวมข้อมูลสำรองสำหรับ ComputeCustomRoutes ComputeCustomRoutes ใช้โฆษณาสำรอง 2 ประเภท ดังนี้

1. ถ้าไม่สามารถคำนวณเส้นทางโดยใช้ Routing_preference ที่ลูกค้าขอได้ ระบบจะใช้การกำหนดเส้นทางสำรองเป็นโหมดการกำหนดเส้นทางอื่น ในกรณีนี้ fallback_routing_mode และRouting_mode_fallback_reason จะใช้เพื่อสื่อสารโหมดการกำหนดเส้นทางสำรองที่ใช้ รวมถึงเหตุผลในการใช้สำรอง

2. หากคำนวณเส้นทาง "ที่ดีที่สุด" สำหรับวัตถุประสงค์ของเส้นทางที่ลูกค้าระบุไม่ได้ ระบบอาจสำรองไปยังวัตถุประสงค์อื่น fallback_route_objective ใช้ในการสื่อสารวัตถุประสงค์ของเส้นทางสำรอง

ช่อง
routing_mode	FallbackRoutingMode โหมดการกำหนดเส้นทางที่ใช้สำหรับการตอบกลับ หากมีการทริกเกอร์เส้นทางสำรอง โหมดอาจแตกต่างจากค่ากำหนดการกำหนดเส้นทางในคำขอของไคลเอ็นต์เดิม
routing_mode_reason	FallbackReason เหตุผลที่ใช้คําตอบสำรองแทนคําตอบต้นฉบับ ช่องนี้จะมีการป้อนข้อมูลเฉพาะเมื่อมีการทริกเกอร์โหมดสำรองและมีการส่งการตอบสนองสำรองกลับมา
route_objective	FallbackRouteObjective วัตถุประสงค์ของเส้นทางที่ใช้สำหรับคำตอบ หากมีการทริกเกอร์วิดีโอสำรอง วัตถุประสงค์อาจแตกต่างจากวัตถุประสงค์ของเส้นทางที่ระบุไว้ในคำขอไคลเอ็นต์เดิม

FallbackRouteObjective

RouteObjective ที่ใช้สำหรับการตอบกลับ

Enum
FALLBACK_ROUTE_OBJECTIVE_UNSPECIFIED	ไม่ได้ระบุวัตถุประสงค์ของเส้นทางสำรอง
FALLBACK_RATECARD_WITHOUT_TOLL_PRICE_DATA	หากลูกค้าขอ RateCard และตั้งค่า include_tolls เป็น true และ Google ไม่มีข้อมูลค่าผ่านทางสำหรับเส้นทาง API จะกลับไปใช้ RateCard โดยไม่พิจารณาค่าผ่านทาง

ComputeRouteMatrixRequest

ข้อความคำขอ ComputeRouteMatrix

ช่อง
origins[]	RouteMatrixOrigin ต้องระบุ อาร์เรย์ของต้นทาง ซึ่งกำหนดแถวของเมทริกซ์คำตอบ มีข้อจำกัดด้านขนาดหลายประการที่มีผลต่อ Cardinality ของต้นทางและปลายทาง ดังนี้ จำนวนองค์ประกอบ (ต้นทาง × ปลายทาง) ต้องไม่เกิน 625 ในทุกกรณี จำนวนองค์ประกอบ (ต้นทาง × ปลายทาง) ต้องไม่เกิน 100 หากตั้งค่า Routing_preference เป็น TRAFFIC_AWARE_OPTIMAL จำนวนจุดอ้างอิง (ต้นทาง + ปลายทาง) ที่ระบุเป็น place_id ต้องไม่เกิน 50
destinations[]	RouteMatrixDestination ต้องระบุ อาร์เรย์ของปลายทาง ซึ่งกำหนดคอลัมน์ของเมทริกซ์การตอบสนอง
travel_mode	RouteTravelMode ไม่บังคับ ระบุรูปแบบการเดินทาง
routing_preference	RoutingPreference ไม่บังคับ ระบุวิธีการคำนวณเส้นทาง เซิร์ฟเวอร์จะพยายามใช้ค่ากำหนดการกำหนดเส้นทางที่เลือกไว้เพื่อคำนวณเส้นทาง หากค่ากำหนดการกำหนดเส้นทางทำให้เกิดข้อผิดพลาดหรือใช้เวลาเวลาในการตอบสนองนานขึ้น ระบบจะแสดงข้อผิดพลาด ในอนาคต เราอาจใช้กลไกสำรองเพื่อใช้ตัวเลือกอื่นเมื่อตัวเลือกที่ต้องการไม่ได้ให้ผลลัพธ์ที่ถูกต้อง คุณจะระบุตัวเลือกนี้ได้เฉพาะเมื่อ travel_mode คือ DRIVE หรือ TWO_WHEELER มิเช่นนั้นคำขอจะไม่สำเร็จ
departure_time	Timestamp ไม่บังคับ เวลาออกเดินทาง หากไม่ตั้งค่านี้ ค่าเริ่มต้นจะเป็นเวลาที่คุณส่งคำขอ ถ้าคุณตั้งค่านี้เป็นเวลาที่เกิดขึ้นแล้ว คำขอจะล้มเหลว

ComputeRoutesRequest

ข้อความคำขอ ComputeRoutes

ช่อง
origin	Waypoint ต้องระบุ จุดอ้างอิงเดิม
destination	Waypoint ต้องระบุ จุดอ้างอิงปลายทาง
intermediates[]	Waypoint ไม่บังคับ ชุดของจุดอ้างอิงระหว่างเส้นทาง (ไม่รวมจุดปลายทาง) สำหรับการหยุดหรือขับผ่าน รองรับจุดอ้างอิงระดับกลางสูงสุด 25 จุด
travel_mode	RouteTravelMode ไม่บังคับ ระบุรูปแบบการเดินทาง
routing_preference	RoutingPreference ไม่บังคับ ระบุวิธีการคำนวณเส้นทาง เซิร์ฟเวอร์จะพยายามใช้ค่ากำหนดการกำหนดเส้นทางที่เลือกไว้เพื่อคำนวณเส้นทาง หากค่ากำหนดการกำหนดเส้นทางทำให้เกิดข้อผิดพลาดหรือใช้เวลาเวลาในการตอบสนองนานขึ้น ระบบจะแสดงข้อผิดพลาด ในอนาคต เราอาจใช้กลไกสำรองเพื่อใช้ตัวเลือกอื่นเมื่อตัวเลือกที่ต้องการไม่ได้ให้ผลลัพธ์ที่ถูกต้อง คุณจะระบุตัวเลือกนี้ได้เฉพาะเมื่อ travel_mode คือ DRIVE หรือ TWO_WHEELER มิเช่นนั้นคำขอจะไม่สำเร็จ
polyline_quality	PolylineQuality ไม่บังคับ ระบุค่ากำหนดของคุณสำหรับคุณภาพของโพลีไลน์
polyline_encoding	PolylineEncoding ไม่บังคับ ระบุการเข้ารหัสที่ต้องการสำหรับโพลีไลน์
departure_time	Timestamp ไม่บังคับ เวลาออกเดินทาง หากไม่ตั้งค่านี้ ค่าเริ่มต้นจะเป็นเวลาที่คุณส่งคำขอ หากตั้งค่านี้เป็นเวลาที่เกิดขึ้นแล้ว คำขอจะล้มเหลว
compute_alternative_routes	bool ระบุว่าจะคำนวณเส้นทางอื่นนอกเหนือจากเส้นทางหรือไม่
route_modifiers	RouteModifiers ไม่บังคับ ชุดเงื่อนไขที่จะแก้ไขเพื่อให้มีผลกับวิธีคำนวณเส้นทาง
language_code	string ไม่บังคับ รหัสภาษา BCP-47 เช่น "en-US" หรือ "sr-Latn" ดูข้อมูลเพิ่มเติมได้ที่ http://www.unicode.org/reports/tr35/#Unicode_locale_identifier ดูการสนับสนุนภาษาสำหรับรายการภาษาที่รองรับ ถ้าคุณไม่ระบุค่านี้ ภาษาที่แสดงจะอนุมานจากตำแหน่งของคำขอเส้นทาง
units	Units ไม่บังคับ ระบุหน่วยวัดสำหรับช่องแสดงผล ซึ่งรวมถึงช่อง instruction ใน NavigationInstruction หน่วยวัดที่ใช้สำหรับเส้นทาง ระยะทางก้าว ก้าว และระยะเวลาจะไม่ได้รับผลกระทบจากค่านี้ หากคุณไม่ระบุค่านี้ ระบบจะอนุมานหน่วยที่แสดงจากตำแหน่งของคำขอ
optimize_waypoint_order	bool หากตั้งค่า performanceWaypointOrder เป็น "จริง" ระบบจะพยายามจัดเรียงจุดอ้างอิงระดับกลางที่ระบุใหม่เพื่อลดค่าใช้จ่ายโดยรวมของเส้นทาง หากจุดอ้างอิงระดับกลางใดๆ มีการชี้ทางนั้น คําขอจะไม่สําเร็จ ใช้ ComputeRoutesResponse.Routes.optimize_intermediate_waypoint_index เพื่อค้นหาลำดับใหม่ หากไม่มีการส่งคำขอ path.optimize_intermediate_waypoint_index ในส่วนหัว X-Goog-FieldMask คำขอจะไม่สำเร็จ หากตั้งค่า OptimizeWaypointOrder เป็น false แล้ว ComputeRoutesResponse.optimize_intermediate_waypoint_index จะว่างเปล่า

ComputeRoutesResponse

ComputeRoutes ข้อความตอบกลับ

ช่อง
routes[]	Route มีอาร์เรย์ของเส้นทางที่คำนวณแล้ว (สูงสุด 3 เส้นทาง) เมื่อคุณระบุ compute_alternatives_redirect และมีเพียงเส้นทางเดียวเมื่อคุณไม่มี เมื่ออาร์เรย์นี้มีหลายรายการ รายการแรกคือเส้นทางที่แนะนำมากที่สุด ถ้าอาร์เรย์ว่างเปล่า แสดงว่าไม่พบเส้นทาง
fallback_info	FallbackInfo ในบางกรณี เมื่อเซิร์ฟเวอร์ไม่สามารถคำนวณผลลัพธ์เส้นทางด้วยค่ากำหนดอินพุตทั้งหมด เซิร์ฟเวอร์อาจกลับไปใช้วิธีการคำนวณแบบอื่น เมื่อใช้โหมดสำรอง ช่องนี้จะมีข้อมูลโดยละเอียดเกี่ยวกับการตอบกลับสำรอง มิเช่นนั้นระบบจะไม่ได้ตั้งค่าช่องนี้

CustomRoute

รวมเส้นทางที่กำหนดเองซึ่งคํานวณตามวัตถุประสงค์ของเส้นทางที่ลูกค้าระบุ CustomRoute มีเส้นทางและโทเค็นเส้นทาง ซึ่งสามารถส่งผ่านไปยัง NavSDK เพื่อสร้างเส้นทางที่กำหนดเองขึ้นมาใหม่สำหรับการนำทางแบบเลี้ยวต่อเลี้ยว

ช่อง
route	Route เส้นทางนั้นถือว่า "ดีที่สุด" สําหรับวัตถุประสงค์ในเส้นทางอินพุต
token	string โทเค็นเส้นทางที่เข้ารหัส base64 แบบ Web-safe สามารถส่งผ่านไปยัง NavSDK ได้ ซึ่งอนุญาตให้ NavSDK สร้างเส้นทางใหม่ในระหว่างการนำทาง และในกรณีที่การเปลี่ยนเส้นทางจะเป็นไปตามความตั้งใจเดิมเมื่อมีการเรียกใช้ RoutesPreferred ComputeCustomRoutes ลูกค้าควรถือว่าโทเค็นนี้เป็น BLOB ทึบแสง

FallbackInfo

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

ช่อง
routing_mode	FallbackRoutingMode โหมดการกำหนดเส้นทางที่ใช้สำหรับการตอบกลับ หากมีการทริกเกอร์เส้นทางสำรอง โหมดอาจแตกต่างจากค่ากำหนดการกำหนดเส้นทางในคำขอของไคลเอ็นต์เดิม
reason	FallbackReason เหตุผลที่ใช้คําตอบสำรองแทนคําตอบต้นฉบับ ช่องนี้จะมีการป้อนข้อมูลเฉพาะเมื่อมีการทริกเกอร์โหมดสำรองและมีการส่งการตอบสนองสำรองกลับมา

FallbackReason

เหตุผลในการใช้การตอบกลับสำรอง

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

FallbackRoutingMode

โหมดการกำหนดเส้นทางจริงที่ใช้สำหรับการตอบสนองสำรอง

Enum
FALLBACK_ROUTING_MODE_UNSPECIFIED	ไม่ใช้
FALLBACK_TRAFFIC_UNAWARE	ระบุว่ามีการใช้โหมดการกำหนดเส้นทาง "TRAFFIC_UNAWARE" ในการคำนวณการตอบสนอง
FALLBACK_TRAFFIC_AWARE	ระบุว่ามีการใช้โหมดการกำหนดเส้นทาง "TRAFFIC_AWARE" ในการคำนวณการตอบสนอง

ตำแหน่ง

มีการห่อหุ้มสถานที่ตั้ง (จุดทางภูมิศาสตร์ และส่วนหัวที่ไม่บังคับ)

ช่อง
lat_lng	LatLng พิกัดทางภูมิศาสตร์ของจุดอ้างอิง
heading	Int32Value ทิศทางของเข็มทิศที่เชื่อมโยงกับทิศทางการเคลื่อนที่ของการจราจร ค่านี้ใช้เพื่อระบุข้างถนนที่จะใช้สำหรับรับและส่ง ค่าส่วนหัวอาจเป็นตั้งแต่ 0 ถึง 360 โดย 0 ระบุทิศทางของทิศเหนือ 90 ระบุทิศทางทิศตะวันออก ฯลฯ คุณสามารถใช้ช่องนี้เฉพาะกับโหมดการเดินทางในDRIVEและTWO_WHEELERเท่านั้น

การเคลื่อนย้าย

ชุดค่าที่ระบุการทำงานของการนำทางสำหรับขั้นตอนปัจจุบัน (เช่น เลี้ยวซ้าย ผสาน เส้นตรง ฯลฯ)

Enum
MANEUVER_UNSPECIFIED	ไม่ใช้
TURN_SLIGHT_LEFT	เบี่ยงไปทางซ้ายเล็กน้อย
TURN_SHARP_LEFT	หักศอกไปทางซ้าย
UTURN_LEFT	กลับรถทางขวา
TURN_LEFT	เลี้ยวซ้าย
TURN_SLIGHT_RIGHT	เบี่ยงไปทางขวาเล็กน้อย
TURN_SHARP_RIGHT	เลี้ยวขวาหักศอก
UTURN_RIGHT	กลับรถทางขวา
TURN_RIGHT	เลี้ยวขวา
STRAIGHT	ตรงไป
RAMP_LEFT	ใช้ทางลาดด้านซ้าย
RAMP_RIGHT	ใช้ทางลาดด้านขวา
MERGE	รวมเข้าไปในการเข้าชม
FORK_LEFT	ใช้ทางแยกซ้าย
FORK_RIGHT	ใช้ทางแยกด้านขวา
FERRY	ขึ้นเรือข้ามฟาก
FERRY_TRAIN	ขึ้นรถไฟไปยังเรือข้ามฟาก
ROUNDABOUT_LEFT	เลี้ยวซ้ายที่วงเวียน
ROUNDABOUT_RIGHT	เลี้ยวขวาที่วงเวียน

NavigationInstruction

ช่อง
maneuver	Maneuver สรุปคำแนะนำการนำทางสำหรับขั้นตอนปัจจุบัน (เช่น เลี้ยวซ้าย ผสาน เส้นตรง ฯลฯ) ช่องนี้จะกำหนดไอคอนที่จะแสดง
instructions	string คำแนะนำสำหรับการนำทางขั้นตอนนี้

เส้นประกอบ

ห่อหุ้มโพลีไลน์ที่เข้ารหัส

ช่อง
ฟิลด์การรวม polyline_type ห่อหุ้มประเภทของโพลีไลน์ ค่าเริ่มต้นเป็น encrypted_polyline polyline_type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
encoded_polyline	string การเข้ารหัสสตริงของโพลีไลน์โดยใช้อัลกอริทึมการเข้ารหัสแบบโพลีไลน์
geo_json_linestring	Struct ระบุโพลีไลน์โดยใช้รูปแบบ GeoJSON LineString

PolylineEncoding

ระบุประเภทของโพลีไลน์ที่ต้องการให้แสดงผล

Enum
POLYLINE_ENCODING_UNSPECIFIED	ไม่ได้ระบุค่ากำหนดประเภทโพลีไลน์ ค่าเริ่มต้นคือ ENCODED_POLYLINE
ENCODED_POLYLINE	ระบุโพลีไลน์ที่เข้ารหัสโดยใช้อัลกอริทึมการเข้ารหัสแบบโพลีไลน์
GEO_JSON_LINESTRING	ระบุโพลีไลน์โดยใช้รูปแบบ GeoJSON LineString

PolylineQuality

ชุดค่าที่ระบุคุณภาพของเส้นประกอบ

Enum
POLYLINE_QUALITY_UNSPECIFIED	ไม่ได้ระบุค่ากำหนดคุณภาพโพลีไลน์ ค่าเริ่มต้นคือ OVERVIEW
HIGH_QUALITY	ระบุโพลีไลน์คุณภาพสูงซึ่งประกอบขึ้นโดยใช้จุดมากกว่า OVERVIEW แต่มีขนาดการตอบสนองเพิ่มขึ้น ใช้ค่านี้เมื่อต้องการความแม่นยำมากขึ้น
OVERVIEW	ระบุโพลีไลน์ภาพรวม - ซึ่งประกอบขึ้นโดยใช้จุดเพียงไม่กี่จุด ใช้ค่านี้เมื่อแสดงภาพรวมของเส้นทาง การใช้ตัวเลือกนี้จะมีเวลาในการตอบสนองของคำขอต่ำกว่าเมื่อเทียบกับการใช้ตัวเลือก HIGH_QUALITY

เส้นทาง

รวมเส้นทาง ซึ่งประกอบด้วยชุดส่วนของถนนที่เชื่อมถึงกันเข้าด้วยกัน ซึ่งผนวกกับจุดอ้างอิงจุดเริ่มต้น จุดสิ้นสุด และจุดระหว่างกลาง

ช่อง
legs[]	RouteLeg คอลเล็กชันขา (ส่วนของเส้นทางระหว่างจุดอ้างอิง) ที่ประกอบกันเป็นเส้นทาง แต่ละขาเท่ากับการเดินทางระหว่างจุดบนเส้นทางที่ไม่ใช่ via จุด 2 จุด เช่น เส้นทางที่ไม่มีจุดระหว่างทางมีขาเพียงขาเดียว เส้นทางที่มีจุดระหว่างทางที่ไม่ใช่ via หนึ่งจุดมี 2 ขา เส้นทางที่มีจุดระหว่างทางระดับกลาง 1 จุดของ via มีขา 1 ขา ลำดับของขาตรงกับลำดับของจุดอ้างอิงจาก origin ไป intermediates ถึง destination
distance_meters	int32 ระยะทางในการเดินทางของเส้นทางในหน่วยเมตร
duration	Duration ระยะเวลาที่ใช้ในการนำทาง หากคุณตั้งค่า routing_preference เป็น TRAFFIC_UNAWARE ค่านี้จะเหมือนกับ static_duration หากคุณตั้งค่า routing_preference เป็น TRAFFIC_AWARE หรือ TRAFFIC_AWARE_OPTIMAL ระบบจะคำนวณค่านี้โดยพิจารณาจากสภาพการจราจร
static_duration	Duration ระยะเวลาเดินทางในเส้นทางโดยไม่พิจารณาสภาพการจราจร
polyline	Polyline เส้นประกอบเส้นทางโดยรวม โพลีไลน์นี้จะเป็นโพลีไลน์รวมของ legs ทั้งหมด
description	string คำอธิบายเส้นทาง
warnings[]	string อาร์เรย์ของคำเตือนที่จะแสดงเมื่อแสดงเส้นทาง
viewport	Viewport กล่องขอบเขตวิวพอร์ตของโพลีไลน์
travel_advisory	RouteTravelAdvisory ข้อมูลเพิ่มเติมเกี่ยวกับเส้นทาง
optimized_intermediate_waypoint_index[]	int32 หากตั้งค่า ComputeRoutesRequest.optimize_waypoint_order เป็น "จริง" ช่องนี้จะมีการจัดลำดับจุดอ้างอิงตัวกลางที่เพิ่มประสิทธิภาพ มิเช่นนั้น ช่องนี้จะว่างเปล่า ตัวอย่างเช่น สมมติว่าอินพุตคือ Origin: LA; Intermediates: Dallas, Bangor, Phoenix; ปลายทาง: New York และลำดับจุดอ้างอิงระหว่างกลางที่เพิ่มประสิทธิภาพแล้วคือ: ฟีนิกซ์ ดัลลัส บันกอร์ จากนั้นช่องนี้จะมีค่า [2, 0, 1] ดัชนีขึ้นต้นด้วย 0 สำหรับจุดอ้างอิงตรงกลางแรก

RouteLeg

ห่อหุ้มกลุ่มระหว่างจุดอ้างอิงที่ไม่ใช่ via

ช่อง
distance_meters	int32 ระยะทางในการเดินทางของขาในเส้นทาง หน่วยเป็นเมตร
duration	Duration ระยะเวลาที่ต้องใช้ในการนำทาง หากตั้งค่า route_preference เป็น TRAFFIC_UNAWARE ค่านี้จะเหมือนกับ static_duration หาก route_preference เป็น TRAFFIC_AWARE หรือ TRAFFIC_AWARE_OPTIMAL ระบบจะคำนวณค่านี้โดยพิจารณาจากสภาพการจราจร
static_duration	Duration ระยะเวลาเดินทางผ่านขา ซึ่งคำนวณโดยไม่คำนึงถึงสภาพการจราจร
polyline	Polyline เส้นประกอบโดยรวมของขานี้ ซึ่งรวมถึงโพลีไลน์ของ step แต่ละรายการ
start_location	Location ตำแหน่งเริ่มต้นของขานี้ ซึ่งอาจต่างจาก origin ที่ให้ไว้ ตัวอย่างเช่น เมื่อ origin ที่ระบุไม่ได้อยู่ใกล้ถนน แสดงว่าเป็นจุดบนถนน
end_location	Location ตำแหน่งสุดท้ายของขานี้ ซึ่งอาจต่างจาก destination ที่ให้ไว้ ตัวอย่างเช่น เมื่อ destination ที่ระบุไม่ได้อยู่ใกล้ถนน แสดงว่าเป็นจุดบนถนน
steps[]	RouteLegStep อาร์เรย์ของขั้นตอนที่แสดงถึงส่วนต่างๆ ภายในขานี้ แต่ละขั้นตอนจะแสดงวิธีการนำทาง 1 รายการ
travel_advisory	RouteLegTravelAdvisory สรุปข้อมูลเพิ่มเติมที่ผู้ใช้ควรทราบ เช่น การจำกัดโซนการเข้าชมที่อาจเกิดขึ้น ฯลฯ ในเส้นทาง

RouteLegStep

ห่อหุ้มส่วนของ RouteLeg ขั้นตอนจะสอดคล้องกับวิธีการนำทางรายการเดียว ขาของเส้นทางประกอบด้วยขั้นบันได

ช่อง
distance_meters	int32 ระยะในการเดินทางของขั้นตอนนี้เป็นเมตร ในบางกรณี ช่องนี้อาจไม่มีค่า
static_duration	Duration ระยะเวลาการเดินทางผ่านขั้นตอนนี้โดยไม่พิจารณาสภาพการจราจร ในบางกรณี ช่องนี้อาจไม่มีค่า
polyline	Polyline เส้นประกอบที่เชื่อมโยงกับขั้นตอนนี้
start_location	Location ตำแหน่งเริ่มต้นของขั้นตอนนี้
end_location	Location ตำแหน่งสุดท้ายของขั้นตอนนี้
navigation_instruction	NavigationInstruction คำแนะนำการนำทาง
travel_advisory	RouteLegStepTravelAdvisory มีการสรุปข้อมูลเพิ่มเติมที่ผู้ใช้ควรทราบ เช่น การจำกัดโซนการเข้าชมที่เป็นไปได้ในขั้นตอนการดำเนินการ

RouteLegStepTravelAdvisory

มีการสรุปข้อมูลเพิ่มเติมที่ผู้ใช้ควรทราบ เช่น การจำกัดโซนการเข้าชมที่เป็นไปได้ในขั้นตอนการดำเนินการ

ช่อง

speed_reading_intervals[]

SpeedReadingInterval ช่วงการอ่านความเร็วที่ให้รายละเอียดความหนาแน่นของการจราจร ใช้ได้ในกรณีของค่ากำหนดการกำหนดเส้นทาง TRAFFIC_AWARE และ TRAFFIC_AWARE_OPTIMAL โดยช่วงเวลาดังกล่าวจะครอบคลุมเส้นประกอบทั้งหมดของ RouteLegStep โดยไม่มีการทับซ้อนกัน จุดเริ่มต้นของช่วงเวลาที่ระบุเหมือนกับจุดสิ้นสุดของช่วงเวลาก่อนหน้า ตัวอย่าง polyline: A ---- B ---- C ---- D ---- E ---- F ---- G speed_reading_intervals: [A,C), [C,D), [D,G).

RouteLegTravelAdvisory

สรุปข้อมูลเพิ่มเติมที่ผู้ใช้ควรทราบ เช่น การจำกัดโซนการเข้าชมที่อาจเกิดขึ้น ฯลฯ ในเส้นทาง

ช่อง
toll_info	TollInfo สรุปข้อมูลเกี่ยวกับค่าผ่านทางใน RouteLeg ที่เฉพาะเจาะจง ฟิลด์นี้จะแสดงในกรณีที่เราคาดว่ามีค่าผ่านทางบน RouteLeg เท่านั้น หากตั้งค่าช่องนี้ไว้ แต่ไม่มีการเติมข้อมูลในช่องย่อยของค่าประมาณ [estimated_price] คาดว่าถนนจะมีค่าผ่านทางแต่ไม่ทราบราคาโดยประมาณ ถ้าไม่มีช่องนี้ แสดงว่าไม่มีค่าผ่านทางบน RouteLeg
speed_reading_intervals[]	SpeedReadingInterval ช่วงการอ่านความเร็วที่ให้รายละเอียดความหนาแน่นของการจราจร ใช้ได้ในกรณีของค่ากำหนดการกำหนดเส้นทาง TRAFFIC_AWARE และ TRAFFIC_AWARE_OPTIMAL ช่วงเวลาจะครอบคลุมเส้นโพลีไลน์ทั้งหมดของ RouteLg โดยไม่ทับซ้อนกัน จุดเริ่มต้นของช่วงเวลาที่ระบุเหมือนกับจุดสิ้นสุดของช่วงเวลาก่อนหน้า ตัวอย่าง polyline: A ---- B ---- C ---- D ---- E ---- F ---- G speed_reading_intervals: [A,C), [C,D), [D,G).

RouteMatrixDestination

ปลายทางเดียวสำหรับ ComputeRouteMatrixRequest

ช่อง
waypoint	Waypoint ต้องระบุ จุดอ้างอิงปลายทาง

RouteMatrixElement

สรุปข้อมูลเส้นทางที่คํานวณสําหรับคู่ต้นทาง/ปลายทางใน ComputeRouteMatrix API คุณสตรีม Proto นี้ไปยังไคลเอ็นต์ได้

ช่อง
origin_index	int32 ดัชนีแบบศูนย์ของต้นทางในคำขอ
destination_index	int32 ดัชนีแบบศูนย์ของปลายทางในคำขอ
status	Status รหัสสถานะข้อผิดพลาดขององค์ประกอบนี้
condition	RouteMatrixElementCondition ระบุว่าพบเส้นทางหรือไม่ ไม่เกี่ยวข้องกับสถานะ
distance_meters	int32 ระยะทางในการเดินทางของเส้นทางในหน่วยเมตร
duration	Duration ระยะเวลาที่ใช้ในการนำทาง หากคุณตั้งค่า routing_preference เป็น TRAFFIC_UNAWARE ค่านี้จะเหมือนกับ static_duration หากคุณตั้งค่า routing_preference เป็น TRAFFIC_AWARE หรือ TRAFFIC_AWARE_OPTIMAL ระบบจะคำนวณค่านี้โดยพิจารณาจากสภาพการจราจร
static_duration	Duration ระยะเวลาเดินทางในเส้นทางโดยไม่พิจารณาสภาพการจราจร
travel_advisory	RouteTravelAdvisory ข้อมูลเพิ่มเติมเกี่ยวกับเส้นทาง ตัวอย่างเช่น ข้อมูลข้อจำกัดและข้อมูลค่าผ่านทาง
fallback_info	FallbackInfo ในบางกรณี เมื่อเซิร์ฟเวอร์ไม่สามารถคำนวณเส้นทางด้วยค่ากำหนดที่ระบุสำหรับคู่ต้นทาง/ปลายทางนี้ เซิร์ฟเวอร์อาจกลับไปใช้การคำนวณโหมดอื่น เมื่อใช้โหมดสำรอง ช่องนี้จะมีข้อมูลโดยละเอียดเกี่ยวกับการตอบกลับสำรอง มิเช่นนั้นระบบจะไม่ได้ตั้งค่าช่องนี้

RouteMatrixElementCondition

เงื่อนไขของเส้นทางที่แสดง

Enum
ROUTE_MATRIX_ELEMENT_CONDITION_UNSPECIFIED	ใช้เมื่อ status ขององค์ประกอบไม่ถูกต้องเท่านั้น
ROUTE_EXISTS	พบเส้นทางและได้กรอกข้อมูลที่เกี่ยวข้องสำหรับองค์ประกอบนั้นแล้ว
ROUTE_NOT_FOUND	ไม่พบเส้นทาง ช่องที่มีข้อมูลเส้นทาง เช่น distance_meters หรือ duration จะไม่มีการกรอกในองค์ประกอบ

RouteMatrixOrigin

ต้นทางเดียวสำหรับ ComputeRouteMatrixRequest

ช่อง
waypoint	Waypoint ต้องระบุ จุดอ้างอิงเดิม
route_modifiers	RouteModifiers ไม่บังคับ ตัวปรับแต่งสำหรับทุกเส้นทางที่ใช้เป็นต้นทาง

RouteModifiers

รวมชุดเงื่อนไขทางเลือกที่ต้องปฏิบัติตามเมื่อคำนวณเส้นทาง

ช่อง
avoid_tolls	bool ระบุว่าเลี่ยงถนนที่เรียกเก็บค่าผ่านทางตามความเหมาะสม เส้นทางที่ไม่มีค่าผ่านทางได้จะได้รับเลือกก่อน มีผลกับรูปแบบการเดินทางDRIVEและTWO_WHEELERเท่านั้น
avoid_highways	bool ระบุว่าควรหลีกเลี่ยงทางหลวงตามความเหมาะสม ระบบจะเลือกใช้เส้นทางที่ไม่มีทางหลวง มีผลกับรูปแบบการเดินทางDRIVEและTWO_WHEELERเท่านั้น
avoid_ferries	bool ระบุว่าจะเลี่ยงเรือข้ามฟากในกรณีที่เหมาะสมหรือไม่ ระบบจะเลือกเส้นทางที่ไม่ได้ใช้เรือข้ามฟากก่อน มีผลกับรูปแบบการเดินทางของDRIVEและTWO_WHEELERเท่านั้น
avoid_indoor	bool ระบุว่าจะเลี่ยงการไปยังส่วนต่างๆ ภายในอาคารตามความเหมาะสม เส้นทางที่ไม่มีการนำทางภายในอาคารจะได้รับการตั้งค่าก่อน ใช้กับโหมดการเดินทางWALKเท่านั้น
vehicle_info	VehicleInfo ระบุข้อมูลรถ
toll_passes[]	TollPass สรุปข้อมูลเกี่ยวกับบัตรผ่านทาง หากมีการแสดงบัตรผ่านทาง API จะพยายามส่งคืนราคาบัตร หากไม่ระบุบัตรผ่านทาง API จะถือว่าบัตรผ่านทางนี้เป็นข้อมูลที่ไม่รู้จักและพยายามส่งคืนราคาเป็นเงินสด ใช้กับโหมดการเดินทาง DRIVE และ TWO_WHEELER เท่านั้น

RouteObjective

สรุปวัตถุประสงค์ที่จะเพิ่มประสิทธิภาพตาม ComputeCustomRoutes

ช่อง
rate_card	RateCard วัตถุประสงค์ของเรตการ์ด

RateCard

สรุปวัตถุประสงค์ของเส้นทางบัตรราคา

ช่อง
cost_per_minute	MonetaryCost ไม่บังคับ ค่าใช้จ่ายต่อนาที
cost_per_km	MonetaryCost ไม่บังคับ ต้นทุนต่อกิโลเมตร
include_tolls	bool ไม่บังคับ รวมค่าผ่านทางในค่าใช้จ่ายโดยรวมหรือไม่

MonetaryCost

สรุปค่าใช้จ่ายที่ใช้ในเรตการ์ด

ช่อง
value	double ต้องระบุ มูลค่าต้นทุนในสกุลเงินท้องถิ่นที่อนุมานจากคําขอ

RouteTravelAdvisory

สรุปข้อมูลเพิ่มเติมที่ผู้ใช้ควรทราบ เช่น การจำกัดโซนการเข้าชมที่เป็นไปได้ เป็นต้น

ช่อง
toll_info	TollInfo สรุปข้อมูลเกี่ยวกับค่าผ่านทางของเส้นทาง ฟิลด์นี้จะแสดงในกรณีที่เราคาดว่ามีค่าผ่านทางบนเส้นทางเท่านั้น หากตั้งค่าช่องนี้ไว้ แต่ไม่มีการเติมข้อมูลในช่องย่อยของค่าประมาณ [estimated_price] คาดว่าถนนจะมีค่าผ่านทางแต่ไม่ทราบราคาโดยประมาณ หากไม่ได้ตั้งค่าฟิลด์นี้ไว้ เราคาดว่าจะไม่มีการเก็บค่าผ่านทางบนเส้นทาง
speed_reading_intervals[]	SpeedReadingInterval ช่วงการอ่านความเร็วที่ให้รายละเอียดความหนาแน่นของการจราจร ใช้ได้ในกรณีของค่ากำหนดการกำหนดเส้นทาง TRAFFIC_AWARE และ TRAFFIC_AWARE_OPTIMAL ช่วงเวลาดังกล่าวจะครอบคลุมเส้นประกอบทั้งหมดของเส้นทางโดยไม่ทับซ้อนกัน จุดเริ่มต้นของช่วงเวลาที่ระบุเหมือนกับจุดสิ้นสุดของช่วงเวลาก่อนหน้า ตัวอย่าง polyline: A ---- B ---- C ---- D ---- E ---- F ---- G speed_reading_intervals: [A,C), [C,D), [D,G).

RouteTravelMode

ชุดค่าที่ใช้ระบุโหมดการเดินทาง

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

RoutingPreference

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

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

SpeedReadingInterval

ตัวบ่งชี้ความหนาแน่นของการจราจรในส่วนที่ต่อเนื่องกันของเส้นประกอบหรือเส้นทาง ตามเส้นทางที่มีจุด P_0, P_1, ... , P_N (ดัชนีแบบศูนย์) SpeedReadingInterval จะกำหนดช่วงและอธิบายการเข้าชมโดยใช้หมวดหมู่ต่อไปนี้

ช่อง
start_polyline_point_index	int32 ดัชนีเริ่มต้นของช่วงเวลานี้ในโพลีไลน์ ใน JSON เมื่อดัชนีเป็น 0 จะไม่มีการป้อนข้อมูลในช่องนี้
end_polyline_point_index	int32 ดัชนีสิ้นสุดของช่วงเวลานี้ในโพลีไลน์ ใน JSON เมื่อดัชนีเป็น 0 จะไม่มีการป้อนข้อมูลในช่องนี้
speed	Speed ความเร็วของการจราจรในช่วงเวลานี้

ความเร็ว

การจัดประเภทความเร็วโพลีไลน์โดยอิงตามข้อมูลการจราจร

Enum
SPEED_UNSPECIFIED	ค่าเริ่มต้น ไม่ได้ใช้ค่านี้
NORMAL	ความเร็วปกติ ไม่พบการชะลอตัว
SLOW	ตรวจพบการจราจรชะลอตัว แต่ไม่พบการจราจรติดขัด
TRAFFIC_JAM	ตรวจพบการจราจรติดขัด

TollInfo

สรุปข้อมูลค่าผ่านทางใน Route หรือใน RouteLeg

ช่อง
estimated_price[]	Money จำนวนเงินค่าผ่านทางสำหรับ Route หรือ RouteLeg รายการนี้ประกอบด้วยจำนวนเงินสำหรับแต่ละสกุลเงินที่คาดว่าจะถูกเรียกเก็บจากสถานีเก็บค่าผ่านทาง โดยปกติแล้ว รายการนี้จะมีเพียงรายการเดียวสำหรับเส้นทางที่มีค่าผ่านทางในสกุลเงินเดียว สำหรับการเดินทางระหว่างประเทศ รายการนี้อาจมีหลายรายการเพื่อแสดงค่าผ่านทางในสกุลเงินต่างๆ

TollPass

รายชื่อบัตรผ่านทางทั่วโลกที่เรารองรับ

Enum
TOLL_PASS_UNSPECIFIED	ไม่ใช้ หากใช้ค่านี้ คำขอจะไม่สำเร็จ
AU_ETOLL_TAG	หนึ่งในผู้ให้บริการบัตรผ่านทางของซิดนีย์หลายราย https://www.myetoll.com.au
AU_EWAY_TAG	หนึ่งในผู้ให้บริการบัตรผ่านทางของซิดนีย์หลายราย https://www.tollpay.com.au/
AU_LINKT	บัตรผ่านทางพิเศษทั่วทั้งออสเตรเลีย ดูรายละเอียดเพิ่มเติมได้ที่ https://www.linkt.com.au/
AR_TELEPASE	บัตรผ่านทางของอาร์เจนตินา ดูรายละเอียดเพิ่มเติมที่ https://telepase.com.ar
BR_AUTO_EXPRESO	บัตรผ่านทางบราซิล ดูรายละเอียดเพิ่มเติมที่ https://www.autoexpreso.com
BR_CONECTCAR	บัตรผ่านทางบราซิล ดูรายละเอียดเพิ่มเติมได้ที่ https://conectcar.com
BR_MOVE_MAIS	บัตรผ่านทางบราซิล ดูรายละเอียดเพิ่มเติมได้ที่ https://movemais.com
BR_PASSA_RAPIDO	บัตรผ่านทางบราซิล ดูรายละเอียดเพิ่มเติมที่ https://pasorapido.gob.do/
BR_SEM_PARAR	บัตรผ่านทางบราซิล ดูรายละเอียดเพิ่มเติมได้ที่ https://www.semparar.com.br
BR_TAGGY	บัตรผ่านทางบราซิล ดูรายละเอียดเพิ่มเติมได้ที่ https://taggy.com.br
BR_VELOE	บัตรผ่านทางบราซิล ดูรายละเอียดเพิ่มเติมได้ที่ https://veloe.com.br/site/onde-usar
CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD	จุดผ่านแดนระหว่างแคนาดากับสหรัฐอเมริกา
CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD	จุดผ่านแดนระหว่างแคนาดากับสหรัฐอเมริกา
CA_US_BLUE_WATER_EDGE_PASS	ด่านชายแดนรัฐออนแทรีโอ ประเทศแคนาดา ไปยังมิชิแกน สหรัฐอเมริกา
CA_US_CONNEXION	ด่านชายแดนรัฐออนแทรีโอ ประเทศแคนาดา ไปยังมิชิแกน สหรัฐอเมริกา
CA_US_NEXUS_CARD	จุดผ่านแดนระหว่างแคนาดากับสหรัฐอเมริกา
ID_E_TOLL	อินโดนีเซีย อีการ์ดจากธนาคารหลายแห่งที่ใช้ชำระค่าผ่านทาง บัตรอิเล็กทรอนิกส์ทั้งหมดผ่านธนาคารจะถูกเรียกเก็บเงินเหมือนกัน ดังนั้นจึงต้องมีค่า enum เพียงค่าเดียว เช่น Bank Mandiri https://www.bankmandiri.co.id/e-money BCA https://www.bca.co.id/flazz BNI https://www.bni.co.id/id-id/ebanking/tapcash
IN_FASTAG	India
IN_LOCAL_HP_PLATE_EXEMPT	อินเดีย ได้รับการยกเว้นสำหรับป้ายทะเบียนรัฐของ HP
MX_TAG_IAVE	ค่าผ่านทางของเม็กซิโก
MX_TAG_TELEVIA	บริษัทบัตรผ่านทางของเม็กซิโก หนึ่งในธุรกิจหลายแห่งที่ดำเนินการในเม็กซิโกซิตี ดูรายละเอียดเพิ่มเติมได้ที่ https://www.televia.com.mx
MX_VIAPASS	ค่าผ่านทางของเม็กซิโก ดูรายละเอียดเพิ่มเติมได้ที่ https://www.viapass.com.mx/viapass/web_home.aspx
US_AL_FREEDOM_PASS	รัฐแอละแบมา สหรัฐอเมริกา
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS	AK, สหรัฐอเมริกา
US_CA_FASTRAK	แคนาดา สหรัฐอเมริกา
US_CA_FASTRAK_CAV_STICKER	ระบุว่าคนขับมีบัตร FasTrak นอกเหนือจากสติกเกอร์ Clean Airรถยนต์ (CAV) ของ DMV https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
US_CO_EXPRESSTOLL	โคโลราโด สหรัฐอเมริกา
US_CO_GO_PASS	โคโลราโด สหรัฐอเมริกา
US_DE_EZPASSDE	เยอรมนี สหรัฐอเมริกา
US_FL_BOB_SIKES_TOLL_BRIDGE_PASS	ฟลอริดา สหรัฐอเมริกา
US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD	ฟลอริดา สหรัฐอเมริกา
US_FL_EPASS	ฟลอริดา สหรัฐอเมริกา
US_FL_GIBA_TOLL_PASS	ฟลอริดา สหรัฐอเมริกา
US_FL_LEEWAY	ฟลอริดา สหรัฐอเมริกา
US_FL_SUNPASS	ฟลอริดา สหรัฐอเมริกา
US_FL_SUNPASS_PRO	ฟลอริดา สหรัฐอเมริกา
US_IL_EZPASSIL	IL, สหรัฐอเมริกา
US_IL_IPASS	IL, สหรัฐอเมริกา
US_IN_EZPASSIN	อินเดีย สหรัฐอเมริกา
US_KS_BESTPASS_HORIZON	แคนซัส สหรัฐอเมริกา
US_KS_KTAG	แคนซัส สหรัฐอเมริกา
US_KS_NATIONALPASS	แคนซัส สหรัฐอเมริกา
US_KS_PREPASS_ELITEPASS	แคนซัส สหรัฐอเมริกา
US_KY_RIVERLINK	รัฐเคนทักกี สหรัฐอเมริกา
US_LA_GEAUXPASS	ลอสแอนเจลิส สหรัฐอเมริกา
US_LA_TOLL_TAG	ลอสแอนเจลิส สหรัฐอเมริกา
US_MA_EZPASSMA	MA, สหรัฐอเมริกา
US_MD_EZPASSMD	MD, สหรัฐอเมริกา
US_ME_EZPASSME	ME, สหรัฐอเมริกา
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD	MI, สหรัฐอเมริกา
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG	MI, สหรัฐอเมริกา
US_MI_IQ_PROX_CARD	MI, สหรัฐอเมริกา
US_MI_MACKINAC_BRIDGE_MAC_PASS	MI, สหรัฐอเมริกา
US_MI_NEXPRESS_TOLL	MI, สหรัฐอเมริกา
US_MN_EZPASSMN	MN, USA
US_NC_EZPASSNC	NC, สหรัฐอเมริกา
US_NC_PEACH_PASS	NC, สหรัฐอเมริกา
US_NC_QUICK_PASS	NC, สหรัฐอเมริกา
US_NH_EZPASSNH	NH, สหรัฐอเมริกา
US_NJ_DOWNBEACH_EXPRESS_PASS	นิวเจอร์ซีย์ สหรัฐอเมริกา
US_NJ_EZPASSNJ	นิวเจอร์ซีย์ สหรัฐอเมริกา
US_NY_EXPRESSPASS	นิวยอร์ก สหรัฐอเมริกา
US_NY_EZPASSNY	นิวยอร์ก สหรัฐอเมริกา
US_OH_EZPASSOH	โอไฮโอ สหรัฐอเมริกา
US_PA_EZPASSPA	PA, สหรัฐอเมริกา
US_RI_EZPASSRI	RI, USA
US_SC_PALPASS	SC, สหรัฐอเมริกา
US_TX_BANCPASS	รัฐเท็กซัส สหรัฐอเมริกา
US_TX_DEL_RIO_PASS	รัฐเท็กซัส สหรัฐอเมริกา
US_TX_EFAST_PASS	รัฐเท็กซัส สหรัฐอเมริกา
US_TX_EAGLE_PASS_EXPRESS_CARD	รัฐเท็กซัส สหรัฐอเมริกา
US_TX_EPTOLL	รัฐเท็กซัส สหรัฐอเมริกา
US_TX_EZ_CROSS	รัฐเท็กซัส สหรัฐอเมริกา
US_TX_EZTAG	รัฐเท็กซัส สหรัฐอเมริกา
US_TX_LAREDO_TRADE_TAG	รัฐเท็กซัส สหรัฐอเมริกา
US_TX_PLUSPASS	รัฐเท็กซัส สหรัฐอเมริกา
US_TX_TOLLTAG	รัฐเท็กซัส สหรัฐอเมริกา
US_TX_TXTAG	รัฐเท็กซัส สหรัฐอเมริกา
US_TX_XPRESS_CARD	รัฐเท็กซัส สหรัฐอเมริกา
US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD	UT, สหรัฐอเมริกา
US_VA_EZPASSVA	เวอร์จิเนีย สหรัฐอเมริกา
US_WA_BREEZEBY	วอชิงตัน สหรัฐอเมริกา
US_WA_GOOD_TO_GO	วอชิงตัน สหรัฐอเมริกา
US_WV_EZPASSWV	เวสต์เวอร์จิเนีย สหรัฐอเมริกา
US_WV_MEMORIAL_BRIDGE_TICKETS	เวสต์เวอร์จิเนีย สหรัฐอเมริกา
US_WV_NEWELL_TOLL_BRIDGE_TICKET	เวสต์เวอร์จิเนีย สหรัฐอเมริกา

หน่วย

ชุดค่าที่ระบุหน่วยวัดที่ใช้ในการแสดงผล

Enum
UNITS_UNSPECIFIED	ไม่ได้ระบุหน่วยวัด ค่าเริ่มต้นจะเป็นหน่วยวัดที่อนุมานจากคำขอ
METRIC	หน่วยวัดที่เป็นเมตริก
IMPERIAL	หน่วยวัดอิมพีเรียล (อังกฤษ)

VehicleEmissionType

ชุดค่าที่อธิบายประเภทการปล่อยก๊าซของยานพาหนะ ใช้กับโหมดการเดินทางของไดรฟ์เท่านั้น

Enum
VEHICLE_EMISSION_TYPE_UNSPECIFIED	ไม่ได้ระบุประเภทการปล่อยก๊าซ ค่าเริ่มต้นคือ GASOLINE
GASOLINE	รถที่ใช้น้ำมันเบนซิน/น้ำมันเบนซิน
ELECTRIC	รถยนต์ที่ใช้ไฟฟ้า
HYBRID	ยานพาหนะที่ใช้เชื้อเพลิงไฮบริด (เช่น น้ำมันเบนซิน + ไฟฟ้า)

VehicleInfo

มีการปกปิดข้อมูลรถ เช่น อักขระตัวสุดท้ายบนป้ายทะเบียน

ช่อง
emission_type	VehicleEmissionType อธิบายประเภทการปล่อยก๊าซของยานพาหนะ ใช้กับโหมดการเดินทางของไดรฟ์เท่านั้น

จุดบอกทาง

ห่อหุ้มจุดอ้างอิง จุดบนเส้นทางจะแสดงทั้งจุดเริ่มต้นและจุดสิ้นสุดของเส้นทาง และจะมีจุดแวะระหว่างทาง

ช่อง
via	bool ทำเครื่องหมายว่าชี้ทางนี้เป็นไมล์สโตนแทนที่จะเป็นจุดหยุด สำหรับการชี้ทางที่ไม่ได้ผ่านแต่ละรายการในคำขอ การตอบกลับจะเพิ่มรายการต่อท้ายอาร์เรย์ legs เพื่อระบุรายละเอียดสำหรับการหยุดพักที่การเดินทางนั้น ตั้งค่านี้เป็นจริงเมื่อคุณต้องการให้เส้นทางผ่านจุดอ้างอิงนี้โดยไม่ต้องหยุดรถ การผ่านจุดอ้างอิงจะไม่ทำให้มีการเพิ่มรายการลงในอาร์เรย์ legs แต่จะกำหนดเส้นทางเส้นทางผ่านจุดอ้างอิง คุณตั้งค่านี้ได้บนจุดอ้างอิงที่เป็นสื่อกลางเท่านั้น คำขอจะล้มเหลวหากคุณตั้งค่าช่องนี้บนจุดอ้างอิงเทอร์มินัล หากตั้งค่า ComputeRoutesRequest.optimize_waypoint_order เป็น "จริง" ช่องนี้จะตั้งค่าให้เป็น "จริง" ไม่ได้ มิเช่นนั้น คำขอจะไม่สำเร็จ
vehicle_stopover	bool บ่งบอกว่าการชี้ทางนั้นมีไว้สำหรับพาหนะที่จะจอด โดยตั้งใจที่จะไปรับหรือไปส่ง เมื่อคุณตั้งค่านี้ เส้นทางที่คำนวณแล้วจะไม่รวมจุดอ้างอิงที่ไม่ใช่ via บนถนนที่ไม่เหมาะแก่การไปรับและส่งซ่อม ตัวเลือกนี้ใช้ได้เฉพาะกับโหมดการเดินทาง DRIVE และ TWO_WHEELER และเมื่อ location_type คือ location
side_of_road	bool ระบุว่าตำแหน่งของจุดอ้างอิงนี้ต้องการให้รถหยุดที่ฝั่งใดฝั่งหนึ่งของถนน เมื่อคุณกำหนดค่านี้ เส้นทางจะผ่านตำแหน่งนั้นเพื่อให้รถสามารถหยุดที่ด้านข้างถนนซึ่งตำแหน่งนั้นจะเริ่มจากจุดศูนย์กลางของถนน ตัวเลือกนี้ใช้ได้เฉพาะกับโหมดการเดินทาง "ไดรฟ์" และ "TWO_WHEELER" และเมื่อตั้งค่า "location_type" เป็น "location"
ฟิลด์การรวม location_type วิธีต่างๆ ในการแสดงสถานที่ location_type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
location	Location จุดที่ระบุโดยใช้พิกัดทางภูมิศาสตร์ รวมถึงส่วนหัวที่ไม่บังคับ
place_id	string รหัสสถานที่ในจุดที่น่าสนใจที่เชื่อมโยงกับจุดอ้างอิง