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

ویژگی‌های جستجو درطول مسیر در Places (New) API زیر دردسترس است:

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

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

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

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

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

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

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

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

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

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

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

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

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

به‌طور پیش‌فرض، مدت و مسافت سفر بااستفاده از گزینه 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 به مقصد.

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

  • \(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} $$
بعدی
جستجو در طول مسیر