Method: computeRoutes

แสดงเส้นทางหลักพร้อมเส้นทางสำรอง (ไม่บังคับ) โดยระบุชุดจุดอ้างอิงปลายทางและจุดอ้างอิงระหว่างทาง

หมายเหตุ: วิธีนี้กำหนดให้คุณต้องระบุมาสก์ช่องการตอบกลับในอินพุต คุณระบุมาสก์ช่องการตอบกลับได้โดยใช้พารามิเตอร์ของ URL $fields หรือ fields หรือใช้ส่วนหัว HTTP/gRPC X-Goog-FieldMask (ดูพารามิเตอร์ของ URL และส่วนหัวที่ใช้ได้) ค่าคือรายการเส้นทางของฟิลด์ที่คั่นด้วยคอมมา ดูเอกสารประกอบโดยละเอียดเกี่ยวกับวิธีสร้างเส้นทางของช่อง

ตัวอย่างเช่น ในเมธอดนี้

  • ฟิลด์มาสก์ของฟิลด์ที่ใช้ได้ทั้งหมด (สำหรับการตรวจสอบด้วยตนเอง): X-Goog-FieldMask: *
  • ฟิลด์มาสก์ของระยะเวลา ระยะทาง และเส้นประกอบระดับเส้นทาง (ตัวอย่างการตั้งค่าเวอร์ชันที่ใช้งานจริง): X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

Google ไม่แนะนำให้ใช้ฟิลด์มาสก์การตอบกลับไวลด์การ์ด (*) หรือระบุฟิลด์มาสก์ที่ระดับบนสุด (routes) เนื่องจากสาเหตุต่อไปนี้

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

คำขอ HTTP

POST https://routes.googleapis.com/directions/v2:computeRoutes

URL ใช้ไวยากรณ์การแปลงรหัส gRPC

เนื้อความของคำขอ

เนื้อหาของคำขอมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON
{
  "origin": {
    object (Waypoint)
  },
  "destination": {
    object (Waypoint)
  },
  "intermediates": [
    {
      object (Waypoint)
    }
  ],
  "travelMode": enum (RouteTravelMode),
  "routingPreference": enum (RoutingPreference),
  "polylineQuality": enum (PolylineQuality),
  "polylineEncoding": enum (PolylineEncoding),
  "departureTime": string,
  "arrivalTime": string,
  "computeAlternativeRoutes": boolean,
  "routeModifiers": {
    object (RouteModifiers)
  },
  "languageCode": string,
  "regionCode": string,
  "units": enum (Units),
  "optimizeWaypointOrder": boolean,
  "requestedReferenceRoutes": [
    enum (ReferenceRoute)
  ],
  "extraComputations": [
    enum (ExtraComputation)
  ],
  "trafficModel": enum (TrafficModel),
  "transitPreferences": {
    object (TransitPreferences)
  }
}
ช่อง
origin

object (Waypoint)

ต้องระบุ จุดอ้างอิงต้นทาง

destination

object (Waypoint)

ต้องระบุ จุดอ้างอิงปลายทาง

intermediates[]

object (Waypoint)

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

travelMode

enum (RouteTravelMode)

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

routingPreference

enum (RoutingPreference)

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

polylineQuality

enum (PolylineQuality)

ไม่บังคับ ระบุค่ากำหนดสำหรับคุณภาพของเส้นประกอบ

polylineEncoding

enum (PolylineEncoding)

ไม่บังคับ ระบุการเข้ารหัสที่ต้องการสำหรับเส้นประกอบ

departureTime

string (Timestamp format)

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

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"

arrivalTime

string (Timestamp format)

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

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"

computeAlternativeRoutes

boolean

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

routeModifiers

object (RouteModifiers)

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

languageCode

string

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

regionCode

string

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

units

enum (Units)

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

optimizeWaypointOrder

boolean

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

requestedReferenceRoutes[]

enum (ReferenceRoute)

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

extraComputations[]

enum (ExtraComputation)

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

trafficModel

enum (TrafficModel)

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

transitPreferences

object (TransitPreferences)

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

เนื้อหาการตอบกลับ

v2.computeRoutes ข้อความตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON
{
  "routes": [
    {
      object (Route)
    }
  ],
  "fallbackInfo": {
    object (FallbackInfo)
  },
  "geocodingResults": {
    object (GeocodingResults)
  }
}
ช่อง
routes[]

object (Route)

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

fallbackInfo

object (FallbackInfo)

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

geocodingResults

object (GeocodingResults)

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

PolylineQuality

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

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

PolylineEncoding

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

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

ReferenceRoute

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

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

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

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

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

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

ExtraComputation

การคำนวณเพิ่มเติมที่ต้องทำขณะดำเนินการตามคำขอให้เสร็จสมบูรณ์ ทั้งนี้ อาจมีการเพิ่มค่าอื่นๆ ในอนาคต

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

เส้นทาง

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

การแสดง JSON
{
  "routeLabels": [
    enum (RouteLabel)
  ],
  "legs": [
    {
      object (RouteLeg)
    }
  ],
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "description": string,
  "warnings": [
    string
  ],
  "viewport": {
    object (Viewport)
  },
  "travelAdvisory": {
    object (RouteTravelAdvisory)
  },
  "optimizedIntermediateWaypointIndex": [
    integer
  ],
  "localizedValues": {
    object (RouteLocalizedValues)
  },
  "routeToken": string,
  "polylineDetails": {
    object (PolylineDetails)
  }
}
ช่อง
routeLabels[]

enum (RouteLabel)

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

legs[]

object (RouteLeg)

คอลเล็กชันของช่วง (กลุ่มเส้นทางระหว่างจุดอ้างอิง) ที่ประกอบกันเป็นเส้นทาง แต่ละช่วงจะสอดคล้องกับการเดินทางระหว่าง Waypoints ที่ไม่ใช่ via 2 แห่ง เช่น เส้นทางที่ไม่มีจุดอ้างอิงระหว่างทางจะมีเพียงช่วงเดียว เส้นทางที่มีจุดอ้างอิงระดับกลางที่ไม่ใช่ via 1 จุดจะมี 2 ช่วง เส้นทางที่มีจุดอ้างอิงระดับกลาง via 1 จุดจะมี 1 ช่วง ลำดับของช่วงจะตรงกับลำดับของจุดอ้างอิงจาก origin ไปยัง intermediates และไปยัง destination

distanceMeters

integer

ระยะทางการเดินทางของเส้นทางเป็นเมตร

duration

string (Duration format)

ระยะเวลาที่ต้องใช้ในการเดินทางตามเส้นทาง หากตั้งค่า routingPreference เป็น TRAFFIC_UNAWARE ค่านี้จะเหมือนกับ staticDuration หากคุณตั้งค่า routingPreference เป็น TRAFFIC_AWARE หรือ TRAFFIC_AWARE_OPTIMAL ระบบจะคำนวณค่านี้โดยพิจารณาจากสภาพการจราจร

เมื่อตั้งค่า routingPreference เป็น TRAFFIC_AWARE_OPTIMAL ระบบจะคำนวณระยะเวลาโดยใช้ความเร็วของรถยนต์นั่งส่วนบุคคลหรือความเร็วของรถบรรทุก (ระยะเวลานานขึ้น) ระบบจะใช้ความเร็วของรถบรรทุกหากตรงตามเงื่อนไขข้อใดข้อหนึ่งต่อไปนี้

ในกรณีอื่นๆ ทั้งหมด ระบบจะใช้ความเร็วของรถยนต์นั่งส่วนบุคคล แม้ว่าจะมีการระบุขนาดหรือน้ำหนักของยานพาหนะอื่นๆ ใน vehicleInfo ก็ตาม

ระยะเวลาเป็นวินาทีที่มีทศนิยมไม่เกิน 9 หลัก โดยลงท้ายด้วย "s" เช่น "3.5s"

staticDuration

string (Duration format)

ระยะเวลาการเดินทางผ่านเส้นทางโดยไม่พิจารณาสภาพการจราจร

ระยะเวลาเป็นวินาทีที่มีทศนิยมไม่เกิน 9 หลัก โดยลงท้ายด้วย "s" เช่น "3.5s"

polyline

object (Polyline)

เส้นประกอบเส้นทางโดยรวม เส้นประกอบนี้เป็นเส้นประกอบที่รวม legs ทั้งหมดเข้าด้วยกัน

description

string

คำอธิบายเส้นทาง

warnings[]

string

อาร์เรย์ของคำเตือนที่จะแสดงเมื่อแสดงเส้นทาง

viewport

object (Viewport)

กรอบล้อมรอบวิวพอร์ตของเส้นประกอบ

travelAdvisory

object (RouteTravelAdvisory)

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

optimizedIntermediateWaypointIndex[]

integer

หากคุณตั้งค่า optimizeWaypointOrder เป็น "จริง" ช่องนี้จะมีการจัดลำดับจุดอ้างอิงระหว่างทางที่เพิ่มประสิทธิภาพแล้ว ไม่เช่นนั้น ช่องนี้จะว่างเปล่า ตัวอย่างเช่น หากคุณป้อนข้อมูลต้นทาง: LA, จุดอ้างอิงกลาง: Dallas, Bangor, Phoenix, ปลายทาง: New York และลำดับจุดอ้างอิงกลางที่เพิ่มประสิทธิภาพคือ Phoenix, Dallas, Bangor ช่องนี้จะมีค่า [2, 0, 1] ดัชนีจะเริ่มต้นด้วย 0 สำหรับจุดอ้างอิงระดับกลางจุดแรกที่ระบุในอินพุต

localizedValues

object (RouteLocalizedValues)

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

routeToken

string

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

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

polylineDetails

object (PolylineDetails)

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

RouteLabel

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

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

RouteLeg

มีกลุ่มระหว่างจุดอ้างอิงที่ไม่ใช่ via

การแสดง JSON
{
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "steps": [
    {
      object (RouteLegStep)
    }
  ],
  "travelAdvisory": {
    object (RouteLegTravelAdvisory)
  },
  "localizedValues": {
    object (RouteLegLocalizedValues)
  },
  "stepsOverview": {
    object (StepsOverview)
  }
}
ช่อง
distanceMeters

integer

ระยะทางในการเดินทางของช่วงเส้นทางเป็นเมตร

duration

string (Duration format)

ระยะเวลาที่ต้องใช้ในการเดินทางในเส้นทางย่อย หากตั้งค่า routingPreference เป็น TRAFFIC_UNAWARE ค่านี้จะเหมือนกับ staticDuration หาก routingPreference เป็น TRAFFIC_AWARE หรือ TRAFFIC_AWARE_OPTIMAL ระบบจะคำนวณค่านี้โดยพิจารณาจากสภาพการจราจร

เมื่อตั้งค่า routingPreference เป็น TRAFFIC_AWARE_OPTIMAL ระบบจะคำนวณระยะเวลาโดยใช้ความเร็วของรถยนต์นั่งส่วนบุคคลหรือความเร็วของรถบรรทุก (ระยะเวลานานขึ้น) ระบบจะใช้ความเร็วของรถบรรทุกหากตรงตามเงื่อนไขข้อใดข้อหนึ่งต่อไปนี้

ในกรณีอื่นๆ ทั้งหมด ระบบจะใช้ความเร็วของรถยนต์นั่งส่วนบุคคล แม้ว่าจะมีการระบุขนาดหรือน้ำหนักของยานพาหนะอื่นๆ ใน vehicleInfo ก็ตาม

ระยะเวลาเป็นวินาทีที่มีทศนิยมไม่เกิน 9 หลัก โดยลงท้ายด้วย "s" เช่น "3.5s"

staticDuration

string (Duration format)

ระยะเวลาการเดินทางผ่านช่วงเส้นทาง ซึ่งคำนวณโดยไม่พิจารณาสภาพการจราจร

ระยะเวลาเป็นวินาทีที่มีทศนิยมไม่เกิน 9 หลัก โดยลงท้ายด้วย "s" เช่น "3.5s"

polyline

object (Polyline)

เส้นประกอบโดยรวมสำหรับช่วงนี้ซึ่งรวมเส้นประกอบของ step แต่ละรายการ

startLocation

object (Location)

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

endLocation

object (Location)

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

steps[]

object (RouteLegStep)

