انتقال از نسخه «پیش‌نمایش»

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

«میانای برنامه‌سازی کاربردی مسیرها» در سپتامبر ۲۰۲۲ به‌عنوان «پیش‌نمایش عمومی» (پیش‌از GA) منتشر شد. «پیشنهادهای پیش‌از دردسترس عموم» تحت پوشش شرایط ویژه سرویس پلاتفرم Google Maps است. برای اطلاعات بیشتر، توضیحات مرحله راه‌اندازی را ببینید.

این بخش نحوه انتقال برنامه از نسخه «پیش‌نمایش» به نسخه GA را توضیح می‌دهد.

ویژگی‌های جدید به نسخه «دسترسی عمومی» اضافه شد

نسخه GA ویژگی‌های جدید زیر را که در «پیش‌نمایش» وجود نداشت اضافه می‌کند:

  • علاوه‌بر شناسه‌های مکان و مختصات طول/عرض جغرافیایی، اکنون می‌توانید مکان را در نسخه GA بااستفاده از موارد زیر مشخص کنید:

    • رشته‌های نشانی («شیکاگو، ایلینوی» یا «داروین، قلمرو شمالی، استرالیا»)

      رشته‌های نشانی اغلب همان چیزی است که کاربر به‌عنوان نشانی وارد می‌کند. بااین‌حال، {product_name} ابتدا باید رشته نشانی را به‌صورت داخلی زمین‌کدگذاری کند تا آن را به مختصات طول/عرض جغرافیایی تبدیل کند و سپس بتواند مسیر را محاسبه کند.

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

    • Plus Codes

      «کدهای باز» مثل نشانی خیابان برای افراد یا مکان‌هایی هستند که نشانی واقعی ندارند. به‌جای نشانی‌هایی با نام و شماره خیابان، Plus Code براساس عرض و طول جغرافیایی است و به‌صورت عدد و حرف نمایش داده می‌شود.

  • پاسخ محاسبه مسیرها اکنون حاوی آرایه geocodingResults است. برای هر مکان در درخواست (مبدأ، مقصد، یا ایستگاه بین راهی) که به‌عنوان رشته نشانی یا Plus Code مشخص شده است، API جستجوی شناسه مکان را انجام می‌دهد. هر عنصر این آرایه حاوی شناسه مکان مربوط به یک مکان به‌همراه فراداده‌های اضافی درباره مکان است. مکان‌های موجود در درخواست که به‌عنوان شناسه مکان یا مختصات عرض جغرافیایی/طول جغرافیایی مشخص شده‌اند نادیده گرفته می‌شوند.

تغییرات در ویژگی‌های «پیش‌نمایش» موجود

اکنون باید ویژگی‌های زیر را با افزودن فیلد آرایه جدید extraComputations به درخواست، به‌طور صریح در GA فعال کنید:

در نسخه «پیش‌نمایش»، از پوشش فیلد استفاده می‌کردید تا مشخص کنید اطلاعات این ویژگی‌ها در پاسخ برگردانده شود. اکنون باید هر دو نفر:

  • پارامتر آرایه extraComputations جدید را تنظیم کنید تا این ویژگی‌ها فعال شوند.
  • یک پوشش فیلد تنظیم کنید تا مشخص کنید اطلاعات در پاسخ برگردانده شود.

چه چیزهایی باید بدانم؟

فیلدهای زیر دیگر در پاسخ‌های computeRouteMatrix گنجانده نخواهد شد مگر اینکه با تنظیم extraComputations به‌طور صریح فعال شده باشد:

  • ‫travelAdvisory.tollInfo (اطلاعات عوارض)

فیلدهای زیر دیگر در پاسخ‌های computeRoutes گنجانده نخواهد شد مگر اینکه با تنظیم extraComputations به‌طور صریح فعال شده باشد:

  • ‫routes.legs.travelAdvisory.tollInfo(اطلاعات عوارض)
  • ‫routes.travelAdvisory.tollInfo(اطلاعات عوارض)
  • ‫routes.travelAdvisory.fuelConsumptionMicroliters(مصرف سوخت)
  • ‫routes.travelAdvisory.speedReadingIntervals(ترافیک در چندضلعی)
  • ‫routes.legs.travelAdvisory.speedReadingIntervals(ترافیک در چندضلعی)

چه کاری باید انجام دهم؟

برای دریافت فیلدهای پاسخ مربوط به اطلاعات عوارض، مصرف سوخت، یا ترافیک در چندخطی، باید فیلد آرایه درخواست جدید، extraComputations، را تنظیم کنید تا شامل یک یا چند مقدار زیر باشد: