Method: computeRoutes

แสดงผลเส้นทางหลักระหว่างต้นทางและปลายทางที่ขอสำหรับโหมดการเดินทางที่ขอ

คำขอ HTTP

POST https://mapstools.googleapis.com/v1:computeRoutes

URL ใช้ไวยากรณ์การแปลงรหัส gRPC

เนื้อความของคำขอ

เนื้อหาของคำขอมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "origin": {
    object (Waypoint)
  },
  "destination": {
    object (Waypoint)
  },
  "travelMode": enum (RouteTravelMode),
  "intermediateWaypoints": [
    {
      object (Waypoint)
    }
  ],
  "routingPreference": enum (RoutingPreference),
  "locationBias": {
    object (LatLng)
  },
  "includePolyline": boolean,
  "computeAlternativeRoutes": boolean,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "departureTime": string,
  "arrivalTime": string
  // End of mutually exclusive fields.
}
ช่อง
origin

object (Waypoint)

ต้องระบุ จุดอ้างอิงต้นทาง
destination

object (Waypoint)

ต้องระบุ จุดอ้างอิงปลายทาง
travelMode

enum (RouteTravelMode)

ไม่บังคับ ระบุรูปแบบการเดินทาง
intermediateWaypoints[]

object (Waypoint)

ไม่บังคับ จุดแวะพักระหว่างต้นทางและปลายทางที่ต้องผ่านตามลำดับ รองรับจุดอ้างอิงระหว่างทางสูงสุด 25 จุด

การระบุจุดอ้างอิงระดับกลางมากกว่า 10 จุดจะทำให้มีค่าใช้จ่ายและเวลาในการตอบสนองสูงขึ้น ระบบไม่รองรับจุดอ้างอิงระดับกลางเมื่อ travelMode เป็น TRANSIT
routingPreference

enum (RoutingPreference)

ไม่บังคับ กำหนดวิธีใช้ข้อมูลการจราจรเพื่อคำนวณเส้นทาง ไม่รองรับ ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL เมื่อ travelMode เป็น WALK หรือ BICYCLE สำหรับ TRANSIT จะเปิดใช้ข้อมูลขนส่งสาธารณะแบบเรียลไทม์ เช่น ความล่าช้าและการยกเลิก
locationBias

object (LatLng)

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

boolean

ไม่บังคับ ระบุว่าจะรวมเส้นประกอบที่เข้ารหัสไว้ในเส้นทางการตอบกลับหรือไม่ ค่าเริ่มต้นคือ false เมื่อตั้งค่าเป็น true ระบบจะแสดงผล Route.encoded_polyline
computeAlternativeRoutes

boolean

ไม่บังคับ เลือกว่าจะคำนวณเส้นทางอื่นนอกเหนือจากเส้นทางที่แนะนำหรือไม่ ค่าเริ่มต้นคือ "เท็จ" ซึ่งในกรณีนี้ระบบจะแสดงเฉพาะเส้นทางที่แนะนำ เมื่อตั้งค่าเป็น "จริง" ระบบจะแสดงผลเส้นทางที่ใช้ได้ทั้งหมด แม้ว่าอาจไม่มีทางเลือกอื่นสำหรับคำขอทั้งหมดก็ตาม
ระบุเวลาที่ต้องการออกเดินทางจากต้นทางหรือถึงจุดอ้างอิงสุดท้าย ค่าเริ่มต้นจะเป็นการออกเดินทาง ณ เวลาปัจจุบัน หากไม่ได้ระบุไว้ สำหรับ TRANSIT เวลาต้องไม่เกิน 7 วันในอดีตและไม่เกิน 100 วันในอนาคต สำหรับรูปแบบการเดินทางอื่นๆ เวลาต้องไม่เป็นเวลาในอดีตและต้องไม่เกิน 365 วันในอนาคต รายการต่อไปนี้คือช่องที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าช่องอย่างน้อย 1 ช่องในการตอบกลับ ดังนี้
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"
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"
สิ้นสุดฟิลด์ที่แยกกัน

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ ComputeRoutesResponse

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/maps-platform.mapstools