อาร์เรย์ของขั้นตอนที่แสดงถึงส่วนต่างๆ ภายในเส้นทางนี้ แต่ละขั้นตอนแสดงถึงคำสั่งการนำทาง 1 รายการ

travelAdvisory

object (RouteLegTravelAdvisory)

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

localizedValues

object (RouteLegLocalizedValues)

การแสดงพร็อพเพอร์ตี้ของ RouteLeg ในรูปแบบข้อความ

stepsOverview

object (StepsOverview)

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

เส้นประกอบ

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

การแสดง JSON
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "encodedPolyline": string,
  "geoJsonLinestring": {
    object
  }
  // End of mutually exclusive fields.
}
ช่อง
สรุปประเภทของเส้นประกอบ ค่าเริ่มต้นคือ encoded_polyline รายการต่อไปนี้คือช่องที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าช่องอย่างน้อย 1 ช่องในการตอบกลับ ดังนี้
encodedPolyline

string

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

geoJsonLinestring

object (Struct format)

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

สิ้นสุดฟิลด์ที่แยกกันโดยสิ้นเชิง

RouteLegStep

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

การแสดง JSON
{
  "distanceMeters": integer,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelAdvisory": {
    object (RouteLegStepTravelAdvisory)
  },
  "localizedValues": {
    object (RouteLegStepLocalizedValues)
  },
  "transitDetails": {
    object (RouteLegStepTransitDetails)
  },
  "travelMode": enum (RouteTravelMode)
}
ช่อง
distanceMeters

integer

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

staticDuration

string (Duration format)

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

ระยะเวลาเป็นวินาทีที่มีทศนิยมไม่เกิน 9 หลัก โดยลงท้ายด้วย "s" เช่น "3.5s"

polyline

object (Polyline)

เส้นประกอบที่เชื่อมโยงกับขั้นตอนนี้

startLocation

object (Location)

สถานที่เริ่มต้นของขั้นตอนนี้

endLocation

object (Location)

สถานที่สิ้นสุดของขั้นตอนนี้

navigationInstruction

object (NavigationInstruction)

วิธีการนำทาง

travelAdvisory

object (RouteLegStepTravelAdvisory)

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

localizedValues

object (RouteLegStepLocalizedValues)

การแสดงพร็อพเพอร์ตี้ของ RouteLegStep ในรูปแบบข้อความ

transitDetails

object (RouteLegStepTransitDetails)

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

travelMode

