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

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

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 ใช้เพื่อระบุการเปลี่ยนชื่อถนน

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

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

string

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

string

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

string

สีที่ใช้กันโดยทั่วไปในข้อความบนป้ายสำหรับสายนี้ แสดงในรูปแบบเลขฐานสิบหก
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

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

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)

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

object (PolylinePointIndex)

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

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