Package google.maps.routing.v2

ดัชนี

เส้นทาง

Routes API

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 ไม่แนะนำให้ใช้มาสก์ฟิลด์การตอบกลับที่เป็นไวลด์การ์ด (*) เนื่องจากเหตุผลต่อไปนี้

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

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

ComputeRouteMatrixRequest

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

ช่อง
origins[]

RouteMatrixOrigin

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

  • ผลรวมของจำนวนต้นทาง + จำนวนปลายทางที่ระบุเป็น place_id หรือ address ต้องไม่เกิน 50
  • ผลคูณของจำนวนต้นทาง × จำนวนปลายทางต้องไม่เกิน 625 ในทุกกรณี
  • ผลคูณของจำนวนต้นทาง × จำนวนปลายทางต้องไม่เกิน 100 หากตั้งค่า routing_preference เป็น TRAFFIC_AWARE_OPTIMAL
  • ผลคูณของจำนวนต้นทาง × จำนวนปลายทางต้องไม่เกิน 100 หากตั้งค่า travel_mode เป็น TRANSIT
destinations[]

RouteMatrixDestination

ต้องระบุ อาร์เรย์ของปลายทาง ซึ่งกำหนดคอลัมน์ของเมทริกซ์การตอบกลับ
travel_mode

RouteTravelMode

ไม่บังคับ ระบุรูปแบบการเดินทาง
routing_preference

RoutingPreference

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

Timestamp

ไม่บังคับ เวลาออกเดินทาง หากไม่ได้ตั้งค่านี้ ค่าเริ่มต้นจะเป็นเวลาที่คุณส่งคำขอ หมายเหตุ: คุณระบุ departure_time ในอดีตได้เมื่อตั้งค่า RouteTravelMode เป็น TRANSIT เท่านั้น
arrival_time

Timestamp

ไม่บังคับ เวลาถึง หมายเหตุ: ตั้งค่าได้เมื่อตั้งค่า RouteTravelMode เป็น TRANSIT เท่านั้น คุณระบุ departure_time หรือ arrival_time ได้อย่างใดอย่างหนึ่ง แต่จะระบุทั้ง 2 อย่างไม่ได้
language_code

string

ไม่บังคับ รหัสภาษา BCP-47 เช่น "en-US" หรือ "sr-Latn" ดูข้อมูลเพิ่มเติมได้ที่ตัวระบุภาษาของ Unicode ดูรายการภาษาที่รองรับได้ที่การรองรับภาษา เมื่อคุณไม่ได้ระบุค่านี้ ระบบจะอนุมานภาษาที่แสดงจากตำแหน่งของต้นทางแรก
region_code

string

ไม่บังคับ รหัสภูมิภาคที่ระบุเป็นค่า ccTLD ("โดเมนระดับบนสุด") 2 อักขระ ดูข้อมูลเพิ่มเติมได้ที่โดเมนระดับบนสุดแบบรหัสประเทศ
units

Units

ไม่บังคับ ระบุหน่วยวัดสำหรับฟิลด์ที่แสดง
extra_computations[]

ExtraComputation

ไม่บังคับ รายการการคำนวณเพิ่มเติมที่อาจใช้เพื่อดำเนินการตามคำขอ หมายเหตุ: การคำนวณเพิ่มเติมเหล่านี้อาจแสดงช่องเพิ่มเติมในการตอบกลับ นอกจากนี้ คุณต้องระบุช่องพิเศษเหล่านี้ในฟิลด์มาสก์ด้วยเพื่อให้แสดงผลในคำตอบ
traffic_model

TrafficModel

ไม่บังคับ ระบุสมมติฐานที่จะใช้เมื่อคำนวณเวลาในการเข้าชม การตั้งค่านี้จะส่งผลต่อค่าที่แสดงในช่องระยะเวลาใน RouteMatrixElement ซึ่งมีเวลาที่คาดการณ์ในการเข้าชมตามค่าเฉลี่ยที่ผ่านมา TrafficModel ใช้ได้กับคำขอที่ตั้งค่า RoutingPreference เป็น TRAFFIC_AWARE_OPTIMAL และ RouteTravelMode เป็น DRIVE เท่านั้น ค่าเริ่มต้นจะเป็น BEST_GUESS หากมีการขอการเข้าชมและไม่ได้ระบุ TrafficModel
transit_preferences

TransitPreferences

ไม่บังคับ ระบุค่ากำหนดที่มีผลต่อเส้นทางที่แสดงสำหรับTRANSITเส้นทาง หมายเหตุ: คุณระบุ transit_preferences ได้ก็ต่อเมื่อตั้งค่า RouteTravelMode เป็น TRANSIT

ExtraComputation

การคำนวณเพิ่มเติมที่จะดำเนินการขณะประมวลผลคำขอ

Enum
EXTRA_COMPUTATION_UNSPECIFIED ไม่ได้ใช้ คำขอที่มีค่านี้จะล้มเหลว
TOLLS ข้อมูลค่าผ่านทางสำหรับองค์ประกอบเมทริกซ์

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

ไม่บังคับ เวลาออกเดินทาง หากไม่ได้ตั้งค่านี้ ค่าเริ่มต้นจะเป็นเวลาที่คุณส่งคำขอ หมายเหตุ: คุณระบุ departure_time ในอดีตได้เมื่อตั้งค่า RouteTravelMode เป็น TRANSIT เท่านั้น การเดินทางด้วยระบบขนส่งสาธารณะจะพร้อมใช้งานย้อนหลังได้สูงสุด 7 วันหรือในอนาคตได้สูงสุด 100 วัน
arrival_time

Timestamp

ไม่บังคับ เวลาถึง หมายเหตุ: ระบบจะละเว้นฟิลด์นี้เมื่อคำขอระบุ RouteTravelMode อื่นที่ไม่ใช่ TRANSIT คุณระบุ departure_time หรือ arrival_time ได้อย่างใดอย่างหนึ่ง แต่จะระบุทั้ง 2 อย่างไม่ได้ การเดินทางด้วยระบบขนส่งสาธารณะจะพร้อมใช้งานย้อนหลังได้สูงสุด 7 วันหรือในอนาคตได้สูงสุด 100 วัน
compute_alternative_routes

