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

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

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

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

เกี่ยวกับฟิลด์มาสก์

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

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

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

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

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

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 จะมีอาร์เรย์ โดยที่องค์ประกอบอาร์เรย์แต่ละรายการจะกำหนดเส้นทางจากจุดเริ่มต้น 1 จุดไปยังจุดหมาย 1 จุด

นอกเหนือจากพร็อพเพอร์ตี้ 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)
    }
  }
  …
]