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

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

  • จำนวนองค์ประกอบ (ต้นทาง × ปลายทาง) ต้องไม่เกิน 625 รายการไม่ว่าในกรณีใดก็ตาม
  • จำนวนองค์ประกอบ (ต้นทาง × ปลายทาง) ต้องไม่เกิน 100 หากตั้งค่าการกำหนดเส้นทาง_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 Locale Identifier ดูรายการภาษาที่รองรับได้ที่การรองรับภาษา หากคุณไม่ได้ระบุค่านี้ ระบบจะอนุมานภาษาที่แสดงจากสถานที่ตั้งของคำขอเส้นทาง

units

Units

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

optimize_waypoint_order

bool

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

ComputeRoutesResponse

ComputeRoute จะส่งข้อความตอบกลับ

ช่อง
routes[]

Route

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

fallback_info

FallbackInfo

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

CustomRoute

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

ช่อง
route

Route

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

token

string

โทเค็นเส้นทางที่เข้ารหัส Base64 ที่ปลอดภัยบนเว็บซึ่งสามารถส่งไปยัง 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 เลี้ยวขวาที่วงเวียน
DEPART การขับขี่เริ่มต้น
NAME_CHANGE ใช้เพื่อระบุการเปลี่ยนชื่อถนน
ช่อง
maneuver

Maneuver

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

instructions

string

คำแนะนำในการไปยังขั้นตอนนี้

เส้นประกอบ

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

ช่อง
ฟิลด์สหภาพ polyline_type บรรจุประเภทของเส้นประกอบ ค่าเริ่มต้นคือ encoded_polyline polyline_type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
encoded_polyline

string

การเข้ารหัสสตริงของเส้นประกอบโดยใช้อัลกอริทึมการเข้ารหัสโพลีไลน์

geo_json_linestring

Struct

ระบุเส้นประกอบโดยใช้รูปแบบ LineString ของ GeoJSON

PolylineEncoding

ระบุประเภทเส้นประกอบที่ต้องการที่จะแสดง

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

PolylineQuality

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

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

เส้นทาง

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

ช่อง
legs[]

RouteLeg

