ভূমিকা
টেক্সট সার্চ (নতুন) একটি স্ট্রিং-এর উপর ভিত্তি করে একগুচ্ছ স্থান সম্পর্কে তথ্য প্রদান করে (উদাহরণস্বরূপ, "নিউ ইয়র্কে পিৎজা" বা "অটোয়ার কাছে জুতার দোকান" বা "১২৩ মেইন স্ট্রিট")। পরিষেবাটি টেক্সট স্ট্রিংটির সাথে মিলে যাওয়া স্থানগুলির একটি তালিকা এবং সেট করা যেকোনো অবস্থানগত পক্ষপাত সহ প্রতিক্রিয়া জানায়।
প্রয়োজনীয় প্যারামিটারগুলোর পাশাপাশি, টেক্সট সার্চ (নতুন) আরও ভালো ফলাফলের জন্য ঐচ্ছিক প্যারামিটার ব্যবহার করে কোয়েরি পরিমার্জন করার সুবিধা দেয়।
এপিআই এক্সপ্লোরার আপনাকে সরাসরি অনুরোধ করার সুযোগ দেয়, যাতে আপনি এপিআই এবং এর অপশনগুলোর সাথে পরিচিত হতে পারেন:
টেক্সট সার্চ (নতুন) অনুরোধ
একটি টেক্সট সার্চ (নতুন) অনুরোধ হলো নিম্নলিখিত ফর্মের একটি HTTP POST অনুরোধ:
https://places.googleapis.com/v1/places:searchText
POST অনুরোধের অংশ হিসেবে সমস্ত প্যারামিটার JSON অনুরোধের বডিতে অথবা হেডারে পাঠান। উদাহরণস্বরূপ:
curl -X POST -d '{
"textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel' \
'https://places.googleapis.com/v1/places:searchText'টেক্সট সার্চ (নতুন) প্রতিক্রিয়া
টেক্সট সার্চ (নতুন) প্রতিক্রিয়া হিসাবে একটি JSON অবজেক্ট ফেরত দেয়। প্রতিক্রিয়ার মধ্যে:
-
placesঅ্যারেটিতে সমস্ত মিলে যাওয়া স্থানগুলো রয়েছে। - অ্যারের প্রতিটি স্থান একটি
Placeঅবজেক্ট দ্বারা উপস্থাপিত হয়।Placeঅবজেক্টটিতে একটি নির্দিষ্ট স্থান সম্পর্কে বিস্তারিত তথ্য থাকে। - অনুরোধে প্রদত্ত FieldMask,
Placeঅবজেক্টে ফেরত আসা ফিল্ডগুলোর তালিকা নির্দিষ্ট করে। - একই ধরনের অনুরোধের ক্ষেত্রে ফেরত আসা স্থানগুলির তালিকা সামঞ্জস্যপূর্ণ হবে এমন কোনো নিশ্চয়তা নেই।
সম্পূর্ণ JSON অবজেক্টটি নিম্নলিখিত আকারে থাকে:
{
"places": [
{
object (Place)
}
]
}প্রয়োজনীয় প্যারামিটার
ফিল্ডমাস্ক
একটি রেসপন্স ফিল্ড মাস্ক তৈরি করে রেসপন্সে ফেরত আসা ফিল্ডগুলোর তালিকা নির্দিষ্ট করুন। URL প্যারামিটার
$fieldsবাfieldsব্যবহার করে, অথবা HTTP হেডারX-Goog-FieldMaskব্যবহার করে রেসপন্স ফিল্ড মাস্কটি মেথডে পাস করুন। রেসপন্সে ফেরত আসা ফিল্ডগুলোর কোনো ডিফল্ট তালিকা নেই। আপনি যদি ফিল্ড মাস্কটি বাদ দেন, তাহলে মেথডটি একটি এরর ফেরত দেবে।ফিল্ড মাস্কিং একটি ভালো ডিজাইন পদ্ধতি, যা অপ্রয়োজনীয় ডেটা অনুরোধ করা থেকে বিরত রাখে এবং এর ফলে অপ্রয়োজনীয় প্রসেসিং সময় ও বিলিং চার্জ এড়ানো যায়।
ফেরত পাওয়ার জন্য স্থানের ডেটা টাইপগুলোর একটি কমা-দ্বারা-বিভক্ত তালিকা নির্দিষ্ট করুন। উদাহরণস্বরূপ, স্থানটির প্রদর্শিত নাম এবং ঠিকানা পুনরুদ্ধার করতে।
X-Goog-FieldMask: places.displayName,places.formattedAddress
সমস্ত ফিল্ড পুনরুদ্ধার করতে
*ব্যবহার করুন।X-Goog-FieldMask: *
নিম্নলিখিত ক্ষেত্রগুলির মধ্যে এক বা একাধিক নির্দিষ্ট করুন:
নিম্নলিখিত ফিল্ডগুলি টেক্সট সার্চ এসেনশিয়ালস আইডি অনলি এসকেইউ (Text Search Essentials ID Only SKU) সক্রিয় করে:
places.attributions
places.id
places.name*
nextPageToken
places.movedPlace
places.movedPlaceIdplaces.name ফিল্ডটিতে স্থান রিসোর্সের নামটি
places/ PLACE_IDআকারে থাকে। স্থানটির টেক্সট নামটি অ্যাক্সেস করতে Pro SKU-তেplaces.displayNameব্যবহার করুনplaces.nameনিম্নলিখিত ফিল্ডগুলি টেক্সট সার্চ প্রো SKU সক্রিয় করে:
places.accessibilityOptions
places.addressComponents
places.addressDescriptor*
places.adrFormatAddress
places.businessStatus
places.containingPlaces
places.displayName
places.formattedAddress
places.googleMapsLinks
places.googleMapsUri
places.iconBackgroundColor
places.iconMaskBaseUri
places.location
places.openingDate
places.photos
places.plusCode
places.postalAddress
places.primaryType
places.primaryTypeDisplayName
places.pureServiceAreaBusiness
places.shortFormattedAddress
places.searchUri
places.subDestinations
places.timeZone
places.types
places.utcOffsetMinutes
places.viewport
ঠিকানা বর্ণনাকারী সাধারণত ভারতের গ্রাহকদের জন্য উপলব্ধ এবং অন্যত্র পরীক্ষামূলক পর্যায়ে রয়েছে।নিম্নলিখিত ফিল্ডগুলি টেক্সট সার্চ এন্টারপ্রাইজ SKU সক্রিয় করে:
places.currentOpeningHours
places.currentSecondaryOpeningHours
places.internationalPhoneNumber
places.nationalPhoneNumber
places.priceLevel
places.priceRange
places.rating
places.regularOpeningHours
places.regularSecondaryOpeningHours
places.userRatingCount
places.websiteUriনিম্নলিখিত ফিল্ডগুলি টেক্সট সার্চ এন্টারপ্রাইজ + অ্যাটমোস্ফিয়ার SKU সক্রিয় করে:
places.allowsDogs
places.curbsidePickup
places.delivery
places.dineIn
places.editorialSummary
places.evChargeAmenitySummary
places.evChargeOptions
places.fuelOptions
places.generativeSummary
places.goodForChildren
places.goodForGroups
places.goodForWatchingSports
places.liveMusic
places.menuForChildren
places.neighborhoodSummary
places.parkingOptions
places.paymentOptions
places.outdoorSeating
places.reservable
places.restroom
places.reviews
places.reviewSummary
routingSummaries*
places.servesBeer
places.servesBreakfast
places.servesBrunch
places.servesCocktails
places.servesCoffee
places.servesDessert
places.servesDinner
places.servesLunch
places.servesVegetarianFood
places.servesWine
places.takeout
শুধুমাত্র টেক্সট সার্চ এবং কাছাকাছি সার্চ
টেক্সট কোয়েরি
যে টেক্সট স্ট্রিংটির উপর ভিত্তি করে অনুসন্ধান করা হবে। উদাহরণস্বরূপ, "restaurant", "123 Main Street", অথবা "Best place to visit in San Francisco"। এপিআই এই স্ট্রিংটির উপর ভিত্তি করে সম্ভাব্য ফলাফলগুলো ফেরত দেয় এবং তাদের অনুভূত প্রাসঙ্গিকতা অনুসারে সেগুলোকে সাজিয়ে রাখে।
টেক্সট সার্চ (নতুন) নিম্নলিখিত সহ দ্ব্যর্থক কোয়েরিগুলির জন্য উদ্দিষ্ট নয় :
কোয়েরি টাইপ উদাহরণ একটি কোয়েরিতে একাধিক স্থান, রাস্তা বা শহরের নামের মতো অনেক বেশি ধারণা বা সীমাবদ্ধতা। "মার্কেট স্ট্রিট সান ফ্রান্সিসকো সান হোসে বিমানবন্দর" গুগল ম্যাপে ডাক ঠিকানার যে উপাদানগুলো দেখানো হয় না "জন স্মিথের তত্ত্বাবধানে, ১২৩ মেইন স্ট্রিট"
পোস্ট অফিস বক্স ১৩ সান ফ্রান্সিসকোব্যবসা, চেইন বা ক্যাটাগরির নাম, সেইসাথে এমন স্থান যেখানে এই সত্তাগুলো উপলব্ধ নয়। ডালাস, টেক্সাসের নিকটবর্তী টেসকো একাধিক ব্যাখ্যা সহ দ্ব্যর্থক প্রশ্ন চার্জার ড্রপ-অফ ঐতিহাসিক নাম যা এখন আর ব্যবহৃত হয় না "মিডলসেক্স যুক্তরাজ্য" অ-ভূস্থানিক উপাদান বা উদ্দেশ্য ভেনচুরা বন্দরে কয়টি নৌকা আছে? অনানুষ্ঠানিক বা শখের নাম "জেঙ্গা"
"দ্য হেল্টার স্কেল্টার"অক্ষাংশ এবং দ্রাঘিমাংশ স্থানাঙ্ক "৩৭.৪২২১৩১,-১২২.০৮৪৮০১"
ঐচ্ছিক পরামিতি
includeFutureOpeningBusinesses
যদি
true, তাহলে ভবিষ্যতে চালু হতে পারে এমন ব্যবসা প্রতিষ্ঠানগুলো ফেরত দেবে। ডিফল্ট মান 'false।
ব্যবসার স্ট্যাটাস জানতে, আপনার রিকোয়েস্ট ফিল্ড মাস্কেplaces.businessStatusঅন্তর্ভুক্ত করুন। ব্যবসার প্রত্যাশিত উদ্বোধনের তারিখ জানতে, আপনার রিকোয়েস্ট ফিল্ড মাস্কেplaces.openingDateঅন্তর্ভুক্ত করুন।অন্তর্ভুক্ত প্রকার
টেবিল A দ্বারা সংজ্ঞায়িত নির্দিষ্ট ধরণের সাথে মেলে এমন স্থানগুলির দিকে ফলাফলকে পক্ষপাতদুষ্ট করে। শুধুমাত্র একটি ধরণ নির্দিষ্ট করা যেতে পারে। উদাহরণস্বরূপ:
-
"includedType":"bar" -
"includedType":"pharmacy"
টেক্সট সার্চ (নতুন) নির্দিষ্ট কিছু কোয়েরির ক্ষেত্রে, প্রযোজ্যতার উপর নির্ভর করে টাইপ ফিল্টারিং প্রয়োগ করে। উদাহরণস্বরূপ, নির্দিষ্ট ঠিকানার ("123 Main Street") কোয়েরির ক্ষেত্রে টাইপ ফিল্টারিং প্রয়োগ নাও হতে পারে, কিন্তু ক্যাটাগরিক্যাল কোয়েরির ("কাছাকাছি দোকান" বা "শপিং মল") ক্ষেত্রে এটি প্রায় সবসময়ই প্রয়োগ করা হয়।
সমস্ত কোয়েরিতে টাইপ ফিল্টারিং প্রয়োগ করতে,
strictTypeFilteringকেtrueসেট করুন।-
বিশুদ্ধ পরিষেবা এলাকার ব্যবসা অন্তর্ভুক্ত করুন
যদি '
trueসেট করা হয়, তাহলে রেসপন্সে সেইসব ব্যবসাও অন্তর্ভুক্ত হবে যারা সরাসরি গ্রাহকদের কাছে যায় বা ডেলিভারি করে, কিন্তু যাদের কোনো ভৌত ব্যবসায়িক ঠিকানা নেই। যদিfalseসেট করা হয়, তাহলে API শুধুমাত্র সেইসব ব্যবসাকেই রিটার্ন করবে যাদের ভৌত ব্যবসায়িক ঠিকানা আছে।ভাষা কোড
যে ভাষায় ফলাফল ফেরত দেওয়া হয়।
- সমর্থিত ভাষাগুলোর তালিকা দেখুন। গুগল প্রায়শই সমর্থিত ভাষাগুলো হালনাগাদ করে, তাই এই তালিকাটি সম্পূর্ণ নাও হতে পারে।
-
languageCodeসরবরাহ করা না হলে, API ডিফল্টরূপেenব্যবহার করে। আপনি যদি একটি অবৈধ ভাষা কোড নির্দিষ্ট করেন, তাহলে API একটিINVALID_ARGUMENTত্রুটি ফেরত দেয়। - এপিআইটি ব্যবহারকারী এবং স্থানীয় বাসিন্দা উভয়ের জন্য পাঠযোগ্য একটি রাস্তার ঠিকানা প্রদান করার জন্য যথাসাধ্য চেষ্টা করে। সেই লক্ষ্য অর্জনের জন্য, এটি পছন্দের ভাষাটি অনুসরণ করে রাস্তার ঠিকানাগুলো স্থানীয় ভাষায় ফেরত দেয় এবং প্রয়োজনে ব্যবহারকারীর পাঠযোগ্য লিপিতে তা প্রতিবর্ণীকরণ করে। অন্য সব ঠিকানা পছন্দের ভাষাতেই ফেরত দেওয়া হয়। ঠিকানার সমস্ত উপাদান একই ভাষায় ফেরত দেওয়া হয়, যা প্রথম উপাদানটি থেকে বেছে নেওয়া হয়।
- পছন্দের ভাষায় কোনো নাম উপলব্ধ না থাকলে, এপিআই সবচেয়ে কাছাকাছি মিল থাকা নামটি ব্যবহার করে।
- পছন্দের ভাষাটি এপিআই দ্বারা ফেরত দেওয়া ফলাফলের সেট এবং সেগুলোর ফেরত দেওয়ার ক্রমের উপর সামান্য প্রভাব ফেলে। জিওকোডার ভাষার উপর নির্ভর করে সংক্ষিপ্ত রূপগুলোকে ভিন্নভাবে ব্যাখ্যা করে, যেমন রাস্তার প্রকারের সংক্ষিপ্ত রূপ, বা এমন প্রতিশব্দ যা একটি ভাষায় বৈধ হলেও অন্য ভাষায় নয়।
অবস্থানগত পক্ষপাত
অনুসন্ধানের জন্য একটি এলাকা নির্দিষ্ট করে। এই অবস্থানটি একটি পক্ষপাত হিসেবে কাজ করে, যার অর্থ হলো নির্দিষ্ট এলাকার বাইরের ফলাফলসহ, নির্দিষ্ট অবস্থানের আশেপাশের ফলাফলগুলোও ফেরত দেওয়া হতে পারে।
আপনি
locationRestrictionঅথবাlocationBiasনির্দিষ্ট করতে পারেন, কিন্তু উভয়ই নয়।locationRestrictionকে এমন একটি অঞ্চল নির্দিষ্ট করা হিসেবে ভাবুন যার মধ্যে ফলাফল অবশ্যই থাকতে হবে, এবংlocationBiasএমন একটি অঞ্চল নির্দিষ্ট করা হিসেবে ভাবুন যার ভিতরে বা কাছাকাছি ফলাফল থাকার সম্ভাবনা রয়েছে, কিন্তু তা ওই এলাকার বাইরেও থাকতে পারে।অঞ্চলটিকে একটি আয়তাকার ভিউপোর্ট অথবা একটি বৃত্ত হিসাবে নির্দিষ্ট করুন।
একটি বৃত্তকে তার কেন্দ্রবিন্দু এবং মিটারে পরিমাপ করা ব্যাসার্ধ দ্বারা সংজ্ঞায়িত করা হয়। ব্যাসার্ধটি অবশ্যই ০.০ থেকে ৫০০০০.০-এর মধ্যে হতে হবে। ডিফল্ট ব্যাসার্ধ হলো ০.০। উদাহরণস্বরূপ:
"locationBias": { "circle": { "center": { "latitude": 37.7937, "longitude": -122.3965 }, "radius": 500.0 } }
একটি আয়তক্ষেত্র হলো একটি অক্ষাংশ-দ্রাঘিমাংশ ভিউপোর্ট, যা দুটি কর্ণানুযায়ী বিপরীত নিম্ন ও উচ্চ বিন্দু দ্বারা উপস্থাপিত হয়। নিম্ন বিন্দুটি আয়তক্ষেত্রটির দক্ষিণ-পশ্চিম কোণকে এবং উচ্চ বিন্দুটি এর উত্তর-পূর্ব কোণকে নির্দেশ করে।
একটি ভিউপোর্টকে একটি বদ্ধ অঞ্চল হিসেবে বিবেচনা করা হয়, যার অর্থ এটি তার সীমানাকে অন্তর্ভুক্ত করে। অক্ষাংশের সীমা অবশ্যই -৯০ থেকে ৯০ ডিগ্রির মধ্যে হতে হবে এবং দ্রাঘিমাংশের সীমা অবশ্যই -১৮০ থেকে ১৮০ ডিগ্রির মধ্যে হতে হবে।
- যদি
low=high, তাহলে ভিউপোর্টটি সেই একক বিন্দুটি নিয়ে গঠিত হয়। - যদি
low.longitude>high.longitude, তাহলে দ্রাঘিমাংশের পরিসরটি উল্টে যায় (ভিউপোর্টটি ১৮০ ডিগ্রি দ্রাঘিমা রেখা অতিক্রম করে)। - যদি
low.longitude= -180 ডিগ্রি এবংhigh.longitude= 180 ডিগ্রি হয়, তাহলে ভিউপোর্টে সমস্ত দ্রাঘিমাংশ অন্তর্ভুক্ত থাকবে। - যদি
low.longitude= 180 ডিগ্রি এবংhigh.longitude= -180 ডিগ্রি হয়, তাহলে দ্রাঘিমাংশের পরিসরটি খালি থাকে। - যদি
low.latitude>high.latitudeহয়, তাহলে অক্ষাংশের পরিসরটি খালি থাকে।
নিম্ন এবং উচ্চ উভয়ই অবশ্যই পূরণ করতে হবে এবং প্রদর্শিত বক্সটি খালি থাকতে পারবে না। একটি খালি ভিউপোর্টের ফলে ত্রুটি দেখা দেয়।
উদাহরণস্বরূপ, এই ভিউপোর্টটি নিউ ইয়র্ক শহরকে সম্পূর্ণরূপে ঘিরে রেখেছে:
"locationBias": { "rectangle": { "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } } }
- যদি
অবস্থান সীমাবদ্ধতা
শুধুমাত্র শ্রেণিভিত্তিক অনুসন্ধানের জন্য একটি এলাকা নির্দিষ্ট করে, যা একাধিক স্থানের ফলাফল দেখাতে পারে (উদাহরণস্বরূপ, "নিউ ইয়র্কের রেস্তোরাঁ" বা "শপিং মল")। নির্দিষ্ট এলাকার বাইরের ফলাফল দেখানো হয় না।
অঞ্চলটিকে একটি আয়তাকার ভিউপোর্ট হিসেবে নির্দিষ্ট করুন। ভিউপোর্ট নির্ধারণের একটি উদাহরণের জন্য,
locationBiasএর বিবরণ দেখুন।আপনি
locationRestrictionঅথবাlocationBiasনির্দিষ্ট করতে পারেন, কিন্তু উভয়ই নয়।locationRestrictionকে এমন একটি অঞ্চল নির্দিষ্ট করা হিসেবে ভাবুন যার মধ্যে ফলাফল অবশ্যই থাকতে হবে, এবংlocationBiasএমন একটি অঞ্চল নির্দিষ্ট করা হিসেবে ভাবুন যার ভিতরে বা কাছাকাছি ফলাফল থাকার সম্ভাবনা রয়েছে, কিন্তু তা ওই এলাকার বাইরেও থাকতে পারে।maxResultCount (অপ্রচলিত)
প্রতি পৃষ্ঠায় প্রদর্শিত ফলাফলের সংখ্যা (১ থেকে ২০-এর মধ্যে) নির্দিষ্ট করে। উদাহরণস্বরূপ,
maxResultCountএর মান ৫ সেট করলে প্রথম পৃষ্ঠায় সর্বোচ্চ ৫টি ফলাফল দেখানো হবে। যদি কোয়েরি থেকে আরও বেশি ফলাফল দেখানো সম্ভব হয়, তাহলে রেসপন্সে একটিnextPageTokenঅন্তর্ভুক্ত থাকে, যা আপনি পরবর্তী পৃষ্ঠায় যাওয়ার জন্য কোনো পরের রিকোয়েস্টে পাস করতে পারেন।evOptions
উপলব্ধ বৈদ্যুতিক যানবাহন (EV) চার্জিং সংযোগকারী এবং চার্জিং হার শনাক্ত করার জন্য প্যারামিটার নির্দিষ্ট করে।
সংযোগকারী প্রকার
কোনো স্থানে উপলব্ধ ইভি চার্জিং কানেক্টরের ধরন অনুযায়ী ফিল্টার করা হয়। যে স্থানটি কোনো ধরনের কানেক্টর সমর্থন করে না, সেটি ফিল্টার থেকে বাদ দেওয়া হবে। সমর্থিত ইভি চার্জিং কানেক্টরের ধরনগুলোর মধ্যে রয়েছে কম্বাইন্ড (এসি এবং ডিসি) চার্জার, টেসলা চার্জার, জিবি/টি-সম্মত চার্জার (চীনে ইভি ফাস্ট চার্জিংয়ের জন্য), এবং ওয়াল আউটলেট চার্জার। আরও তথ্যের জন্য, রেফারেন্স ডকুমেন্টেশন দেখুন।
- কোনো নির্দিষ্ট সমর্থিত কানেক্টরের জন্য ফলাফল ফিল্টার করতে,
connectorTypesসেই মানে সেট করুন। উদাহরণস্বরূপ, J1772 টাইপ 1 কানেক্টর খুঁজে পেতে,connectorTypesEV_CONNECTOR_TYPE_J1772তে সেট করুন। - অসমর্থিত কানেক্টরগুলির জন্য ফলাফল ফিল্টার করতে,
connectorTypesEV_CONNECTOR_TYPE_OTHERএ সেট করুন। - যেকোনো ওয়াল আউটলেট কানেক্টর টাইপের ফলাফল ফিল্টার করতে,
connectorTypesEV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLETএ সেট করুন। - যেকোনো কানেক্টর টাইপের জন্য ফলাফল ফিল্টার করতে,
connectorTypesEV_CONNECTOR_TYPE_UNSPECIFIEDএ সেট করুন অথবাconnectorTypesজন্য কোনো মান সেট করবেন না।
- কোনো নির্দিষ্ট সমর্থিত কানেক্টরের জন্য ফলাফল ফিল্টার করতে,
সর্বনিম্ন চার্জিং রেট কিলোওয়াট
কিলোওয়াট (kW) এককে সর্বনিম্ন ইভি চার্জিং রেট অনুযায়ী স্থানগুলি ফিল্টার করে। সর্বনিম্ন চার্জিং রেটের চেয়ে কম চার্জিং রেটযুক্ত যেকোনো স্থান ফিল্টার করে বাদ দেওয়া হয়। উদাহরণস্বরূপ, কমপক্ষে 10 kW চার্জিং রেটযুক্ত ইভি চার্জারগুলি খুঁজে পেতে, আপনি এই প্যারামিটারটি "10" এ সেট করতে পারেন।
সর্বনিম্ন রেটিং
ফলাফল শুধুমাত্র তাদের মধ্যেই সীমাবদ্ধ থাকবে যাদের গড় ব্যবহারকারী রেটিং এই সীমার সমান বা তার বেশি। মান অবশ্যই ০.০ থেকে ৫.০ (উভয়সহ) এর মধ্যে ০.৫ এর গুণিতকে হতে হবে। উদাহরণস্বরূপ: ০, ০.৫, ১.০, ... , ৫.০ (উভয়সহ)। মান নিকটতম ০.৫ এ উন্নীত করা হয়। উদাহরণস্বরূপ, ০.৬ মানটি ১.০ এর কম রেটিংযুক্ত সমস্ত ফলাফল বাদ দিয়ে দেয়।
এখন খোলা
যদি
true, তাহলে কোয়েরি পাঠানোর সময় শুধুমাত্র সেই স্থানগুলোই ফেরত দেওয়া হবে যেগুলো ব্যবসার জন্য খোলা আছে। যদিfalse, তাহলে খোলা থাকার অবস্থা নির্বিশেষে সমস্ত ব্যবসা ফেরত দেওয়া হবে। আপনি যদি এই প্যারামিটারটি 'falseসেট করেন, তাহলে Google Places ডেটাবেসে যেসব স্থানের খোলার সময় উল্লেখ করা নেই, সেগুলোও ফেরত দেওয়া হবে।পৃষ্ঠার আকার
প্রতি পৃষ্ঠায় প্রদর্শিত ফলাফলের সংখ্যা (১ থেকে ২০-এর মধ্যে) নির্দিষ্ট করে। উদাহরণস্বরূপ,
pageSizeএর মান ৫ সেট করলে প্রথম পৃষ্ঠায় সর্বোচ্চ ৫টি ফলাফল দেখানো হবে। যদি কোয়েরি থেকে আরও বেশি ফলাফল দেখানো সম্ভব হয়, তাহলে রেসপন্সে একটিnextPageTokenঅন্তর্ভুক্ত থাকে, যা আপনি পরবর্তী পৃষ্ঠায় যাওয়ার জন্য কোনো পরের রিকোয়েস্টে পাস করতে পারেন।পৃষ্ঠা টোকেন
পূর্ববর্তী পৃষ্ঠার প্রতিক্রিয়া বডি থেকে
nextPageTokenনির্দিষ্ট করে।মূল্যস্তর
অনুসন্ধানটি নির্দিষ্ট মূল্যস্তরে চিহ্নিত স্থানগুলিতে সীমাবদ্ধ করুন। ডিফল্টরূপে সমস্ত মূল্যস্তর নির্বাচিত থাকে।
নিম্নলিখিত ধরনের স্থানগুলোর ক্ষেত্রে মূল্যস্তর প্রত্যাশিত হতে পারে:
priceLevelsনির্দিষ্ট করা থাকলে, অসমর্থিত ধরনের স্থানগুলো রেসপন্সে অন্তর্ভুক্ত করা হবে না।PriceLevelদ্বারা সংজ্ঞায়িত এক বা একাধিক মানের একটি অ্যারে নির্দিষ্ট করুন।উদাহরণস্বরূপ:
"priceLevels":["PRICE_LEVEL_INEXPENSIVE", "PRICE_LEVEL_MODERATE"]
র্যাঙ্কপ্রেফারেন্স
কোয়েরির ধরনের উপর ভিত্তি করে রেসপন্সে ফলাফলগুলো কীভাবে র্যাঙ্ক করা হবে তা নির্দিষ্ট করে:
- "নিউ ইয়র্ক সিটির রেস্তোরাঁ"-এর মতো একটি ক্যাটাগরিক্যাল কোয়েরির জন্য,
RELEVANCE(সার্চের প্রাসঙ্গিকতা অনুসারে ফলাফল র্যাঙ্ক করা) হলো ডিফল্ট। আপনিrankPreferenceRELEVANCEঅথবাDISTANCE(দূরত্ব অনুসারে ফলাফল র্যাঙ্ক করা)-তে সেট করতে পারেন। - "Mountain View, CA"-এর মতো অ-শ্রেণীবদ্ধ কোয়েরির জন্য, আমরা
rankPreferenceসেট না করার পরামর্শ দিই।
- "নিউ ইয়র্ক সিটির রেস্তোরাঁ"-এর মতো একটি ক্যাটাগরিক্যাল কোয়েরির জন্য,
অঞ্চল কোড
প্রতিক্রিয়া বিন্যাস করার জন্য ব্যবহৃত অঞ্চল কোড, যা একটি দুই-অক্ষরের CLDR কোড মান হিসাবে নির্দিষ্ট করা হয়। এই প্যারামিটারটি অনুসন্ধানের ফলাফলের উপর পক্ষপাতমূলক প্রভাবও ফেলতে পারে। এর কোনো ডিফল্ট মান নেই।
রেসপন্সের
formattedAddressফিল্ডের দেশের নাম যদি `regionCodeএর সাথে মিলে যায়, তাহলেformattedAddressথেকে কান্ট্রি কোডটি বাদ দেওয়া হয়। এই প্যারামিটারটিরadrFormatAddressএর উপর কোনো প্রভাব নেই, কারণ `adrFormatAddress`-এ দেশের নাম থাকলে তা সবসময় অন্তর্ভুক্ত থাকে; এবংshortFormattedAddressউপরও কোনো প্রভাব নেই, কারণ `adrFormatAddress`-এ তা কখনোই অন্তর্ভুক্ত থাকে না।কিছু উল্লেখযোগ্য ব্যতিক্রম ছাড়া, বেশিরভাগ CLDR কোড ISO 3166-1 কোডের অনুরূপ। উদাহরণস্বরূপ, যুক্তরাজ্যের ccTLD হলো "uk" (.co.uk), যেখানে এর ISO 3166-1 কোড হলো "gb" (যা প্রযুক্তিগতভাবে "The United Kingdom of Great Britain and Northern Ireland" সত্তাটিকে বোঝায়)। প্রযোজ্য আইনের উপর ভিত্তি করে এই প্যারামিটারটি ফলাফলকে প্রভাবিত করতে পারে।
strictTypeFiltering
includedTypeপ্যারামিটারের সাথে ব্যবহৃত হয়। যখন এটিtrueতে সেট করা হয়, তখন শুধুমাত্রincludedTypeদ্বারা নির্দিষ্ট করা টাইপের সাথে মেলে এমন স্থানগুলোই ফেরত দেওয়া হয়। যখন এটি false (ডিফল্ট) থাকে, তখন রেসপন্সে এমন স্থানও থাকতে পারে যা নির্দিষ্ট টাইপের সাথে মেলে না।
টেক্সট সার্চ (নতুন) উদাহরণ
কোয়েরি স্ট্রিং দ্বারা একটি স্থান খুঁজুন
নিম্নলিখিত উদাহরণটি "Spicy Vegetarian Food in Sydney, Australia" এর জন্য একটি টেক্সট সার্চ (নতুন) অনুরোধ দেখাচ্ছে:
curl -X POST -d '{
"textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress' \
'https://places.googleapis.com/v1/places:searchText'
উল্লেখ্য যে, X-Goog-FieldMask হেডারটি নির্দিষ্ট করে যে রেসপন্সটিতে নিম্নলিখিত ডেটা ফিল্ডগুলো রয়েছে: places.displayName,places.formattedAddress । এরপর রেসপন্সটি এই ফর্মে থাকে:
{ "places": [ { "formattedAddress": "367 Pitt St, Sydney NSW 2000, Australia", "displayName": { "text": "Mother Chu's Vegetarian Kitchen", "languageCode": "en" } }, { "formattedAddress": "175 First Ave, Five Dock NSW 2046, Australia", "displayName": { "text": "Veggo Sizzle - Vegan & Vegetarian Restaurant, Five Dock, Sydney", "languageCode": "en" } }, { "formattedAddress": "29 King St, Sydney NSW 2000, Australia", "displayName": { "text": "Peace Harmony", "languageCode": "en" } }, ... ] }
অতিরিক্ত তথ্য পেতে ফিল্ড মাস্কে আরও ডেটা টাইপ যোগ করুন। উদাহরণস্বরূপ, রেসপন্সে রেস্তোরাঁর ধরন এবং ওয়েব অ্যাড্রেস অন্তর্ভুক্ত করতে places.types,places.websiteUri যোগ করুন।
curl -X POST -d '{
"textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.types,places.websiteUri' \
'https://places.googleapis.com/v1/places:searchText'প্রতিক্রিয়াটি এখন নিম্নরূপ:
{ "places": [ { "types": [ "vegetarian_restaurant", "vegan_restaurant", "chinese_restaurant", "restaurant", "food", "point_of_interest", "establishment" ], "formattedAddress": "367 Pitt St, Sydney NSW 2000, Australia", "websiteUri": "http://www.motherchusvegetarian.com.au/", "displayName": { "text": "Mother Chu's Vegetarian Kitchen", "languageCode": "en" } }, { "types": [ "vegan_restaurant", "thai_restaurant", "vegetarian_restaurant", "indian_restaurant", "italian_restaurant", "american_restaurant", "restaurant", "food", "point_of_interest", "establishment" ], "formattedAddress": "175 First Ave, Five Dock NSW 2046, Australia", "websiteUri": "http://www.veggosizzle.com.au/", "displayName": { "text": "Veggo Sizzle - Vegan & Vegetarian Restaurant, Five Dock, Sydney", "languageCode": "en" } }, ... ] }
মূল্যস্তর অনুযায়ী স্থান ফিল্টার করুন
ফলাফলকে সস্তা বা মাঝারি দামি হিসেবে চিহ্নিত রেস্তোরাঁগুলিতে ফিল্টার করতে priceLevel অপশনটি ব্যবহার করুন:
curl -X POST -d '{
"textQuery" : "Spicy Vegetarian Food in Sydney, Australia",
"priceLevels":["PRICE_LEVEL_INEXPENSIVE", "PRICE_LEVEL_MODERATE"]
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel' \
'https://places.googleapis.com/v1/places:searchText'এই উদাহরণটিতেও রেসপন্সে places.priceLevel ডেটা ফিল্ডটি যোগ করার জন্য X-Goog-FieldMask হেডার ব্যবহার করা হয়েছে, ফলে এটি এই ফর্মে থাকে:
{ "places": [ { "formattedAddress": "367 Pitt St, Sydney NSW 2000, Australia", "priceLevel": "PRICE_LEVEL_MODERATE", "displayName": { "text": "Mother Chu's Vegetarian Kitchen", "languageCode": "en" } }, { "formattedAddress": "115 King St, Newtown NSW 2042, Australia", "priceLevel": "PRICE_LEVEL_MODERATE", "displayName": { "text": "Green Mushroom", "languageCode": "en" } }, ... ] }
আপনার অনুসন্ধানকে আরও পরিমার্জিত করতে অতিরিক্ত বিকল্প যোগ করুন, যেমন includedType , minRating , rankPreference , openNow এবং ঐচ্ছিক প্যারামিটার (Optional parameters) অংশে বর্ণিত অন্যান্য প্যারামিটারসমূহ।
অনুসন্ধান একটি নির্দিষ্ট এলাকায় সীমাবদ্ধ করুন
কোনো অনুসন্ধানকে একটি নির্দিষ্ট এলাকায় সীমাবদ্ধ করতে locationRestriction অথবা locationBias ব্যবহার করুন, কিন্তু উভয়ই নয়। locationRestriction কে এমন একটি অঞ্চল নির্দিষ্টকারী হিসেবে ভাবুন যার মধ্যে ফলাফল অবশ্যই থাকতে হবে, এবং locationBias এমন একটি অঞ্চল নির্দিষ্টকারী হিসেবে ভাবুন যার কাছাকাছি ফলাফল থাকতে হবে কিন্তু তা ওই এলাকার বাইরেও হতে পারে।
অবস্থান সীমাবদ্ধতা ব্যবহার করে এলাকা সীমাবদ্ধ করুন
কোয়েরির ফলাফল একটি নির্দিষ্ট অঞ্চলে সীমাবদ্ধ করতে locationRestriction প্যারামিটারটি ব্যবহার করুন। আপনার রিকোয়েস্ট বডিতে, অঞ্চলের সীমানা নির্ধারণকারী low ও high অক্ষাংশ এবং দ্রাঘিমাংশের মান উল্লেখ করুন।
নিম্নলিখিত উদাহরণটি নিউ ইয়র্ক সিটিতে 'নিরামিষ খাবার' এর জন্য একটি টেক্সট সার্চ (নতুন) অনুরোধ দেখাচ্ছে। এই অনুরোধটি শুধুমাত্র খোলা থাকা স্থানগুলির প্রথম ১০টি ফলাফল ফেরত দেয়।
curl -X POST -d '{
"textQuery" : "vegetarian food",
"pageSize" : "10",
"locationRestriction": {
"rectangle": {
"low": {
"latitude": 40.477398,
"longitude": -74.259087
},
"high": {
"latitude": 40.91618,
"longitude": -73.70018
}
}
}
}' \
-H 'Content-Type: application/json' \
-H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.id,places.formattedAddress' \
'https://places.googleapis.com/v1/places:searchText'
অবস্থান পক্ষপাত ব্যবহার করে একটি এলাকার প্রতি পক্ষপাত
নিম্নলিখিত উদাহরণটি সান ফ্রান্সিসকোর ডাউনটাউনের একটি নির্দিষ্ট স্থান থেকে ৫০০ মিটারের মধ্যে অবস্থিত কোনো স্থানের জন্য "নিরামিষ খাবার" এর একটি টেক্সট সার্চ (নতুন) অনুরোধ দেখাচ্ছে। এই অনুরোধটি শুধুমাত্র খোলা থাকা স্থানগুলির প্রথম ১০টি ফলাফল ফেরত দেয়।
curl -X POST -d '{
"textQuery" : "vegetarian food",
"openNow": true,
"pageSize": 10,
"locationBias": {
"circle": {
"center": {"latitude": 37.7937, "longitude": -122.3965},
"radius": 500.0
}
},
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress' \
'https://places.googleapis.com/v1/places:searchText'
সর্বনিম্ন চার্জিং রেট সহ ইভি চার্জার খুঁজুন
আপনার ইভি-র জন্য উপযুক্ত চার্জার আছে এমন জায়গা খুঁজতে minimumChargingRateKw এবং connectorTypes ব্যবহার করুন।
নিম্নলিখিত উদাহরণটি ক্যালিফোর্নিয়ার মাউন্টেন ভিউতে সর্বনিম্ন ১০ কিলোওয়াট চার্জিং রেট সহ টেসলা এবং J1772 টাইপ ১ ইভি চার্জিং কানেক্টরের জন্য একটি অনুরোধ দেখাচ্ছে। মাত্র চারটি ফলাফল ফেরত দেওয়া হয়েছে।
curl -X POST -d '{
"textQuery": "EV Charging Station Mountain View",
"pageSize": 4,
"evOptions": {
"minimumChargingRateKw": 10,
"connectorTypes": ["EV_CONNECTOR_TYPE_J1772","EV_CONNECTOR_TYPE_TESLA"]
}
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H "X-Goog-FieldMask: places.displayName,places.evChargeOptions" \
'https://places.googleapis.com/v1/places:searchText'
অনুরোধটি নিম্নলিখিত প্রতিক্রিয়া প্রদান করে:
{ "places": [ { "displayName": { "text": "EVgo Charging Station", "languageCode": "en" }, "evChargeOptions": { "connectorCount": 16, "connectorAggregation": [ { "type": "EV_CONNECTOR_TYPE_CHADEMO", "maxChargeRateKw": 100, "count": 8, "availableCount": 5, "outOfServiceCount": 0, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" }, { "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1", "maxChargeRateKw": 100, "count": 2, "availableCount": 2, "outOfServiceCount": 0, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" }, { "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1", "maxChargeRateKw": 350, "count": 6, "availableCount": 3, "outOfServiceCount": 0, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" } ] } }, { "displayName": { "text": "EVgo Charging Station", "languageCode": "en" }, "evChargeOptions": { "connectorCount": 6, "connectorAggregation": [ { "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1", "maxChargeRateKw": 100, "count": 4, "availableCount": 3, "outOfServiceCount": 0, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" }, { "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1", "maxChargeRateKw": 350, "count": 2, "availableCount": 0, "outOfServiceCount": 2, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" } ] } }, { "displayName": { "text": "EVgo Charging Station", "languageCode": "en" }, "evChargeOptions": { "connectorCount": 5, "connectorAggregation": [ { "type": "EV_CONNECTOR_TYPE_J1772", "maxChargeRateKw": 3.5999999046325684, "count": 1, "availableCount": 0, "outOfServiceCount": 1, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" }, { "type": "EV_CONNECTOR_TYPE_CHADEMO", "maxChargeRateKw": 50, "count": 2, "availableCount": 0, "outOfServiceCount": 0, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" }, { "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1", "maxChargeRateKw": 50, "count": 2, "availableCount": 0, "outOfServiceCount": 0, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" } ] } }, { "displayName": { "text": "Electric Vehicle Charging Station", "languageCode": "en" }, "evChargeOptions": { "connectorCount": 10, "connectorAggregation": [ { "type": "EV_CONNECTOR_TYPE_OTHER", "maxChargeRateKw": 210, "count": 10 } ] } } ] }
পরিষেবা এলাকার ব্যবসাগুলি অনুসন্ধান করুন
যাদের কোনো ভৌত পরিষেবা ঠিকানা নেই (যেমন, একটি ভ্রাম্যমাণ পরিচ্ছন্নতা পরিষেবা বা একটি ফুড ট্রাক) এমন ব্যবসাগুলি অনুসন্ধান করতে includePureServiceAreaBusinesses প্যারামিটারটি ব্যবহার করুন।
নিম্নলিখিত উদাহরণটি সান ফ্রান্সিসকোতে প্লাম্বারদের জন্য একটি অনুরোধ দেখাচ্ছে:
curl -X POST -d '{
"textQuery" : "plumber San Francisco",
"includePureServiceAreaBusinesses": true
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress' \
'https://places.googleapis.com/v1/places:searchText'
যেসব ব্যবসার কোনো ভৌত পরিষেবা ঠিকানা নেই, তারা উত্তরে formattedAddress ফিল্ডটি অন্তর্ভুক্ত করে না:
{ "places": [ { "formattedAddress": "3450 Sacramento St #204, San Francisco, CA 94118, USA", "displayName": { "text": "Advanced Plumbing & Drain", "languageCode": "en" } }, { "formattedAddress": "1455 Bancroft Ave, San Francisco, CA 94124, USA", "displayName": { "text": "Magic Plumbing Heating & Cooling", "languageCode": "en" } }, /.../ { "displayName": { "text": "Starboy Plumbing Inc.", "languageCode": "en" } }, { "formattedAddress": "78 Dorman Ave, San Francisco, CA 94124, USA", "displayName": { "text": "Cabrillo Plumbing, Heating & Air", "languageCode": "en" } }, { "formattedAddress": "540 Barneveld Ave # D, San Francisco, CA 94124, USA", "displayName": { "text": "Mr. Rooter Plumbing of San Francisco", "languageCode": "en" } }, /.../ { "displayName": { "text": "Pipeline Plumbing", "languageCode": "en" } }, { "formattedAddress": "350 Bay St #100-178, San Francisco, CA 94133, USA", "displayName": { "text": "One Source Plumbing and Rooter", "languageCode": "en" } }, /.../ ] }
প্রতি পৃষ্ঠায় ফেরত দেওয়া ফলাফলের সংখ্যা নির্দিষ্ট করুন।
প্রতি পৃষ্ঠায় কতগুলো ফলাফল ফেরত দেওয়া হবে তা নির্দিষ্ট করতে pageSize প্যারামিটারটি ব্যবহার করুন। রেসপন্স বডিতে থাকা nextPageToken প্যারামিটারটি একটি টোকেন প্রদান করে, যা পরবর্তী কলগুলোতে ফলাফলের পরবর্তী পৃষ্ঠা অ্যাক্সেস করার জন্য ব্যবহার করা যেতে পারে।
নিম্নলিখিত উদাহরণটি "নিউ ইয়র্কে পিৎজা" এর জন্য একটি অনুরোধ দেখাচ্ছে, যেখানে প্রতি পৃষ্ঠায় ৫টি ফলাফলের মধ্যে সীমাবদ্ধ রাখা হয়েছে:
curl -X POST -d '{
"textQuery": "pizza in New York",
"pageSize": 5
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H "X-Goog-FieldMask: places.id,nextPageToken" \
'https://places.googleapis.com/v1/places:searchText'
{ "places": [ { "id": "ChIJifIePKtZwokRVZ-UdRGkZzs" }, { "id": "ChIJPxPd_P1YwokRfzLhSiACEoU" }, { "id": "ChIJrXXKn5NZwokR78g0ipCnY60" }, { "id": "ChIJ6ySICVZYwokR9rIK8HjXhzE" }, { "id": "ChIJ6xvs94VZwokRnT1D2lX2OTw" } ], "nextPageToken": "AeCrKXsZWzNVbPzO-MRWPu52jWO_Xx8aKwOQ69_Je3DxRpfdjClq8Ekwh3UcF2h2Jn75kL6PtWLGV4ecQri-GEUKN_OFpJkdVc-JL4Q" }
ফলাফলের পরবর্তী পৃষ্ঠা অ্যাক্সেস করতে, রিকোয়েস্ট বডিতে pageToken ব্যবহার করে ` nextPageToken পাস করুন:
curl -X POST -d '{
"textQuery": "pizza in New York",
"pageSize": 5,
"pageToken": "AeCrKXsZWzNVbPzO-MRWPu52jWO_Xx8aKwOQ69_Je3DxRpfdjClq8Ekwh3UcF2h2Jn75kL6PtWLGV4ecQri-GEUKN_OFpJkdVc-JL4Q"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H "X-Goog-FieldMask: places.id,nextPageToken" \
'https://places.googleapis.com/v1/places:searchText'
{ "places": [ { "id": "ChIJL-LN1N1ZwokR8K2jACu6Ydw" }, { "id": "ChIJjaD94kFZwokR-20CXqlpy_4" }, { "id": "ChIJ6ffdpJNZwokRmcafdROM5q0" }, { "id": "ChIJ8Q2WSpJZwokRQz-bYYgEskM" }, { "id": "ChIJ8164qwFZwokRhplkmhvq1uE" } ], "nextPageToken": "AeCrKXvPd6uUy-oj96W2OaqEe2pUD8QTxOM8-sKfUcFsC9t2Wey5qivrKGoGSxcZnyc7RPmaFfAktslrKbUh31ZDTkL0upRmaxA7c_c" }
ঠিকানা বর্ণনাকারী পান
ঠিকানার বর্ণনাকারী কোনো স্থানের অবস্থান সম্পর্কে সম্পর্কীয় তথ্য প্রদান করে, যার মধ্যে নিকটবর্তী দর্শনীয় স্থান এবং অন্তর্ভুক্ত এলাকাগুলো রয়েছে।
নিম্নলিখিত উদাহরণটি স্যান হোসে-র একটি মলের কাছাকাছি স্থানগুলির জন্য একটি টেক্সট সার্চ (নতুন) অনুরোধ দেখাচ্ছে। এই উদাহরণে, আপনি ফিল্ড মাস্কে addressDescriptors অন্তর্ভুক্ত করবেন:
curl -X POST -d '{
"textQuery": "clothes",
"maxResultCount": 5,
"locationBias": {
"circle": {
"center": {
"latitude": 37.321328,
"longitude": -121.946275
}
}
},
"rankPreference":"RANK_PREFERENCE_UNSPECIFIED"
}' \
-H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.displayName,places.addressDescriptor" \
https://places.googleapis.com/v1/places:searchText
উত্তরে অনুরোধে উল্লেখিত স্থান, নিকটবর্তী গুরুত্বপূর্ণ স্থানসমূহের তালিকা ও স্থানটি থেকে সেগুলোর দূরত্ব, এবং এলাকাগুলোর তালিকা ও স্থানটির সাথে সেগুলোর অন্তর্ভুক্তিমূলক সম্পর্ক অন্তর্ভুক্ত থাকে:
{ "places": [ { "displayName": { "text": "Urban Outfitters", "languageCode": "en" }, "addressDescriptor": { "landmarks": [ { "name": "places/ChIJVVVVUB7Lj4ARXyb4HFVDV8s", "placeId": "ChIJVVVVUB7Lj4ARXyb4HFVDV8s", "displayName": { "text": "Westfield Valley Fair", "languageCode": "en" }, "types": [ "clothing_store", "department_store", "establishment", "food", "movie_theater", "point_of_interest", "restaurant", "shoe_store", "shopping_mall", "store" ], "spatialRelationship": "WITHIN", "straightLineDistanceMeters": 133.72855 }, { "name": "places/ChIJ62_oCR7Lj4AR_MGWkSPotD4", "placeId": "ChIJ62_oCR7Lj4AR_MGWkSPotD4", "displayName": { "text": "Nordstrom", "languageCode": "en" }, "types": [ "clothing_store", "department_store", "establishment", "point_of_interest", "shoe_store", "store" ], "straightLineDistanceMeters": 250.99161 }, { "name": "places/ChIJ8WvuSB7Lj4ARFyHppkxDRQ4", "placeId": "ChIJ8WvuSB7Lj4ARFyHppkxDRQ4", "displayName": { "text": "Macy's", "languageCode": "en" }, "types": [ "clothing_store", "department_store", "establishment", "point_of_interest", "store" ], "straightLineDistanceMeters": 116.24196 }, { "name": "places/ChIJ9d3plB_Lj4ARzyaU5bn80WY", "placeId": "ChIJ9d3plB_Lj4ARzyaU5bn80WY", "displayName": { "text": "Bank of America Financial Center", "languageCode": "en" }, "types": [ "bank", "establishment", "finance", "point_of_interest" ], "straightLineDistanceMeters": 121.61515 }, { "name": "places/ChIJaXCjxvXLj4ARCPmQpvJ52Lw", "placeId": "ChIJaXCjxvXLj4ARCPmQpvJ52Lw", "displayName": { "text": "Bloomingdale's", "languageCode": "en" }, "types": [ "clothing_store", "department_store", "establishment", "furniture_store", "home_goods_store", "point_of_interest", "shoe_store", "store" ], "straightLineDistanceMeters": 81.32396 } ], "areas": [ { "name": "places/ChIJb3F-EB7Lj4ARnHApQ_Hu1gI", "placeId": "ChIJb3F-EB7Lj4ARnHApQ_Hu1gI", "displayName": { "text": "Westfield Valley Fair", "languageCode": "en" }, "containment": "WITHIN" }, { "name": "places/ChIJXYuykB_Lj4AR1Ot8nU5q26Q", "placeId": "ChIJXYuykB_Lj4AR1Ot8nU5q26Q", "displayName": { "text": "Valley Fair", "languageCode": "en" }, "containment": "WITHIN" }, { "name": "places/ChIJtYoUX2DLj4ARKoKOb1G0CpM", "placeId": "ChIJtYoUX2DLj4ARKoKOb1G0CpM", "displayName": { "text": "Central San Jose", "languageCode": "en" }, "containment": "WITHIN" } ] } }, /.../ ] }
ভবিষ্যতে চালু হতে যাওয়া ব্যবসাগুলো খুঁজুন।
নিম্নলিখিত উদাহরণটি আইডাহোর নিউ মেডোজে ভবিষ্যতে চালু হতে যাওয়া ব্যবসা প্রতিষ্ঠানগুলোর জন্য একটি টেক্সট সার্চ (নতুন) অনুরোধ দেখাচ্ছে:
curl -X POST \
-H "Content-Type: application/json" \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,places.businessStatus,places.openingDate" \
-d '{
"textQuery": "Roberts Greenhouse and Tree Farm",
"includeFutureOpeningBusinesses": true,
"maxResultCount": 20,
"locationBias": {
"circle": {
"center": {"latitude": 44.9755100, "longitude": -116.2842180},
"radius": 20
}
}
}' \
"https://places.googleapis.com/v1/places:searchText"
এই উত্তরে ভবিষ্যতে চালু হতে যাওয়া ব্যবসা প্রতিষ্ঠানগুলোর নাম, তাদের ব্যবসার অবস্থা এবং প্রত্যাশিত উদ্বোধনের তারিখ অন্তর্ভুক্ত রয়েছে:
{ "places": [ { "id": "ChIJp1-VoKWJplQRMz8g-7Wa3Do", "businessStatus": "FUTURE_OPENING", "displayName": { "text": "Roberts Greenhouse and Tree Farm", "languageCode": "en" }, "openingDate": { "year": 2026, "month": 4, "day": 15 } } ] }
চেষ্টা করে দেখুন!
এপিআই এক্সপ্লোরার আপনাকে নমুনা অনুরোধ করার সুযোগ দেয়, যাতে আপনি এপিআই এবং এর অপশনগুলোর সাথে পরিচিত হতে পারেন।
পৃষ্ঠার ডানদিকে থাকা API আইকনটি (api) নির্বাচন করুন।
ইচ্ছা হলে অনুরোধের প্যারামিটারগুলো সম্পাদনা করুন।
Execute বাটনটি নির্বাচন করুন। প্রদর্শিত ডায়ালগ বক্সে, অনুরোধটি করার জন্য আপনি যে অ্যাকাউন্টটি ব্যবহার করতে চান, সেটি বেছে নিন।
এপিআই এক্সপ্লোরার প্যানেলে, এপিআই এক্সপ্লোরার উইন্ডোটি প্রসারিত করতে ফুলস্ক্রিন আইকনটি নির্বাচন করুন।