bool

ไม่บังคับ ระบุว่าจะคำนวณเส้นทางอื่นนอกเหนือจากเส้นทางหรือไม่ ระบบจะไม่แสดงเส้นทางอื่นสำหรับคำขอที่มีจุดแวะพักกลาง
route_modifiers

RouteModifiers

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

string

ไม่บังคับ รหัสภาษา BCP-47 เช่น "en-US" หรือ "sr-Latn" ดูข้อมูลเพิ่มเติมได้ที่ตัวระบุภาษาของ Unicode ดูรายการภาษาที่รองรับได้ที่การรองรับภาษา หากไม่ได้ระบุค่านี้ ระบบจะอนุมานภาษาที่แสดงจากตำแหน่งของคำขอเส้นทาง
region_code

string

ไม่บังคับ รหัสภูมิภาคที่ระบุเป็นค่า ccTLD ("โดเมนระดับบนสุด") 2 อักขระ ดูข้อมูลเพิ่มเติมได้ที่โดเมนระดับบนสุดแบบรหัสประเทศ
units

Units

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

bool

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

ReferenceRoute

ไม่บังคับ ระบุเส้นทางอ้างอิงที่จะคำนวณเป็นส่วนหนึ่งของคำขอนอกเหนือจากเส้นทางเริ่มต้น เส้นทางอ้างอิงคือเส้นทางที่มีวัตถุประสงค์ในการคำนวณเส้นทางแตกต่างจากเส้นทางเริ่มต้น เช่น FUEL_EFFICIENTการคำนวณเส้นทางอ้างอิงจะพิจารณาพารามิเตอร์ต่างๆ ที่จะสร้างเส้นทางที่ประหยัดน้ำมันได้ดีที่สุด เมื่อใช้ฟีเจอร์นี้ ให้มองหา route_labels ในเส้นทางที่ได้
extra_computations[]

ExtraComputation

ไม่บังคับ รายการการคำนวณเพิ่มเติมที่อาจใช้เพื่อดำเนินการตามคำขอ หมายเหตุ: การคำนวณเพิ่มเติมเหล่านี้อาจแสดงช่องเพิ่มเติมในการตอบกลับ นอกจากนี้ คุณต้องระบุช่องพิเศษเหล่านี้ในฟิลด์มาสก์ด้วยเพื่อให้แสดงผลในคำตอบ
traffic_model

TrafficModel

ไม่บังคับ ระบุสมมติฐานที่จะใช้เมื่อคำนวณเวลาในการเข้าชม การตั้งค่านี้จะส่งผลต่อค่าที่แสดงในช่องระยะเวลาใน Route และ RouteLeg ซึ่งมีเวลาที่คาดการณ์ในการเข้าชมตามค่าเฉลี่ยที่ผ่านมา TrafficModel ใช้ได้กับคำขอที่ตั้งค่า RoutingPreference เป็น TRAFFIC_AWARE_OPTIMAL และ RouteTravelMode เป็น DRIVE เท่านั้น ค่าเริ่มต้นจะเป็น BEST_GUESS หากมีการขอการเข้าชมและไม่ได้ระบุ TrafficModel
transit_preferences

TransitPreferences

ไม่บังคับ ระบุค่ากำหนดที่มีผลต่อเส้นทางที่แสดงสำหรับTRANSITเส้นทาง หมายเหตุ: คุณระบุ transit_preferences ได้ก็ต่อเมื่อตั้งค่า RouteTravelMode เป็น TRANSIT

ExtraComputation

การคำนวณเพิ่มเติมที่จะดำเนินการขณะประมวลผลคำขอ

Enum
EXTRA_COMPUTATION_UNSPECIFIED ไม่ได้ใช้ คำขอที่มีค่านี้จะล้มเหลว
TOLLS ข้อมูลค่าผ่านทางสำหรับเส้นทาง
FUEL_CONSUMPTION การใช้น้ำมันเชื้อเพลิงโดยประมาณสำหรับเส้นทาง
TRAFFIC_ON_POLYLINE Polyline ที่รับรู้การจราจรสำหรับเส้นทาง
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS NavigationInstructions แสดงเป็นสตริงข้อความ HTML ที่จัดรูปแบบแล้ว เนื้อหานี้มีไว้ให้อ่านตามที่แสดงเท่านั้น อย่าแยกวิเคราะห์โดยใช้โปรแกรม
FLYOVER_INFO_ON_POLYLINE ข้อมูลฟลายโอเวอร์สำหรับเส้นทาง ต้องระบุ routes.polyline_details.flyover_info fieldmask เพื่อแสดงข้อมูลนี้ ปัจจุบันระบบจะป้อนข้อมูลนี้สำหรับเขตปริมณฑลบางแห่งในอินเดียเท่านั้น ฟีเจอร์นี้ยังอยู่ในขั้นทดลองและอาจมีการเปลี่ยนแปลง SKU/ค่าใช้จ่าย
NARROW_ROAD_INFO_ON_POLYLINE ข้อมูลถนนแคบสำหรับเส้นทาง ต้องระบุ routes.polyline_details.narrow_road_info fieldmask เพื่อแสดงข้อมูลนี้ ปัจจุบันระบบจะป้อนข้อมูลนี้สำหรับเขตปริมณฑลบางแห่งในอินเดียเท่านั้น ฟีเจอร์นี้ยังอยู่ในขั้นทดลองและอาจมีการเปลี่ยนแปลง SKU/ค่าใช้จ่าย

ReferenceRoute

เส้นทางอ้างอิงที่รองรับใน ComputeRoutesRequest

Enum
REFERENCE_ROUTE_UNSPECIFIED ไม่ได้ใช้ คำขอที่มีค่านี้จะล้มเหลว
FUEL_EFFICIENT เส้นทางที่ประหยัดเชื้อเพลิง
SHORTER_DISTANCE

