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

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

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

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

หมายเหตุ: เมทริกซ์เส้นทางจะไม่แสดงข้อมูลเส้นทางโดยละเอียด เช่น ขา ก้าว และเส้นประกอบของเส้นทาง หากต้องการรับข้อมูลเส้นทางโดยละเอียด ให้ส่งต้นทางและปลายทางเดียวไปยัง เส้นทางการประมวลผล

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

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

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

โปรดดูข้อมูลเพิ่มเติมที่หัวข้อเลือกข้อมูลที่จะแสดง

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

คุณต้องใส่คำชี้แจงลิขสิทธิ์ต่อไปนี้เมื่อแสดงผลลัพธ์ให้แก่ผู้ใช้

Powered by Google, ©YEAR Google

เช่น

Powered by Google, ©2023 Google

ระบุเส้นทางในคำตอบ

ใช้พร็อพเพอร์ตี้การตอบกลับ originIndex และ destinationIndex เพื่อระบุแต่ละเส้นทางในคำตอบ พร็อพเพอร์ตี้เหล่านี้มีดัชนีแบบฐานศูนย์ของจุดอ้างอิง origin อินพุตและจุดอ้างอิง destination ของอินพุตที่ใช้ในการคำนวณเส้นทาง ซึ่งหมายความว่าจุดอ้างอิงต้นทางแรกและจุดอ้างอิงปลายทางแรกในคำขออยู่ที่ดัชนีอาร์เรย์ 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)
    }
  }
  …
]