نمای کلی جستجو در طول مسیر

ویژگی‌های «جستجو درطول مسیر» در «میاناهای برنامه‌سازی کاربردی مکان‌ها (جدید)» زیر دردسترس است:

  • فقط «جستجوی نوشتاری» (جدید): مکان‌های طول مسیر سفر ازپیش‌تعیین‌شده را جستجو کنید.
  • جستجوی نوشتاری (جدید) و جستجوی اطراف (جدید): خلاصه مسیریابی را از مکان مبدأ مسیریابی مشخص‌شده تا هر مکان در نتایج جستجو محاسبه می‌کند.
  • فقط «جستجوی نوشتاری» (جدید): خلاصه مسیریابی را برای هر مکان درطول مسیر سفر ازپیش‌تعیین‌شده محاسبه کنید.

جستجو درطول مسیر

از میانای برنامه‌سازی کاربردی «مسیرها» برای محاسبه مسیر سفر بین دو مکان استفاده می‌کنید. «میانای برنامه‌سازی کاربردی مسیرها» می‌تواند مسیری را برای خودرو، دوچرخه، وسیله نقلیه دوچرخ، سیستم حمل‌ونقل عمومی، یا پیاده‌روی محاسبه کند.

«جستجوی نوشتاری» (جدید) به شما امکان می‌دهد از این مسیر محاسبه‌شده برای انجام جستجو درطول مسیر استفاده کنید. با این گزینه، مسیر ازپیش محاسبه‌شده را از «میانای برنامه‌سازی کاربردی مسیرها» به درخواست «جستجوی نوشتاری (جدید)» منتقل می‌کنید. سپس پاسخ حاوی مکان‌هایی است که با معیارهای جستجو مطابقت دارند و همچنین در نزدیکی مسیر مشخص‌شده قرار دارند.

جستجو درطول مسیر مشابه استفاده از گزینه‌های درخواست locationRestriction یا locationBias برای سوگیری نتایج جستجو است. locationRestriction نتایج جستجویی را برمی‌گرداند که در محدوده نمای دید قرار دارند، درحالی‌که locationBias ممکن است نتایج جستجویی را خارج از نمای دید برگرداند. بااین‌حال، درحالی‌که گزینه‌های locationBias و locationRestriction به شما امکان می‌دهند منطقه‌ای را برای جانبداری نتایج جستجو مشخص کنید، ویژگی جستجو درطول مسیر در «جستجوی نوشتاری» نیز به شما امکان می‌دهد نتایج جستجو را به‌گونه‌ای جانبداری کنید که شامل مواردی با حداقل زمان انحراف از مبدأ مسیر تا مقصد مسیر باشد. بااستفاده از locationBias یا locationRestriction در ترکیب با چندخط می‌توانید نتایج جستجو را متمایل کنید.

برای مثال، مسیر از مبدأ (که در Routes API به آن نقطه‌مسیر گفته می‌شود) تا مقصد را که توسط Routes API محاسبه شده است درنظر بگیرید:

مسیر از نقطه‌مسیر مبدأ تا مقصد با نتایج جستجو.

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

محاسبه خلاصه مسیریابی

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

در تصویر زیر، نقاط A،‏ B، و C مکان‌هایی هستند که در پاسخ جستجو برگردانده شده‌اند:

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

برای هر مکان در نتایج، پاسخ حاوی مدت سفر و فاصله از مبدأ مسیریابی به مکان است (درصورت دردسترس بودن).

به‌طور پیش‌فرض، مدت و فاصله سفر بااستفاده از گزینه TRAFFIC_UNAWARE در «میانای برنامه‌سازی کاربردی مسیرها» محاسبه می‌شود. می‌توانید به‌صورت اختیاری اولویت‌های مسیریابی را تنظیم کنید تا شرایط ترافیک زنده TRAFFIC_AWARE_OPTIMAL یا شرایط ترافیک زنده با تأخیر کاهش‌یافته TRAFFIC_AWARE را در محاسبات درنظر بگیرید.

درباره مسیرها، بخش‌ها، و ایستگاه‌های بین راه

چندین مؤلفه یک مسیر را تشکیل می‌دهند، که توسط Routes API محاسبه می‌شود:

اجزای تشکیل‌دهنده مسیر.

مسیر از اجزای زیر تشکیل شده است:

  • Waypoint: برای محاسبه مسیر، حداقل مکان‌های مبدأ و مقصد را مشخص می‌کنید. این مکان‌ها را به‌عنوان نقطه‌مسیر در مسیر تعریف می‌کنید. نقطه‌مسیرهای میانی مکان‌هایی بین مبدأ و مقصد هستند که می‌خواهید مسیر از آن‌ها عبور کند.

  • مسیر: کل سفر از ایستگاه بین راهی مبدأ، ازطریق هر ایستگاه بین راهی، تا ایستگاه بین راهی مقصد. مسیر از یک یا چند مسیر تشکیل شده است.

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

  • بخش: مسیر از یک نقطه‌مسیر در مسیر به نقطه‌مسیر بعدی در مسیر. هر بخش از یک یا چند مرحله مجزا تشکیل شده است.

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

    برای هر ایستگاه بین راهی اضافی که پس‌از مبدأ و مقصد به مسیر اضافه می‌کنید، که ایستگاه بین راهی میانی نامیده می‌شود، «میانای برنامه‌سازی کاربردی» یک بخش جداگانه اضافه می‌کند.

برای اطلاعات بیشتر درباره مسیرها و محاسبه مسیرها، به Routes API مراجعه کنید.

محاسبه خلاصه مسیریابی با جستجو درطول مسیر

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

برای مثال، مسیر زیر را از مبدأ تا مقصد درنظر بگیرید که توسط «میانای برنامه‌سازی کاربردی مسیرها» محاسبه شده است. این مسیر را به‌همراه معیارهای جستجویتان به Text Search (New) API ارسال کنید.

مسیر از ایستگاه بین راهی مبدأ تا مقصد با انحراف به نتیجه جستجو.

در این مثال، مکان A مکانی است که در نتایج جستجو از «جستجوی نوشتاری» (جدید) برگردانده شده است. برای هر مکان در پاسخ، جستجو شامل مدت‌زمان و مسافت لازم برای انحراف به آن مکان به‌عنوان سفر دو مرحله‌ای است:

  • بخش اول شامل مدت زمان سفر و فاصله از مبدأ مسیر تا مکان است. در این مثال، از مبدأ تا مکان الف.
  • بخش دوم شامل مدت سفر و فاصله از مکان تا مقصد مسیر است. در این مثال، از A به مقصد.

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

  • \(t_{OD}\) مدت سفر از مبدأ تا مقصد است، \(s_{OD}\) فاصله سفر از مبدأ تا مقصد است
  • \(t_{OA}\) مدت سفر از مبدأ به A است؛ \(s_{OA}\) فاصله سفر از مبدأ به A است
  • \(t_{AD}\) مدت سفر از A به مقصد است؛ \(s_{AD}\) مسافت سفر از A به مقصد است

مدت انحراف تفاوت مدت بین سفر اصلی (از مبدأ تا مقصد) و سفر جدید (از مبدأ تا مقصد ازطریق A) است:

$$ t_{detour} = t_{OA} + t_{AD} - t_{OD} $$

فاصله انحراف تفاوت فاصله بین سفر اصلی (از مبدأ تا مقصد) و سفر جدید (از مبدأ تا مقصد ازطریق A) است:

$$ s_{detour} = s_{OA} + s_{AD} - s_{OD} $$
بعدی
جستجو در طول مسیر