API مسیرها (Routes API) در سپتامبر 2022 به عنوان پیشنمایش عمومی (قبل از GA) منتشر شد. پیشنهادات قبل از GA تحت پوشش شرایط خاص سرویس پلتفرم نقشههای گوگل (Google Maps Platform Service Specific Terms ) قرار دارند. برای اطلاعات بیشتر، به توضیحات مرحله راهاندازی مراجعه کنید.
این بخش نحوهی انتقال یک برنامه از نسخهی پیشنمایش به نسخهی اصلی را شرح میدهد.
ویژگیهای جدیدی به نسخه GA اضافه شد
نسخه GA ویژگیهای جدید زیر را که در پیشنمایش وجود نداشتند، اضافه میکند:
همراه با شناسههای مکان و مختصات طول و عرض جغرافیایی، اکنون میتوانید با استفاده از موارد زیر، مکانی را در نسخه GA مشخص کنید :
رشتههای آدرس ("شیکاگو، ایلینوی" یا "داروین، انتی، استرالیا")
رشتههای آدرس اغلب روشی هستند که کاربر آدرس را وارد میکند. با این حال، {product_name} ابتدا باید رشته آدرس را به صورت داخلی geocode کند تا آن را به مختصات عرض/طول جغرافیایی تبدیل کند، قبل از اینکه بتواند مسیری را محاسبه کند.
علاوه بر این، پشتیبانی از پارامتر درخواست
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"تنظیم کنید.