محاسبه اجمالی مسیرها

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

مقدمه

محاسبه مسیرها (Compute Routes) روشی در سرویس Routes API است که یک درخواست HTTPS را می‌پذیرد و مسیر ایده‌آل بین دو مکان را برمی‌گرداند. مسیرهایی را با ترافیک لحظه‌ای برای حمل و نقل عمومی، دوچرخه‌سواری، رانندگی، وسایل نقلیه موتوری دو چرخ یا پیاده‌روی بین چندین مکان ارائه می‌دهد.

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

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

چرا از Compute Routes استفاده کنیم؟

با استفاده از Compute Routes و با طیف گسترده‌ای از جزئیات مسیر، می‌توانید وسایل نقلیه یا بسته‌های خود را مطابق با ترجیحات خود مسیریابی کنید و در عین حال هزینه و کیفیت را بهینه کنید.

با Compute Routes چه کارهایی می‌توان انجام داد؟

با متد Compute Routes در API مربوط به Routes، می‌توانید کارهای زیر را انجام دهید:

  • برای مسیرهای مختلف سفر و برای یک یا چند مقصد، مسیر دریافت کنید :

    • روش‌های حمل و نقل: حمل و نقل عمومی، رانندگی، وسایل نقلیه دو چرخ، پیاده‌روی یا دوچرخه‌سواری.

    • مجموعه‌ای از نقاط مسیر که می‌توانید برای کارآمدترین ترتیب سفر به آنها، آنها را بهینه کنید.

  • از چندین روش برای مشخص کردن مبدا، مقصد و نقاط مسیر استفاده کنید :

    • رشته‌های متنی. برای مثال: "شیکاگو، ایلینوی"، "داروین، ان‌تی، استرالیا"، "1800 آمفی‌تئاتر پارک‌وی، مانتین ویو، کالیفرنیا 94043" یا "CWF6+FWX مانتین ویو، کالیفرنیا"

    • شناسه‌های مکان

    • مختصات طول و عرض جغرافیایی، به صورت اختیاری با جهت خودرو

  • گزینه‌های مسیر خود را بر اساس نیازها و اهدافتان تنظیم کنید :

  • با درخواست فقط داده‌های مورد نیاز با استفاده از یک ماسک فیلد، تأخیر و کیفیت خود را کنترل کنید ، که به شما کمک می‌کند از زمان پردازش غیرضروری و نرخ‌های بالاتر درخواست صورتحساب جلوگیری کنید. برای جزئیات بیشتر، به بخش «انتخاب اطلاعات برای بازگشت» مراجعه کنید.

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

متد ComputeRoutes API مربوط به Routes، یک درخواست HTTP POST با بدنه درخواست JSON که شامل جزئیات درخواست است را می‌پذیرد. مقادیر مورد نیاز شامل origin، destination، travelMode و یک field mask برای مشخص کردن فیلدهایی که باید برگردانده شوند، می‌باشند.

مثال 

curl -X POST -d '{
    "origin": {
      "address": "1800 Amphitheatre Parkway, Mountain View, CA 94043"
    },
    "destination": {
      "address": "Sloat Blvd &, Upper Great Hwy, San Francisco, CA 94132"
    },
  "travelMode": "DRIVE"
  }' \
  -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
  -H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters' \
  'https://routes.googleapis.com/directions/v2:computeRoutes'

سپس سرویس مسیر درخواستی را محاسبه می‌کند و فیلدهایی را که درخواست کرده‌اید، برمی‌گرداند.

منابع

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

منابع داده داده‌ها بازگردانده شدند قالب بازگشتی
مسیرهای محاسباتی مسیرها، پایه‌ها و گام‌های یک مسیر را برمی‌گرداند و در صورت درخواست، مسیرهای جایگزین را نیز ارائه می‌دهد. جی‌سون

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

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

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

برای فهرستی از کتابخانه‌های کلاینت موجود برای مسیرهای محاسباتی، به کتابخانه‌های کلاینت مراجعه کنید.

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