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

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

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

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

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

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

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

برای مثال، مسیر از مبدأ، که در «میانای برنامه‌سازی کاربردی مسیرها» به‌عنوان ایستگاه بین راهی نامیده می‌شود، تا مقصد را که «میانای برنامه‌سازی کاربردی مسیرها» محاسبه کرده است درنظر بگیرید:

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

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

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

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

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

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

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

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

درباره مسیرها، بخش‌ها، و نقطه‌مسیرها

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

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

مسیر از مؤلفه‌های زیر تشکیل شده است:

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

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

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

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

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

    برای هر نقطه‌مسیر اضافه‌ای که بعداز مبدأ و مقصد به مسیر اضافه می‌کنید، که نقطه‌مسیر میانی نامیده می‌شود، API یک بخش جداگانه اضافه می‌کند.

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

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

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

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

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

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

  • بخش اول شامل مدت زمان سفر و فاصله از مبدأ مسیر تا مکان است. در این مثال، از مبدأ به مکان 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} $$