Directions API (Legacy) یک سرویس وب است که مسیرهای بین مکانها را برای رانندگی، پیادهروی، دوچرخهسواری، و حملونقل عمومی، ازجمله مسیرهای چندبخشی با نقطهمسیرها، محاسبه میکند و مسیرها، بخشها، و مراحل را در قالب JSON یا XML برمیگرداند. در وضعیت «قدیمی» است: از اکتبر ۲۰۲۶ نمیتوان آن را برای پروژههای جدید Google Cloud فعال کرد؛ به Routes API منتقل شوید.
Directions API: حقایق کلیدی
- محصول: Directions API
- با این نام هم شناخته میشود: Directions API (قدیمی)
- دسته: مسیرها
- پلاتفرم: سرویس وب (REST)
- اجرا در: سرور (کد پسین)
- مرحله راهاندازی: GA
- چرخه حیات: قدیمی
- جایگزینشده با: Routes API
- نمای کلی: نمای کلی Directions API
- دردسترس بودن منطقهای: جهانی. پوشش بسته به منطقه و حالت سفر متفاوت است (حملونقل عمومی به دادههای ارائهدهندگان حملونقل عمومی بستگی دارد). (جزئیات پوشش)
Directions API: زمان استفاده از آن
در شرایط زیر از Directions API استفاده کنید:
- شما پروژه Google Cloud موجودی را نگهداری میکنید که ازقبل Directions API (قدیمی) در آن فعال است و
maps/api/directionsرا فراخوانی میکند. - در پروژه موجود، به مسیرهای سمت سرور برای رانندگی، پیادهروی، دوچرخهسواری، یا حملونقل عمومی (نقاطمسیر فقط برای حالتهای غیرحملونقل عمومی) در JSON یا XML نیاز دارید.
در موارد زیر از Directions API استفاده نکنید:
- درحال شروع پروژه Google Cloud جدیدی هستید؛ از اکتبر ۲۰۲۶، Directions API (قدیمی) را نمیتوان برای پروژههای جدید فعال کرد. درعوض از Routes API استفاده کنید.
- به ویژگیهای جدید مسیریابی و عملکرد بهبودیافته نیاز دارید. درعوض از Routes API استفاده کنید.
- در یک درخواست، به زمانهای سفر و مسافتهای بین چندین مبدأ و مقصد نیاز دارید. درعوض از Routes API استفاده کنید.
Directions API: setup
- سرویس برای فعال کردن:
directions-backend.googleapis.com - اصالتسنجی: کلید میانای برنامهسازی کاربردی
- شروع به کار: راهاندازی Directions API
- مرجع: مرجع Directions API
- قیمتگذاری: استفاده و صورتحساب Directions API
- خطمشیها: خطمشیهای Directions API
- یادداشتهای انتشار: یادداشتهای انتشار Directions API
Directions API: اشتباهات رایج
- مشکل: درخواستهای ارسالشده به Directions API (قدیمی) از پروژهای که میانای برنامهسازی کاربردی قدیمی در آن فعال نشده است با
LegacyApiNotActivatedMapErrorناموفق میشود. راهحل: اگر مالک برنامه هستید، به Routes API منتقل شوید. بهعنوان راهحلی کوتاهمدت درحین انتقال یا انتظار برای بهروزرسانی برنامه، میتوانید با تکمیل فرم فعالسازی API قدیمی، API قدیمی را فعال کنید. /maps/legacy را ببینید. - مشکل: استفاده از پیشوند
via:در نقاطمسیر باعث میشود که آنها بهعنوان نقاط عبور دقیق درنظر گرفته شوند، که میتواند منجر به انحرافهای شدید یا وضعیتZERO_RESULTSشود. اصلاح: از نقاطمسیر توقفگاه (بدون پیشوندvia:) استفاده کنید، مگراینکه نقطه عبور دقیق لازم باشد. /maps/documentation/directions/get-directions را ببینید. - مشکل: درخواستهای دارای ۱۱ تا ۲۵ نقطهمسیر،
optimize:true، مدتهای بااحتساب ترافیک (duration_in_traffic)، یا اصلاحکنندههای مکانside_of_roadیاheadingبا شناسه محصول بالاتر Directions Advanced (Pro) صورتحساب میشوند. راهحل: فقط وقتی به این ویژگیها نیاز دارید از آنها استفاده کنید؛ تعداد نقاطمسیر را ۱۰ یا کمتر نگه دارید وoptimize:true،departure_time(برای رانندگی)،side_of_road، وheadingرا حذف کنید تا در SKU «ضروریات» بمانید. /maps/billing-and-pricing/sku-details/legacy#directions-advanced-pro-sku را ببینید. - مشکل: برای رانندگی،
departure_timeنمیتواند در گذشته باشد (درخواست باINVALID_REQUESTناموفق میشود). بدونdeparture_time، مسیر و مدتزمان از میانگین ترافیک مستقل از زمان استفاده میکنند و هیچduration_in_trafficبرگردانده نمیشود. اصلاح:departure_timeرا رویnowیا زمان آینده باmode=drivingتنظیم کنید تاduration_in_trafficرا دریافت کنید. درخواستهایی کهduration_in_trafficرا برمیگردانند با شناسه کالای «مسیرهای پیشرفته (Pro)» صورتحساب میشوند. /maps/documentation/directions/get-directions را ببینید.