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