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

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

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

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

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

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

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

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

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

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

Powered by Google, ©YEAR Google

เช่น

Powered by Google, ©2023 Google

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

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