- HTTP অনুরোধ
- অনুরোধকারী শরীর
- প্রতিক্রিয়া সংস্থা
- অনুমোদনের পরিধি
- র্যাঙ্কপ্রেফারেন্স
- অবস্থানগত পক্ষপাত
- অবস্থান সীমাবদ্ধতা
- ইভিঅপশনস
- SearchAlongRouteParameters
- পলিলাইন
- প্রাসঙ্গিক বিষয়বস্তু
- ন্যায্যতা
- পর্যালোচনার যৌক্তিকতা
- হাইলাইট করা টেক্সট
- হাইলাইট করা টেক্সট রেঞ্জ
- ব্যবসায়িক প্রাপ্যতা বৈশিষ্ট্য ন্যায্যতা
টেক্সট কোয়েরি ভিত্তিক স্থান অনুসন্ধান।
HTTP অনুরোধ
POST https://places.googleapis.com/v1/places:searchText
URL-টিতে gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করা হয়েছে।
অনুরোধকারী শরীর
অনুরোধের মূল অংশে নিম্নলিখিত কাঠামোসহ ডেটা থাকে:
| JSON উপস্থাপনা |
|---|
{ "textQuery": string, "languageCode": string, "regionCode": string, "rankPreference": enum ( |
| ক্ষেত্র | |
|---|---|
textQuery | প্রয়োজনীয়। পাঠ্য অনুসন্ধানের জন্য পাঠ্য কোয়েরি। |
languageCode | স্থানের বিবরণ উপলব্ধ থাকলে পছন্দের ভাষায় প্রদর্শিত হবে। যদি ভাষা কোড অনির্দিষ্ট বা অচেনা হয়, তবে যেকোনো ভাষার স্থানের বিবরণ দেখানো হতে পারে, এবং সেক্ষেত্রে ইংরেজি বিবরণ থাকলে সেটিকে অগ্রাধিকার দেওয়া হবে। বর্তমানে সমর্থিত ভাষাগুলোর তালিকা: https://developers.google.com/maps/faq#languagesupport । |
regionCode | অনুরোধটি যে স্থান থেকে আসছে, সেখানকার ইউনিকোড দেশ/অঞ্চল কোড (CLDR)। এই প্যারামিটারটি স্থানের বিবরণ, যেমন অঞ্চল-ভিত্তিক স্থানের নাম (যদি উপলব্ধ থাকে), প্রদর্শন করতে ব্যবহৃত হয়। প্রযোজ্য আইনের উপর ভিত্তি করে এই প্যারামিটারটি ফলাফলকে প্রভাবিত করতে পারে। আরও তথ্যের জন্য, https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html দেখুন। উল্লেখ্য যে, বর্তমানে ৩-সংখ্যার অঞ্চল কোড সমর্থিত নয়। |
rankPreference | প্রতিক্রিয়ায় ফলাফলগুলো কীভাবে ক্রমবিন্যাস করা হবে |
includedType | অনুরোধকৃত স্থানের ধরণ। সমর্থিত ধরণগুলোর সম্পূর্ণ তালিকা: https://developers.google.com/maps/documentation/places/web-service/place-types । শুধুমাত্র একটি অন্তর্ভুক্ত ধরণ সমর্থন করে। |
openNow | বর্তমানে খোলা থাকা স্থানগুলিতে অনুসন্ধান সীমাবদ্ধ করতে ব্যবহৃত হয়। এর ডিফল্ট মান হলো false। |
minRating | যেসব ফলাফলের গড় ব্যবহারকারী রেটিং এই সীমার চেয়ে কঠোরভাবে কম, সেগুলোকে ফিল্টার করে বাদ দিন। একটি বৈধ মান অবশ্যই ০ থেকে ৫ (উভয়সহ) এর মধ্যে একটি ফ্লোট হতে হবে, যা ০.৫ ব্যবধানে বাড়বে, অর্থাৎ [০, ০.৫, ১.০, ... , ৫.০] (উভয়সহ)। ইনপুট করা রেটিং নিকটতম ০.৫ (সর্বোচ্চ সীমা)-এ রাউন্ড আপ করা হবে। উদাহরণস্বরূপ, ০.৬ রেটিং দিলে ১.০-এর কম রেটিংযুক্ত সমস্ত ফলাফল বাদ দেওয়া হবে। |
maxResultCount | অপ্রচলিত: এর পরিবর্তে প্রতি পৃষ্ঠায় সর্বোচ্চ যতগুলো ফলাফল ফেরত দেওয়া যেতে পারে। যদি উপলব্ধ ফলাফলের সংখ্যা যদি |
pageSize | ঐচ্ছিক। প্রতি পৃষ্ঠায় সর্বাধিক যতগুলো ফলাফল ফেরত দেওয়া যাবে। যদি উপলব্ধ ফলাফলের সংখ্যা যদি |
pageToken | ঐচ্ছিক। পূর্ববর্তী TextSearch কল থেকে প্রাপ্ত একটি পৃষ্ঠা টোকেন। পরবর্তী পৃষ্ঠাটি পুনরুদ্ধার করতে এটি প্রদান করুন। পেজিনেশন করার সময়, TextSearch-কে দেওয়া |
priceLevels[] | নির্দিষ্ট মূল্যস্তর হিসেবে চিহ্নিত স্থানগুলিতে অনুসন্ধান সীমাবদ্ধ করতে ব্যবহৃত হয়। ব্যবহারকারীরা মূল্যস্তরের যেকোনো সংমিশ্রণ বেছে নিতে পারেন। ডিফল্টরূপে সমস্ত মূল্যস্তর নির্বাচিত থাকে। |
strictTypeFiltering | includedType-এর জন্য কঠোর টাইপ ফিল্টারিং সেট করতে ব্যবহৃত হয়। যদি এটি true সেট করা হয়, তবে শুধুমাত্র একই টাইপের ফলাফল ফেরত দেওয়া হবে। ডিফল্ট মান false। |
locationBias | অনুসন্ধানের অঞ্চল। এই অবস্থানটি একটি পক্ষপাত হিসেবে কাজ করে, যার অর্থ প্রদত্ত অবস্থানের আশেপাশের ফলাফলও দেখানো হতে পারে। এটি locationRestriction-এর সাথে একসাথে সেট করা যায় না। |
locationRestriction | অনুসন্ধানের অঞ্চল। এই অবস্থানটি একটি সীমাবদ্ধতা হিসেবে কাজ করে, যার অর্থ প্রদত্ত অবস্থানের বাইরের কোনো ফলাফল দেখানো হবে না। এটি locationBias-এর সাথে একসাথে সেট করা যায় না। |
evOptions | ঐচ্ছিক। একটি স্থান অনুসন্ধানের অনুরোধের অনুসন্ধানযোগ্য EV বিকল্পগুলি সেট করুন। |
routingParameters | ঐচ্ছিক। ফলাফলে পাঠানোর জন্য অতিরিক্ত প্যারামিটার। |
searchAlongRouteParameters | ঐচ্ছিক। একটি রুট বরাবর অনুসন্ধানের জন্য অতিরিক্ত প্যারামিটার প্রোটো। |
includePureServiceAreaBusinesses | ঐচ্ছিক। যদি ফিল্ডটি 'true' সেট করা থাকে, তাহলে বিশুদ্ধ পরিষেবা এলাকার ব্যবসাগুলো অন্তর্ভুক্ত করুন। বিশুদ্ধ পরিষেবা এলাকার ব্যবসা হলো এমন একটি ব্যবসা যা সরাসরি গ্রাহকদের কাছে যায় বা পণ্য সরবরাহ করে, কিন্তু গ্রাহকদের ব্যবসায়িক ঠিকানায় পরিষেবা দেয় না। উদাহরণস্বরূপ, পরিচ্ছন্নতা পরিষেবা বা প্লাম্বারের মতো ব্যবসা। এই ব্যবসাগুলোর গুগল ম্যাপসে কোনো ভৌত ঠিকানা বা অবস্থান নেই। এই ব্যবসাগুলোর জন্য 'Places' ' |
includeFutureOpeningBusinesses | ঐচ্ছিক। যদি সত্য হয়, তবে সেই ব্যবসাগুলোও অন্তর্ভুক্ত করুন যেগুলো এখনও চালু হয়নি কিন্তু ভবিষ্যতে চালু হবে। |
প্রতিক্রিয়া সংস্থা
places.searchText-এর জন্য প্রতিক্রিয়া প্রোটো।
সফল হলে, প্রতিক্রিয়া অংশে নিম্নলিখিত কাঠামোসহ ডেটা থাকে:
| JSON উপস্থাপনা |
|---|
{ "places": [ { object ( |
| ক্ষেত্র | |
|---|---|
places[] | ব্যবহারকারীর টেক্সট সার্চের শর্ত পূরণ করে এমন স্থানগুলোর একটি তালিকা। |
routingSummaries[] | রাউটিং সারাংশগুলির একটি তালিকা, যেখানে প্রতিটি এন্ট্রি |
contextualContents[] | পরীক্ষামূলক: আরও বিস্তারিত জানতে https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative দেখুন। প্রাসঙ্গিক বিষয়বস্তুর একটি তালিকা, যেখানে প্রতিটি এন্ট্রি 'places' ফিল্ডের একই ইনডেক্সে থাকা সংশ্লিষ্ট স্থানের সাথে যুক্ত থাকে। অনুরোধের |
nextPageToken | পরবর্তী পৃষ্ঠা আনার জন্য |
searchUri | একটি লিঙ্কের মাধ্যমে ব্যবহারকারী অনুরোধে উল্লেখিত একই টেক্সট কোয়েরি ব্যবহার করে গুগল ম্যাপসে অনুসন্ধান করতে পারেন। |
অনুমোদনের পরিধি
নিম্নলিখিত OAuth স্কোপগুলির মধ্যে একটি প্রয়োজন:
-
https://www.googleapis.com/auth/maps-platform.places.textsearch -
https://www.googleapis.com/auth/maps-platform.places -
https://www.googleapis.com/auth/cloud-platform
র্যাঙ্কপ্রেফারেন্স
প্রতিক্রিয়ায় ফলাফলগুলো কীভাবে ক্রমবিন্যাস করা হবে
| এনাম | |
|---|---|
RANK_PREFERENCE_UNSPECIFIED | 'Restaurants in New York City'-এর মতো ক্যাটাগরিক্যাল কোয়েরির জন্য RELEVANCE হলো ডিফল্ট। 'Mountain View, CA'-এর মতো নন-ক্যাটাগরিক্যাল কোয়েরির ক্ষেত্রে আমরা rankPreference আনসেট রাখার পরামর্শ দিই। |
DISTANCE | দূরত্ব অনুসারে ফলাফলকে ক্রমভুক্ত করে। |
RELEVANCE | প্রাসঙ্গিকতা অনুসারে ফলাফলগুলোকে বিন্যস্ত করে। সাজানোর ক্রম সাধারণ র্যাঙ্কিং স্ট্যাক দ্বারা নির্ধারিত হয়। |
অবস্থানগত পক্ষপাত
অনুসন্ধানের অঞ্চল। এই অবস্থানটি একটি পক্ষপাত হিসেবে কাজ করে, যার অর্থ প্রদত্ত অবস্থানের আশেপাশের ফলাফলও দেখানো হতে পারে।
| JSON উপস্থাপনা |
|---|
{ // Union field |
| ক্ষেত্র | |
|---|---|
ইউনিয়ন ফিল্ডের | |
rectangle | উত্তর-পূর্ব এবং দক্ষিণ-পশ্চিম কোণ দ্বারা সংজ্ঞায়িত একটি আয়তক্ষেত্রাকার বক্স। |
circle | কেন্দ্রবিন্দু ও ব্যাসার্ধ দ্বারা সংজ্ঞায়িত একটি বৃত্ত। |
অবস্থান সীমাবদ্ধতা
অনুসন্ধানের অঞ্চল। এই অবস্থানটি একটি সীমাবদ্ধতা হিসেবে কাজ করে, যার অর্থ প্রদত্ত অবস্থানের বাইরের কোনো ফলাফল দেখানো হবে না।
| JSON উপস্থাপনা |
|---|
{ // Union field |
| ক্ষেত্র | |
|---|---|
ইউনিয়ন ফিল্ডের | |
rectangle | উত্তর-পূর্ব এবং দক্ষিণ-পশ্চিম কোণ দ্বারা সংজ্ঞায়িত একটি আয়তক্ষেত্রাকার বক্স। |
ইভিঅপশনস
একটি স্থান অনুসন্ধানের অনুরোধের অনুসন্ধানযোগ্য বৈদ্যুতিক গাড়ির বিকল্পসমূহ।
| JSON উপস্থাপনা |
|---|
{
"minimumChargingRateKw": number,
"connectorTypes": [
enum ( |
| ক্ষেত্র | |
|---|---|
minimumChargingRateKw | ঐচ্ছিক। কিলোওয়াটে ন্যূনতম প্রয়োজনীয় চার্জিং হার। নির্দিষ্ট হারের চেয়ে কম চার্জিং হারযুক্ত স্থান ফিল্টার করে বাদ দেওয়া হয়। |
connectorTypes[] | ঐচ্ছিক। পছন্দের ইভি কানেক্টর প্রকারের তালিকা। যে স্থান তালিকাভুক্ত কোনো কানেক্টর প্রকার সমর্থন করে না, তা ফিল্টার করে বাদ দেওয়া হয়। |
SearchAlongRouteParameters
রাউটস এপিআই (Routes API) থেকে একটি পূর্ব-গণনাকৃত পলিলাইন নির্দিষ্ট করে, যা অনুসন্ধানের জন্য রুটটি নির্ধারণ করে। একটি রুট বরাবর অনুসন্ধান করা, অনুসন্ধানের ফলাফলকে প্রভাবিত করার জন্য locationBias বা locationRestriction রিকোয়েস্ট অপশন ব্যবহার করার মতোই। তবে, locationBias এবং locationRestriction অপশনগুলো আপনাকে অনুসন্ধানের ফলাফলকে প্রভাবিত করার জন্য একটি অঞ্চল নির্দিষ্ট করতে দেয়, কিন্তু এই অপশনটি আপনাকে একটি ট্রিপ রুট বরাবর ফলাফলকে প্রভাবিত করতে দেয়।
ফলাফল প্রদত্ত পথ বরাবরই থাকবে এমন কোনো নিশ্চয়তা নেই, বরং পলিলাইন এবং ঐচ্ছিকভাবে locationBias বা locationRestriction দ্বারা সংজ্ঞায়িত অনুসন্ধান এলাকার মধ্যে উৎস থেকে গন্তব্যে পৌঁছানোর ন্যূনতম ঘুরপথের সময়ের উপর ভিত্তি করে সেগুলোকে র্যাঙ্ক করা হয়। ফলাফল কোনো বিকল্প পথেও হতে পারে, বিশেষ করে যদি প্রদত্ত পলিলাইনটি উৎস থেকে গন্তব্যে পৌঁছানোর জন্য কোনো সর্বোত্তম পথ নির্দেশ না করে।
| JSON উপস্থাপনা |
|---|
{
"polyline": {
object ( |
| ক্ষেত্র | |
|---|---|
polyline | প্রয়োজনীয় রুট পলিলাইন। |
পলিলাইন
একটি রাউট পলিলাইন। এটি শুধুমাত্র একটি এনকোডেড পলিলাইন সমর্থন করে, যা একটি স্ট্রিং হিসাবে পাস করা যেতে পারে এবং এতে ন্যূনতম লসিনেস সহ কম্প্রেশন অন্তর্ভুক্ত থাকে। এটি রাউটস এপিআই-এর ডিফল্ট আউটপুট।
| JSON উপস্থাপনা |
|---|
{ // Union field |
| ক্ষেত্র | |
|---|---|
ইউনিয়ন ফিল্ড polyline_type পলিলাইনের ধরনকে আবদ্ধ করে। রাউটস এপিআই-এর আউটপুট ডিফল্টভাবে encoded_polyline হয়। polyline_type নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে: | |
encodedPolyline | একটি এনকোডেড পলিলাইন , যা রাউটস এপিআই ডিফল্টরূপে ফেরত দেয়। এনকোডার এবং ডিকোডার টুলগুলো দেখুন। |
প্রাসঙ্গিক বিষয়বস্তু
স্থান-সংক্রান্ত অনুসন্ধানের সাথে প্রাসঙ্গিক বিষয়বস্তু।
| JSON উপস্থাপনা |
|---|
{ "reviews": [ { object ( |
| ক্ষেত্র | |
|---|---|
reviews[] | স্থান সম্পর্কিত অনুসন্ধানের পরিপ্রেক্ষিতে এই স্থানটি সম্পর্কে পর্যালোচনার তালিকা। |
photos[] | স্থান সম্পর্কিত অনুসন্ধানের পরিপ্রেক্ষিতে, এই স্থানের ছবি সংক্রান্ত তথ্য (তথ্যসূত্র সহ)। |
justifications[] | স্থানটির যৌক্তিকতা। |
ন্যায্যতা
স্থানটির যৌক্তিকতা। যৌক্তিকতা এই প্রশ্নের উত্তর দেয় যে, কেন একটি স্থান একজন চূড়ান্ত ব্যবহারকারীর কাছে আকর্ষণীয় হতে পারে।
| JSON উপস্থাপনা |
|---|
{ // Union field |
| ক্ষেত্র | |
|---|---|
ইউনিয়ন ক্ষেত্রের | |
reviewJustification | |
businessAvailabilityAttributesJustification | |
পর্যালোচনার যৌক্তিকতা
ব্যবহারকারী পর্যালোচনার যৌক্তিকতা। এটি ব্যবহারকারী পর্যালোচনার এমন একটি অংশকে তুলে ধরে যা একজন সাধারণ ব্যবহারকারীর জন্য আগ্রহের বিষয় হতে পারে। উদাহরণস্বরূপ, যদি সার্চ কোয়েরিটি "firewood pizza" হয়, তাহলে পর্যালোচনার যৌক্তিকতাটি সার্চ কোয়েরির সাথে প্রাসঙ্গিক লেখাটিকে তুলে ধরে।
| JSON উপস্থাপনা |
|---|
{ "highlightedText": { object ( |
| ক্ষেত্র | |
|---|---|
highlightedText | |
review | যে পর্যালোচনা থেকে হাইলাইট করা লেখাটি তৈরি করা হয়েছে। |
হাইলাইট করা টেক্সট
জাস্টিফিকেশন দ্বারা হাইলাইট করা টেক্সট। এটি মূল রিভিউটিরই একটি অংশ। হাইলাইট করার জন্য নির্দিষ্ট শব্দটি HighlightedTextRange দ্বারা চিহ্নিত করা থাকে। হাইলাইট করা টেক্সটটিতে একাধিক শব্দ থাকতে পারে।
| JSON উপস্থাপনা |
|---|
{
"text": string,
"highlightedTextRanges": [
{
object ( |
| ক্ষেত্র | |
|---|---|
text | |
highlightedTextRanges[] | হাইলাইট করা টেক্সটের রেঞ্জগুলোর তালিকা। |
হাইলাইট করা টেক্সট রেঞ্জ
হাইলাইট করা টেক্সটের পরিসর।
| JSON উপস্থাপনা |
|---|
{ "startIndex": integer, "endIndex": integer } |
| ক্ষেত্র | |
|---|---|
startIndex | |
endIndex | |
ব্যবসায়িক প্রাপ্যতা বৈশিষ্ট্য ন্যায্যতা
BusinessAvailabilityAttributes-এর যৌক্তিকতা। এটি একটি ব্যবসার এমন কিছু বৈশিষ্ট্য তুলে ধরে যা একজন অন্তিম ব্যবহারকারীর আগ্রহ জাগাতে পারে।
| JSON উপস্থাপনা |
|---|
{ "takeout": boolean, "delivery": boolean, "dineIn": boolean } |
| ক্ষেত্র | |
|---|---|
takeout | যদি কোনো জায়গা টেকআউটের ব্যবস্থা রাখে। |
delivery | যদি কোনো জায়গা ডেলিভারি দিয়ে থাকে। |
dineIn | যদি কোনো জায়গায় বসে খাওয়ার ব্যবস্থা থাকে |