เส้นทางที่มีระยะการเดินทางสั้นกว่า นี่เป็นฟีเจอร์ทดลองใช้

สำหรับDRIVE คำขอ ฟีเจอร์นี้จะจัดลำดับความสำคัญของระยะทางที่สั้นกว่าเหนือความสะดวกสบายในการขับขี่ เช่น อาจเลือกใช้ถนนในพื้นที่แทนทางหลวง ใช้ถนนลูกรัง ตัดผ่านลานจอดรถ ฯลฯ ฟีเจอร์นี้จะไม่แสดงการเลี้ยวที่ Google Maps ทราบว่าผิดกฎหมาย

สำหรับคำขอ BICYCLE และ TWO_WHEELER ฟีเจอร์นี้จะแสดงเส้นทางที่คล้ายกับเส้นทางที่แสดงเมื่อคุณไม่ได้ระบุ requested_reference_routes

ฟีเจอร์นี้ใช้ร่วมกับโหมดการเดินทางอื่นๆ ผ่านจุดแวะพักกลางทาง หรือ optimize_waypoint_order ไม่ได้ คำขอดังกล่าวจะล้มเหลว แต่คุณใช้ฟีเจอร์นี้กับ routing_preference ใดก็ได้

ComputeRoutesResponse

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

ช่อง
routes[]

Route

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

FallbackInfo

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

GeocodingResults

มีข้อมูลการตอบกลับการแปลงพิกัดภูมิศาสตร์สำหรับจุดอ้างอิงที่ระบุเป็นที่อยู่

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 RoutingPreference ในการคำนวณคำตอบ
FALLBACK_TRAFFIC_AWARE ระบุว่าใช้ TRAFFIC_AWARE RoutingPreference ในการคำนวณคำตอบ

GeocodedWaypoint

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

ช่อง
geocoder_status

Status

ระบุรหัสสถานะที่เกิดจากการดำเนินการ Geocoding
type[]

string

ประเภทของผลลัพธ์ในรูปแบบของแท็กประเภทตั้งแต่ 0 รายการขึ้นไป ประเภทที่รองรับ: ประเภทที่อยู่และประเภทคอมโพเนนต์ของที่อยู่
partial_match

bool

ระบุว่า Geocoder ไม่ได้แสดงผลการจับคู่ที่ตรงกันทุกประการสำหรับคำขอเดิม แม้ว่าจะจับคู่ส่วนหนึ่งของที่อยู่ที่ขอได้ก็ตาม คุณอาจต้องตรวจสอบคำขอเดิมว่ามีการสะกดผิดและ/หรือที่อยู่ไม่ครบถ้วนหรือไม่
place_id

string

รหัสสถานที่สำหรับผลการค้นหานี้
intermediate_waypoint_request_index

int32

ดัชนีของจุดอ้างอิงกลางที่เกี่ยวข้องในคำขอ จะมีการป้อนข้อมูลก็ต่อเมื่อจุดอ้างอิงที่เกี่ยวข้องเป็นจุดอ้างอิงกลาง

GeocodingResults

มี GeocodedWaypoints สำหรับต้นทาง จุดหมาย และจุดแวะพักระหว่างทาง จะมีการป้อนข้อมูลสำหรับจุดอ้างอิงที่เป็นที่อยู่เท่านั้น

ช่อง
origin

GeocodedWaypoint

จุดอ้างอิงต้นทางที่เข้ารหัสพิกัดภูมิศาสตร์
destination

GeocodedWaypoint

จุดอ้างอิงที่เข้ารหัสพิกัดภูมิศาสตร์ของปลายทาง
intermediates[]

GeocodedWaypoint

รายการจุดแวะพักที่แปลงรหัสพิกัดทางภูมิศาสตร์ระดับกลาง ซึ่งแต่ละรายการมีฟิลด์ดัชนีที่สอดคล้องกับตำแหน่งฐาน 0 ของจุดแวะพักตามลำดับที่ระบุในคำขอ

LocalizedTime

คำอธิบายเวลาที่แปลแล้ว

ช่อง
time

LocalizedText

เวลาที่ระบุเป็นสตริงในเขตเวลาที่กำหนด
time_zone

string

มีเขตเวลา ค่าคือชื่อของเขตเวลาตามที่กำหนดไว้ในฐานข้อมูลเขตเวลาของ IANA เช่น "America/New_York"

ตำแหน่ง

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

ช่อง
lat_lng

LatLng

พิกัดทางภูมิศาสตร์ของจุดอ้างอิง
heading

Int32Value

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

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 ใช้เพื่อระบุการเปลี่ยนชื่อถนน

สรุปวิธีการนำทางสำหรับ RouteLegStep

ช่อง
maneuver

Maneuver

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

string

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

เส้นประกอบ

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

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

string

การเข้ารหัสสตริงของเส้นหลายเส้นโดยใช้อัลกอริทึมการเข้ารหัสเส้นหลายเส้น
geo_json_linestring

Struct

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

PolylineDetails

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

ช่อง
flyover_info[]

FlyoverInfo

รายละเอียดการบินผ่านตามแนวเส้น
narrow_road_info[]

NarrowRoadInfo

รายละเอียดถนนแคบตามแนวเส้นประกอบ

FlyoverInfo

แคปซูลข้อมูลเกี่ยวกับภาพมุมสูงตามแนวเส้นประกอบ

ช่อง
flyover_presence

RoadFeatureState

เอาต์พุตเท่านั้น ระบุว่ามีฟลายโอเวอร์สำหรับช่วงของเส้นหลายเส้นที่กำหนดหรือไม่
polyline_point_index

PolylinePointIndex

ตำแหน่งของข้อมูลที่เกี่ยวข้องกับฟลายโอเวอร์ตามแนวเส้นประกอบ

NarrowRoadInfo