enum (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 ใช้เพื่อระบุการเปลี่ยนชื่อถนน
DESTINATION ใช้เพื่อระบุการมาถึงจุดหมายปลายทาง

RouteLegStepTravelAdvisory

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

การแสดง JSON
{
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}
ช่อง
speedReadingIntervals[]

object (SpeedReadingInterval)

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

RouteLegStepLocalizedValues

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

การแสดง JSON
{
  "distance": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}
ช่อง
distance

object (LocalizedText)

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

staticDuration

object (LocalizedText)

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

RouteLegStepTransitDetails

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

การแสดง JSON
{
  "stopDetails": {
    object (TransitStopDetails)
  },
  "localizedValues": {
    object (TransitDetailsLocalizedValues)
  },
  "headsign": string,
  "headway": string,
  "transitLine": {
    object (TransitLine)
  },
  "stopCount": integer,
  "tripShortText": string
}
ช่อง
stopDetails

object (TransitStopDetails)

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

localizedValues

object (TransitDetailsLocalizedValues)

การแสดงพร็อพเพอร์ตี้ของ RouteLegStepTransitDetails ในรูปแบบข้อความ

headsign

string

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

headway

string (Duration format)

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

ระยะเวลาเป็นวินาทีที่มีทศนิยมไม่เกิน 9 หลัก โดยลงท้ายด้วย "s" เช่น "3.5s"

transitLine

object (TransitLine)

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

stopCount

integer

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

tripShortText

string

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

TransitStopDetails

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

การแสดง JSON
{
  "arrivalStop": {
    object (TransitStop)
  },
  "arrivalTime": string,
  "departureStop": {
    object (TransitStop)
  },
  "departureTime": string
}
ช่อง
arrivalStop

object (TransitStop)

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

arrivalTime

string (Timestamp format)

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

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"

departureStop

object (TransitStop)

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

departureTime

string (Timestamp format)

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

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"

TransitStop

ข้อมูลเกี่ยวกับป้ายหยุดรถขนส่งสาธารณะ

การแสดง JSON
{
  "name": string,
  "location": {
    object (Location)
  }
}
ช่อง
name

string

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

location

object (Location)

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

TransitDetailsLocalizedValues

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

การแสดง JSON
{
  "arrivalTime": {
    object (LocalizedTime)
  },
  "departureTime": {
    object (LocalizedTime)
  }
}
ช่อง
arrivalTime

object (LocalizedTime)

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

departureTime

object (LocalizedTime)

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

LocalizedTime

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

การแสดง JSON
{
  "time": {
    object (LocalizedText)
  },
  "timeZone": string
}
ช่อง
time

object (LocalizedText)

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

timeZone

string

มีเขตเวลา ค่าคือชื่อของเขตเวลาตามที่ระบุไว้ในฐานข้อมูลเขตเวลา IANA เช่น "America/New_York"

TransitLine

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

การแสดง JSON
{
  "agencies": [
    {
      object (TransitAgency)
    }
  ],
  "name": string,
  "uri": string,
  "color": string,
  "iconUri": string,
  "nameShort": string,
  "textColor": string,
  "vehicle": {
    object (TransitVehicle)
  }
}
ช่อง
agencies[]

object (TransitAgency)

บริษัทขนส่ง (หรือหลายบริษัท) ที่ให้บริการเส้นทางขนส่งสาธารณะนี้

name

string

ชื่อเต็มของสายขนส่งสาธารณะนี้ เช่น "8 Avenue Local"

uri

string

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

color

string

สีที่ใช้กันทั่วไปในป้ายสำหรับสายนี้ แสดงเป็นเลขฐาน 16

iconUri

string

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

nameShort

string

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

textColor

string

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

vehicle

object (TransitVehicle)

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

TransitAgency

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

การแสดง JSON
{
  "name": string,
  "phoneNumber": string,
  "uri": string
}
ช่อง
name

string

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

phoneNumber

string

หมายเลขโทรศัพท์ของบริษัทขนส่งในรูปแบบระหว่างประเทศ

uri

string

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

TransitVehicle

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

การแสดง JSON
{
  "name": {
    object (LocalizedText)
  },
  "type": enum (TransitVehicleType),
  "iconUri": string,
  "localIconUri": string
}
ช่อง
name

object (LocalizedText)

ชื่อของยานพาหนะนี้ โดยขึ้นต้นด้วยตัวพิมพ์ใหญ่

type

enum (TransitVehicleType)

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

iconUri

string

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

localIconUri

string

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

TransitVehicleType

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

Enum
TRANSIT_VEHICLE_TYPE_UNSPECIFIED ไม่ได้ใช้
BUS 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 รถรางไฟฟ้า

RouteLegTravelAdvisory

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

การแสดง JSON
{
  "tollInfo": {
    object (TollInfo)
  },
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}
ช่อง
tollInfo

object (TollInfo)

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

speedReadingIntervals[]

object (SpeedReadingInterval)

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

ตัวอย่าง

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

RouteLegLocalizedValues

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

การแสดง JSON
{
  "distance": {
    object (LocalizedText)
  },
  "duration": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}
ช่อง
distance

object (LocalizedText)

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

duration

object (LocalizedText)

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

staticDuration

object (LocalizedText)

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

StepsOverview

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

การแสดง JSON
{
  "multiModalSegments": [
    {
      object (MultiModalSegment)
    }
  ]
}
ช่อง
multiModalSegments[]

object (MultiModalSegment)

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

MultiModalSegment

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

การแสดง JSON
{
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelMode": enum (RouteTravelMode),
  "stepStartIndex": integer,
  "stepEndIndex": integer
}
ช่อง
navigationInstruction

object (NavigationInstruction)

NavigationInstruction สำหรับส่วนแบบหลายโมดัล

travelMode

enum (RouteTravelMode)

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

stepStartIndex

integer

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

stepEndIndex

integer

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

วิวพอร์ต

วิวพอร์ตในรูปแบบละติจูด-ลองจิจูด ซึ่งกำหนดด้วยจุด low และ high ที่อยู่มุมตรงข้ามกัน วิวพอร์ตถือเป็นพื้นที่ปิด ซึ่งหมายรวมถึงขอบเขตของตัววิวพอร์ตเองด้วย ขอบเขตละติจูดต้องอยู่ระหว่าง -90 ถึง 90 องศา และขอบเขตลองจิจูดต้องอยู่ระหว่าง -180 ถึง 180 องศา กรณีต่างๆ ได้แก่

  • หาก low = high วิวพอร์ตจะประกอบด้วยจุดเดียวดังกล่าว

  • หาก low.longitude > high.longitude หมายความว่าช่วงลองจิจูดกลับด้าน (วิวพอร์ตข้ามเส้นลองจิจูด 180 องศา)

  • หาก low.longitude = -180 องศา และ high.longitude = 180 องศา วิวพอร์ตจะครอบคลุมลองจิจูดทั้งหมด

  • หาก low.longitude = 180 องศา และ high.longitude = -180 องศา ช่วงลองจิจูดจะว่างเปล่า

  • หาก low.latitude > high.latitude ช่วงละติจูดจะว่างเปล่า

คุณต้องระบุทั้ง low และ high และช่องที่แสดงต้องไม่ว่าง (ตามที่ระบุไว้ในคำจำกัดความข้างต้น) โดยวิวพอร์ตที่ว่างเปล่าจะทำให้เกิดข้อผิดพลาด

ตัวอย่างเช่น วิวพอร์ตนี้ครอบคลุมนิวยอร์กซิตี้ทั้งหมด

{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }

การแสดง JSON
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
ช่อง
low

object (LatLng)

ต้องระบุ จุดต่ำสุดของวิวพอร์ต

high

object (LatLng)

ต้องระบุ จุดสูงสุดของวิวพอร์ต

RouteLocalizedValues

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

การแสดง JSON
{
  "distance": {
    object (LocalizedText)
  },
  "duration": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  },
  "transitFare": {
    object (LocalizedText)
  }
}
ช่อง
distance

