Routes API Overview

Routes API سرویسی است که درخواست HTTPS را می‌پذیرد و مسیر ایده‌آل بین دو مکان یا مسافت‌ها و زمان سفر را برای ماتریسی از مسیرها بین مکان‌های مبدا و مقصد مختلف برمی‌گرداند.

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

با Routes API، می‌توانید مسیرها و اطلاعات سفر را با استفاده از جزئیات حمل‌ونقل، وضعیت ترافیک و جاده به‌روز و تنظیمات برگزیده مسیر دریافت کنید:

  • نوع و قابلیت های انواع حمل و نقل

  • یک وسیله نقلیه به کدام سمت می رود

  • کنار جاده برای سوار کردن یا تحویل گرفتن

  • وضعیت ترافیک و بسته شدن جاده ها

  • نگرانی‌های ایمنی مانند اجتناب از مناطق خطرناک یا ایجاد مناطق امن برای حمل و نقل

  • تأخیر، کیفیت و هزینه را در بین نیازهای مسیریابی خود با ویژگی‌های اختیاری مانند عوارض و ابرداده سفر مانند زمان و مسافت و کارایی سوخت متعادل کنید.

همچنین می توانید کارآمدترین مسیرها را برای برنامه ریزی اعزام تعیین کنید، مانند:

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

  • بهترین انباری را که می توان بسته ها را از آنجا به مقصد نهایی ارسال کرد، تعیین کنید

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

با Routes API، می توانید دو دسته اصلی از اطلاعات مسیریابی را دریافت کنید:

  • مسیرها از یک مکان به یک یا چند مقصد

  • ماتریسی از مسیرهای ممکن بین بسیاری از مکان‌های شروع و پایان.

مسیرهایی را برای یک یا چند مقصد دریافت کنید

با روش Routes API Compute Routes ، می توانید بین مکان ها محاسبه کنید:

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

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

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

  • راه های متعدد برای تعیین مبدا، مقصد، و ایستگاه های بین راه :

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

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

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

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

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

ماتریسی از مسیرهای ممکن را دریافت کنید

روش Routes API Compute Route Matrix ماتریسی از اطلاعات برای مسیرهای توصیه شده بین چندین نقطه شروع و پایان، از جمله مسافت و زمان تخمینی رسیدن، ارائه می‌کند تا به شما کمک کند بهترین مبدا و مقصد را بر اساس نیازهای تجاری خود انتخاب کنید. می توانید این نوع داده های فاصله را درخواست کنید:

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

  • فاصله بر حسب کیلومتر یا مایل

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

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

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

شما می توانید چندین مبدا و مقصد را برای هر درخواست سمت سرور با تعداد مبدا ضربدر تعداد مقصد تا 625 مشخص کنید.

Routes API چگونه کار می کند

Routes API دو روش دارد: ComputeRoutes و ComputeRouteMatrix .

ComputeRoutes

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

مثال 

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'

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

ComputeRouteMatrix

Routes API 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 را به همراه داده هایی که برمی گرداند خلاصه می کند.

منابع داده داده ها برگردانده شد فرمت بازگشت
ComputeRoutes در صورت درخواست، مسیرها، پاها و مراحل یک مسیر را با مسیرهای جایگزین برمی‌گرداند. JSON
ComputeRouteMatrix آرایه ای از مسیرها را از یک نقطه راه مبدأ به یک نقطه بین مقصد برمی گرداند.

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

1 راه اندازی شود با راه‌اندازی پروژه Google Cloud خود شروع کنید و دستورالعمل‌های راه‌اندازی را تکمیل کنید.
2 یک مسیر را محاسبه کنید و پاسخ را مرور کنید برای اطلاعات بیشتر، به دریافت مسیر و بررسی پاسخ‌های مسیر مراجعه کنید.
3 محاسبه ماتریس مسیرها و بررسی پاسخ برای اطلاعات بیشتر، به دریافت ماتریس مسیر و بررسی پاسخ ماتریس مسیر مراجعه کنید.

کتابخانه های مشتری موجود

برای فهرستی از کتابخانه های سرویس گیرنده موجود برای Routes API، به کتابخانه های سرویس گیرنده مراجعه کنید.

بعدش چی