این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

چرا به Routes API مهاجرت کنیم؟

Routes API عملکرد بهبود یافته ای را برای محاسبه مسیرها، مسافت و زمان سفر ارائه می دهد و جایگزینی برنامه هایی را که در حال حاضر از Directions API و Distance Matrix API استفاده می کنند، ارزشمند می کند. بیشتر عملکرد Routes API با هم با Directions API و Distance Matrix API سازگار است.

از این راهنما برای درک تفاوت‌های کلیدی Routes API در مقایسه با محصولاتی که جایگزین آن‌ها می‌شود، همراه با نحوه انجام تغییرات ضروری استفاده کنید. برای جزئیات بیشتر در مورد سایر ویژگی‌های Routes API، به نمای کلی محصول مراجعه کنید.

پیشرفت های کلیدی

این بخش برخی از پیشرفت‌هایی را پوشش می‌دهد که می‌توانید هنگام استفاده از Routes API در برنامه‌های خود انتظار داشته باشید.

افزایش محدودیت درخواست

Routes API	حداکثر 625 عنصر، مگر اینکه `TRAFFIC_AWARE_OPTIMAL` مشخص کنید. حداکثر 100 عنصر با `TRAFFIC_AWARE_OPTIMAL` . تنظیمات ترجیحی مسیریابی را ببینید. حداکثر 50 نقطه راه (مبداء + مقصد) با استفاده از شناسه مکان.
Distance Matrix API	حداکثر 25 مبدا یا 25 مقصد در هر درخواست. حداکثر 100 عنصر (تعداد مبدا × تعداد مقصد) در هر درخواست سمت سرور.

پاسخ سریعتر درخواست

ویژگی ماتریس مسیر محاسباتی بهبودهای تأخیر زیر را ارائه می دهد:

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

پیشرفت های مسیریابی

ویژگی مسیر محاسبه این پیشرفت های مسیریابی را ارائه می دهد:

اطلاعات عوارض علاوه بر مسافت و ایتا.
مسیرهای وسایل نقلیه 2 چرخ .
ایستگاه های توقف خود را برای ایمنی واجد شرایط کنید .
افزایش دقت ETA با تنظیم جهت حرکت و سمت جاده برای ایستگاه های بین راه.

فقط داده هایی را که نیاز دارید درخواست کنید

اکنون مشخص می‌کنید که کدام فیلدها را بازگردانید، که زمان پردازش و هزینه‌های صورت‌حساب را کاهش می‌دهد.

Routes API

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

Directions API
Distance Matrix API

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

محاسبات مسیر پیشرفته برای ترافیک

Routes API از سه اولویت مسیریابی پشتیبانی می کند که می توانید از آنها برای ایجاد تعادل بین تاخیر پاسخ و کیفیت داده هنگام درخواست اطلاعات ترافیک استفاده کنید.

برای اطلاعات بیشتر، پیکربندی کیفیت در مقابل تأخیر را ببینید.

`TRAFFIC_UNAWARE` (پیش فرض)	از داده‌های ترافیک مستقل از زمان متوسط، نه داده‌های ترافیک زنده، برای محاسبه مسیر استفاده می‌کند که در نتیجه کمترین تأخیر پاسخ را ایجاد می‌کند. این تنظیم معادل زمانی است که از ترافیک در Directions API و Distance Matrix API استفاده نمی شود.
`TRAFFIC_AWARE` (جدید)	کیفیت ترافیک زنده با عملکرد بهینه برای کاهش تاخیر. برخلاف `TRAFFIC_AWARE_OPTIMAL` ، این تنظیم بهینه‌سازی‌هایی را برای کاهش قابل توجه تأخیر اعمال می‌کند. این تنظیم همچنین برای Routes API جدید است و هیچ معادلی در Directions API یا Distance Matrix API ندارد.
`TRAFFIC_AWARE_OPTIMAL`	داده های ترافیکی با کیفیت بالا و جامع. این تنظیم بیشترین تأخیر را ایجاد می کند و معادل تنظیم `departure_time` در Directions API و Distance Matrix API است. این اولویت معادل حالتی است که maps.google.com و برنامه تلفن همراه Google Maps استفاده می‌کند.

