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

คำขอเมทริกซ์เส้นทางจะรับอาร์เรย์ของจุดอ้างอิงต้นทางและปลายทางเป็นอินพุต จากนั้น 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 ในอาร์เรย์อินพุต

เกี่ยวกับการตอบกลับ

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

นอกจากพร็อพเพอร์ตี้ originIndex และ destinationIndex แล้ว แต่ละเส้นทางยังมีข้อมูลเฉพาะสำหรับเส้นทางนั้นๆ เช่น distanceMeters, duration และ travelAdvisory

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

[
  // 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)
    }
  }
  …
]