Route

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

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

object (RouteLeg)

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

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

RouteLeg

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

การแสดง JSON 
{
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "steps": [
    {
      object (RouteLegStep)
    }
  ],
  "travelAdvisory": {
    object (RouteLegTravelAdvisory)
  }
}
ช่อง
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)

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

เส้นประกอบ

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

การแสดง JSON 
{

  // Union field polyline_type can be only one of the following:
  "encodedPolyline": string,
  "geoJsonLinestring": {
    object
  }
  // End of list of possible types for union field polyline_type.
}
ช่อง
ช่องการรวม polyline_type ห่อหุ้มชนิดของเส้นประกอบ ค่าเริ่มต้นคือ encrypted_polyline polyline_type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
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)
  }
}
ช่อง
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)

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

RouteLegStepTravelAdvisory

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

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

object (SpeedReadingInterval)

ช่วงการอ่านเร็วซึ่งแสดงรายละเอียดความหนาแน่นของการจราจร ใช้ได้ในกรณีที่มีค่ากำหนดการกำหนดเส้นทาง TRAFFIC_AWARE และ TRAFFIC_AWARE_OPTIMAL ช่วงเวลาจะครอบคลุมเส้นประกอบทั้งหมดของ RouteLegStep โดยไม่มีการทับซ้อนกัน จุดเริ่มต้นของช่วงที่ระบุเหมือนกับจุดสิ้นสุดของช่วงก่อนหน้า

ตัวอย่าง

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

RouteLegTravelAdvisory

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

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

object (TollInfo)

สรุปข้อมูลเกี่ยวกับค่าผ่านทางบน RouteLeg ที่เฉพาะเจาะจง ฟิลด์นี้จะมีการป็อปปูเลตค่าในกรณีที่เราคาดว่ามีค่าผ่านทางบน RouteLeg เท่านั้น หากตั้งค่าช่องนี้แล้ว แต่ไม่ได้ใส่ช่องย่อยรายได้โดยประมาณ เราคาดว่าถนนจะมีค่าผ่านทางแต่เราไม่ทราบราคาโดยประมาณ หากไม่มีฟิลด์นี้ ก็จะไม่มีการเก็บค่าผ่านทางบน RouteLeg
speedReadingIntervals[]

object (SpeedReadingInterval)

ช่วงการอ่านเร็วซึ่งแสดงรายละเอียดความหนาแน่นของการจราจร ใช้ได้ในกรณีที่มีค่ากำหนดการกำหนดเส้นทาง TRAFFIC_AWARE และ TRAFFIC_AWARE_OPTIMAL ช่วงเวลาจะครอบคลุมเส้นประกอบทั้งหมดของ RouteLg โดยไม่มีการซ้อนทับ จุดเริ่มต้นของช่วงที่ระบุเหมือนกับจุดสิ้นสุดของช่วงก่อนหน้า

ตัวอย่าง

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