ดูการตอบกลับเมทริกซ์เส้นทาง

คำขอเมทริกซ์เส้นทางจะใช้อาร์เรย์ของจุดแวะพักต้นทางและปลายทางเป็นอินพุต จากนั้น Routes API จะคำนวณเส้นทางจากจุดแวะพักต้นทางแต่ละจุดไปยังจุดแวะพักปลายทางแต่ละจุด ตัวอย่างเช่น หากคุณระบุจุดแวะพักต้นทาง 2 จุดและจุดแวะพักปลายทาง 2 จุด API จะคำนวณเส้นทางแยกกัน 4 เส้นทาง

การตอบกลับของ API จะมีอาร์เรย์ ซึ่งองค์ประกอบอาร์เรย์แต่ละรายการจะสอดคล้องกับเส้นทางจากจุดแวะพักต้นทางหนึ่งจุดไปยังจุดแวะพักปลายทางหนึ่งจุด ดังนั้น หากคุณระบุจุดแวะพักต้นทาง 2 จุดและจุดแวะพักปลายทาง 2 จุด อาร์เรย์การตอบกลับจะมีองค์ประกอบ 4 รายการ ซึ่งแต่ละรายการจะแสดงเส้นทางที่คำนวณได้

การใช้การตอบกลับจะช่วยให้คุณสามารถเสนอตัวเลือกเส้นทางต่างๆ ให้ลูกค้า แล้วให้ผู้ใช้เลือกเส้นทางที่เหมาะสมกับความต้องการ

เกี่ยวกับมาสก์ของช่อง

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

ตัวอย่างในเอกสารนี้แสดงออบเจ็กต์การตอบกลับทั้งหมดโดยไม่พิจารณามาสก์ของช่อง ในสภาพแวดล้อมฮาร์ดแวร์และซอฟต์แวร์ การตอบกลับจะมีเฉพาะช่องที่คุณระบุอย่างชัดเจนในมาสก์ของช่องเท่านั้น

ดูข้อมูลเพิ่มเติมได้ที่ เลือกว่าจะให้แสดงข้อมูลใด

เกี่ยวกับการแสดงลิขสิทธิ์

คุณต้องใส่ข้อความเกี่ยวกับลิขสิทธิ์ต่อไปนี้เมื่อแสดงผลการค้นหาแก่ผู้ใช้

Powered by Google, ©YEAR Google

เช่น

Powered by Google, ©2023 Google

ระบุเส้นทางในการตอบกลับ

ใช้พร็อพเพอร์ตี้การตอบกลับ originIndex และ destinationIndex เพื่อระบุเส้นทางแต่ละเส้นทางในการตอบกลับ พร็อพเพอร์ตี้เหล่านี้มีดัชนีฐาน 0 ของจุดแวะพักต้นทาง และปลายทาง ที่ใช้คำนวณเส้นทาง ซึ่งหมายความว่าจุดแวะพักต้นทางจุดแรกและจุดแวะพักปลายทางจุดแรกในคำขอจะอยู่ที่ดัชนีอาร์เรย์ 0

ตัวอย่างเช่น เส้นทางในการตอบกลับจะมีข้อมูลต่อไปนี้

"originIndex": 1,
"destinationIndex": 0

พร็อพเพอร์ตี้เหล่านี้ระบุว่าเส้นทางคำนวณจากจุดแวะพักต้นทางที่ดัชนี 1 ในอาร์เรย์อินพุต และจากจุดแวะพักปลายทางที่ดัชนี 0

สำหรับเส้นทางถัดไป

"originIndex": 4,
"destinationIndex": 1

เส้นทางคำนวณจากจุดแวะพักต้นทางที่ดัชนี 4 ในอาร์เรย์อินพุต และจากจุดแวะพักปลายทางที่ดัชนี 1 ในอาร์เรย์อินพุต

เกี่ยวกับข้อมูลเส้นทางในการตอบกลับ

การตอบกลับของ API จะมีอาร์เรย์ ซึ่งองค์ประกอบอาร์เรย์แต่ละรายการจะกำหนดเส้นทางจากจุดอ้างอิงต้นทางหนึ่งจุดไปยังจุดอ้างอิงปลายทางหนึ่งจุด องค์ประกอบเหล่านี้คือ RouteMatrixElements ในเมธอด gRPC หรือ เนื้อหาการตอบกลับ ใน การตอบกลับ HTTP

องค์ประกอบแต่ละรายการจะมีเฉพาะข้อมูลพื้นฐานที่เฉพาะเจาะจงกับเส้นทางนั้นๆ เช่น distanceMeters, duration และ travelAdvisory นอกเหนือจากพร็อพเพอร์ตี้ originIndex และ destinationIndex หากต้องการดูข้อมูลโดยละเอียดเพิ่มเติมเกี่ยวกับเส้นทาง เช่น เส้นประกอบ ให้ใช้ computeRoutes

การตอบกลับจะมีรูปแบบดังนี้

[
  // One array element for each combination of origin and destination waypoints.
  {
    // The route for source waypoint 0 and destination waypoint 0.
    "originIndex": 0,
    "destinationIndex": 0,
    "status": {
      object (Status)
    },
    "condition": enum (RouteMatrixElementCondition),
    "distanceMeters": integer,
    "duration": string,
    "staticDuration": string,
    "travelAdvisory": {
      object (RouteTravelAdvisory)
    },
    "fallbackInfo": {
      object (FallbackInfo)
    }
  }
  {
    // The route for source waypoint 0 and destination waypoint 1.
    "originIndex": 0,
    "destinationIndex": 1,
    "status": {
      object (Status)
    },
    "condition": enum (RouteMatrixElementCondition),
    "distanceMeters": integer,
    "duration": string,
    "staticDuration": string,
    "travelAdvisory": {
      object (RouteTravelAdvisory)
    },
    "fallbackInfo": {
      object (FallbackInfo)
    }
  }
  …
]