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

ReferenceRoute

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

Enum
REFERENCE_ROUTE_UNSPECIFIED ไม่ได้ใช้ คำขอที่มีค่านี้จะดำเนินการไม่สำเร็จ
FUEL_EFFICIENT เส้นทางที่ประหยัดเชื้อเพลิง เส้นทางที่ติดป้ายกำกับด้วยค่านี้ได้รับการกำหนดมาเพื่อเพิ่มประสิทธิภาพให้กับพารามิเตอร์ต่างๆ เช่น การบริโภคน้ำมันเชื้อเพลิง

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

ระบุรหัสสถานะที่เกิดจากการดำเนินการเข้ารหัสพิกัดภูมิศาสตร์
type[]

string

ประเภทของผลลัพธ์ในรูปแบบของแท็กประเภทศูนย์รายการหรือมากกว่า ประเภทที่รองรับ: ประเภทที่อยู่และประเภทคอมโพเนนต์ที่อยู่
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 และ RouteTravelMode ของ TWO_WHEELER เท่านั้น

การบังคับทิศทาง

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

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

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

ช่อง
maneuver

Maneuver

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

string

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

เส้นประกอบ

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

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

string

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

Struct

ระบุโพลีไลน์โดยใช้รูปแบบ GeoJSON LineString

PolylineEncoding

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

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

PolylineQuality

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

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

เส้นทาง

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

ช่อง
route_labels[]

RouteLabel

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

RouteLeg

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

RouteLocalizedValues

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

string

โทเค็นเส้นทางที่เข้ารหัสแบบ Base64 สำหรับเว็บซึ่งสามารถส่งผ่านไปยัง Navigation SDK ทำให้ Navigation SDK สามารถสร้างเส้นทางใหม่ในระหว่างการนำทาง และในกรณีที่เปลี่ยนเส้นทาง ให้ยึดตามความตั้งใจเดิมเมื่อคุณสร้างเส้นทางด้วยการเรียกใช้ ComputeRoutes ลูกค้าควรถือว่าโทเค็นนี้เป็น Blob ทึบ ไม่ได้มีไว้เพื่ออ่านหรือเปลี่ยนแปลง หมายเหตุ: Route.route_token จะใช้ได้กับคำขอที่ตั้งค่า ComputeRoutesRequest.routing_preference เป็น TRAFFIC_AWARE หรือ TRAFFIC_AWARE_OPTIMAL เท่านั้น ไม่รองรับ Route.route_token สำหรับคำขอที่มีจุดอ้างอิง Via

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 เส้นทางที่ประหยัดเชื้อเพลิง เส้นทางที่ติดป้ายกำกับด้วยค่านี้ได้รับการกำหนดมาเพื่อเพิ่มประสิทธิภาพให้กับพารามิเตอร์อีโค เช่น การบริโภคเชื้อเพลิง

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 นี้ ช่องนี้จะมีการป้อนข้อมูลสำหรับเส้นทาง TRANSIT เท่านั้น

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

ดัชนีแบบศูนย์ของต้นทางในคำขอ
destination_index

int32

ดัชนีแบบศูนย์ของปลายทางในคำขอ

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

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

bool

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

bool

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

bool

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

VehicleInfo

ระบุข้อมูลรถ
toll_passes[]

TollPass

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

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

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

RoutingPreference

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

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

SpeedReadingInterval

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

ช่อง
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 Japan ETC. ระบบไร้สายอิเล็กทรอนิกส์สำหรับเก็บค่าผ่านทาง https://www.go-etc.jp/
JP_ETC2 Japan 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 แอละแบมา สหรัฐอเมริกา
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 CO, สหรัฐอเมริกา
US_CO_GO_PASS CO, สหรัฐอเมริกา
US_DE_EZPASSDE DE, USA
US_FL_BOB_SIKES_TOLL_BRIDGE_PASS ฟลอริดา สหรัฐอเมริกา
US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD ฟลอริดา สหรัฐอเมริกา
US_FL_EPASS ฟลอริดา สหรัฐอเมริกา
US_FL_GIBA_TOLL_PASS ฟลอริดา สหรัฐอเมริกา
US_FL_LEEWAY ฟลอริดา สหรัฐอเมริกา
US_FL_SUNPASS ฟลอริดา สหรัฐอเมริกา
US_FL_SUNPASS_PRO ฟลอริดา สหรัฐอเมริกา
US_IL_EZPASSIL IL, สหรัฐอเมริกา
US_IL_IPASS IL, สหรัฐอเมริกา
US_IN_EZPASSIN IN, สหรัฐอเมริกา
US_KS_BESTPASS_HORIZON แคนซัส สหรัฐอเมริกา
US_KS_KTAG แคนซัส สหรัฐอเมริกา
US_KS_NATIONALPASS แคนซัส สหรัฐอเมริกา
US_KS_PREPASS_ELITEPASS แคนซัส สหรัฐอเมริกา
US_LA_GEAUXPASS ลอสแอนเจลิส สหรัฐอเมริกา
US_LA_TOLL_TAG ลอสแอนเจลิส สหรัฐอเมริกา
US_MA_EZPASSMA MA, USA
US_MD_EZPASSMD MD, สหรัฐอเมริกา
US_ME_EZPASSME ME, สหรัฐอเมริกา
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD MI, สหรัฐอเมริกา
US_MI_BCPASS MI, สหรัฐอเมริกา
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG MI, สหรัฐอเมริกา
US_MI_IQ_PROX_CARD

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

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 เพื่อระบุรายละเอียดสำหรับการแวะพักในเที่ยวบินนั้น ตั้งค่านี้เป็น true เมื่อคุณต้องการให้เส้นทางผ่านจุดอ้างอิงนี้โดยไม่หยุด จุดอ้างอิงผ่านทางจะไม่ทำให้มีการเพิ่มรายการลงในอาร์เรย์ legs แต่จะกำหนดเส้นทางเส้นทางผ่านจุดอ้างอิง คุณตั้งค่านี้ได้บนจุดอ้างอิงที่เป็นสื่อกลางเท่านั้น คำขอจะล้มเหลวหากคุณตั้งค่าช่องนี้บนจุดอ้างอิงเทอร์มินัล หากตั้งค่า ComputeRoutesRequest.optimize_waypoint_order เป็น "จริง" ช่องนี้จะตั้งค่าให้เป็น "จริง" ไม่ได้ มิเช่นนั้น คำขอจะไม่สำเร็จ
vehicle_stopover

bool

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

bool

ระบุว่าตำแหน่งจุดอ้างอิงนี้ต้องการให้รถจอดที่ฝั่งใดฝั่งหนึ่งของถนน เมื่อคุณกำหนดค่านี้ เส้นทางจะผ่านตำแหน่งเพื่อให้รถสามารถหยุดที่ด้านข้างถนนที่ตำแหน่งดังกล่าวมีความคลาดเคลื่อนจากกึ่งกลางของถนน ตัวเลือกนี้ใช้ได้กับ DRIVE และ RouteTravelMode ของ TWO_WHEELER เท่านั้น
ฟิลด์สหภาพ location_type วิธีต่างๆ ในการนำเสนอสถานที่ location_type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
location

Location

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

string

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

string

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