نمای کلی Compute Routes

مقدمه

«محاسبه مسیرها» روشی در سرویس Routes API است که درخواست HTTPS را می‌پذیرد و مسیر ایده‌آل بین دو مکان را برمی‌گرداند. مسیرها را با ترافیک هم‌زمان برای حمل‌ونقل عمومی، دوچرخه‌سواری، رانندگی، وسایل نقلیه موتوری ۲ چرخ، یا پیاده‌روی بین چند مکان ارائه می‌دهد.

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

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

چرا باید از Compute Routes استفاده کرد

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

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

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

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

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

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

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

  • رشته‌های نوشتاری. برای مثال: «Chicago, IL»، «Darwin, NT, Australia»، «1800 Amphitheatre Parkway, Mountain View, CA 94043»، یا «CWF6+FWX Mountain View, California»

  • شناسه‌های جا

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

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

  • با مشخص کردن ویژگی‌های خودرو مانند ابعاد، وزن، و مواد خطرناک، مسیرها را برای کامیون‌ها و سایر خودروهای بزرگ سفارشی‌سازی کنید. برای جزئیات، به نمای کلی مسیریابی خودروهای بزرگ مراجعه کنید.

  • مسیرهای با بهره‌وری سوخت یا انرژی را برای نوع موتور خودروتان انتخاب کنید: دیزلی، برقی، هیبریدی، بنزینی. برای اطلاعات بیشتر، به دریافت مسیر بوم‌سازگار مراجعه کنید.

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

  • برای افزایش دقت زمان تخمینی رسیدن، جهت خودرو (جهت حرکت) و اطلاعات کنار جاده را برای نقطه‌مسیرها تنظیم کنید. برای جزئیات، مشخص کردن جهت خودرو و سمت جاده را ببینید.

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

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

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

نحوه عملکرد Compute Routes

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

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'

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

منابع

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

نحوه استفاده از Compute Routes

کتابخانه‌های کارخواه دردسترس

برای مشاهده فهرست کتابخانه‌های مشتری دردسترس برای Compute Routes، به کتابخانه‌های مشتری مراجعه کنید.

قدم بعدی چیست

• دریافت مسیر
• گزینه‌های مسیر دردسترس
• انتخاب اطلاعاتی که باید برگردانده شود
• انتقال از Directions API (قدیمی)
• انتقال از پیش‌نمایش Routes API به GA