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

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

  • ผลรวมของจำนวนต้นทาง + จำนวนปลายทางที่ระบุเป็น place_id หรือ address ต้องไม่เกิน 50
  • ผลคูณของจำนวนต้นทาง × จำนวนปลายทางต้องไม่เกิน 625 ไม่ว่าในกรณีใดก็ตาม
  • ผลคูณของจำนวนต้นทาง × จำนวนปลายทางต้องไม่เกิน 100 หากตั้งค่า traffic_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 Locale Identifier โปรดดูรายการภาษาที่รองรับในการสนับสนุนภาษา หากไม่ระบุค่านี้ ภาษาที่แสดงจะอนุมานจากตำแหน่งของต้นทางแรก

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 วันที่ผ่านมาหรือ 100 วันข้างหน้า

arrival_time

Timestamp

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

compute_alternative_routes

bool

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

route_modifiers

RouteModifiers

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

language_code

string

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

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 จะพิจารณาพารามิเตอร์ต่างๆ ที่จะสร้างเส้นทางที่ประหยัดเชื้อเพลิงที่เหมาะสมที่สุด

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

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

ช่อง
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 บ่งบอกว่ามีการใช้ RoutingPreference ของ TRAFFIC_UNAWARE เพื่อคำนวณคำตอบ
FALLBACK_TRAFFIC_AWARE บ่งบอกว่ามีการใช้ RoutingPreference ของ TRAFFIC_AWARE เพื่อคำนวณคำตอบ

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

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

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 ห่อหุ้มชนิดของเส้นประกอบ ค่าเริ่มต้นคือ 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

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

localized_values

RouteLocalizedValues

ข้อความแสดงคุณสมบัติของ Route

route_token

string

โทเค็นเส้นทางที่เข้ารหัสแบบ Base64 ที่ปลอดภัยสำหรับเว็บซึ่งส่งไปยัง SDK การนำทางได้ ซึ่งช่วยให้ 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

วิธีการไปยังส่วนต่างๆ สำหรับกลุ่มแบบหลายโมดัล

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 สามารถสตรีม Proto นี้ไปยังไคลเอ็นต์ได้

ช่อง
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 อยู่ในรุ่นเบต้า และบางครั้งอาจไม่มีทางเท้าที่ชัดเจน ทางเท้า หรือเส้นทางจักรยาน คุณต้องแสดงคำเตือนนี้ต่อผู้ใช้สำหรับเส้นทางการเดิน การขี่จักรยาน และ 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 (ดัชนีแบบศูนย์) 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 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 AL, สหรัฐอเมริกา
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS อาร์คันซอ สหรัฐอเมริกา
US_CA_FASTRAK แคนาดา สหรัฐอเมริกา
US_CA_FASTRAK_CAV_STICKER ระบุว่าคนขับมีบัตร FasTrak เพิ่มเติมจากสติกเกอร์ Clean Air พาหนะ (CAV) ที่ออกโดย DMV https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
US_CO_EXPRESSTOLL โคโลราโด สหรัฐอเมริกา
US_CO_GO_PASS โคโลราโด สหรัฐอเมริกา
US_DE_EZPASSDE เยอรมนี สหรัฐอเมริกา
US_FL_BOB_SIKES_TOLL_BRIDGE_PASS ฟลอริดา สหรัฐอเมริกา
US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD ฟลอริดา สหรัฐอเมริกา
US_FL_EPASS ฟลอริดา สหรัฐอเมริกา
US_FL_GIBA_TOLL_PASS ฟลอริดา สหรัฐอเมริกา
US_FL_LEEWAY ฟลอริดา สหรัฐอเมริกา
US_FL_SUNPASS ฟลอริดา สหรัฐอเมริกา
US_FL_SUNPASS_PRO ฟลอริดา สหรัฐอเมริกา
US_IL_EZPASSIL IL, สหรัฐอเมริกา
US_IL_IPASS IL, สหรัฐอเมริกา
US_IN_EZPASSIN อินเดีย สหรัฐอเมริกา
US_KS_BESTPASS_HORIZON แคนซัส สหรัฐอเมริกา
US_KS_KTAG แคนซัส สหรัฐอเมริกา
US_KS_NATIONALPASS แคนซัส สหรัฐอเมริกา
US_KS_PREPASS_ELITEPASS แคนซัส สหรัฐอเมริกา
US_LA_GEAUXPASS ลอสแอนเจลิส สหรัฐอเมริกา
US_LA_TOLL_TAG ลอสแอนเจลิส สหรัฐอเมริกา
US_MA_EZPASSMA แมสซาชูเซตส์ สหรัฐอเมริกา
US_MD_EZPASSMD MD, สหรัฐอเมริกา
US_ME_EZPASSME ME, สหรัฐอเมริกา
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD MI, สหรัฐอเมริกา
US_MI_BCPASS MI, สหรัฐอเมริกา
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG MI, สหรัฐอเมริกา
US_MI_IQ_PROX_CARD

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