مقایسه محاسبات مسیر

جدول زیر گزینه‌های مسیریابی را بین Routes API و Directions API و Distance Matrix API مقایسه می‌کند.

گزینه ترافیک Routes API Directions API
Distance Matrix API تاخیر

بدون ترافیک زمان واقعی TRAFFIC_UNAWARE ویژگی departure_time تنظیم نشده است سریعترین تاخیر از سه حالت.

شرایط ترافیک زنده اعمال شد

گزینه ترافیک	Routes API	Directions API Distance Matrix API	تاخیر
بدون ترافیک زمان واقعی	`TRAFFIC_UNAWARE`	ویژگی `departure_time` تنظیم نشده است	سریعترین تاخیر از سه حالت.
شرایط ترافیک زنده اعمال شد	`TRAFFIC_AWARE`	معادل ندارد	حالت جدید اضافه شده توسط Routes API. تأخیر کمی بیشتر از `TRAFFIC_UNAWARE` با هزینه کمی کیفیت ETA ارائه می کند. تأخیر بسیار کمتری نسبت به `TRAFFIC_AWARE_OPTIMAL` دارد.
داده های ترافیک زنده با کیفیت بالا و جامع اعمال می شود	`TRAFFIC_AWARE_OPTIMAL`	مجموعه ویژگی `departure_time`	معادل حالت استفاده شده توسط maps.google.com و برنامه تلفن همراه Google Maps. برای محاسبه مسیر ماتریس، تعداد عناصر در یک درخواست (تعداد مبدا × تعداد مقصد) نمی تواند از 100 تجاوز کند.

TRAFFIC_AWARE

معادل ندارد

حالت جدید اضافه شده توسط Routes API. تأخیر کمی بیشتر از TRAFFIC_UNAWARE با هزینه کمی کیفیت ETA ارائه می کند.

تأخیر بسیار کمتری نسبت به TRAFFIC_AWARE_OPTIMAL دارد.

داده های ترافیک زنده با کیفیت بالا و جامع اعمال می شود

TRAFFIC_AWARE_OPTIMAL

مجموعه ویژگی departure_time

معادل حالت استفاده شده توسط maps.google.com و برنامه تلفن همراه Google Maps.

برای محاسبه مسیر ماتریس، تعداد عناصر در یک درخواست (تعداد مبدا × تعداد مقصد) نمی تواند از 100 تجاوز کند.

تفاوت های کلیدی

این بخش تفاوت‌های کلیدی بین Routes API و سرویس‌هایی را که جایگزین می‌کند، همراه با روش‌هایی که می‌توانید در هنگام مهاجرت از این سرویس‌ها در برنامه‌های موجود خود، به این تفاوت‌ها رسیدگی کنید، پوشش می‌دهد.

به جای دو سرویس با یک سرویس تماس بگیرید

Routes API	فقط یک سرویس را در کنسول API فعال کنید تا برنامه شما از Compute Routes و Compute Route Matrix استفاده کند. برای اطلاعات بیشتر، به تنظیم در کنسول API Google مراجعه کنید.
Directions API Distance Matrix API	دو سرویس را فعال کنید: Directions API و Distance Matrix API به عنوان سرویس‌های جداگانه در کنسول API.

از درخواست های `HTTPS POST` استفاده می کند

Routes API	پارامترها را در بدنه درخواست یا در هدرها به عنوان بخشی از درخواست `HTTP POST` ارسال کنید. برای مثال، نگاه کنید به: - یک مسیر را محاسبه کنید - یک ماتریس مسیر را محاسبه کنید
Directions API Distance Matrix API	پارامترهای URL را با استفاده از درخواست `HTTP GET` ارسال کنید.

تفاوت پاسخ ETA

Routes API ETA را برمی‌گرداند و از ویژگی پاسخ duration متفاوت با Directions API و Distance Matrix API استفاده می‌کند که در جدول زیر نشان داده شده است.

نوع ETA Routes API Directions API
Distance Matrix API

ترافیک ناآگاه، ETA مستقل از زمان.

