ภาพรวมเมทริกซ์เส้นทางของ Compute
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
นักพัฒนาแอปในเขตเศรษฐกิจยุโรป (EEA)
Compute Route Matrix เป็นเมธอดในบริการ Routes API ที่ยอมรับคำขอ HTTPS และแสดงระยะทางและเวลาในการเดินทางสำหรับเมทริกซ์ของเส้นทางระหว่างต้นทางและปลายทางที่แตกต่างกัน คำนวณเวลาในการเดินทางและระยะทางสำหรับหลายๆ จุดหมายปลายทางได้สูงสุด 625 องค์ประกอบของเส้นทาง
หากต้องการเส้นทางการขับขี่ หากสนใจเส้นทาง โปรดดูภาพรวม Compute Routes
กำลังย้ายข้อมูลใช่ไหม หากคุณย้ายข้อมูลจาก Distance Matrix API (เดิม) โปรดดูวิธีการย้ายข้อมูลโดยเริ่มจากหัวข้อ
เหตุผลที่ควรย้ายข้อมูลไปใช้ Routes API
เหตุผลที่ควรใช้เมทริกซ์เส้นทาง Compute
เมื่อใช้ Compute Route Matrix คุณจะกำหนดเส้นทางที่มีประสิทธิภาพมากที่สุด
สำหรับการจัดกำหนดการส่งได้ เช่น
สิ่งที่คุณทำได้ด้วยเมทริกซ์เส้นทางการคำนวณ
เมื่อใช้ Compute Route Matrix คุณจะได้รับเมทริกซ์ของเส้นทางที่เป็นไปได้
ระหว่างจุดเริ่มต้นและจุดสิ้นสุดหลายแห่ง คุณระบุต้นทางและปลายทางได้หลายรายการต่อคำขอฝั่งเซิร์ฟเวอร์ โดยมีจำนวนต้นทางคูณด้วยจำนวนปลายทางสูงสุด 625 รายการ คุณสามารถสตรีมองค์ประกอบของการตอบกลับก่อนที่ระบบจะคำนวณเมทริกซ์ทั้งหมด ซึ่งจะช่วยลดเวลาในการตอบสนอง
คุณขอข้อมูลเส้นทางประเภทนี้เพื่อพิจารณาวิธีที่มีประสิทธิภาพมากที่สุดในการ
กำหนดเส้นทางผู้โดยสาร การจัดส่ง หรือคนทำงานระหว่างต้นทางและปลายทางหลายแห่งได้
วิธีการทำงานของเมทริกซ์เส้นทางของ Compute
ComputeRouteMatrix เมธอดจะยอมรับคำขอ HTTP POST ที่มี
ส่วนเนื้อหาของคำขอ JSON ซึ่งมีรายละเอียดคำขอ ต้องมีต้นทางอย่างน้อย 1 แห่ง ปลายทางตั้งแต่ 2 แห่งขึ้นไป travelMode และฟิลด์มาสก์เพื่อระบุฟิลด์ที่จะแสดง
ตัวอย่าง
curl -X POST -d '{
"origins": [
{
"waypoint": {
"location": {
"latLng": {
"latitude": 37.420761,
"longitude": -122.081356
}
}
}
},
{
"waypoint": {
"location": {
"latLng": {
"latitude": 37.403184,
"longitude": -122.097371
}
}
}
}
],
"destinations": [
{
"waypoint": {
"location": {
"latLng": {
"latitude": 37.420999,
"longitude": -122.086894
}
}
}
},
{
"waypoint": {
"location": {
"latLng": {
"latitude": 37.383047,
"longitude": -122.044651
}
}
}
}
],
"travelMode": "DRIVE"
}' \
-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'
การตอบกลับมีเส้นทางที่เป็นไปได้สำหรับการรวมจุดอ้างอิงต้นทาง
และปลายทางทั้งหมด
แหล่งข้อมูล
ตารางต่อไปนี้สรุปทรัพยากรที่มีผ่านเมธอด Compute Route Matrix ของ Routes API พร้อมกับข้อมูลที่เมธอดส่งคืน
| แหล่งข้อมูล |
ข้อมูลที่แสดงผล |
รูปแบบการแสดงผล |
| ComputeRouteMatrix |
แสดงผลอาร์เรย์ของเส้นทางจากจุดอ้างอิงต้นทางไปยังจุดอ้างอิงปลายทาง
|
JSON |
วิธีใช้เมทริกซ์เส้นทางของ Compute
ไลบรารีของไคลเอ็นต์ที่พร้อมใช้งาน
ดูรายการไลบรารีของไคลเอ็นต์ที่พร้อมใช้งานสำหรับ
เมทริกซ์เส้นทางของ Compute ได้ที่
ไลบรารีของไคลเอ็นต์
ขั้นตอนถัดไป
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-09-04 UTC
[null,null,["อัปเดตล่าสุด 2025-09-04 UTC"],[],[],null,["# Compute Route Matrix Overview\n\n**European Economic Area (EEA) developers** If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](/maps/comms/eea/faq).\n\nCompute Route Matrix is a method in the Routes API service that accepts\nan HTTPS request and returns distances and travel times for a matrix of routes\nbetween different origin and destination locations. Calculate travel times and\ndistances for multiple destinations for up to 625 route elements.\n\n**Need Driving Routes?** If you are interested in route directions, see\n[Compute Routes Overview](/maps/documentation/routes/compute-route-over).\n\n**Migrating?** If you are migrating from the Distance Matrix API (Legacy),\nsee migration instructions starting with\n[Why migrate to the Routes API](/maps/documentation/routes/migrate-routes-why).\n\nWhy use Compute Route Matrix\n----------------------------\n\nWith Compute Route Matrix, you can determine the most efficient\nroutes for dispatch scheduling, such as:\n\n- How best to assign a set of workers to pick up a series of packages\n\n- Determine the best warehouse from which to ship packages to their final\n destination\n\nWhat you can do with Compute Route Matrix?\n------------------------------------------\n\nWith Compute Route Matrix, you can get a matrix of possible routes\nbetween many start and end locations. You can specify multiple origins and\ndestinations per server-side request with the number of origins times the number\nof destinations up to 625. You can stream elements of the response before the\nentire matrix has been calculated, lowering response latency.\n\nYou can request these kinds of route data to determine the most efficient way to\nroute passengers, shipments, or workers between multiple origins and\ndestinations:\n\n- **Distance in kilometers or miles for a selected travel mode**\n\n- **Estimated travel time in traffic**\n\nHow Compute Route Matrix works\n------------------------------\n\nThe `ComputeRouteMatrix` method accepts an HTTP POST request with\na JSON request body that contains the request details. Required are at least one\norigin, two or more destinations, travelMode, and a field mask to specify which\nfields to return. \n\n#### Example\n\n```console\ncurl -X POST -d '{\n \"origins\": [\n {\n \"waypoint\": {\n \"location\": {\n \"latLng\": {\n \"latitude\": 37.420761,\n \"longitude\": -122.081356\n }\n }\n }\n },\n {\n \"waypoint\": {\n \"location\": {\n \"latLng\": {\n \"latitude\": 37.403184,\n \"longitude\": -122.097371\n }\n }\n }\n }\n ],\n \"destinations\": [\n {\n \"waypoint\": {\n \"location\": {\n \"latLng\": {\n \"latitude\": 37.420999,\n \"longitude\": -122.086894\n }\n }\n }\n },\n {\n \"waypoint\": {\n \"location\": {\n \"latLng\": {\n \"latitude\": 37.383047,\n \"longitude\": -122.044651\n }\n }\n }\n }\n ],\n \"travelMode\": \"DRIVE\"\n}' \\\n-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: \u003cvar translate=\"no\"\u003eYOUR_API_KEY\u003c/var\u003e' \\\n-H 'X-Goog-FieldMask: originIndex,destinationIndex,duration,distanceMeters,status,condition' \\\n'https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix'\n```\n\nThe response contains the possible routes for the combination of all origin\nand destination waypoints.\n\n### Resources\n\nThe following table summarizes the resources available through the\nRoutes API Compute Route Matrix method, along with\nthe data it returns.\n\n\u003cbr /\u003e\n\n| Data resources | Data returned | Return format |\n|-----------------------------------------------------------------------|----------------------------------------------------------------------------------|---------------|\n| [ComputeRouteMatrix](/maps/documentation/routes/compute_route_matrix) | Returns an array of routes from one origin waypoint to one destination waypoint. | JSON |\n\n\u003cbr /\u003e\n\nHow to use Compute Route Matrix\n-------------------------------\n\n|---|------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 1 | **Get set up** | Start with [Set up your Google Cloud project](/maps/documentation/routes/cloud-setup) and complete the setup instructions that follow. |\n| 2 | **Understand how the Routes API bills** | For information, see [Usage and billing](/maps/documentation/routes/usage-and-billing). |\n| 3 | **Compute matrix of routes and review the response** | For more information, see [Get a route matrix](/maps/documentation/routes/compute_route_matrix) and [Review the route matrix response](/maps/documentation/routes/understand-rm-response). |\n\n### Available client libraries\n\nFor a list of the available client libraries for\nCompute Route Matrix, see\n[Client libraries](/maps/documentation/routes/client-libraries).\n\nWhat's next\n-----------\n\n- [Get a route matrix](/maps/documentation/routes/compute_route_matrix)\n- [Available route matrix options](/maps/documentation/routes/options-rm)\n- [Choose what information to return](/maps/documentation/routes/choose_fields-rm)\n- [Migrate from Distance Matrix API (Legacy)](/maps/documentation/routes/migrate-routes)\n- [Migrate from the Routes API preview to GA](/maps/documentation/routes/migrate-routes-preview)"]]
