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

หมายเหตุ: ปัจจุบันช่องนี้ไม่มีข้อมูล

RouteLegTravelAdvisory

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

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

object (TollInfo)

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

object (SpeedReadingInterval)

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

ตัวอย่าง

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