object (LocalizedText)

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

duration

object (LocalizedText)

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

staticDuration

object (LocalizedText)

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

transitFare

object (LocalizedText)

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

PolylineDetails

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

การแสดง JSON
{
  "tunnelInfo": [
    {
      object (TunnelInfo)
    }
  ],
  "restrictionInfo": [
    {
      object (RestrictionInfo)
    }
  ],
  "flyoverInfo": [
    {
      object (FlyoverInfo)
    }
  ],
  "narrowRoadInfo": [
    {
      object (NarrowRoadInfo)
    }
  ],
  "bridgeInfo": [
    {
      object (BridgeInfo)
    }
  ],
  "skywayInfo": [
    {
      object (SkywayInfo)
    }
  ]
}
ช่อง
tunnelInfo[]

object (TunnelInfo)

รายละเอียดอุโมงค์ตามเส้นประกอบ ระบบจะป้อนข้อมูลในช่องนี้หากคำขอระบุตัวแก้ไขเส้นทาง avoidTunnels และเส้นทางที่ได้ไม่สามารถหลีกเลี่ยงได้ หรือหากระบุ TUNNEL_INFO_ON_POLYLINE ใน extraComputations และเส้นทางมีอุโมงค์

restrictionInfo[]

object (RestrictionInfo)

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

flyoverInfo[]

object (FlyoverInfo)

รายละเอียดการบินผ่านตามเส้นประกอบ

narrowRoadInfo[]

object (NarrowRoadInfo)

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

bridgeInfo[]

object (BridgeInfo)

รายละเอียดสะพานตามเส้นประกอบ

skywayInfo[]

object (SkywayInfo)

รายละเอียดทางเดินลอยฟ้าตามเส้นประกอบ

TunnelInfo

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

