بررسی اجمالی ماتریس مسیر محاسبه، نمای کلی ماتریس مسیر محاسبه، نمای کلی ماتریس مسیر محاسبه

توسعه‌دهندگان منطقه اقتصادی اروپا (EEA)

محاسبه ماتریس مسیر روشی در سرویس Routes API است که یک درخواست HTTPS را می‌پذیرد و مسافت و زمان سفر را برای ماتریسی از مسیرها بین مکان‌های مبدا و مقصد مختلف برمی‌گرداند. زمان و مسافت سفر را برای چندین مقصد برای حداکثر ۶۲۵ عنصر مسیر محاسبه کنید.

به مسیرهای رانندگی نیاز دارید؟ اگر به مسیرهای مسیر علاقه‌مند هستید، به «مرور کلی مسیرهای محاسبه‌شده» مراجعه کنید.

مهاجرت می‌کنید؟ اگر از API Distance Matrix (Legacy) مهاجرت می‌کنید، دستورالعمل‌های مهاجرت را که با «چرا به API Routes مهاجرت کنیم» شروع می‌شوند، ببینید.

چرا از ماتریس مسیر محاسبه استفاده کنیم؟

با استفاده از Compute Route Matrix، می‌توانید کارآمدترین مسیرها را برای زمان‌بندی اعزام تعیین کنید، مانند:

  • چگونه به بهترین شکل ممکن مجموعه‌ای از کارگران را برای جمع‌آوری مجموعه‌ای از بسته‌ها اختصاص دهیم؟

  • بهترین انبار را برای ارسال بسته‌ها به مقصد نهایی خود تعیین کنید

با محاسبه ماتریس مسیر چه کارهایی می‌توان انجام داد؟

با استفاده از Compute Route Matrix، می‌توانید ماتریسی از مسیرهای ممکن بین چندین مکان شروع و پایان را بدست آورید. می‌توانید چندین مبدا و مقصد را برای هر درخواست سمت سرور مشخص کنید، به طوری که تعداد مبداها ضربدر تعداد مقصدها تا ۶۲۵ باشد. می‌توانید عناصر پاسخ را قبل از محاسبه کل ماتریس، استریم کنید و تأخیر پاسخ را کاهش دهید.

شما می‌توانید این نوع داده‌های مسیر را برای تعیین کارآمدترین روش برای مسیریابی مسافران، محموله‌ها یا کارگران بین چندین مبدا و مقصد درخواست کنید:

  • مسافت بر حسب کیلومتر یا مایل برای حالت سفر انتخاب شده

  • زمان تخمینی سفر در ترافیک

نحوه کار ماتریس مسیر محاسبه شده

متد 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'

پاسخ شامل مسیرهای ممکن برای ترکیب تمام نقاط مسیر مبدا و مقصد است.

منابع

جدول زیر منابع موجود از طریق متد Compute Route Matrix در Routes API را به همراه داده‌هایی که برمی‌گرداند، خلاصه می‌کند.

منابع داده داده‌ها بازگردانده شدند قالب بازگشتی
محاسبه مسیر ماتریس آرایه‌ای از مسیرها را از یک نقطه مبدا به یک نقطه مقصد برمی‌گرداند. جی‌سون

نحوه استفاده از محاسبه ماتریس مسیر

۱ راه‌اندازی شوید با راه‌اندازی پروژه Google Cloud خود شروع کنید و دستورالعمل‌های راه‌اندازی که در ادامه آمده است را تکمیل کنید.
۲ نحوه‌ی محاسبه‌ی هزینه‌ها توسط API مسیرها را درک کنید برای اطلاعات بیشتر، به بخش «استفاده و صورتحساب» مراجعه کنید.
۳ محاسبه ماتریس مسیرها و بررسی پاسخ برای اطلاعات بیشتر، به دریافت ماتریس مسیر و بررسی پاسخ ماتریس مسیر مراجعه کنید.

کتابخانه‌های کلاینت موجود

برای فهرستی از کتابخانه‌های کلاینت موجود برای Compute Route Matrix، به Client libraries مراجعه کنید.

قدم بعدی چیست؟