نوع ETA	Routes API	Directions API Distance Matrix API
ترافیک ناآگاه، ETA مستقل از زمان.	با استفاده از `TRAFFIC_UNAWARE` تنظیم کنید. ETA موجود در ویژگی پاسخ `duration` . ویژگی‌های پاسخ `duration` و `staticDuration` دارای یک مقدار هستند.	مربوط به `departure_time` است که در درخواست تنظیم نشده است. ETA موجود در ویژگی پاسخ `duration` . ویژگی پاسخ `duration_in_traffic` برگردانده نمی شود.
ETA که ترافیک بلادرنگ را در نظر می گیرد.	با استفاده از `TRAFFIC_AWARE` یا `TRAFFIC_AWARE_OPTIMAL` تنظیم کنید. ETA با در نظر گرفتن ترافیک بلادرنگ در ویژگی پاسخ `duration` موجود است. ویژگی پاسخ `staticDuration` شامل مدت زمان سفر در مسیر بدون در نظر گرفتن شرایط ترافیکی است. ویژگی `duration_in_traffic` دیگر برگردانده نمی شود.	با استفاده از `departure_time` در درخواست تنظیم کنید. ETA با در نظر گرفتن ترافیک بلادرنگ در ویژگی پاسخ `duration_in_traffic` موجود است.

با استفاده از TRAFFIC_UNAWARE تنظیم کنید.

ETA موجود در ویژگی پاسخ duration .
ویژگی‌های پاسخ duration و staticDuration دارای یک مقدار هستند.

مربوط به departure_time است که در درخواست تنظیم نشده است.

ETA موجود در ویژگی پاسخ duration .
ویژگی پاسخ duration_in_traffic برگردانده نمی شود.

ETA که ترافیک بلادرنگ را در نظر می گیرد.

با استفاده از TRAFFIC_AWARE یا TRAFFIC_AWARE_OPTIMAL تنظیم کنید.

ETA با در نظر گرفتن ترافیک بلادرنگ در ویژگی پاسخ duration موجود است.
ویژگی پاسخ staticDuration شامل مدت زمان سفر در مسیر بدون در نظر گرفتن شرایط ترافیکی است.
ویژگی duration_in_traffic دیگر برگردانده نمی شود.

با استفاده از departure_time در درخواست تنظیم کنید.

ETA با در نظر گرفتن ترافیک بلادرنگ در ویژگی پاسخ duration_in_traffic موجود است.

نقاط راه چند خطی

دیگر نیازی نیست مختصات طول و عرض جغرافیایی خود را با این سرویس، که از بدنه درخواست POST پشتیبانی می کند، به نقاط بین خطی تبدیل کنید و بنابراین دیگر تحت تأثیر محدودیت های رشته URL قرار نمی گیرد. برخی از کاربران Distance Matrix API مشکل محدودیت درخواست را با تبدیل نقاط طول و عرض جغرافیایی به نقاط بین چند خطی حل کردند.

آدرس های قالب بندی شده (ژئوکد معکوس)

Routes API آدرس های قالب بندی شده را در پاسخ ارائه نمی کند. برای به دست آوردن آدرس های فرمت شده، از Geocoding API استفاده کنید که برای این مورد ساخته شده است و نتایج با کیفیت بالاتری ارائه می دهد.

حالت های سفر موجود

همانطور که در مورد Directions API وجود دارد، Routes API از DRIVE به عنوان حالت پیش فرض زمانی که درخواست مسیر حالت سفر را مشخص نمی کند، استفاده می کند. با این حال، هنگامی که یک درخواست حالت سفر را برای یک مسیر مشخص می‌کند، Routes API آرایه‌ای از حالت‌های سفر موجود را به عنوان گزینه‌های جایگزین برای درخواست برمی‌گرداند. اگر مورد استفاده شما به این ویژگی متکی است، مشکلی را در مورد نحوه استفاده از این ویژگی ثبت کنید تا بتوانیم آن را پیگیری کنیم.

XML به عنوان یک فرمت پاسخ

Routes API XML را به عنوان قالب پاسخ ارائه نمی دهد. می توانید تعدادی مبدل JSON به XML را به صورت آنلاین پیدا کنید که باید با اهداف شما مطابقت داشته باشد.