การแสดง JSON
{
  "tunnelPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
ช่อง
tunnelPresence

enum (RoadFeatureState)

ระบุว่ามีอุโมงค์สำหรับเส้นประกอบที่กำหนดหรือไม่

polylinePointIndex

object (PolylinePointIndex)

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

RoadFeatureState

สรุปสถานะของลักษณะถนนตามแนวเส้นประกอบ

Enum
ROAD_FEATURE_STATE_UNSPECIFIED ระบบไม่ได้คำนวณสถานะของลักษณะถนน (ค่าเริ่มต้น)
EXISTS มีฟีเจอร์ถนนอยู่
DOES_NOT_EXIST ไม่มีองค์ประกอบถนน

PolylinePointIndex

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

การแสดง JSON
{
  "startIndex": integer,
  "endIndex": integer
}
ช่อง
startIndex

integer

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

endIndex

integer

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

RestrictionInfo

สรุปข้อมูลเกี่ยวกับข้อจำกัดต่างๆ ตามเส้นประกอบ

การแสดง JSON
{
  "restrictionPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "restrictedHeightMm": string,
  "restrictedWeightKg": string,
  "hazardousGoods": boolean,
  "trucksProhibited": boolean
  // End of mutually exclusive fields.
}
ช่อง
restrictionPresence

enum (RoadFeatureState)

เอาต์พุตเท่านั้น ระบุว่ามีข้อจำกัดสำหรับเส้นประกอบที่กำหนดหรือไม่

polylinePointIndex

object (PolylinePointIndex)

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

สรุปประเภทข้อจำกัดที่ใช้กับเส้นประกอบที่กำหนดได้ รายการต่อไปนี้คือช่องที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าช่องอย่างน้อย 1 ช่องในการตอบกลับ ดังนี้
restrictedHeightMm

string (int64 format)

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

restrictedWeightKg

string (int64 format)

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

hazardousGoods

boolean

ระบบจะตั้งค่าช่องนี้เป็น "จริง" เมื่อมีการจำกัดการขนส่งสินค้าอันตราย

trucksProhibited

boolean

ระบบจะตั้งค่าช่องนี้เป็น "จริง" เมื่อห้ามรถบรรทุกเข้า

สิ้นสุดฟิลด์ที่แยกกันโดยสิ้นเชิง

FlyoverInfo

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

การแสดง JSON
{
  "flyoverPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
ช่อง
flyoverPresence

enum (RoadFeatureState)

เอาต์พุตเท่านั้น ระบุว่ามีสะพานข้ามแยกสำหรับเส้นประกอบที่กำหนดหรือไม่

polylinePointIndex

object (PolylinePointIndex)

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

NarrowRoadInfo

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

การแสดง JSON
{
  "narrowRoadPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
ช่อง
narrowRoadPresence

enum (RoadFeatureState)

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

polylinePointIndex

object (PolylinePointIndex)

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

BridgeInfo

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

การแสดง JSON
{
  "bridgePresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
ช่อง
bridgePresence

enum (RoadFeatureState)

ระบุว่ามีสะพานสำหรับเส้นประกอบที่กำหนดหรือไม่

polylinePointIndex

object (PolylinePointIndex)

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

SkywayInfo

สรุปข้อมูลเกี่ยวกับทางเดินลอยฟ้าตามเส้นประกอบ

การแสดง JSON
{
  "skywayPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
ช่อง
skywayPresence

enum (RoadFeatureState)

ระบุว่ามีทางเชื่อมสำหรับเส้นประกอบที่กำหนดหรือไม่

polylinePointIndex

object (PolylinePointIndex)

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

GeocodingResults

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

การแสดง JSON
{
  "origin": {
    object (GeocodedWaypoint)
  },
  "destination": {
    object (GeocodedWaypoint)
  },
  "intermediates": [
    {
      object (GeocodedWaypoint)
    }
  ]
}
ช่อง
origin

object (GeocodedWaypoint)

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

destination

object (GeocodedWaypoint)

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

intermediates[]

object (GeocodedWaypoint)

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

GeocodedWaypoint

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

การแสดง JSON
{
  "geocoderStatus": {
    object (Status)
  },
  "type": [
    string
  ],
  "partialMatch": boolean,
  "placeId": string,
  "intermediateWaypointRequestIndex": integer
}
ช่อง
geocoderStatus

object (Status)

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

type[]

string

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

partialMatch

boolean

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

placeId

string

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

intermediateWaypointRequestIndex

integer

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