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

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

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

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

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

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

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

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

هنگامی که در طول مسیر جستجو می‌کنید، جستجو برای بازگرداندن مکان‌های نزدیک به مسیر با حداقل زمان انحراف از مبدا تا مقصد، مغرضانه است. در این مثال، نقاط A، B و C مکان هایی هستند که توسط جستجو برگردانده می شوند.

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

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

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

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

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

درباره مسیرها، پاها، و ایستگاه های بین راه

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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