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

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

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

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

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

توجه: مسیرهای سیستم حمل و نقل توسط Places API پشتیبانی نمی‌شوند.

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

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

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

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

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

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

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

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

توجه: این فقط تخمینی از اطلاعات مسیریابی است. برای دریافت جزئیات واقعی مسیر، از جمله دستورالعمل‌های گام به گام، از Routes API استفاده کنید.

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

توجه: TRAFFIC_AWARE و TRAFFIC_OPTIMAL فقط برای حالت‌های سفر DRIVE و TWO_WHEELER اعمال می‌شوند. اگر یکی از اولویت‌های مسیریابی با حالت سفر پشتیبانی‌نشده مشخص شده باشد، محاسبه خلاصه مسیریابی به طور پیش‌فرض از گزینه TRAFFIC_UNAWARE استفاده می‌کند. اگر TWO_WHEELER در یک منطقه پشتیبانی نشده مشخص شده باشد، API خلاصه مسیریابی خالی را برمی گرداند.

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

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

چندین مؤلفه یک مسیر را تشکیل می دهند که توسط 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) است:

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

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

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

،

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

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

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

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

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

توجه: مسیرهای سیستم حمل و نقل توسط Places API پشتیبانی نمی‌شوند.

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

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

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

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

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

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

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

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

توجه: این فقط تخمینی از اطلاعات مسیریابی است. برای دریافت جزئیات واقعی مسیر، از جمله دستورالعمل‌های گام به گام، از Routes API استفاده کنید.

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

توجه: TRAFFIC_AWARE و TRAFFIC_OPTIMAL فقط برای حالت‌های سفر DRIVE و TWO_WHEELER اعمال می‌شوند. اگر یکی از اولویت‌های مسیریابی با حالت سفر پشتیبانی‌نشده مشخص شده باشد، محاسبه خلاصه مسیریابی به طور پیش‌فرض از گزینه TRAFFIC_UNAWARE استفاده می‌کند. اگر TWO_WHEELER در یک منطقه پشتیبانی نشده مشخص شده باشد، API خلاصه مسیریابی خالی را برمی گرداند.

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

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

چندین مؤلفه یک مسیر را تشکیل می دهند که توسط 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) است:

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

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

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