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 ในมาสก์ช่อง ไม่เช่นนั้นข้อความทั้งหมดจะปรากฏว่า "OK" 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 เพียงรายการใดรายการหนึ่ง
language_code

string

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

string

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

Units

ไม่บังคับ ระบุหน่วยวัดสำหรับช่องแสดงผล
extra_computations[]

ExtraComputation

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

TrafficModel

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

bool

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

RouteModifiers

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

string

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

string

ไม่บังคับ รหัสภูมิภาคที่ระบุเป็นค่า 2 อักขระของ ccTLD ("โดเมนระดับบนสุด") ดูข้อมูลเพิ่มเติมได้ที่โดเมนระดับบนสุดแบบรหัสประเทศ
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 เส้นประกอบที่คำนึงถึงการจราจรสำหรับเส้นทาง
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 และมีเพียงเส้นทางเดียวเมื่อคุณไม่ได้ระบุ เมื่ออาร์เรย์นี้มีรายการหลายรายการ รายการแรกจะเป็นเส้นทางที่แนะนำมากที่สุด หากอาร์เรย์ว่าง แสดงว่าไม่พบเส้นทาง
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

ระบุรหัสสถานะที่เป็นผลมาจากการดำเนินการเปลี่ยนที่อยู่เป็นพิกัดภูมิศาสตร์
type[]

string

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

bool

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

การเคลื่อนไหว

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

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

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

เส้นประกอบ

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

ช่อง
ฟิลด์สหภาพ 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 ไม่ได้ระบุค่ากําหนดประเภทเส้นประกอบ ค่าเริ่มต้นคือ 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

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

หากคุณตั้งค่า 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

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

ช่อง
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 จะถือว่าบัตรผ่านทางนั้นไม่รู้จักและพยายามแสดงผลราคาเงินสด มีผลกับ DRIVE และ TWO_WHEELER RouteTravelMode เท่านั้น

RouteTravelAdvisory

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

ช่อง
toll_info

TollInfo

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

int64

ปริมาณเชื้อเพลิงที่ใช้โดยประมาณเป็นไมโครลิตร
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

ดัชนีสิ้นสุดของช่วงเวลานี้ในเส้นประกอบ

ฟิลด์สหภาพ speed_type

speed_type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
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 อิลลินอยส์ สหรัฐอเมริกา
US_IL_IPASS อิลลินอยส์ สหรัฐอเมริกา
US_IN_EZPASSIN อินเดีย สหรัฐอเมริกา
US_KS_BESTPASS_HORIZON KS, สหรัฐอเมริกา
US_KS_KTAG KS, สหรัฐอเมริกา
US_KS_NATIONALPASS KS, สหรัฐอเมริกา
US_KS_PREPASS_ELITEPASS KS, สหรัฐอเมริกา
US_LA_GEAUXPASS ลอสแอนเจลิส สหรัฐอเมริกา
US_LA_TOLL_TAG ลอสแอนเจลิส สหรัฐอเมริกา
US_MA_EZPASSMA แมสซาชูเซตส์ สหรัฐอเมริกา
US_MD_EZPASSMD รัฐแมริแลนด์ สหรัฐอเมริกา
US_ME_EZPASSME สหรัฐอเมริกา
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD มิชิแกน สหรัฐอเมริกา
US_MI_BCPASS มิชิแกน สหรัฐอเมริกา
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG มิชิแกน สหรัฐอเมริกา
US_MI_IQ_PROX_CARD

มิชิแกน สหรัฐอเมริกา เลิกใช้งานแล้วเนื่องจากบัตรประเภทนี้ไม่มีอยู่แล้ว
US_MI_IQ_TAG MI, USA
US_MI_MACKINAC_BRIDGE_MAC_PASS มิชิแกน สหรัฐอเมริกา
US_MI_NEXPRESS_TOLL มิชิแกน สหรัฐอเมริกา
US_MN_EZPASSMN MN, สหรัฐอเมริกา
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 PA, USA
US_RI_EZPASSRI RI, USA
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 UT, สหรัฐอเมริกา
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.

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

Location

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

string

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

string

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