US_MI_IQ_TAG MI, สหรัฐอเมริกา
US_MI_MACKINAC_BRIDGE_MAC_PASS MI, สหรัฐอเมริกา
US_MI_NEXPRESS_TOLL MI, สหรัฐอเมริกา
US_MN_EZPASSMN มินนิโซตา สหรัฐอเมริกา
US_NC_EZPASSNC นอร์ทแคโรไลนา สหรัฐอเมริกา
US_NC_PEACH_PASS นอร์ทแคโรไลนา สหรัฐอเมริกา
US_NC_QUICK_PASS นอร์ทแคโรไลนา สหรัฐอเมริกา
US_NH_EZPASSNH NH, สหรัฐอเมริกา
US_NJ_DOWNBEACH_EXPRESS_PASS นิวเจอร์ซีย์ สหรัฐอเมริกา
US_NJ_EZPASSNJ นิวเจอร์ซีย์ สหรัฐอเมริกา
US_NY_EXPRESSPASS นิวยอร์ก สหรัฐอเมริกา
US_NY_EZPASSNY นิวยอร์ก สหรัฐอเมริกา
US_OH_EZPASSOH โอไฮโอ สหรัฐอเมริกา
US_PA_EZPASSPA เพนซิลเวเนีย สหรัฐอเมริกา
US_RI_EZPASSRI รัฐโรดไอแลนด์ สหรัฐอเมริกา
US_SC_PALPASS เซาท์แคโรไลนา สหรัฐอเมริกา
US_TX_AVI_TAG เท็กซัส, สหรัฐอเมริกา
US_TX_BANCPASS เท็กซัส, สหรัฐอเมริกา
US_TX_DEL_RIO_PASS เท็กซัส, สหรัฐอเมริกา
US_TX_EFAST_PASS เท็กซัส, สหรัฐอเมริกา
US_TX_EAGLE_PASS_EXPRESS_CARD เท็กซัส, สหรัฐอเมริกา
US_TX_EPTOLL เท็กซัส, สหรัฐอเมริกา
US_TX_EZ_CROSS เท็กซัส, สหรัฐอเมริกา
US_TX_EZTAG เท็กซัส, สหรัฐอเมริกา
US_TX_FUEGO_TAG เท็กซัส, สหรัฐอเมริกา
US_TX_LAREDO_TRADE_TAG เท็กซัส, สหรัฐอเมริกา
US_TX_PLUSPASS เท็กซัส, สหรัฐอเมริกา
US_TX_TOLLTAG เท็กซัส, สหรัฐอเมริกา
US_TX_TXTAG เท็กซัส, สหรัฐอเมริกา
US_TX_XPRESS_CARD เท็กซัส, สหรัฐอเมริกา
US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD รัฐยูทาห์ สหรัฐอเมริกา
US_VA_EZPASSVA VA, สหรัฐอเมริกา
US_WA_BREEZEBY วอชิงตัน สหรัฐอเมริกา
US_WA_GOOD_TO_GO วอชิงตัน สหรัฐอเมริกา
US_WV_EZPASSWV WV, สหรัฐอเมริกา
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 เพื่อให้รายละเอียดเกี่ยวกับการแวะพักระหว่างการเดินทางนั้น ตั้งค่านี้เป็น "จริง" เมื่อคุณต้องการให้เส้นทางผ่านจุดอ้างอิงนี้โดยไม่หยุด จุดอ้างอิงจะไม่ทำให้มีการเพิ่มรายการลงในอาร์เรย์ 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 ที่มนุษย์อ่านได้ ดูรายละเอียดได้ที่ https://plus.codes