แคปซูลข้อมูลเกี่ยวกับถนนแคบตามแนวเส้นประกอบ

ช่อง
narrow_road_presence

RoadFeatureState

เอาต์พุตเท่านั้น ระบุว่ามีถนนแคบสำหรับช่วงของเส้นประกอบที่ระบุหรือไม่
polyline_point_index

PolylinePointIndex

ตำแหน่งของข้อมูลที่เกี่ยวข้องกับถนนแคบตามแนวเส้นประกอบ

PolylinePointIndex

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

ช่อง
start_index

int32

ดัชนีเริ่มต้นของรายละเอียดนี้ในเส้นหลายเส้น
end_index

int32

ดัชนีสิ้นสุดของรายละเอียดนี้ในเส้นหลายเส้น

RoadFeatureState

แคปซูลสถานะขององค์ประกอบถนนตามแนวเส้นประกอบ

Enum
ROAD_FEATURE_STATE_UNSPECIFIED ไม่ได้คำนวณสถานะของฟีเจอร์ถนน (ค่าเริ่มต้น)
EXISTS มีฟีเจอร์ถนน
DOES_NOT_EXIST ไม่มีฟีเจอร์ถนน

PolylineEncoding

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

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

PolylineQuality

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

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

เส้นทาง

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

ช่อง
route_labels[]

RouteLabel

ป้ายกำกับสำหรับ Route ที่มีประโยชน์ในการระบุพร็อพเพอร์ตี้ที่เฉพาะเจาะจงของเส้นทางเพื่อเปรียบเทียบกับเส้นทางอื่นๆ
legs[]

RouteLeg

ชุดของขา (กลุ่มเส้นทางระหว่างจุดอ้างอิง) ที่ประกอบกันเป็นเส้นทาง แต่ละขาจะสอดคล้องกับการเดินทางระหว่าง via Waypoints 2 แห่ง เช่น เส้นทางที่ไม่มีจุดแวะพักระหว่างทางจะมีเพียง 1 ขา เส้นทางที่มีจุดแวะพักที่ไม่ใช่via 1 จุดจะมี 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

หากตั้งค่า optimize_waypoint_order เป็นจริง ช่องนี้จะมีการเรียงลำดับจุดแวะพักกลางที่เพิ่มประสิทธิภาพแล้ว ไม่เช่นนั้น ช่องนี้จะว่างเปล่า เช่น หากคุณป้อนต้นทาง: ลอสแอนเจลิส จุดแวะพักกลางทาง: แดลลัส แบงกอร์ ฟีนิกซ์ ปลายทาง: นิวยอร์ก และลำดับจุดแวะพักกลางทางที่เพิ่มประสิทธิภาพแล้วคือ ฟีนิกซ์ แดลลัส แบงกอร์ ฟิลด์นี้จะมีค่า [2, 0, 1] ดัชนีเริ่มต้นด้วย 0 สำหรับจุดอ้างอิงกลางแรกที่ระบุในอินพุต
localized_values

RouteLocalizedValues

การแสดงข้อความของพร็อพเพอร์ตี้ของ Route
route_token

string

โทเค็นแบบทึบแสงที่ส่งไปยัง Navigation SDK เพื่อสร้างเส้นทางใหม่ในระหว่างการนำทาง และในกรณีที่มีการเปลี่ยนเส้นทาง ให้ดำเนินการตามความตั้งใจเดิมเมื่อสร้างเส้นทาง ถือว่าโทเค็นนี้เป็น Blob ที่คลุมเครือ อย่าเปรียบเทียบค่าในคำขอต่างๆ เนื่องจากค่าอาจเปลี่ยนแปลงได้แม้ว่าบริการจะแสดงเส้นทางเดียวกันก็ตาม

หมายเหตุ: Route.route_token ใช้ได้กับคำขอที่ตั้งค่า ComputeRoutesRequest.routing_preference เป็น TRAFFIC_AWARE หรือ TRAFFIC_AWARE_OPTIMAL เท่านั้น Route.route_token ไม่รองรับคำขอที่มีจุดแวะพัก
polyline_details

PolylineDetails

มีข้อมูลเกี่ยวกับรายละเอียดตามแนวเส้น

RouteLocalizedValues

การแสดงข้อความของพร็อพเพอร์ตี้บางอย่าง

ช่อง
distance

LocalizedText

ระยะทางในการเดินทางที่แสดงในรูปแบบข้อความ
duration

LocalizedText

ระยะเวลาที่แสดงในรูปแบบข้อความและแปลเป็นภาษาท้องถิ่นของภูมิภาคที่ทำการค้นหา พิจารณาสภาพการจราจร หมายเหตุ: หากไม่ได้ขอข้อมูลการเข้าชม ค่านี้จะเป็นค่าเดียวกับ static_duration
static_duration

LocalizedText

ระยะเวลาโดยไม่พิจารณาถึงสภาพการจราจร ซึ่งแสดงในรูปแบบข้อความ
transit_fare

LocalizedText

ค่าโดยสารขนส่งที่แสดงในรูปแบบข้อความ

RouteLabel

ป้ายกำกับสำหรับ Route ที่มีประโยชน์ในการระบุพร็อพเพอร์ตี้ที่เฉพาะเจาะจงของเส้นทางเพื่อเปรียบเทียบกับเส้นทางอื่นๆ

Enum
ROUTE_LABEL_UNSPECIFIED ค่าเริ่มต้น - ไม่ได้ใช้
DEFAULT_ROUTE เส้นทาง "ดีที่สุด" เริ่มต้นที่แสดงผลสำหรับการคำนวณเส้นทาง
DEFAULT_ROUTE_ALTERNATE เส้นทางอื่นแทนเส้นทาง "ดีที่สุด" ตามค่าเริ่มต้น ระบบจะแสดงเส้นทางเช่นนี้เมื่อระบุ compute_alternative_routes
FUEL_EFFICIENT เส้นทางที่ประหยัดเชื้อเพลิง เส้นทางที่มีป้ายกำกับเป็นค่านี้จะได้รับการพิจารณาว่าได้รับการเพิ่มประสิทธิภาพสำหรับพารามิเตอร์ที่เป็นมิตรต่อสิ่งแวดล้อม เช่น การสิ้นเปลืองเชื้อเพลิง
SHORTER_DISTANCE เส้นทางที่มีระยะทางสั้นกว่า นี่เป็นฟีเจอร์ทดลองใช้

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

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

