รับเมทริกซ์เส้นทาง

ใช้ Routes API เพื่อคำนวณระยะทางและระยะเวลาของเส้นทางสำหรับต้นทางและปลายทางหลายแห่งโดยการเรียกใช้เมธอด computeRouteMatrix (REST) หรือเมธอดสตรีมมิง ComputeRouteMatrix (gRPC)

จากรายการของต้นทางและจุดหมาย วิธีนี้จะคำนวณระยะทางและระยะเวลาของเส้นทางที่เริ่มต้นจากต้นทางแต่ละแห่งและจบที่ปลายทางแต่ละแห่ง

ขอเมทริกซ์เส้นทางขนส่งสาธารณะ

นอกจากนี้คุณยังคำนวณเมทริกซ์เส้นทางในการขนส่งสาธารณะได้อีกด้วย โปรดดูตัวอย่างที่หัวข้อรับเมทริกซ์เส้นทางขณะเดินทาง

ขีดจำกัดคำขอ

เมธอด Compute Route Matrix จะบังคับใช้ขีดจำกัดคำขอต่อไปนี้สำหรับจุดอ้างอิงที่ใช้ที่อยู่หรือรหัสสถานที่ และสำหรับองค์ประกอบ องค์ประกอบคือเส้นทางระหว่างต้นทางและปลายทางแต่ละรายการในเมทริกซ์เส้นทาง ดังนั้นจำนวนองค์ประกอบคือจำนวนของต้นทางเท่าของจำนวนจุดหมาย เช่น หากมีต้นทาง 10 แห่งและปลายทาง 10 แห่ง คุณจะมีองค์ประกอบ 100 รายการ

• จำนวนองค์ประกอบต้องไม่เกิน 625 สำหรับเส้นทางที่ไม่ใช่ TRANSIT เส้นทาง

• หากคุณระบุเส้นทาง TRANSIT จำนวนองค์ประกอบต้องไม่เกิน 100 รายการ

• หากคุณระบุ TRAFFIC_AWARE_OPTIMAL จำนวนองค์ประกอบจะไม่เกิน 100 รายการ ดูข้อมูลเพิ่มเติมเกี่ยวกับ TRAFFIC_AWARE_OPTIMAL ได้ที่หัวข้อระบุวิธีและกรณีที่จะรวมข้อมูลการเข้าชม

• ถ้าคุณระบุต้นทางหรือปลายทางโดยใช้ที่อยู่หรือรหัสสถานที่ คุณจะระบุด้วยวิธีนี้ได้รวม 50 รายการ

ข้อผิดพลาดในการตอบกลับ

ฟีเจอร์หนึ่งของเมธอด Compute Route Matrix คือระบบจะแสดงข้อผิดพลาดสำหรับการตอบกลับทั้งหมดหรือสำหรับองค์ประกอบการตอบกลับแต่ละรายการ ตัวอย่างเช่น การตอบกลับทั้งหมดมีข้อผิดพลาดหากคำขอมีรูปแบบไม่ถูกต้อง (เช่น คำขอไม่มีต้นทาง)

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

ผลการสตรีม gRPC

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

หมายเหตุ: REST API ไม่รองรับผลของสตรีม

ทั้งนี้ เราไม่รับประกันว่าองค์ประกอบที่แสดงผลโดยสตรีมจะได้รับการส่งคืนในลำดับใดๆ ดังนั้น องค์ประกอบการตอบสนองแต่ละรายการจะมี origin_index และ destination_index สำหรับต้นทางและปลายทางที่ระบุโดยคำขอ ต้นทางของเส้นทางจะเทียบเท่ากับ origins[origin_index] ขององค์ประกอบที่กำหนด และปลายทางของเส้นทางจะมีค่าเท่ากับ destinations[destination_index] อาร์เรย์เหล่านี้ไม่มีการจัดทำดัชนี การจัดเก็บลำดับในรายการต้นทางและปลายทางเป็นสิ่งสำคัญ

ตัวอย่างเมทริกซ์เส้นทาง

ใช้เมธอด computeRouteMatrix ในคำขอ HTTP เพื่อคำนวณเมทริกซ์เส้นทาง

ตัวอย่าง HTTP

ตัวอย่างต่อไปนี้แสดงคำขอ HTTP computeRouteMatrix ในตัวอย่างนี้ คุณทำสิ่งต่อไปนี้

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

  ในอาร์เรย์ องค์ประกอบแรกอยู่ที่ดัชนี 0 ส่วนที่สองคือดัชนี 1 เป็นต้น

• ใส่มาสก์ฟิลด์การตอบกลับเพื่อระบุฟิลด์ของ การตอบกลับ (REST) หรือ ComputeRoutesResponse (gRPC) ที่จะแสดง ในตัวอย่างนี้ ให้กำหนดค่าคำขอส่งคืน originIndex, destinationIndex, duration, distanceMeters, status และ condition สำหรับแต่ละเส้นทาง ดูข้อมูลเพิ่มเติมได้ที่เลือกช่องที่จะแสดง

curl -X POST -d '{
  "origins": [
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.420761,
            "longitude": -122.081356
          }
        }
      },
      "routeModifiers": { "avoid_ferries": true}
    },
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.403184,
            "longitude": -122.097371
          }
        }
      },
      "routeModifiers": { "avoid_ferries": true}
    }
  ],
  "destinations": [
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.420999,
            "longitude": -122.086894
          }
        }
      }
    },
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.383047,
            "longitude": -122.044651
          }
        }
      }
    }
  ],
  "travelMode": "DRIVE",
  "routingPreference": "TRAFFIC_AWARE"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: originIndex,destinationIndex,duration,distanceMeters,status,condition' \
'https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix'

การตอบสนองจะมี 4 เส้นทางที่เป็นไปได้สำหรับการรวมกันของจุดอ้างอิงต้นทางและปลายทางทั้งหมด

หมายเหตุ: โปรดดูคำอธิบายการตอบกลับโดยละเอียดที่หัวข้อทำความเข้าใจการตอบกลับเมทริกซ์ของ Compute Router

ระบุแต่ละเส้นทางในการตอบกลับโดยใช้ช่องคำตอบ originIndex และ destinationIndex ตัวอย่างเช่น originIndex จาก 1 ในการตอบสนองสอดคล้องกับเส้นทางที่คำนวณจากจุดอ้างอิงที่ดัชนี 1 ของอาร์เรย์ origins ในคำขอ

[
    {
        "originIndex": 0,
        "destinationIndex": 0,
        "status": {},
        "distanceMeters": 822,
        "duration": "160s",
        "condition": "ROUTE_EXISTS"
    },
    {
        "originIndex": 1,
        "destinationIndex": 0,
        "status": {},
        "distanceMeters": 2919,
        "duration": "361s",
        "condition": "ROUTE_EXISTS"
    },
    {
        "originIndex": 1,
        "destinationIndex": 1,
        "status": {},
        "distanceMeters": 5598,
        "duration": "402s",
        "condition": "ROUTE_EXISTS"
    },
    {
        "originIndex": 0,
        "destinationIndex": 1,
        "status": {},
        "distanceMeters": 7259,
        "duration": "712s",
        "condition": "ROUTE_EXISTS"
    }
]

ตัวอย่าง gRPC

เช่น คำขอ gRPC ดูตัวอย่างในตัวอย่างคำขอ gRPC ตัวอย่าง Java ในหน้านั้นเรียกทั้ง Compute Routes และ Compute Route Matrix