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 ขา เส้นทางที่มีจุดระหว่างทางระดับกลาง 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

หากตั้งค่า ComputeRoutesRequest.optimize_waypoint_order เป็น "จริง" ช่องนี้จะมีการจัดลำดับจุดอ้างอิงตัวกลางที่เพิ่มประสิทธิภาพ มิเช่นนั้น ช่องนี้จะว่างเปล่า ตัวอย่างเช่น สมมติว่าอินพุตคือ Origin: LA; Intermediates: Dallas, Bangor, Phoenix; ปลายทาง: New York และลำดับจุดอ้างอิงระหว่างกลางที่เพิ่มประสิทธิภาพแล้วคือ: ฟีนิกซ์ ดัลลัส บันกอร์ จากนั้นช่องนี้จะมีค่า [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).