Overview of search along route
নিম্নলিখিত Places (New) API-গুলিতে রুট বরাবর অনুসন্ধানের বৈশিষ্ট্যগুলি উপলব্ধ রয়েছে:
- টেক্সট সার্চ (শুধুমাত্র নতুন): পূর্বনির্ধারিত ভ্রমণপথ বরাবর স্থানসমূহ অনুসন্ধান করুন।
- টেক্সট সার্চ (নতুন) এবং নিয়ারবাই সার্চ (নতুন): একটি নির্দিষ্ট রাউটিং উৎস অবস্থান থেকে সার্চ ফলাফলের প্রতিটি স্থানে যাওয়ার রাউটিং সারাংশ গণনা করুন।
- টেক্সট সার্চ (শুধুমাত্র নতুন): একটি পূর্বনির্ধারিত ভ্রমণ পথের প্রতিটি স্থানের জন্য রুটিং সারাংশ গণনা করুন।
Search along a route
দুটি অবস্থানের মধ্যে ভ্রমণের পথ গণনা করার জন্য আপনি Routes API ব্যবহার করেন। Routes API গাড়ি, সাইকেল, দুই চাকার যান, গণপরিবহন ব্যবস্থা বা হেঁটে যাওয়ার জন্য পথ গণনা করতে পারে।
টেক্সট সার্চ (নতুন) আপনাকে এই ক্যালকুলেটেড রুটটি ব্যবহার করে একটি রুট বরাবর অনুসন্ধান করার সুযোগ দেয়। এই বিকল্পটির মাধ্যমে, আপনি রাউটস এপিআই (Routes API) থেকে আগে থেকে গণনা করা রুটটি টেক্সট সার্চ (নতুন) অনুরোধে পাঠান। এরপর প্রাপ্ত প্রতিক্রিয়াটিতে এমন স্থানগুলো থাকে যা অনুসন্ধানের শর্তের সাথে মেলে এবং নির্দিষ্ট রুটের কাছাকাছি অবস্থিত।
একটি রুট বরাবর অনুসন্ধান করা, সার্চ রেজাল্টকে প্রভাবিত করার জন্য locationRestriction বা locationBias রিকোয়েস্ট অপশন ব্যবহার করার মতোই। locationRestriction ভিউপোর্টের সীমার মধ্যে থাকা সার্চ রেজাল্টগুলো ফেরত দেয়, অন্যদিকে locationBias ভিউপোর্টের বাইরের সার্চ রেজাল্টও ফেরত দিতে পারে। তবে, locationBias এবং locationRestriction অপশনগুলো আপনাকে সার্চ রেজাল্টকে প্রভাবিত করার জন্য একটি অঞ্চল নির্দিষ্ট করতে দিলেও, টেক্সট সার্চের 'সার্চ অ্যালং রুট' ফিচারটি আপনাকে রুটের উৎস থেকে গন্তব্যে পৌঁছানোর জন্য ন্যূনতম পথ ঘুরে আসা ফলাফলগুলোকেও অন্তর্ভুক্ত করতে দেয়। আপনি পলিলাইনের সাথে locationBias বা locationRestriction যেকোনো একটি ব্যবহার করে সার্চ রেজাল্টকে প্রভাবিত করতে পারেন।
উদাহরণস্বরূপ, উৎস থেকে গন্তব্য পর্যন্ত পথটি বিবেচনা করুন, যা Routes API-তে একটি ওয়েপয়েন্ট হিসাবে পরিচিত এবং Routes API দ্বারা গণনা করা হয়:
যখন আপনি পথ বরাবর অনুসন্ধান করেন, তখন অনুসন্ধানটি পথের কাছাকাছি এমন স্থানগুলিকে দেখানোর জন্য পক্ষপাতদুষ্ট হয় যেখান থেকে উৎস থেকে গন্তব্যে পৌঁছাতে ন্যূনতম ঘুরে যেতে হয়। এই উদাহরণে, A, B, এবং C হলো অনুসন্ধানের মাধ্যমে প্রাপ্ত স্থান।
Calculate routing summary
টেক্সট সার্চ (নতুন) এবং নিয়ারবাই সার্চ (নতুন) অনুরোধে নির্দিষ্ট করা রাউটিং অরিজিন লোকেশনের উপর ভিত্তি করে রেসপন্সের প্রতিটি স্থানের রাউটিং সামারি , অর্থাৎ সময়কাল এবং দূরত্ব, গণনা করতে পারে। যখন আপনি রাউটিং অরিজিন নির্দিষ্ট করেন, তখন রেসপন্সে শুধু সার্চের সাথে মিলে যাওয়া স্থানগুলোর তালিকা থাকে না, বরং রাউটিং অরিজিন থেকে প্রতিটি স্থানে ভ্রমণের সময়কাল এবং দূরত্বও থাকে।
নিচের ছবিতে, A, B, এবং C বিন্দুগুলো হলো অনুসন্ধানের ফলাফলে প্রাপ্ত স্থানসমূহ:
ফলাফলের প্রতিটি স্থানের জন্য, প্রতিক্রিয়াটিতে ভ্রমণের সময়কাল এবং রাউটিং উৎস থেকে সেই স্থান পর্যন্ত দূরত্ব অন্তর্ভুক্ত থাকে, যদি তা উপলব্ধ থাকে।
ডিফল্টরূপে, রাউটস এপিআই (Routes API)-এর TRAFFIC_UNAWARE অপশনটি ব্যবহার করে ভ্রমণের সময়কাল এবং দূরত্ব গণনা করা হয়। গণনার সময় লাইভ ট্র্যাফিক পরিস্থিতি TRAFFIC_AWARE_OPTIMAL অথবা ল্যাটেন্সি-হ্রাসকৃত লাইভ ট্র্যাফিক পরিস্থিতি TRAFFIC_AWARE বিবেচনায় নেওয়ার জন্য আপনি ঐচ্ছিকভাবে রাউটিং প্রেফারেন্স সেট করতে পারেন।
About routes, legs, and waypoints
Routes API দ্বারা গণনা অনুযায়ী, একটি রুট বেশ কয়েকটি উপাদান নিয়ে গঠিত:
A route consists of the following components:
- ওয়েপয়েন্ট : একটি রুট গণনা করার জন্য, আপনাকে ন্যূনতম উৎস এবং গন্তব্যের অবস্থান নির্দিষ্ট করতে হয়। আপনি এই অবস্থানগুলোকে রুটের উপর ওয়েপয়েন্ট হিসেবে নির্ধারণ করেন। মধ্যবর্তী ওয়েপয়েন্ট হলো উৎস এবং গন্তব্যের মাঝের এমন সব অবস্থান, যেগুলোর মধ্য দিয়ে আপনি রুটটিকে নিয়ে যেতে চান।
রুট : উৎস ওয়েপয়েন্ট থেকে শুরু করে, যেকোনো মধ্যবর্তী ওয়েপয়েন্টের মধ্য দিয়ে, গন্তব্য ওয়েপয়েন্ট পর্যন্ত সম্পূর্ণ যাত্রাপথ। একটি রুট এক বা একাধিক লেগ নিয়ে গঠিত।
টেক্সট সার্চে কোনো রাউট পাঠানোর সময়, আপনাকে রাউটস এপিআই (Routes API) দ্বারা ফেরত দেওয়া রাউটটির এনকোডেড পলিলাইনটি পাঠাতে হয়। একটি এনকোডেড পলিলাইন হলো অক্ষাংশ এবং দ্রাঘিমাংশ বিন্দুর একটি এনকোডেড তালিকা, যা আপনাকে রাউটের পলিলাইনটিকে একটি স্ট্রিং হিসাবে উপস্থাপন করতে দেয়।
লেগ : একটি রুটের এক ওয়েপয়েন্ট থেকে পরবর্তী ওয়েপয়েন্ট পর্যন্ত পথ। প্রতিটি লেগ এক বা একাধিক স্বতন্ত্র ধাপ নিয়ে গঠিত।
একটি রুটে প্রতিটি ওয়েপয়েন্ট থেকে পরবর্তী ওয়েপয়েন্টে যাওয়ার পথের জন্য একটি আলাদা অংশ থাকে। উদাহরণস্বরূপ, যদি রুটটিতে একটিমাত্র উৎস ওয়েপয়েন্ট এবং একটিমাত্র গন্তব্য ওয়েপয়েন্ট থাকে, তাহলে রুটটিতে একটিমাত্র অংশ থাকে।
উৎস এবং গন্তব্যের পরে আপনি রুটে প্রতিটি অতিরিক্ত ওয়েপয়েন্ট যোগ করলে, যাকে মধ্যবর্তী ওয়েপয়েন্ট বলা হয়, এপিআই একটি আলাদা লেগ যোগ করে।
রুট এবং রুট গণনা সম্পর্কে আরও তথ্যের জন্য, রুটস এপিআই (Routes API) দেখুন।
রুট বরাবর অনুসন্ধানের মাধ্যমে রাউটিং সারাংশ গণনা করুন।
আপনি রুটিং সারাংশ গণনার সাথে একটি রুট বরাবর অনুসন্ধানকে একত্রিত করতে পারেন। এক্ষেত্রে, টেক্সট সার্চ (নতুন) প্রতিক্রিয়ার প্রতিটি স্থানে যাওয়ার ভ্রমণের সময়কাল ও দূরত্ব এবং তারপর প্রতিটি স্থান থেকে রুটের চূড়ান্ত গন্তব্যে যাওয়ার সময়কাল ও দূরত্ব ফেরত দেয়। এই গণনাটিকে এভাবে ভাবুন যে, আপনি যদি অনুসন্ধানের ফলাফলে থাকা কোনো স্থানে যাওয়ার জন্য নির্দিষ্ট রুট থেকে পথ পরিবর্তন করেন এবং তারপর চূড়ান্ত গন্তব্যে যাত্রা চালিয়ে যান, তবে এটি আপনাকে ভ্রমণের সময়কাল ও দূরত্ব প্রদান করে।
উদাহরণস্বরূপ, Routes API দ্বারা গণনাকৃত উৎস থেকে গন্তব্য পর্যন্ত নিম্নলিখিত রুটটি বিবেচনা করুন। আপনার অনুসন্ধানের শর্তাবলীর সাথে এই রুটটি Text Search (New) API-তে পাঠান।
এই উদাহরণে, অবস্থান A হলো টেক্সট সার্চ (নতুন) থেকে প্রাপ্ত অনুসন্ধানের ফলাফলে পাওয়া একটি জায়গা। ফলাফলের প্রতিটি জায়গার জন্য, অনুসন্ধানে সেই জায়গায় দুই ধাপে ঘুরে যাওয়ার জন্য প্রয়োজনীয় সময়কাল এবং দূরত্ব অন্তর্ভুক্ত থাকে:
- প্রথম ধাপে পথের উৎস থেকে গন্তব্যস্থল পর্যন্ত ভ্রমণের সময়কাল এবং দূরত্ব উল্লেখ থাকে। এই উদাহরণে, উৎস থেকে স্থান A পর্যন্ত।
- দ্বিতীয় ধাপে স্থান থেকে পথের গন্তব্য পর্যন্ত ভ্রমণের সময়কাল ও দূরত্ব উল্লেখ থাকে। এই উদাহরণে, A থেকে গন্তব্য পর্যন্ত।
প্রাপ্ত তথ্য থেকে, আপনি বিকল্প পথের সময়কাল এবং দূরত্ব গণনা করতে পারবেন, যেখানে:
- \(t_{OD}\) উৎস থেকে গন্তব্য পর্যন্ত ভ্রমণের সময়কাল , \(s_{OD}\) উৎস থেকে গন্তব্য পর্যন্ত ভ্রমণের দূরত্ব
- \(t_{OA}\) is the trip duration from the origin to A; \(s_{OA}\) is the trip distance from the origin to A
- \(t_{AD}\) is the trip duration from A to the destination; \(s_{AD}\) is the trip distance from A to the destination
পথ পরিবর্তন পথের সময়কাল হলো মূল যাত্রা (উৎস থেকে গন্তব্য পর্যন্ত) এবং নতুন যাত্রা (উৎস থেকে A-এর মধ্য দিয়ে গন্তব্যে পৌঁছানো) - এই দুই যাত্রার সময়কালের পার্থক্য :
ঘুরপথের দূরত্ব হলো মূল যাত্রাপথ (উৎস থেকে গন্তব্য পর্যন্ত) এবং নতুন যাত্রাপথ (উৎস থেকে A-এর মধ্য দিয়ে গন্তব্যে যাওয়া)-এর মধ্যকার দূরত্বের পার্থক্য :