Package google.maps.routes.v1

ดัชนี

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

ไม่บังคับ ระบุรูปแบบการเดินทาง รองรับเฉพาะ DRIVE และ "TWO_WHEELER"

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" ดูข้อมูลเพิ่มเติมได้ที่ตัวระบุภาษาของ Unicode ดูรายการภาษาที่รองรับได้ที่การรองรับภาษา หากไม่ได้ระบุค่านี้ ระบบจะอนุมานภาษาที่แสดงจากตำแหน่งของคำขอเส้นทาง

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 เป็นจริง และ 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" ดูข้อมูลเพิ่มเติมได้ที่ตัวระบุภาษาของ Unicode ดูรายการภาษาที่รองรับได้ที่การรองรับภาษา หากไม่ได้ระบุค่านี้ ระบบจะอนุมานภาษาที่แสดงจากตำแหน่งของคำขอเส้นทาง

units

Units

ไม่บังคับ ระบุหน่วยวัดสำหรับฟิลด์ที่แสดง ซึ่งรวมถึงฟิลด์ instruction ใน NavigationInstruction หน่วยวัดที่ใช้สำหรับเส้นทาง ขาการเดินทาง ระยะทางของขั้นตอน และระยะเวลาจะไม่ได้รับผลกระทบจากค่านี้ หากคุณไม่ระบุค่านี้ ระบบจะอนุมานหน่วยแสดงผลจากตำแหน่งของคำขอ

optimize_waypoint_order

bool

หากตั้งค่า optimizeWaypointOrder เป็น true ระบบจะพยายามจัดลำดับจุดแวะพักกลางที่ระบุใหม่เพื่อลดต้นทุนโดยรวมของเส้นทาง หากจุดแวะพักใดก็ตามเป็นจุดแวะพักผ่าน คำขอจะไม่สำเร็จ ใช้ ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index เพื่อค้นหาการจัดเรียงใหม่ หากไม่ได้ขอ routes.optimized_intermediate_waypoint_index ในส่วนหัว X-Goog-FieldMask คำขอจะไม่สำเร็จ หากตั้งค่า optimize_waypoint_order เป็น "เท็จ" ComputeRoutesResponse.optimized_intermediate_waypoint_index จะว่างเปล่า

ComputeRoutesResponse

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

ช่อง
routes[]

Route

มีอาร์เรย์ของเส้นทางที่คำนวณแล้ว (สูงสุด 3 เส้นทาง) เมื่อคุณระบุ compute_alternatives_routes และมีเพียง 1 เส้นทางเมื่อคุณไม่ได้ระบุ เมื่ออาร์เรย์นี้มีหลายรายการ รายการแรกคือเส้นทางที่แนะนำมากที่สุด หากอาร์เรย์ว่างเปล่า แสดงว่าไม่พบเส้นทาง

fallback_info

FallbackInfo

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

CustomRoute

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

ช่อง
route

Route

เส้นทางที่ถือว่า "ดีที่สุด" สำหรับวัตถุประสงค์ของเส้นทางที่ป้อน

token

string

โทเค็นเส้นทางที่เข้ารหัส base64 ที่ปลอดภัยบนเว็บซึ่งส่งไปยัง NavSDK ได้ ซึ่งจะช่วยให้ NavSDK สร้างเส้นทางใหม่ได้ในระหว่างการนำทาง และในกรณีที่มีการเปลี่ยนเส้นทาง ให้เป็นไปตามความตั้งใจเดิมเมื่อมีการเรียกใช้ RoutesPreferred ComputeCustomRoutes ลูกค้าควรปฏิบัติต่อโทเค็นนี้เป็นออบเจ็กต์ทึบแสง

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

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

Maneuver

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

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 เลี้ยวขวาที่วงเวียน
DEPART การเลี้ยวครั้งแรก
NAME_CHANGE ใช้เพื่อระบุการเปลี่ยนชื่อถนน
DESTINATION ใช้เพื่อระบุการมาถึงจุดหมาย
ช่อง
maneuver

Maneuver

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

instructions

string

วิธีการไปยังส่วนนี้

เส้นประกอบ

ห่อหุ้มเส้นประกอบที่เข้ารหัส

ช่อง
ฟิลด์ Union polyline_type แคปซูลประเภทของเส้นประกอบ ค่าเริ่มต้นคือ encoded_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 จุด ตัวอย่างเช่น เส้นทางที่ไม่มีจุดแวะพักระหว่างทางจะมีเพียง 1 ขา เส้นทางที่มีจุดแวะพักที่ไม่ใช่viaจุดแวะพักกลาง 1 จุดจะมี 2 ขา เส้นทางที่มีจุดแวะพักกลาง via 1 จุดจะมี 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 เป็น "จริง" ช่องนี้จะมีลำดับจุดแวะพักกลางที่เพิ่มประสิทธิภาพ มิเช่นนั้นช่องนี้จะว่าง ตัวอย่างเช่น สมมติว่าต้นทางคือ ลอสแอนเจลิส จุดแวะพักคือ ดัลลัส แบงกอร์ ฟีนิกซ์ ปลายทางคือ นิวยอร์ก และลำดับจุดแวะพักที่ปรับให้เหมาะสมคือ ฟีนิกซ์ ดัลลัส แบงกอร์ จากนั้นช่องนี้จะมีค่า [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

หมายเหตุ: ขณะนี้ช่องนี้ไม่มีข้อมูล

RouteLegTravelAdvisory

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

ช่อง
toll_info

TollInfo

แคปซูลข้อมูลเกี่ยวกับค่าผ่านทางบน RouteLeg ที่เฉพาะเจาะจง ฟิลด์นี้จะสร้างขึ้นก็ต่อเมื่อเราคาดว่าจะมีค่าผ่านทางใน RouteLeg หากตั้งค่าฟิลด์นี้ แต่ไม่ได้กรอกข้อมูลในฟิลด์ย่อย estimated_price เราคาดว่าถนนมีค่าผ่านทาง แต่ไม่ทราบราคาโดยประมาณ หากไม่มีฟิลด์นี้ แสดงว่าไม่มีค่าผ่านทางบน RouteLeg

speed_reading_intervals[]

SpeedReadingInterval

ช่วงเวลาในการอ่านอย่างรวดเร็วที่แสดงรายละเอียดความหนาแน่นของการจราจร ใช้ได้ในกรณีของค่ากำหนดการกำหนดเส้นทาง TRAFFIC_AWARE และ TRAFFIC_AWARE_OPTIMAL ช่วงเวลาจะครอบคลุมเส้นหลายเส้นทั้งหมดของ RouteLeg โดยไม่ทับซ้อนกัน จุดเริ่มต้นของช่วงเวลาที่ระบุจะเหมือนกับจุดสิ้นสุดของช่วงเวลาก่อนหน้า

ตัวอย่าง

polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speed_reading_intervals: [A,C), [C,D), [D,G).

RouteMatrixDestination

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

ช่อง
waypoint

Waypoint

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

RouteMatrixElement

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

ช่อง
origin_index

int32

ดัชนีที่อิงตาม 0 ของต้นทางในคำขอ

destination_index

int32

ดัชนีที่อิงตาม 0 ของปลายทางในคำขอ

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

ช่อง
ฟิลด์ Union objective วัตถุประสงค์ของเส้นทาง objective ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
rate_card

RateCard

วัตถุประสงค์ของ RateCard

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 เป็นฟีเจอร์ทดลอง หากลูกค้าขอเส้นทางแท็กซี่ในเมืองที่ไม่มีข้อมูลเลนแท็กซี่ ระบบจะแสดงเส้นทางขับรถ

RoutingPreference

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

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

SpeedReadingInterval

เครื่องหมายแสดงความหนาแน่นของการจราจรในส่วนที่ต่อเนื่องของเส้นประกอบหรือเส้นทาง เมื่อกำหนดเส้นทางที่มีจุด P_0, P_1, ... , P_N (ดัชนีที่อิงตาม 0) 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 ที่เกี่ยวข้อง รายการนี้มีจำนวนเงินสำหรับแต่ละสกุลเงินที่คาดว่าสถานีเก็บค่าผ่านทางจะเรียกเก็บ โดยปกติแล้ว รายการนี้จะมีเพียง 1 รายการสำหรับเส้นทางที่มีค่าผ่านทางในสกุลเงินเดียว สำหรับการเดินทางระหว่างประเทศ รายการนี้อาจมีหลายรายการเพื่อแสดงค่าผ่านทางในสกุลเงินต่างๆ

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 อินเดีย การยกเว้นป้ายทะเบียนของรัฐหิมาจัลประเทศ
JP_ETC ETC ของญี่ปุ่น ระบบไร้สายอิเล็กทรอนิกส์สำหรับเก็บค่าผ่านทาง https://www.go-etc.jp/
JP_ETC2 ETC2.0 ของญี่ปุ่น ETC เวอร์ชันใหม่พร้อมส่วนลดเพิ่มเติมและการสื่อสารแบบ 2 ทางระหว่างอุปกรณ์ในรถยนต์และเสาอากาศบนท้องถนน https://www.go-etc.jp/etc2/index.html
MX_IAVE เม็กซิโก https://iave.capufe.gob.mx/#/
MX_PASE เม็กซิโก https://www.pase.com.mx
MX_QUICKPASS เม็กซิโก https://operadoravial.com/quick-pass/
MX_SISTEMA_TELEPEAJE_CHIHUAHUA เม็กซิโก http://appsh.chihuahua.gob.mx/transparencia/?doc=/ingresos/TelepeajeFormato4.pdf
MX_TAG_IAVE เม็กซิโก
MX_TAG_TELEVIA บริษัทบัตรผ่านทางของเม็กซิโก หนึ่งในหลายๆ แห่งที่ดำเนินการในเม็กซิโกซิตี ดูรายละเอียดเพิ่มเติมได้ที่ https://www.televia.com.mx
MX_TELEVIA บริษัทบัตรผ่านทางของเม็กซิโก หนึ่งในหลายๆ แห่งที่ดำเนินการในเม็กซิโกซิตี้ https://www.televia.com.mx
MX_VIAPASS บัตรผ่านทางของเม็กซิโก ดูรายละเอียดเพิ่มเติมได้ที่ https://www.viapass.com.mx/viapass/web_home.aspx
US_AL_FREEDOM_PASS AL, USA.
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS AK, USA.
US_CA_FASTRAK แคนาดา สหรัฐอเมริกา
US_CA_FASTRAK_CAV_STICKER ระบุว่าผู้ขับมีบัตร FasTrak นอกเหนือจากสติกเกอร์ Clean Air Vehicle (CAV) ที่ DMV ออกให้ https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
US_CO_EXPRESSTOLL CO, USA.
US_CO_GO_PASS CO, USA.
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 อิลลินอยส์ สหรัฐอเมริกา
US_IL_IPASS อิลลินอยส์ สหรัฐอเมริกา
US_IN_EZPASSIN อินเดีย สหรัฐอเมริกา
US_KS_BESTPASS_HORIZON KS, USA.
US_KS_KTAG KS, USA.
US_KS_NATIONALPASS KS, USA.
US_KS_PREPASS_ELITEPASS KS, USA.
US_LA_GEAUXPASS ลอสแอนเจลิส สหรัฐอเมริกา
US_LA_TOLL_TAG ลอสแอนเจลิส สหรัฐอเมริกา
US_MA_EZPASSMA MA, USA.
US_MD_EZPASSMD MD, USA.
US_ME_EZPASSME ME, USA.
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD MI, USA
US_MI_BCPASS MI, USA
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG MI, USA
US_MI_IQ_PROX_CARD

MI, USA เลิกใช้งานเนื่องจากไม่มีบัตรประเภทนี้อีกต่อไป

US_MI_IQ_TAG MI, USA
US_MI_MACKINAC_BRIDGE_MAC_PASS MI, USA
US_MI_NEXPRESS_TOLL MI, USA
US_MN_EZPASSMN MN, USA.
US_NC_EZPASSNC นอร์ทแคโรไลนา สหรัฐอเมริกา
US_NC_PEACH_PASS นอร์ทแคโรไลนา สหรัฐอเมริกา
US_NC_QUICK_PASS นอร์ทแคโรไลนา สหรัฐอเมริกา
US_NH_EZPASSNH NH, USA.
US_NJ_DOWNBEACH_EXPRESS_PASS NJ, USA.
US_NJ_EZPASSNJ นิวเจอร์ซีย์ สหรัฐอเมริกา
US_NY_EXPRESSPASS นิวยอร์ก สหรัฐอเมริกา
US_NY_EZPASSNY นิวยอร์ก สหรัฐอเมริกา
US_OH_EZPASSOH โอไฮโอ สหรัฐอเมริกา
US_PA_EZPASSPA PA, USA.
US_RI_EZPASSRI RI, USA.
US_SC_PALPASS SC, USA.
US_TX_AVI_TAG TX, USA.
US_TX_BANCPASS TX, USA.
US_TX_DEL_RIO_PASS TX, USA.
US_TX_EFAST_PASS TX, USA.
US_TX_EAGLE_PASS_EXPRESS_CARD TX, USA.
US_TX_EPTOLL TX, USA.
US_TX_EZ_CROSS TX, USA.
US_TX_EZTAG TX, USA.
US_TX_FUEGO_TAG TX, USA.
US_TX_LAREDO_TRADE_TAG TX, USA.
US_TX_PLUSPASS TX, USA.
US_TX_TOLLTAG TX, USA.
US_TX_TXTAG TX, USA.
US_TX_XPRESS_CARD TX, USA.
US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD UT, USA.
US_VA_EZPASSVA VA, USA.
US_WA_BREEZEBY วอชิงตัน สหรัฐอเมริกา
US_WA_GOOD_TO_GO วอชิงตัน สหรัฐอเมริกา
US_WV_EZPASSWV WV, USA.
US_WV_MEMORIAL_BRIDGE_TICKETS WV, USA.
US_WV_MOV_PASS WV, USA
US_WV_NEWELL_TOLL_BRIDGE_TICKET WV, USA.

หน่วย

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

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

VehicleEmissionType

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

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

VehicleInfo

แคปซูลข้อมูลยานพาหนะ เช่น ประเภทการปล่อยมลพิษของยานพาหนะ

ช่อง
emission_type

VehicleEmissionType

อธิบายประเภทการปล่อยก๊าซของยานพาหนะ ใช้กับ DRIVE RouteTravelMode เท่านั้น

จุดบอกทาง

ห่อหุ้มจุดอ้างอิง จุดอ้างอิงจะทำเครื่องหมายทั้งจุดเริ่มต้นและจุดสิ้นสุดของเส้นทาง รวมถึงจุดแวะพักระหว่างเส้นทาง

ช่อง
via

bool

ทำเครื่องหมายจุดอ้างอิงนี้เป็นเหตุการณ์สำคัญแทนที่จะเป็นจุดแวะพัก สำหรับจุดอ้างอิงที่ไม่ใช่จุดแวะพักผ่านในคำขอ การตอบกลับจะต่อท้ายรายการในอาร์เรย์ legs เพื่อให้รายละเอียดสำหรับการแวะพักในขาของการเดินทางนั้น ตั้งค่านี้เป็น "จริง" เมื่อต้องการให้เส้นทางผ่านจุดอ้างอิงนี้โดยไม่ต้องหยุด จุดอ้างอิงระหว่างทางจะไม่ทำให้มีการเพิ่มรายการลงในอาร์เรย์ legs แต่จะกำหนดเส้นทางของการเดินทางผ่านจุดอ้างอิง คุณตั้งค่านี้ได้เฉพาะในจุดอ้างอิงที่เป็นจุดกลางเท่านั้น คำขอจะล้มเหลวหากคุณตั้งค่าฟิลด์นี้ในจุดแวะพักสุดท้าย หากตั้งค่า ComputeRoutesRequest.optimize_waypoint_order เป็น "จริง" จะตั้งค่าช่องนี้เป็น "จริง" ไม่ได้ มิเช่นนั้นคำขอจะล้มเหลว

vehicle_stopover

bool

ระบุว่าจุดอ้างอิงมีไว้เพื่อให้ยานพาหนะหยุดรับหรือส่งผู้โดยสาร เมื่อตั้งค่านี้ เส้นทางที่คำนวณแล้วจะไม่รวมจุดอ้างอิงที่ไม่ใช่ via บนถนนที่ไม่เหมาะกับการรับและส่งผู้โดยสาร ตัวเลือกนี้ใช้ได้เฉพาะกับโหมดการเดินทาง DRIVE และ TWO_WHEELER และเมื่อ location_type เป็น location

side_of_road

bool

ระบุว่าจุดอ้างอิงนี้มีไว้เพื่อกำหนดให้ยานพาหนะหยุดที่ด้านใดด้านหนึ่งของถนน เมื่อตั้งค่านี้ เส้นทางจะผ่านสถานที่เพื่อให้ยานพาหนะจอดที่ข้างถนนซึ่งสถานที่นั้นอยู่ใกล้จากกึ่งกลางของถนน ตัวเลือกนี้ใช้ได้กับโหมดการเดินทาง "DRIVE" และ "TWO_WHEELER" เท่านั้น

ฟิลด์ Union location_type วิธีต่างๆ ในการแสดงตำแหน่ง location_type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
location

Location

จุดที่ระบุโดยใช้พิกัดทางภูมิศาสตร์ รวมถึงส่วนหัวที่ไม่บังคับ

place_id

string

รหัสสถานที่ของจุดที่น่าสนใจที่เชื่อมโยงกับจุดอ้างอิง