RouteLegLocalizedValues

การแสดงข้อความของพร็อพเพอร์ตี้ของ RouteLeg
steps_overview

StepsOverview

ข้อมูลภาพรวมเกี่ยวกับขั้นตอนในRouteLegนี้ ระบบจะป้อนข้อมูลในช่องนี้สำหรับเส้นทางขนส่งสาธารณะเท่านั้น

RouteLegLocalizedValues

การแสดงข้อความของพร็อพเพอร์ตี้บางอย่าง

ช่อง
distance

LocalizedText

ระยะทางในการเดินทางที่แสดงในรูปแบบข้อความ
duration

LocalizedText

ระยะเวลาที่แสดงในรูปแบบข้อความและแปลเป็นภาษาท้องถิ่นของภูมิภาคที่ทำการค้นหา พิจารณาสภาพการจราจร หมายเหตุ: หากไม่ได้ขอข้อมูลการเข้าชม ค่านี้จะเป็นค่าเดียวกับ static_duration
static_duration

LocalizedText

ระยะเวลาโดยไม่พิจารณาถึงสภาพการจราจร ซึ่งแสดงในรูปแบบข้อความ

StepsOverview

ให้ข้อมูลภาพรวมเกี่ยวกับรายการของ RouteLegStep

ช่อง
multi_modal_segments[]

MultiModalSegment

ข้อมูลสรุปเกี่ยวกับกลุ่มมัลติโมดัลต่างๆ ของ RouteLeg.steps ระบบจะไม่ป้อนข้อมูลในช่องนี้หาก RouteLeg ไม่มีส่วนแบบมัลติโมดัลในขั้นตอน

MultiModalSegment

ให้ข้อมูลสรุปเกี่ยวกับกลุ่มมัลติโมดัลต่างๆ ของ RouteLeg.steps กลุ่มมัลติโมดัลหมายถึง RouteLegStep ที่ต่อเนื่องกันอย่างน้อย 1 รายการซึ่งมี RouteTravelMode เดียวกัน ระบบจะไม่ป้อนข้อมูลในช่องนี้หาก RouteLeg ไม่มีส่วนแบบมัลติโมดัลในขั้นตอน

ช่อง
navigation_instruction

NavigationInstruction

NavigationInstruction สำหรับกลุ่มมัลติโมดัล
travel_mode

RouteTravelMode

รูปแบบการเดินทางของส่วนหลายรูปแบบ
step_start_index

int32

RouteLegStepดัชนีที่เกี่ยวข้องซึ่งเป็นจุดเริ่มต้นของกลุ่มมัลติโมดัล
step_end_index

int32

RouteLegStep ดัชนีที่เกี่ยวข้องซึ่งเป็นจุดสิ้นสุดของกลุ่มมัลติโมดัล

RouteLegStep

มีส่วนของ RouteLeg โดยแต่ละขั้นตอนจะสอดคล้องกับคำสั่งการนำทางเดียว ขาของเส้นทางประกอบด้วยขั้นตอนต่างๆ

ช่อง
distance_meters

int32

ระยะทางการเดินทางของขั้นตอนนี้เป็นเมตร ในบางกรณี ช่องนี้อาจไม่มีค่า
static_duration

Duration

ระยะเวลาการเดินทางผ่านขั้นตอนนี้โดยไม่พิจารณาสภาพการจราจร ในบางกรณี ช่องนี้อาจไม่มีค่า
polyline

Polyline

เส้นหลายเหลี่ยมที่เชื่อมโยงกับขั้นตอนนี้
start_location

Location

ตำแหน่งเริ่มต้นของขั้นตอนนี้
end_location

Location

ตำแหน่งสิ้นสุดของขั้นตอนนี้
navigation_instruction

NavigationInstruction

คำแนะนำการนำทาง
travel_advisory

RouteLegStepTravelAdvisory

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

RouteLegStepLocalizedValues

การแสดงข้อความของพร็อพเพอร์ตี้ของ RouteLegStep
transit_details

RouteLegStepTransitDetails

รายละเอียดที่เกี่ยวข้องกับขั้นตอนนี้หากโหมดการเดินทางเป็น TRANSIT
travel_mode

RouteTravelMode

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

RouteLegStepLocalizedValues

การแสดงข้อความของพร็อพเพอร์ตี้บางอย่าง

ช่อง
distance

LocalizedText

ระยะทางในการเดินทางที่แสดงในรูปแบบข้อความ
static_duration

LocalizedText

ระยะเวลาโดยไม่พิจารณาถึงสภาพการจราจร ซึ่งแสดงในรูปแบบข้อความ

RouteLegStepTransitDetails

ข้อมูลเพิ่มเติมสำหรับ RouteLegStep ที่เกี่ยวข้องกับเส้นทาง TRANSIT

ช่อง
stop_details

TransitStopDetails

ข้อมูลเกี่ยวกับป้ายรถประจำทางขาเข้าและขาออกสำหรับขั้นตอน
localized_values

TransitDetailsLocalizedValues

การแสดงข้อความของพร็อพเพอร์ตี้ของ RouteLegStepTransitDetails
headsign

string

ระบุทิศทางที่จะเดินทางในเส้นทางนี้ตามที่ระบุไว้ในยานพาหนะหรือที่ป้ายหยุดรถต้นทาง โดยมักจะเป็นสถานีปลายทาง
headway

Duration

