از نسخه پیش نمایش مهاجرت کنید

Routes API به‌عنوان پیش‌نمایش عمومی (قبل از GA) در سپتامبر 2022 منتشر شد. پیشنهادات Pre-GA تحت شرایط خاص سرویس پلتفرم Google Maps قرار دارند. برای اطلاعات بیشتر، به توضیحات مرحله راه اندازی مراجعه کنید.

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

ویژگی های جدید به نسخه GA اضافه شده است

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

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

  • رشته‌های آدرس ("Chicago, IL" یا "Darwin, NT, Australia")

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

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

  • کدهای پلاس

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

• پاسخ مسیرهای محاسبه اکنون حاوی آرایه geocodingResults است. برای هر مکان در درخواست (مبداء، مقصد، یا نقطه میانی) که به عنوان رشته آدرس یا کد پلاس مشخص شده است، 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 را طوری تنظیم کنید که شامل یک یا چند مقدار زیر باشد:

• برای دریافت اطلاعات عوارض ، فیلد جدید آرایه extraComputations را روی "TOLLS" تنظیم کنید.

• برای دریافت مصرف سوخت ، فیلد جدید آرایه extraComputations را روی "FUEL_CONSUMPTION" تنظیم کنید.

• برای دریافت اطلاعات ترافیک در چند خط ، فیلد آرایه extraComputations جدید را روی "TRAFFIC_ON_POLYLINE" تنظیم کنید.