คอลเล็กชันของขา (ส่วนของเส้นทางระหว่างจุดอ้างอิง) ที่ประกอบกันเป็นเส้นทาง แต่ละเส้นจะสอดคล้องกับการเดินทางระหว่างจุดบนเส้นทางที่ไม่ใช่ via จำนวน 2 จุด เช่น เส้นทางที่ไม่มีจุดแวะพักระหว่างทางจะมีเพียงช่วงเดียว เส้นทางที่มีจุดแวะพักกลางซึ่งไม่ใช่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 เป็น "จริง" ช่องนี้จะมีลำดับการเพิ่มประสิทธิภาพของจุดอ้างอิงระดับกลาง หากไม่ใช่ ช่องนี้จะว่างเปล่า ตัวอย่างเช่น สมมติว่าอินพุตคือต้นทาง: LA; ตัวกลาง: ดัลลัส บังกอร์ ฟีนิกซ์ ปลายทาง: นิวยอร์ก และลำดับจุดอ้างอิงกลางที่เพิ่มประสิทธิภาพคือ Phoenix, Dallas, Bangor ช่องนี้จึงมีค่า [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

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

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

ช่อง
ช่องการรวม 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 ยานพาหนะสองล้อที่ใช้เครื่องยนต์ เช่น จักรยานยนต์ โปรดทราบว่าข้อมูลนี้แตกต่างจากรูปแบบการเดินทาง BICYCLE ซึ่งครอบคลุมรูปแบบการเดินทางด้วยคน
TAXI

เดินทางด้วยแท็กซี่ที่ได้รับอนุญาต ซึ่งอาจอนุญาตให้ยานพาหนะวิ่งบนเลนแท็กซี่ที่กำหนดในบางพื้นที่

โหมด TAXI เป็นฟีเจอร์ทดลอง หากลูกค้าขอเส้นทางแท็กซี่ในเมืองที่ไม่มีข้อมูลเลนแท็กซี่ ระบบจะแสดงเส้นทางขับรถ

RoutingPreference

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

Enum
ROUTING_PREFERENCE_UNSPECIFIED ไม่ได้ระบุค่ากำหนดการกำหนดเส้นทาง ค่าเริ่มต้นคือ TRAFFIC_AWARE
TRAFFIC_UNAWARE ประมวลผลเส้นทางโดยไม่นำสภาพการจราจรแบบเรียลไทม์มาพิจารณา เหมาะสำหรับเมื่อสภาพการจราจรไม่สำคัญหรือไม่เกี่ยวข้อง การใช้ค่านี้จะทำให้เกิดเวลาในการตอบสนองต่ำสุด หมายเหตุ: สำหรับ "ไดรฟ์ของ RouteTravelMode" และ "TWO_WHEELER" เส้นทางและระยะเวลาที่เลือกจะขึ้นอยู่กับเครือข่ายถนนและสภาพการจราจรที่ไม่ขึ้นอยู่กับเวลาโดยเฉลี่ย ไม่ใช่สภาพการจราจรในปัจจุบัน ด้วยเหตุนี้ เส้นทางจึงอาจรวมถึงถนนที่ปิดชั่วคราว ผลลัพธ์ของคำขอหนึ่งๆ อาจแตกต่างกันไปเมื่อเวลาผ่านไปเนื่องจากการเปลี่ยนแปลงของเครือข่ายถนน สภาพการจราจรเฉลี่ยที่อัปเดต และลักษณะการกระจายของบริการ ผลลัพธ์อาจแตกต่างกันไประหว่างเส้นทางที่เกือบเท่ากันทุกเมื่อหรือทุกความถี่
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 ของอินเดีย
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, สหรัฐอเมริกา
US_CA_FASTRAK แคนาดา สหรัฐอเมริกา
US_CA_FASTRAK_CAV_STICKER บ่งบอกว่าคนขับมีบัตร FasTrak นอกเหนือจากสติกเกอร์ยานพาหนะอากาศสะอาด (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 KS, สหรัฐอเมริกา
US_KS_KTAG KS, สหรัฐอเมริกา
US_KS_NATIONALPASS KS, สหรัฐอเมริกา
US_KS_PREPASS_ELITEPASS แคนซัส สหรัฐอเมริกา
US_LA_GEAUXPASS ลอสแอนเจลิส สหรัฐอเมริกา
US_LA_TOLL_TAG ลอสแอนเจลิส สหรัฐอเมริกา
US_MA_EZPASSMA แมสซาชูเซตส์ สหรัฐอเมริกา
US_MD_EZPASSMD MD, สหรัฐอเมริกา
US_ME_EZPASSME ME, สหรัฐอเมริกา
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD MI, สหรัฐอเมริกา
US_MI_BCPASS MI, สหรัฐอเมริกา
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG MI, สหรัฐอเมริกา
US_MI_IQ_PROX_CARD

มิชิแกน สหรัฐอเมริกา เลิกใช้งานเนื่องจากไม่มีบัตรประเภทนี้แล้ว

US_MI_IQ_TAG MI, สหรัฐอเมริกา
US_MI_MACKINAC_BRIDGE_MAC_PASS MI, สหรัฐอเมริกา
US_MI_NEXPRESS_TOLL มิชิแกน สหรัฐอเมริกา
US_MN_EZPASSMN มินนิโซตา สหรัฐอเมริกา
US_NC_EZPASSNC นอร์ทแคโรไลนา สหรัฐอเมริกา
US_NC_PEACH_PASS นอร์ทแคโรไลนา สหรัฐอเมริกา
US_NC_QUICK_PASS นอร์ทแคโรไลนา สหรัฐอเมริกา
US_NH_EZPASSNH NH, สหรัฐอเมริกา
US_NJ_DOWNBEACH_EXPRESS_PASS นิวเจอร์ซีย์ สหรัฐอเมริกา
US_NJ_EZPASSNJ นิวเจอร์ซีย์ สหรัฐอเมริกา
US_NY_EXPRESSPASS นิวยอร์ก สหรัฐอเมริกา
US_NY_EZPASSNY นิวยอร์ก สหรัฐอเมริกา
US_OH_EZPASSOH โอไฮโอ สหรัฐอเมริกา
US_PA_EZPASSPA เพนซิลเวเนีย สหรัฐอเมริกา
US_RI_EZPASSRI รัฐโรดไอแลนด์ สหรัฐอเมริกา
US_SC_PALPASS SC, USA
US_TX_AVI_TAG เท็กซัส, สหรัฐอเมริกา
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_FUEGO_TAG เท็กซัส, สหรัฐอเมริกา
US_TX_LAREDO_TRADE_TAG เท็กซัส, สหรัฐอเมริกา
US_TX_PLUSPASS เท็กซัส, สหรัฐอเมริกา
US_TX_TOLLTAG เท็กซัส, สหรัฐอเมริกา
US_TX_TXTAG เท็กซัส, สหรัฐอเมริกา
US_TX_XPRESS_CARD เท็กซัส สหรัฐอเมริกา
US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD ยูทาห์ สหรัฐอเมริกา
US_VA_EZPASSVA VA, สหรัฐอเมริกา
US_WA_BREEZEBY วอชิงตัน สหรัฐอเมริกา
US_WA_GOOD_TO_GO วอชิงตัน สหรัฐอเมริกา
US_WV_EZPASSWV WV, USA.
US_WV_MEMORIAL_BRIDGE_TICKETS WV, สหรัฐอเมริกา
US_WV_MOV_PASS WV, สหรัฐอเมริกา
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

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

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

Location

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

place_id

string

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