ระบุเวลาที่คาดไว้เป็นระยะเวลาระหว่างการออกเดินทางจากป้ายเดียวกันในเวลานี้ เช่น หากมีค่า headway seconds เป็น 600 คุณก็คาดได้ว่าจะต้องรอ 10 นาทีหากขึ้นรถประจำทางไม่ทัน
transit_line

TransitLine

ข้อมูลเกี่ยวกับสายรถประจำทางที่ใช้ในขั้นตอนนี้
stop_count

int32

จำนวนป้ายจอดรถตั้งแต่ป้ายต้นทางจนถึงป้ายปลายทาง จำนวนนี้รวมป้ายจอดรถขาเข้า แต่ไม่รวมป้ายจอดรถขาออก เช่น หากเส้นทางของคุณออกจากป้าย A ผ่านป้าย B และ C แล้วไปถึงป้าย D

stop_count

ผลตอบแทน 3
trip_short_text

string

ข้อความที่ปรากฏในตารางเวลาและป้ายบอกทางเพื่อระบุการเดินทางด้วยระบบขนส่งสาธารณะให้ผู้โดยสาร ข้อความควรระบุการเดินทางภายในวันให้บริการได้อย่างไม่ซ้ำกัน เช่น "538" คือtrip_short_textของรถไฟ Amtrak ที่ออกจากซานโฮเซ รัฐแคลิฟอร์เนีย เวลา 15:10 น. ในวันธรรมดาไปยังแซคราเมนโต รัฐแคลิฟอร์เนีย

TransitDetailsLocalizedValues

คำอธิบายค่าที่แปลแล้วสำหรับ RouteTransitDetails

ช่อง
arrival_time

LocalizedTime

เวลาในรูปแบบข้อความที่จัดรูปแบบพร้อมเขตเวลาที่เกี่ยวข้อง
departure_time

LocalizedTime

เวลาในรูปแบบข้อความที่จัดรูปแบบพร้อมเขตเวลาที่เกี่ยวข้อง

TransitStopDetails

รายละเอียดเกี่ยวกับป้ายจอดรถประจำทางสำหรับ RouteLegStep

ช่อง
arrival_stop

TransitStop

ข้อมูลเกี่ยวกับป้ายจอดรถขาเข้าสำหรับขั้นตอน
arrival_time

Timestamp

เวลาถึงโดยประมาณของขั้นตอน
departure_stop

TransitStop

ข้อมูลเกี่ยวกับป้ายรถประจำทางต้นทางสำหรับขั้นตอน
departure_time

Timestamp

เวลาออกเดินทางโดยประมาณของขั้นตอน

RouteLegStepTravelAdvisory

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

ช่อง
speed_reading_intervals[]

SpeedReadingInterval

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

RouteLegTravelAdvisory

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

ช่อง
toll_info

TollInfo

มีข้อมูลเกี่ยวกับค่าผ่านทางบน RouteLeg ที่เฉพาะเจาะจง ระบบจะป้อนข้อมูลในช่องนี้ก็ต่อเมื่อเราคาดว่าจะมีค่าผ่านทางใน RouteLeg และ TOLLS รวมอยู่ใน ComputeRoutesRequest.extra_computations ของคำขอ หากตั้งค่าฟิลด์นี้แต่ไม่ได้กรอกข้อมูลในฟิลด์ย่อย estimated_price เราคาดว่าถนนมีค่าผ่านทางแต่ไม่ทราบราคาโดยประมาณ หาก toll_info ไม่มีอยู่ แสดงว่าไม่มีค่าผ่านทางบน RouteLeg
speed_reading_intervals[]

SpeedReadingInterval

ช่วงการอ่านความเร็วที่แสดงความหนาแน่นของการจราจร ระบบจะป้อนข้อมูลในช่องนี้สำหรับคำขอเท่านั้นเมื่อคำขอมีค่า TRAFFIC_AWARE หรือ TRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routing_preference และรวม TRAFFIC_ON_POLYLINE ไว้ใน ComputeRoutesRequest.extra_computations ช่วงเวลาจะครอบคลุมเส้นหลายเส้นทั้งหมดของ 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 ซึ่งสามารถสตรีมไปยังไคลเอ็นต์ได้

ช่อง
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

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

LocalizedValues

การแสดงข้อความของพร็อพเพอร์ตี้ของ RouteMatrixElement
origin_index

int32

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

int32

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

LocalizedValues

การแสดงข้อความของพร็อพเพอร์ตี้บางอย่าง

ช่อง
distance

LocalizedText

ระยะทางในการเดินทางที่แสดงในรูปแบบข้อความ
duration

LocalizedText

ระยะเวลาที่แสดงในรูปแบบข้อความโดยพิจารณาสภาพการจราจร หมายเหตุ: หากไม่ได้ขอข้อมูลการเข้าชม ค่านี้จะเป็นค่าเดียวกับ static_duration
static_duration

LocalizedText

ระยะเวลาที่แสดงในรูปแบบข้อความโดยไม่พิจารณาสภาพการจราจร
transit_fare

LocalizedText

ค่าโดยสารขนส่งที่แสดงในรูปแบบข้อความ

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 RouteTravelMode เท่านั้น
avoid_highways

bool

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

bool

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

bool

เมื่อตั้งค่าเป็น "จริง" ระบบจะหลีกเลี่ยงการนำทางในอาคารหากเป็นไปได้ และให้ความสำคัญกับเส้นทางที่ไม่มีการนำทางในอาคาร ใช้กับ WALK RouteTravelMode เท่านั้น
vehicle_info

VehicleInfo

ระบุข้อมูลยานพาหนะ
toll_passes[]

TollPass

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

RouteTravelAdvisory

มีข้อมูลเพิ่มเติมที่ผู้ใช้ควรทราบ เช่น ข้อจำกัดเกี่ยวกับเขตการจราจรที่อาจเกิดขึ้น

ช่อง
toll_info

TollInfo

