- HTTP অনুরোধ
- অনুরোধের মূল অংশ
- প্রতিক্রিয়া মূল অংশ
- অনুমোদনের সুযোগ
- র্যাঙ্কপ্রেফারেন্স
- অবস্থান পক্ষপাত
- অবস্থান বিধিনিষেধ
- EVOptions সম্পর্কে
- সার্চঅলংরুট প্যারামিটার
- পলিলাইন
- প্রাসঙ্গিকবিষয়বস্তু
- যুক্তি
- পর্যালোচনাযথার্থতা
- হাইলাইটেডটেক্সট
- হাইলাইট করা টেক্সটরেঞ্জ
- ব্যবসাউপলব্ধতাগুণসমূহযথার্থতা
টেক্সট কোয়েরি ভিত্তিক স্থান অনুসন্ধান।
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 | বর্তমানে খোলা জায়গাগুলিতে অনুসন্ধান সীমাবদ্ধ করতে ব্যবহৃত হয়। ডিফল্ট হল মিথ্যা। |
minRating | যেসব ফলাফলের গড় ব্যবহারকারী রেটিং এই সীমার চেয়ে কম, সেগুলিকে ফিল্টার করুন। একটি বৈধ মান 0.5 ক্যাডেন্সে 0 থেকে 5 (সমেত) এর মধ্যে একটি ফ্লোট হতে হবে অর্থাৎ [0, 0.5, 1.0, ..., 5.0] সমেত। ইনপুট রেটিংটি নিকটতম 0.5 (সিলিং) পর্যন্ত পূর্ণ হবে। উদাহরণস্বরূপ, 0.6 রেটিং 1.0 এর কম রেটিং সহ সমস্ত ফলাফল বাদ দেবে। |
maxResultCount | অবচিত: পরিবর্তে প্রতি পৃষ্ঠায় সর্বোচ্চ কতগুলি ফলাফল ফেরত দেওয়া যাবে। যদি উপলব্ধ ফলাফলের সংখ্যা যদি |
pageSize | ঐচ্ছিক। প্রতি পৃষ্ঠায় সর্বোচ্চ কত ফলাফল ফেরত দেওয়া যাবে। যদি উপলব্ধ ফলাফলের সংখ্যা যদি |
pageToken | ঐচ্ছিক। পূর্ববর্তী টেক্সটসার্চ কল থেকে প্রাপ্ত একটি পৃষ্ঠা টোকেন। পরবর্তী পৃষ্ঠাটি পুনরুদ্ধার করার জন্য এটি প্রদান করুন। পৃষ্ঠাকরণের সময়, TextSearch-এ প্রদত্ত |
priceLevels[] | নির্দিষ্ট মূল্য স্তর হিসাবে চিহ্নিত স্থানগুলিতে অনুসন্ধান সীমাবদ্ধ করতে ব্যবহৃত হয়। ব্যবহারকারীরা মূল্য স্তরের যেকোনো সমন্বয় বেছে নিতে পারেন। সমস্ত মূল্য স্তর নির্বাচন করার জন্য ডিফল্ট। |
strictTypeFiltering | includedType-এর জন্য কঠোর টাইপ ফিল্টারিং সেট করতে ব্যবহৃত হয়। যদি true তে সেট করা হয়, তাহলে শুধুমাত্র একই ধরণের ফলাফলই ফেরত পাঠানো হবে। ডিফল্ট হিসেবে false। |
locationBias | অনুসন্ধানের জন্য অঞ্চল। এই অবস্থানটি একটি পক্ষপাত হিসাবে কাজ করে যার অর্থ প্রদত্ত অবস্থানের আশেপাশের ফলাফলগুলি ফেরত পাঠানো হতে পারে। অবস্থানের সীমাবদ্ধতার সাথে সেট করা যাবে না। |
locationRestriction | অনুসন্ধানের জন্য অঞ্চল। এই অবস্থানটি একটি সীমাবদ্ধতা হিসেবে কাজ করে যার অর্থ প্রদত্ত অবস্থানের বাইরের ফলাফলগুলি ফেরত পাঠানো হবে না। অবস্থান-বিয়াসের সাথে সেট করা যাবে না। |
evOptions | ঐচ্ছিক। স্থান অনুসন্ধানের অনুরোধের অনুসন্ধানযোগ্য EV বিকল্পগুলি সেট করুন। |
routingParameters | ঐচ্ছিক। ফলাফলে রাউটিংয়ের জন্য অতিরিক্ত পরামিতি। |
searchAlongRouteParameters | ঐচ্ছিক। রুট ধরে অনুসন্ধানের জন্য অতিরিক্ত প্যারামিটার প্রোটো। |
includePureServiceAreaBusinesses | ঐচ্ছিক। যদি ক্ষেত্রটি সত্য হিসেবে সেট করা থাকে তবে বিশুদ্ধ পরিষেবা এলাকার ব্যবসাগুলি অন্তর্ভুক্ত করুন। বিশুদ্ধ পরিষেবা এলাকার ব্যবসা হল এমন একটি ব্যবসা যা সরাসরি গ্রাহকদের কাছে যায় বা তাদের কাছে ডেলিভারি দেয় কিন্তু গ্রাহকদের তাদের ব্যবসায়িক ঠিকানায় পরিষেবা দেয় না। উদাহরণস্বরূপ, পরিষ্কারের পরিষেবা বা প্লাম্বারদের মতো ব্যবসা। এই ব্যবসাগুলির Google মানচিত্রে কোনও প্রকৃত ঠিকানা বা অবস্থান নেই। স্থানগুলি এই ব্যবসাগুলির জন্য |
প্রতিক্রিয়া মূল অংশ
places.searchText এর জন্য প্রতিক্রিয়া প্রোটো।
যদি সফল হয়, তাহলে রেসপন্স বডিতে নিম্নলিখিত কাঠামো সহ ডেটা থাকবে:
| JSON উপস্থাপনা |
|---|
{ "places": [ { object ( |
| ক্ষেত্র | |
|---|---|
places[] | ব্যবহারকারীর টেক্সট অনুসন্ধানের মানদণ্ড পূরণ করে এমন স্থানের একটি তালিকা। |
routingSummaries[] | রাউটিং সারাংশের একটি তালিকা যেখানে প্রতিটি এন্ট্রি |
contextualContents[] | পরীক্ষামূলক: আরও বিস্তারিত জানার জন্য https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative দেখুন। প্রাসঙ্গিক বিষয়বস্তুর একটি তালিকা যেখানে প্রতিটি এন্ট্রি স্থান ক্ষেত্রের একই সূচীতে সংশ্লিষ্ট স্থানের সাথে সম্পর্কিত। অনুরোধে থাকা |
nextPageToken | একটি টোকেন যা পরবর্তী পৃষ্ঠাটি পুনরুদ্ধার করার জন্য |
searchUri | একটি লিঙ্ক ব্যবহারকারীকে গুগল ম্যাপে অনুরোধে উল্লেখিত একই টেক্সট কোয়েরি দিয়ে অনুসন্ধান করতে দেয়। |
অনুমোদনের সুযোগ
নিম্নলিখিত OAuth স্কোপ প্রয়োজন:
-
https://www.googleapis.com/auth/cloud-platform
র্যাঙ্কপ্রেফারেন্স
উত্তরে ফলাফল কীভাবে র্যাঙ্ক করা হবে।
| এনামস | |
|---|---|
RANK_PREFERENCE_UNSPECIFIED | "নিউ ইয়র্ক সিটির রেস্তোরাঁ" এর মতো শ্রেণীবদ্ধ প্রশ্নের জন্য, RELEVANCE ডিফল্ট। "মাউন্টেন ভিউ, CA" এর মতো শ্রেণীবদ্ধ প্রশ্নের জন্য আমরা আপনাকে rankPreference সেট না করে রাখার পরামর্শ দিচ্ছি। |
DISTANCE | দূরত্ব অনুসারে ফলাফল র্যাঙ্ক করে। |
RELEVANCE | প্রাসঙ্গিকতা অনুসারে ফলাফল র্যাঙ্ক করে। স্বাভাবিক র্যাঙ্কিং স্ট্যাক অনুসারে সাজানোর ক্রম নির্ধারণ করা হয়। |
অবস্থান পক্ষপাত
অনুসন্ধানের জন্য অঞ্চল। এই অবস্থানটি একটি পক্ষপাত হিসাবে কাজ করে যার অর্থ প্রদত্ত অবস্থানের আশেপাশে ফলাফলগুলি ফেরত পাঠানো হতে পারে।
| JSON উপস্থাপনা |
|---|
{ // Union field |
| ক্ষেত্র | |
|---|---|
ইউনিয়ন ক্ষেত্রের | |
rectangle | উত্তর-পূর্ব এবং দক্ষিণ-পশ্চিম কোণ দ্বারা সংজ্ঞায়িত একটি আয়তক্ষেত্রাকার বাক্স। |
circle | কেন্দ্রবিন্দু এবং ব্যাসার্ধ দ্বারা সংজ্ঞায়িত একটি বৃত্ত। |
অবস্থান বিধিনিষেধ
অনুসন্ধানের জন্য অঞ্চল। এই অবস্থানটি একটি সীমাবদ্ধতা হিসেবে কাজ করে যার অর্থ প্রদত্ত অবস্থানের বাইরের ফলাফলগুলি ফেরত পাঠানো হবে না।
| JSON উপস্থাপনা |
|---|
{ // Union field |
| ক্ষেত্র | |
|---|---|
ইউনিয়ন ক্ষেত্রের | |
rectangle | উত্তর-পূর্ব এবং দক্ষিণ-পশ্চিম কোণ দ্বারা সংজ্ঞায়িত একটি আয়তক্ষেত্রাকার বাক্স। |
EVOptions সম্পর্কে
স্থান অনুসন্ধানের অনুরোধের অনুসন্ধানযোগ্য EV বিকল্পগুলি।
| JSON উপস্থাপনা |
|---|
{
"minimumChargingRateKw": number,
"connectorTypes": [
enum ( |
| ক্ষেত্র | |
|---|---|
minimumChargingRateKw | ঐচ্ছিক। কিলোওয়াটে প্রয়োজনীয় ন্যূনতম চার্জিং হার। নির্দিষ্ট হারের চেয়ে কম চার্জিং হার সহ একটি স্থান ফিল্টার করা হয়। |
connectorTypes[] | ঐচ্ছিক। পছন্দের EV সংযোগকারীর প্রকারের তালিকা। তালিকাভুক্ত সংযোগকারীর প্রকারগুলির কোনওটিই সমর্থন করে না এমন একটি স্থান ফিল্টার করা হয়েছে। |
সার্চঅলংরুট প্যারামিটার
Routes API থেকে একটি পূর্বনির্ধারিত পলিলাইন নির্দিষ্ট করে যা অনুসন্ধানের রুট নির্ধারণ করে। একটি রুট ধরে অনুসন্ধান করা অনুসন্ধান ফলাফলগুলিকে পক্ষপাতী করার জন্য locationBias বা locationRestriction অনুরোধ বিকল্প ব্যবহার করার অনুরূপ। তবে, locationBias এবং locationRestriction বিকল্পগুলি আপনাকে অনুসন্ধান ফলাফলগুলিকে পক্ষপাতী করার জন্য একটি অঞ্চল নির্দিষ্ট করতে দেয়, এই বিকল্পটি আপনাকে একটি ট্রিপ রুট বরাবর ফলাফলগুলিকে পক্ষপাতী করার অনুমতি দেয়।
ফলাফলগুলি প্রদত্ত রুটেই থাকার নিশ্চয়তা দেওয়া হয় না, বরং পলিলাইন দ্বারা নির্ধারিত অনুসন্ধান এলাকার মধ্যে এবং ঐচ্ছিকভাবে, locationBias বা locationRestriction অনুসারে স্থান নির্ধারণ করা হয়। ফলাফলগুলি বিকল্প রুটেই থাকতে পারে, বিশেষ করে যদি প্রদত্ত পলিলাইনটি উৎপত্তিস্থল থেকে গন্তব্যস্থলে যাওয়ার সর্বোত্তম রুট নির্ধারণ না করে।
| JSON উপস্থাপনা |
|---|
{
"polyline": {
object ( |
| ক্ষেত্র | |
|---|---|
polyline | প্রয়োজনীয়। রুট পলিলাইন। |
পলিলাইন
একটি রুট পলিলাইন। শুধুমাত্র একটি এনকোডেড পলিলাইন সমর্থন করে, যা একটি স্ট্রিং হিসাবে পাস করা যেতে পারে এবং ন্যূনতম ক্ষতি সহ কম্প্রেশন অন্তর্ভুক্ত করে। এটি হল রুটস API ডিফল্ট আউটপুট।
| JSON উপস্থাপনা |
|---|
{ // Union field |
| ক্ষেত্র | |
|---|---|
Union ফিল্ড polyline_type । পলিলাইনের ধরণকে এনক্যাপসুলেট করে। API আউটপুটকে ডিফল্টভাবে encoded_polyline এ রুট করে। polyline_type নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে: | |
encodedPolyline | একটি এনকোডেড পলিলাইন , যা ডিফল্টরূপে Routes API দ্বারা ফেরত পাঠানো হয়। এনকোডার এবং ডিকোডার টুলগুলি দেখুন। |
প্রাসঙ্গিকবিষয়বস্তু
পরীক্ষামূলক: আরও বিস্তারিত জানার জন্য https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative দেখুন।
স্থানের প্রশ্নের সাথে প্রাসঙ্গিক কন্টেন্ট।
| JSON উপস্থাপনা |
|---|
{ "reviews": [ { object ( |
| ক্ষেত্র | |
|---|---|
reviews[] | এই স্থান সম্পর্কে পর্যালোচনার তালিকা, স্থানের প্রশ্নের সাথে প্রাসঙ্গিক। |
photos[] | এই স্থানের ছবি সম্পর্কে তথ্য (রেফারেন্স সহ), স্থানের প্রশ্নের সাথে প্রাসঙ্গিক। |
justifications[] | পরীক্ষামূলক: আরও বিস্তারিত জানার জন্য https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative দেখুন। স্থানটির পক্ষে যুক্তি। |
যুক্তি
পরীক্ষামূলক: আরও বিস্তারিত জানার জন্য https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative দেখুন।
স্থানের যুক্তি। যুক্তি কেন একটি স্থান একজন শেষ ব্যবহারকারীর আগ্রহের কারণ হতে পারে এই প্রশ্নের উত্তর দেয়।
| JSON উপস্থাপনা |
|---|
{ // Union field |
| ক্ষেত্র | |
|---|---|
ইউনিয়ন ক্ষেত্রের | |
reviewJustification | পরীক্ষামূলক: আরও বিস্তারিত জানার জন্য https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative দেখুন। |
businessAvailabilityAttributesJustification | পরীক্ষামূলক: আরও বিস্তারিত জানার জন্য https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative দেখুন। |
পর্যালোচনাযথার্থতা
পরীক্ষামূলক: আরও বিস্তারিত জানার জন্য https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative দেখুন।
ব্যবহারকারীর পর্যালোচনার যুক্তি। এটি ব্যবহারকারীর পর্যালোচনার এমন একটি অংশ তুলে ধরে যা একজন শেষ ব্যবহারকারীর আগ্রহের কারণ হবে। উদাহরণস্বরূপ, যদি অনুসন্ধান কোয়েরিটি "ফায়ারউড পিৎজা" হয়, তাহলে পর্যালোচনার যুক্তি অনুসন্ধান কোয়েরির সাথে প্রাসঙ্গিক পাঠ্যটি তুলে ধরে।
| JSON উপস্থাপনা |
|---|
{ "highlightedText": { object ( |
| ক্ষেত্র | |
|---|---|
highlightedText | |
review | হাইলাইট করা টেক্সটটি যে পর্যালোচনা থেকে তৈরি করা হয়েছে। |
হাইলাইটেডটেক্সট
যুক্তি দ্বারা হাইলাইট করা টেক্সট। এটি পর্যালোচনার একটি উপসেট। হাইলাইট করার জন্য সঠিক শব্দটি হাইলাইটেডটেক্সটরেঞ্জ দ্বারা চিহ্নিত করা হয়েছে। হাইলাইট করা টেক্সটে বেশ কয়েকটি শব্দ থাকতে পারে।
| JSON উপস্থাপনা |
|---|
{
"text": string,
"highlightedTextRanges": [
{
object ( |
| ক্ষেত্র | |
|---|---|
text | |
highlightedTextRanges[] | হাইলাইট করা টেক্সটের রেঞ্জের তালিকা। |
হাইলাইট করা টেক্সটরেঞ্জ
হাইলাইট করা টেক্সটের পরিসর।
| JSON উপস্থাপনা |
|---|
{ "startIndex": integer, "endIndex": integer } |
| ক্ষেত্র | |
|---|---|
startIndex | |
endIndex | |
ব্যবসাউপলব্ধতাগুণসমূহযথার্থতা
পরীক্ষামূলক: আরও বিস্তারিত জানার জন্য https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative দেখুন। BusinessAvailabilityAttributes-এর যুক্তি। এটি এমন কিছু বৈশিষ্ট্য দেখায় যা একজন ব্যবহারকারীর আগ্রহের কারণ হতে পারে।
| JSON উপস্থাপনা |
|---|
{ "takeout": boolean, "delivery": boolean, "dineIn": boolean } |
| ক্ষেত্র | |
|---|---|
takeout | যদি কোনও জায়গায় খাবারের ব্যবস্থা থাকে। |
delivery | যদি কোন জায়গা থেকে ডেলিভারি দেওয়া হয়। |
dineIn | যদি কোন জায়গায় খাবারের ব্যবস্থা থাকে। |