بررسی اجمالی ماتریس مسیر محاسبه، نمای کلی ماتریس مسیر محاسبه، نمای کلی ماتریس مسیر محاسبه
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
توسعه دهندگان منطقه اقتصادی اروپا (EEA). Compute Route Matrix روشی در سرویس Routes API است که درخواست HTTPS را می‌پذیرد و مسافت‌ها و زمان سفر را برای ماتریسی از مسیرها بین مکان‌های مبدا و مقصد مختلف برمی‌گرداند. محاسبه زمان سفر و مسافت برای چندین مقصد تا 625 عنصر مسیر.
آیا به مسیرهای رانندگی نیاز دارید؟ اگر به مسیرهای مسیر علاقه دارید، به بررسی اجمالی محاسبه مسیرها مراجعه کنید.
مهاجرت؟ اگر از Distance Matrix API (Legacy) مهاجرت می‌کنید، دستورالعمل‌های انتقال را ببینید که با Why migre to Routes API شروع می‌شود.
چرا از Compute Route Matrix استفاده کنیم؟
با Compute Route Matrix می‌توانید کارآمدترین مسیرها را برای زمان‌بندی اعزام تعیین کنید، مانند:
با Compute Route Matrix چه کاری می توانید انجام دهید؟
با Compute Route Matrix، می‌توانید ماتریسی از مسیرهای ممکن بین بسیاری از مکان‌های شروع و پایان دریافت کنید. می‌توانید در هر درخواست سمت سرور چندین مبدا و مقصد را با تعداد مبدا ضربدر تعداد مقصدها تا 625 مشخص کنید. می‌توانید عناصر پاسخ را قبل از محاسبه کل ماتریس پخش کنید و تأخیر پاسخ را کاهش دهید.
می‌توانید این نوع داده‌های مسیر را برای تعیین کارآمدترین راه برای مسیریابی مسافران، محموله‌ها یا کارگران بین مبدا و مقصد مختلف درخواست کنید:
نحوه عملکرد ماتریس مسیر محاسبه
متد ComputeRouteMatrix یک درخواست HTTP POST با بدنه درخواست JSON که حاوی جزئیات درخواست است می پذیرد. حداقل یک مبدأ، دو یا چند مقصد، 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' پاسخ شامل مسیرهای احتمالی برای ترکیب همه ایستگاه های مسیر مبدا و مقصد است.
منابع
جدول زیر منابع موجود از طریق روش Routes API Compute Route Matrix را به همراه داده هایی که برمی گرداند خلاصه می کند.
| منابع داده | داده ها برگردانده شد | فرمت بازگشت |
|---|
| ComputeRouteMatrix | آرایه ای از مسیرها را از یک نقطه راه مبدأ به یک نقطه بین مقصد برمی گرداند. | JSON |
نحوه استفاده از Compute Route Matrix
کتابخانه های مشتری موجود
برای فهرستی از کتابخانه های سرویس گیرنده موجود برای Compute Route Matrix، به کتابخانه های Client مراجعه کنید.
بعدش چی
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-06-20 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-06-20 بهوقت ساعت هماهنگ جهانی."],[],[],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)"]]