มีข้อมูลเกี่ยวกับค่าผ่านทางในเส้นทาง ระบบจะป้อนข้อมูลในช่องนี้ก็ต่อเมื่อคาดว่าเส้นทางจะมีค่าผ่านทางและมี TOLLS อยู่ใน ComputeRoutesRequest.extra_computations ของคำขอ หากตั้งค่าฟิลด์นี้ แต่ไม่ได้กรอกข้อมูลestimatedPriceฟิลด์ย่อย แสดงว่าเส้นทางมีค่าผ่านทาง แต่ไม่ทราบราคาโดยประมาณ หากไม่ได้ตั้งค่า toll_info แสดงว่าเส้นทางไม่มีค่าผ่านทาง
speed_reading_intervals[]

SpeedReadingInterval

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

ตัวอย่าง

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

int64

ปริมาณการใช้เชื้อเพลิงที่คาดการณ์ไว้ในหน่วยไมโครลิตร ระบบจะป้อนข้อมูลในช่องนี้เมื่อมี FUEL_CONSUMPTION ใน ComputeRoutesRequest.extra_computations ของคำขอเท่านั้น
route_restrictions_partially_ignored

bool

เส้นทางที่แสดงอาจมีข้อจำกัดที่ไม่เหมาะกับโหมดการเดินทางหรือตัวปรับเส้นทางที่ขอ
transit_fare

Money

หากมี จะมีค่าโดยสารหรือค่าตั๋วทั้งหมดในเส้นทางนี้ พร็อพเพอร์ตี้นี้จะแสดงเฉพาะสำหรับคำขอ TRANSIT และเฉพาะเส้นทางที่มีข้อมูลค่าโดยสารสำหรับขั้นตอนการขนส่งสาธารณะทั้งหมด

RouteTravelMode

ชุดค่าที่ใช้เพื่อระบุโหมดการเดินทาง หมายเหตุ: เส้นทาง WALK, BICYCLE และ TWO_WHEELER อยู่ในเวอร์ชันเบต้า และบางครั้งอาจไม่มีทางเท้า ทางคนเดินเท้า หรือทางจักรยานที่ชัดเจน คุณต้องแสดงคำเตือนนี้ต่อผู้ใช้สำหรับเส้นทางเดินเท้า ปั่นจักรยาน และเส้นทาง 2 ล้อทั้งหมดที่แสดงในแอป

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

RoutingPreference

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

Enum
ROUTING_PREFERENCE_UNSPECIFIED ไม่ได้ระบุค่ากำหนดการกำหนดเส้นทาง ค่าเริ่มต้นคือ TRAFFIC_UNAWARE
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

ดัชนีเริ่มต้นของช่วงนี้ในเส้นโพลีไลน์
end_polyline_point_index

int32

ดัชนีสิ้นสุดของช่วงเวลานี้ในเส้นโพลีไลน์
ฟิลด์ Union speed_type ประเภทความเร็วในช่วงเวลานี้ speed_type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
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, สหรัฐอเมริกา
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 IL, USA.
US_IL_IPASS IL, USA.
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 LA, USA.
US_LA_TOLL_TAG LA, USA.
US_MA_EZPASSMA MA, USA
US_MD_EZPASSMD MD, USA.
US_ME_EZPASSME ME, สหรัฐอเมริกา
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 NC, USA.
US_NC_PEACH_PASS NC, USA.
US_NC_QUICK_PASS NC, USA.
US_NH_EZPASSNH NH, USA.
US_NJ_DOWNBEACH_EXPRESS_PASS NJ, สหรัฐอเมริกา
US_NJ_EZPASSNJ NJ, สหรัฐอเมริกา
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 WA, USA.
US_WA_GOOD_TO_GO WA, USA.
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.

TrafficModel

ระบุสมมติฐานที่จะใช้เมื่อคำนวณเวลาในการเข้าชม การตั้งค่านี้จะส่งผลต่อค่าที่แสดงในช่อง duration ในการตอบกลับ ซึ่งมีเวลาที่คาดการณ์ในการจราจรตามค่าเฉลี่ยในอดีต

Enum
TRAFFIC_MODEL_UNSPECIFIED ไม่ได้ใช้ หากระบุ ระบบจะใช้ BEST_GUESS เป็นค่าเริ่มต้น
BEST_GUESS ระบุว่า duration ที่แสดงควรเป็นค่าประมาณเวลาที่ใช้เดินทางที่ดีที่สุดตามข้อมูลที่ทราบเกี่ยวกับสภาพการจราจรในอดีตและสภาพการจราจรแบบเรียลไทม์ การเข้าชมแบบเรียลไทม์จะมีความสำคัญมากขึ้นเมื่อdeparture_timeใกล้กับเวลาปัจจุบัน
PESSIMISTIC ระบุว่าระยะเวลาที่ส่งคืนควรนานกว่าเวลาเดินทางจริงในวันส่วนใหญ่ แม้ว่าบางวันที่มีสภาพการจราจรแย่เป็นพิเศษอาจมีค่าเกินกว่านี้
OPTIMISTIC ระบุว่าระยะเวลาที่แสดงควรสั้นกว่าเวลาเดินทางจริงในวันส่วนใหญ่ แม้ว่าในบางวันที่มีสภาพการจราจรดีเป็นพิเศษอาจเร็วกว่าค่านี้

TransitAgency

บริษัทขนส่งที่ให้บริการเส้นทางขนส่งสาธารณะ

ช่อง
name

string

ชื่อของบริษัทขนส่งนี้
phone_number

string

หมายเลขโทรศัพท์ที่จัดรูปแบบเฉพาะภาษาของหน่วยงานขนส่ง
uri

string

URI ของบริษัทขนส่ง

TransitLine

มีข้อมูลเกี่ยวกับเส้นทางการขนส่งสาธารณะที่ใช้ในขั้นตอนนี้

ช่อง
agencies[]

TransitAgency

บริษัทขนส่งที่ให้บริการเส้นทางขนส่งสาธารณะนี้
name

string

ชื่อเต็มของเส้นทางขนส่งนี้ เช่น "8 Avenue Local"
uri

string

