Routes API یک سرویس وب با دو روش است: Compute Routes مسیری را بین دو مکان با نقاطمسیر میانی اختیاری برمیگرداند، و Compute Route Matrix مسافت و زمان سفر را برای ترکیبی از مبدأها و مقصدها (تا ۶۲۵ عنصر مسیر) برمیگرداند.
میانای برنامهسازی کاربردی مسیرها: حقایق کلیدی
- محصول: Routes API
- با این نامها نیز شناخته میشود: Routes API v2، Compute Routes، Compute Route Matrix
- دسته: مسیرها
- پلاتفرم: سرویس وب (REST)
- اجرا در: سرور (کد پسین)
- مرحله راهاندازی: GA
- چرخه حیات: فعال
- نمای کلی: نمای کلی Routes API
- دردسترس بودن منطقهای: جهانی. مسیریابی موتورسیکلت، مسیرهای بومسازگار، و محاسبه عوارض محدود به کشورها و شهرهای پشتیبانیشده است و قلمروهای وابسته با کد CLDR خودشان پشتیبانی نمیشوند مگراینکه فهرست شده باشند. برای نشانیهای صورتحساب منطقه اقتصادی اروپا (EEA)، شرایط EEA در https://developers.google.com/maps/comms/eea/routes استفاده از شرح یا مراحل مسیر را با هر نقشهای ممنوع میکند. (جزئیات پوشش)
Routes API: when to use it
در موارد زیر از Routes API استفاده کنید:
- برای رانندگی، پیادهروی، دوچرخهسواری، موتورسواری، یا حملونقل عمومی به مسیری بین مبدأ و مقصد با نقاطمسیر میانی اختیاری نیاز دارید.
- در یک درخواست، به مسافتها و زمانهای سفر برای چندین جفت مبدأ-مقصد نیاز دارید (حداکثر ۶۲۵ عنصر).
- به تخمین هزینه عوارض (شهرهای منتخب)، مسیرهای بومسازگار (مناطق منتخب)، چندخطیهای آگاه از ترافیک، یا مسیریابی خودروهای بزرگ (دسترسی محدود) نیاز دارید.
- درحال انتقال برنامه سرور از Directions API یا Distance Matrix API قدیمی هستید.
در موارد زیر از Routes API استفاده نکنید:
- باید تخصیص بار را بهینهسازی کنید و سفارشدهی را برای کل ناوگان خودروها متوقف کنید. درعوض از Route Optimization API استفاده کنید.
- به ناوبری گامبهگام درونبرنامه در Android نیاز دارید که از مسیر محاسبهشده پیروی کند. درعوض از کیت توسعه نرمافزار ناوبری برای Android استفاده کنید.
- به ناوبری گامبهگام درونبرنامه در iOS نیاز دارید که مسیر محاسبهشده را دنبال کند. درعوض از کیت توسعه نرمافزار ناوبری برای iOS استفاده کنید.
Routes API: setup
- سرویس برای فعال کردن:
routes.googleapis.com - اصالتسنجی: کلید میانای API، OAuth 2.0، حساب سرویس
- شروع به کار: راهاندازی Routes API
- مرجع: مرجع Routes API
- قیمتگذاری: استفاده و صورتحساب Routes API
- خطمشیها: خطمشیهای Routes API
- یادداشتهای انتشار: یادداشتهای انتشار Routes API
بستههای رسمی Routes API:
- npm:
@googlemaps/routing - pypi:
google-maps-routing - برو:
cloud.google.com/go/maps - maven:
com.google.maps:google-maps-routing
میانای برنامهسازی کاربردی مسیرها: محصولات مرتبط
- جایگزین: Directions API، Distance Matrix API
- اغلب با این موارد استفاده میشود: Navigation SDK for Android، Navigation SDK for iOS، Route Optimization API، Geocoding API، Places API (New)
Routes API: اشتباهات رایج
- مشکل: فهرست پیشفرضی برای فیلدهای برگرداندهشده وجود ندارد؛ درخواستهای بدون ماسک فیلد (سرصفحه
X-Goog-FieldMaskیا پارامتر$fields) خطا برمیگردانند. راهحل: همیشه ماسک فیلدی ارسال کنید که فیلدهای پاسخ موردنیازتان را فهرست کند. /maps/documentation/routes/choose_fields را ببینید. - مشکل: استفاده از ماسک فیلد عام (
*) در تولید باعث افزایش هزینه و تأخیر میشود و با اضافه شدن ویژگیهای پیشرفته جدید به پاسخ، هزینه میتواند بهطور غیرمنتظرهای افزایش یابد. اصلاح: از*فقط درطول توسعه استفاده کنید؛ در نسخه تولید فقط فیلدهای موردنیازتان را درخواست کنید. /maps/documentation/routes/choose_fields را ببینید. - مشکل: اطلاعات عوارض و مصرف سوخت فقط با افزودن آنها به ماسک فیلد برگردانده نمیشوند؛ از زمان GA، آنها باید بهطور صریح فعال شوند. اصلاح: آرایه
extraComputations(برای مثالTOLLS،FUEL_CONSUMPTION) را علاوهبر پوشش فیلد به درخواست اضافه کنید. /maps/documentation/routes/migrate-routes-preview را ببینید. - مشکل: Compute Route Matrix ۶۲۵ عنصر را مجاز میکند، اما وقتی
routingPreferenceTRAFFIC_AWARE_OPTIMALباشد، فقط ۱۰۰ عنصر مجاز است. اصلاح: هنگام استفاده ازTRAFFIC_AWARE_OPTIMAL، مبدأها و مقصدها را روی ۱۰۰ یا کمتر نگه دارید، یا درخواست را تقسیم کنید. /maps/documentation/routes/compute_route_matrix را ببینید.
کارهایی که میتوانید با Routes API انجام دهید
برای هر تکلیف، راهنماهای پیوندشده در زیر را ببینید یا محصولات را در کاوشگر قابلیتها با یکدیگر مقایسه کنید.
- مسیرهای بین دو یا چند مختصات عرض/طول جغرافیایی را بهعنوان مجموعهای از مختصات برای هر مرحله درطول مسیر برمیگرداند.
- مسیرهای بین دو یا چند مجموعه از مختصات عرض جغرافیایی/طول جغرافیایی را بهعنوان مجموعهای از شرحهای مانور برای مراحل درطول مسیر برمیگرداند.
- فاصله بین هر مرحله درطول مسیر بین دو یا چند مجموعه مختصات عرض/طول جغرافیایی را برمیگرداند.
- مدت سفر بین هر مرحله درطول مسیر بین دو یا چند مجموعه مختصات عرض/طول جغرافیایی را برمیگرداند.
- یک چندخطی کدگذاریشده بین هر مرحله درطول مسیر بین دو یا چند مجموعه مختصات طول/عرض جغرافیایی برمیگرداند.
- فاصله مسیر بین دو یا چند مجموعه مختصات طول/عرض جغرافیایی را برمیگرداند.
- مدت سفر را برای مسیری بین دو یا چند مجموعه مختصات طول/عرض جغرافیایی برمیگرداند.
- یک چندخطی کدگذاریشده برای مسیری بین دو یا چند مجموعه مختصات عرض/طول جغرافیایی برمیگرداند.
- اطلاعات عوارض را برای مسیری بین دو یا چند مجموعه مختصات عرض/طول جغرافیایی برمیگرداند.
- حالت سفر (رانندگی، حملونقل عمومی، پیادهروی، موتورسیکلت) را برای درخواست مسیر مشخص کنید. توجه: در سرویس وب Routes API (computeRoutes)، travelMode را در بدنه HTTP POST JSON بااستفاده از RouteTravelMode (DRIVE، BICYCLE، TWO_WHEELER، WALK، TRANSIT، یا TRUCK با routeModifiers.vehicleInfo) ارسال کنید و بهجای پارامتر پُرسمان حالت GET قدیمی، سرصفحه X-Goog-FieldMask الزامی را اضافه کنید. در کتابخانه Maps JavaScript API Routes، travelMode و فیلدها را در ComputeRoutesRequest ارسال کنید.
- نقطه توقف یا عبور را برای درخواست مسیر مشخص کنید.
- مشخص کنید که دادههای ترافیک چگونه در درخواست مسیر استفاده میشوند.
- ویژگیهایی را که میخواهید از آنها اجتناب شود، مانند بزرگراهها یا عوارضیها، برای درخواست مسیر مشخص کنید.
- نقطهمسیرهایی را درطول مسیر تنظیم کنید.
- نقطهمسیرهای میانی را درطول مسیر تنظیم کنید.
- نقطهای را برای عبور مسیر تنظیم کنید.
- جهت خودرو و سمت جاده را برای مسیر مشخص کنید.
- ترتیب ایستگاهها را در مسیرتان بهینهسازی کنید.
- مسیریابی زیستمحیطی را برای درخواست مسیرها مشخص کنید. پیشدید
- مسافت کوتاهتر یا مسیریابی جایگزین را برای درخواست مسیرها مشخص کنید. توجه: در Routes API، درخواست مسیر مرجع کوتاهتر (SHORTER_DISTANCE) آزمایشی است، درحالیکه درخواست مسیرهای جایگزین (computeAlternativeRoutes) دردسترس عموم است.
- فاصلهها را برای ماتریسی از مسیرها بین چندین مبدأ و مقصد برمیگرداند.
- مدت سفر را برای ماتریسی از مسیرها بین چند مبدأ و مقصد برمیگرداند.
- اطلاعات عوارض را برای ماتریسی از مسیرها بین چند مبدأ و مقصد برمیگرداند.
- حالت سفر (رانندگی، حملونقل عمومی، پیادهروی، موتورسیکلت) را برای درخواست جدول مسیرها مشخص کنید. توجه: در سرویس وب Routes API (computeRouteMatrix)، travelMode را در بدنه HTTP POST JSON بااستفاده از RouteTravelMode (DRIVE، TWO_WHEELER، WALK، TRANSIT، یا TRUCK با origins[].routeModifiers.vehicleInfo؛ BICYCLE برای ماتریسهای مسیر پشتیبانی نمیشود) ارسال کنید و سرصفحه X-Goog-FieldMask الزامی را اضافه کنید. در کتابخانه Maps JavaScript API Routes، travelMode و فیلدها را در ComputeRouteMatrixRequest ارسال کنید.