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 และมีเพียง 1 เส้นทางเมื่อคุณไม่ได้ระบุ เมื่ออาร์เรย์นี้มีหลายรายการ รายการแรกคือเส้นทางที่แนะนำมากที่สุด หากอาร์เรย์ว่างเปล่า แสดงว่าไม่พบเส้นทาง
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 fieldmask เพื่อแสดงข้อมูลนี้ ปัจจุบันระบบจะป้อนข้อมูลนี้สำหรับเมืองใหญ่บางแห่งในอินเดียเท่านั้น ฟีเจอร์นี้ยังอยู่ในขั้นทดลองและ SKU/การเรียกเก็บเงินอาจมีการเปลี่ยนแปลง
NARROW_ROAD_INFO_ON_POLYLINE ข้อมูลถนนแคบสำหรับเส้นทาง ต้องระบุ routes.polyline_details.narrow_road_info fieldmask เพื่อแสดงข้อมูลนี้ ปัจจุบันระบบจะป้อนข้อมูลนี้สำหรับเมืองใหญ่บางแห่งในอินเดียเท่านั้น ฟีเจอร์นี้ยังอยู่ในขั้นทดลองและ SKU/การเรียกเก็บเงินอาจมีการเปลี่ยนแปลง
TUNNEL_INFO_ON_POLYLINE ข้อมูลอุโมงค์สำหรับเส้นทาง ต้องระบุ routes.polyline_details.tunnel_info fieldmask เพื่อแสดงข้อมูลนี้
BRIDGE_INFO_ON_POLYLINE ข้อมูลสะพานสำหรับเส้นทาง ต้องระบุ routes.polyline_details.bridge_info fieldmask เพื่อแสดงข้อมูลนี้
SKYWAY_INFO_ON_POLYLINE ข้อมูลเกี่ยวกับทางด่วนสำหรับเส้นทาง ต้องระบุ routes.polyline_details.skyway_info fieldmask เพื่อแสดงข้อมูลนี้

เส้นทาง

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

การแสดง 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)

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

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

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

ระยะเวลาเป็นวินาทีที่มีเศษทศนิยมได้สูงสุด 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)

ระบุเส้นหลายเส้นโดยใช้รูปแบบ GeoJSON LineString
สิ้นสุดฟิลด์ที่แยกกัน

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)

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

Maneuver

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

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

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

string

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

boolean

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

string

รหัสสถานที่ของผลลัพธ์นี้
intermediateWaypointRequestIndex

integer

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