URI สำหรับเส้นทางขนส่งสาธารณะนี้ตามที่บริษัทขนส่งระบุ
color

string

สีที่มักใช้ในป้ายสำหรับสายนี้ แสดงในรูปแบบเลขฐานสิบหก
icon_uri

string

URI ของไอคอนที่เชื่อมโยงกับบรรทัดนี้
name_short

string

ชื่อย่อของเส้นทางขนส่งสาธารณะนี้ โดยปกติแล้วชื่อนี้จะเป็นหมายเลขสาย เช่น "M7" หรือ "355"
text_color

string

สีที่ใช้กันโดยทั่วไปในข้อความบนป้ายสำหรับสายนี้ แสดงในรูปแบบเลขฐานสิบหก
vehicle

TransitVehicle

ประเภทของยานพาหนะที่วิ่งในเส้นทางขนส่งสาธารณะนี้

TransitPreferences

ค่ากำหนดสำหรับเส้นทางที่อิงตาม TRANSIT ซึ่งมีผลต่อเส้นทางที่แสดง

ช่อง
allowed_travel_modes[]

TransitTravelMode

ชุดโหมดการเดินทางที่จะใช้เมื่อรับTRANSITเส้นทาง ค่าเริ่มต้นคือรูปแบบการเดินทางที่รองรับทั้งหมด
routing_preference

TransitRoutingPreference

ค่ากำหนดการกำหนดเส้นทางซึ่งเมื่อระบุแล้วจะส่งผลต่อTRANSIT เส้นทางที่แสดง

TransitRoutingPreference

ระบุค่ากำหนดการกำหนดเส้นทางสำหรับเส้นทางขนส่งสาธารณะ

Enum
TRANSIT_ROUTING_PREFERENCE_UNSPECIFIED ไม่ได้ระบุค่ากำหนด
LESS_WALKING ระบุว่าเส้นทางที่คำนวณแล้วควรมีการเดินในระยะทางที่จำกัด
FEWER_TRANSFERS ระบุว่าเส้นทางที่คำนวณควรมีการเปลี่ยนรถจำนวนจำกัด

TransitTravelMode

ชุดค่าที่ใช้เพื่อระบุโหมดการขนส่ง

Enum
TRANSIT_TRAVEL_MODE_UNSPECIFIED ไม่ได้ระบุโหมดการเดินทางด้วยขนส่งสาธารณะ
BUS เดินทางโดยรถประจำทาง
SUBWAY เดินทางโดยรถไฟใต้ดิน
TRAIN เดินทางโดยรถไฟ
LIGHT_RAIL เดินทางด้วยรถไฟฟ้ารางเบาหรือรถราง
RAIL เดินทางโดยรถไฟ ซึ่งเทียบเท่ากับการรวมกันของ SUBWAY, TRAIN และ LIGHT_RAIL

TransitStop

ข้อมูลเกี่ยวกับป้ายหยุดรถประจำทาง

ช่อง
name

string

ชื่อของป้ายจอดรถ
location

Location

ตำแหน่งของป้ายจอดรถที่แสดงในพิกัดละติจูด/ลองจิจูด

TransitVehicle

ข้อมูลเกี่ยวกับยานพาหนะที่ใช้ในเส้นทางการขนส่ง

ช่อง
name

LocalizedText

ชื่อของยานพาหนะนี้ (ตัวพิมพ์ใหญ่)
type

TransitVehicleType

ประเภทของยานพาหนะที่ใช้
icon_uri

string

URI ของไอคอนที่เชื่อมโยงกับยานพาหนะประเภทนี้
local_icon_uri

string

URI สำหรับไอคอนที่เชื่อมโยงกับประเภทยานพาหนะนี้ตามป้ายบอกทางของระบบขนส่งในพื้นที่

TransitVehicleType

ประเภทของยานพาหนะสำหรับเส้นทางขนส่งสาธารณะ

Enum
TRANSIT_VEHICLE_TYPE_UNSPECIFIED ไม่ได้ใช้
BUS รถประจำทาง
CABLE_CAR ยานพาหนะที่วิ่งบนสายเคเบิล โดยปกติจะอยู่บนพื้น กระเช้าลอยฟ้าอาจเป็นประเภท GONDOLA_LIFT
COMMUTER_TRAIN รถไฟ
FERRY เรือข้ามฟาก
FUNICULAR ยานพาหนะที่ดึงขึ้นไปบนทางลาดชันด้วยสายเคเบิล โดยปกติแล้ว รถกระเช้าจะประกอบด้วยรถ 2 คัน ซึ่งแต่ละคันจะทำหน้าที่เป็นตัวถ่วงน้ำหนักสำหรับอีกคันหนึ่ง
GONDOLA_LIFT กระเช้าลอยฟ้า
HEAVY_RAIL รถไฟหนัก
HIGH_SPEED_TRAIN รถไฟความเร็วสูง
INTERCITY_BUS รถบัสทางไกล
LONG_DISTANCE_TRAIN รถไฟทางไกล
METRO_RAIL รถไฟฟ้ารางเบา
MONORAIL รถไฟรางเดี่ยว
OTHER ยานพาหนะอื่นๆ ทั้งหมด
RAIL รถไฟ
SHARE_TAXI แท็กซี่ร่วมโดยสารเป็นรถประจำทางประเภทหนึ่งที่สามารถรับส่งผู้โดยสารได้ทุกที่ตามเส้นทาง
SUBWAY รถไฟฟ้ารางเบาใต้ดิน
TRAM รถไฟฟ้ารางเบาบนพื้นดิน
TROLLEYBUS รถรางที่ใช้ไฟฟ้า

หน่วย

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

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

VehicleEmissionType

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

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

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 RouteTravelMode เท่านั้น
ฟิลด์ Union location_type วิธีต่างๆ ในการแสดงสถานที่ location_type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
location

Location

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

string

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

string

ที่อยู่ที่มนุษย์อ่านได้หรือ Plus Code ดูรายละเอียดได้ที่ https://plus.codes