ভূমিকা
টেক্সট সার্চ (নতুন) স্ট্রিংয়ের (যেমন, "নিউ ইয়র্কে পিৎজা" বা "অটোয়ার কাছাকাছি জুতো দোকান" বা "১২৩ মেইন স্ট্রিট") উপর ভিত্তি করে একগুচ্ছ জায়গা সম্পর্কে তথ্য দেয়। পরিষেবাটি টেক্সট স্ট্রিং এবং সেট করা যেকোনও লোকেশন বায়াসের সাথে মেলে এমন জায়গার তালিকা সহ উত্তর দেয়।
প্রয়োজনীয় প্যারামিটার ছাড়াও, আরও ভালো ফলাফল পেতে টেক্সট সার্চ (নতুন) কোয়েরি রিফাইন করার জন্য ঐচ্ছিক প্যারামিটার ব্যবহার করা যায়।
API এক্সপ্লোরার আপনাকে লাইভ অনুরোধ করতে দেয় যাতে আপনি API ও API বিকল্প সম্পর্কে পরিচিত হতে পারেন:
Text Search (New) সংক্রান্ত অনুরোধ
টেক্সট সার্চ (নতুন) অনুরোধ হল নিম্নলিখিত ফর্মের একটি HTTP POST অনুরোধ:
https://places.googleapis.com/v1/places:searchText
JSON অনুরোধের বডিতে বা হেডারগুলিতে POST অনুরোধের অংশ হিসেবে সব প্যারামিটার পাস করুন। যেমন:
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)
}
]
}প্রয়োজনীয় প্যারামিটার
-
FieldMask
রেসপন্স ফিল্ড মাস্ক তৈরি করে, উত্তরে ফেরত পাঠানোর জন্য ফিল্ডের তালিকা নির্দিষ্ট করুন। URL প্যারামিটার
$fieldsবাfieldsঅথবা HTTP হেডারX-Goog-FieldMaskব্যবহার করে, মেথডে রেসপন্স ফিল্ড মাস্ক পাস করুন। উত্তরে ফেরত আসা ফিল্ডের কোনও ডিফল্ট তালিকা নেই। আপনি ফিল্ড মাস্ক বাদ দিলে, পদ্ধতিটি একটি সমস্যা রিটার্ন করে।ফিল্ড মাস্কিং হল একটি ভালো ডিজাইন প্র্যাক্টিস যা নিশ্চিত করে যে আপনি অপ্রয়োজনীয় ডেটার জন্য অনুরোধ করছেন না, যা অপ্রয়োজনীয় প্রসেসিং সময় এবং বিলিং চার্জ এড়াতে সাহায্য করে।
ফেরত পাঠানোর জন্য কমা দিয়ে আলাদা করা প্লেস ডেটা ধরনের তালিকা নির্দিষ্ট করুন। যেমন, জায়গার নাম ও ঠিকানা ফিরিয়ে আনতে।
X-Goog-FieldMask: places.displayName,places.formattedAddress
সব ফিল্ড রিট্রিভ করতে
*ব্যবহার করুন।X-Goog-FieldMask: *
নিম্নলিখিত ফিল্ডের মধ্যে একটি বা একাধিক ফিল্ড নির্দিষ্ট করুন:
নিম্নলিখিত ফিল্ড শুধুমাত্র টেক্সট সার্চ এসেনশিয়াল আইডি SKU ট্রিগার করে:
places.attributions
places.id
places.consumerAlert
places.name*
nextPageToken
places.movedPlace
places.movedPlaceId*
places.nameফিল্ডে প্লেস রিসোর্স নাম এই ফর্ম্যাটে আছে:places/PLACE_ID. জায়গার টেক্সট নাম অ্যাক্সেস করতে Pro SKU-তেplaces.displayNameব্যবহার করুন।ফিল্ডের সম্পূর্ণ তালিকা এবং তাদের সাথে সম্পর্কিত SKU-এর জন্য, জায়গার ডেটা ফিল্ড (নতুন) দেখুন।
নিম্নলিখিত ফিল্ডগুলি Text Search Pro SKU ট্রিগার করে:
places.accessibilityOptions
places.addressComponents
places.addressDescriptor*
places.adrFormatAddress
places.businessStatus
places.containingPlaces
places.displayName
places.formattedAddress
places.googleMapsLinks
places.googleMapsTypeLabel
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-এর সম্পূর্ণ তালিকা দেখতে, প্লেস ডেটা ফিল্ড (নতুন) দেখুন।
নিম্নলিখিত ফিল্ড Text Search Enterprise SKU ট্রিগার করে:
places.currentOpeningHours
places.currentSecondaryOpeningHours
places.internationalPhoneNumber
places.nationalPhoneNumber
places.priceLevel
places.priceRange
places.rating
places.regularOpeningHours
places.regularSecondaryOpeningHours
places.transitStation
places.userRatingCount
places.websiteUriফিল্ড ও সংশ্লিষ্ট SKU-এর সম্পূর্ণ তালিকা দেখতে, প্লেস ডেটা ফিল্ড (নতুন) দেখুন।
নিম্নলিখিত ফিল্ড Text Search Enterprise + Atmosphere 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
* শুধুমাত্র টেক্সট সার্চ ও নিয়ারবাই সার্চফিল্ড ও সংশ্লিষ্ট SKU-এর সম্পূর্ণ তালিকা দেখতে, প্লেস ডেটা ফিল্ড (নতুন) দেখুন।
-
textQuery
যে টেক্সট স্ট্রিং সার্চ করতে হবে। যেমন, "রেস্তোরাঁ", "১২৩ মেইন স্ট্রিট" অথবা "সান ফ্রান্সিসকোতে ঘোরার সেরা জায়গা"। API এই স্ট্রিংয়ের ভিত্তিতে সম্ভাব্য ম্যাচ ফেরত পাঠায় এবং তাদের অনুভূত প্রাসঙ্গিকতার ভিত্তিতে ফলাফলগুলি সাজায়।
টেক্সট সার্চ (নতুন) নয় অস্পষ্ট কোয়েরির জন্য, যার মধ্যে নিম্নলিখিত বিষয়গুলি অন্তর্ভুক্ত:
কোয়েরির ধরন উদাহরণ একটি কোয়েরিতে একাধিক জায়গা, রাস্তা বা শহরের নামের মতো অনেক বেশি কনসেপ্ট বা সীমাবদ্ধতা "Market Street San Francisco San Jose Airport" Google Maps-এ ডাক ঠিকানার এলিমেন্ট দেখানো হয়নি "C/O John Smith 123 Main Street"
"P.O. Box 13 San Francisco"ব্যবসা, চেন বা বিভাগের নাম লোকেশনের সাথে যুক্ত করা যেখানে এইসব এন্টিটি উপলভ্য নয় "টেক্সাসের ডালাসের কাছাকাছি Tesco" একাধিক ব্যাখ্যা সহ অস্পষ্ট কোয়েরি "চার্জার ড্রপ-অফ" ঐতিহাসিক নাম যা আর ব্যবহার করা হয় না "Middlesex United Kingdom" নন-জিওস্পেশিয়াল এলিমেন্ট বা উদ্দেশ্য "ভেনচুরা হারবারে কতগুলি নৌকা আছে?" বেসরকারি বা ভ্যানিটি নাম "দ্য জেঙ্গা"
"দ্য হেল্টার স্কেল্টার"অক্ষাংশ ও দ্রাঘিমাংশ কোঅর্ডিনেট "37.422131,-122.084801"
ঐচ্ছিক প্যারামিটার
-
includeFutureOpeningBusinesses
trueহলে, ভবিষ্যতে খুলতে পারে এমন ব্যবসা দেখায়। ডিফল্ট হিসেবেfalseসেট করা থাকে।
ব্যবসার স্ট্যাটাস পেতে, আপনার অনুরোধ ফিল্ড মাস্কেplaces.businessStatusযোগ করুন। ব্যবসা খোলার সম্ভাব্য তারিখ পেতে, আপনার অনুরোধ ফিল্ড মাস্কেplaces.openingDateযোগ করুন। -
includedType
সারণী ক-এর মাধ্যমে নির্দিষ্ট করা ধরন অনুযায়ী জায়গার ফলাফল দেখায়। শুধুমাত্র একটি ধরন নির্দিষ্ট করা যেতে পারে। যেমন:
"includedType":"bar""includedType":"pharmacy"
টেক্সট সার্চ (নতুন) প্রযোজ্যতার উপর নির্ভর করে নির্দিষ্ট কোয়েরির জন্য ধরন ফিল্টারিং প্রয়োগ করে। যেমন, নির্দিষ্ট ঠিকানার কোয়েরির ক্ষেত্রে টাইপ ফিল্টারিং প্রয়োগ করা নাও হতে পারে ("১২৩ মেইন স্ট্রিট"), কিন্তু বিভাগভিত্তিক কোয়েরির ক্ষেত্রে টাইপ ফিল্টারিং প্রায় সবসময়ই প্রয়োগ করা হয় ("আশেপাশের দোকান" বা "শপিং মল")।
সব কোয়েরিতে টাইপ ফিল্টারিং প্রয়োগ করতে,
strictTypeFiltering-কেtrue-এ সেট করুন। -
includePureServiceAreaBusinesses
trueহিসেবে সেট করা থাকলে, উত্তরে এমন ব্যবসা অন্তর্ভুক্ত থাকে যেগুলি সরাসরি গ্রাহকদের কাছে যায় বা ডেলিভার করে, কিন্তু সেগুলির কোনও ফিজিক্যাল ব্যবসার লোকেশন নেই।falseহিসেবে সেট করা থাকলে, API শুধুমাত্র এমন ব্যবসা রিটার্ন করে যেগুলির বাস্তব লোকেশন আছে। languageCode
ফলাফল যে ভাষায় দেখানো হবে।
- কাজ করে এমন ভাষার তালিকা দেখুন। Google প্রায়ই কাজ করে এমন ভাষার তালিকা আপডেট করে, তাই এই তালিকা সম্পূর্ণ নাও হতে পারে।
-
languageCodeপ্রদান করা না হলে, API ডিফল্ট হিসেবেenব্যবহার করে। আপনি যদি কোনও ভুল ভাষার কোড উল্লেখ করেন, তাহলে APIINVALID_ARGUMENTসমস্যা দেখায়। - API, ব্যবহারকারী ও স্থানীয় লোকজন, উভয়ের কাছেই পাঠযোগ্য এমন রাস্তার ঠিকানা প্রদান করার জন্য যথাসাধ্য চেষ্টা করে। সেই লক্ষ্য পূরণ করতে, এটি স্থানীয় ভাষায় রাস্তার ঠিকানা রিটার্ন করে, প্রয়োজন হলে ব্যবহারকারীর পড়ার মতো স্ক্রিপ্টে ট্রান্সলিটারেট করে এবং পছন্দের ভাষা মেনে চলে। অন্যান্য সব ঠিকানা পছন্দের ভাষায় দেখানো হয়। ঠিকানার কম্পোনেন্টগুলি সব একই ভাষায় রিটার্ন করা হয়, যা প্রথম কম্পোনেন্ট থেকে বেছে নেওয়া হয়।
- পছন্দসই ভাষায় কোনও নাম উপলভ্য না থাকলে, API সবচেয়ে কাছাকাছি ম্যাচ ব্যবহার করে।
- API যে ফলাফল দেখায় এবং যে ক্রমে দেখায়, তার উপর পছন্দের ভাষার সামান্য প্রভাব থাকে। জিওকোডার ভাষার উপর নির্ভর করে সংক্ষিপ্ত রূপকে আলাদাভাবে ব্যাখ্যা করে, যেমন রাস্তার প্রকারের সংক্ষিপ্ত রূপ বা সমার্থক শব্দ যা একটি ভাষায় বৈধ হতে পারে কিন্তু অন্য ভাষায় নয়।
locationBias
সার্চ করার জন্য একটি নির্দিষ্ট এলাকা। এই লোকেশনটি একটি বায়াস হিসেবে কাজ করে, এর অর্থ হল নির্দিষ্ট লোকেশনের আশেপাশে থাকা ফলাফল দেখানো হতে পারে, এর মধ্যে নির্দিষ্ট এলাকার বাইরে থাকা ফলাফলও অন্তর্ভুক্ত।
আপনি
locationRestrictionবাlocationBiasউল্লেখ করতে পারেন, তবে দুটিই নয়।locationRestriction-কে এমন একটি অঞ্চল হিসেবে ভাবুন যেখানে ফলাফল থাকতে হবে এবংlocationBias-কে এমন একটি অঞ্চল হিসেবে ভাবুন যেখানে ফলাফল থাকার বা কাছাকাছি থাকার সম্ভাবনা আছে, তবে সেটি অঞ্চলের বাইরেও থাকতে পারে।আয়তাকার ভিউপোর্ট বা বৃত্ত হিসেবে অঞ্চলটি নির্দিষ্ট করুন।
বৃত্তের কেন্দ্রবিন্দু এবং মিটারে ব্যাসার্ধ দ্বারা বৃত্তকে সংজ্ঞায়িত করা হয়। ব্যাসার্ধ অবশ্যই ০.০ থেকে ৫০০০০.০-এর মধ্যে হতে হবে, এই দুটি মান সহ। ডিফল্ট ব্যাসার্ধ হল ০.০। যেমন:
"locationBias": { "circle": { "center": { "latitude": 37.7937, "longitude": -122.3965 }, "radius": 500.0 } }
আয়তক্ষেত্র হল অক্ষাংশ-দ্রাঘিমাংশ ভিউপোর্ট, যা দুটি কোণাকুণি বিপরীতমুখী নিম্ন ও উচ্চ পয়েন্ট হিসেবে দেখানো হয়। নিম্নতম বিন্দুটি আয়তক্ষেত্রের দক্ষিণ-পশ্চিম কোণকে চিহ্নিত করে এবং সর্বোচ্চ বিন্দুটি আয়তক্ষেত্রের উত্তর-পূর্ব কোণকে চিহ্নিত করে।
ভিউপোর্টকে একটি বন্ধ অঞ্চল হিসেবে বিবেচনা করা হয়, অর্থাৎ এতে এর সীমানা অন্তর্ভুক্ত থাকে। অক্ষাংশের বাউন্ড অবশ্যই -৯০ থেকে ৯০ ডিগ্রির মধ্যে হতে হবে এবং দ্রাঘিমাংশের বাউন্ড অবশ্যই -১৮০ থেকে ১৮০ ডিগ্রির মধ্যে হতে হবে:
low=highহলে, ভিউপোর্টে সেই একটি পয়েন্ট থাকে।low.longitude>high.longitudeহলে, দ্রাঘিমাংশের রেঞ্জ উল্টে যায় (ভিউ পোর্ট ১৮০ ডিগ্রি দ্রাঘিমাংশ রেখা অতিক্রম করে)।low.longitude= -১৮০ ডিগ্রি এবংhigh.longitude= ১৮০ ডিগ্রি হলে, ভিউপোর্টে সব দ্রাঘিমাংশ অন্তর্ভুক্ত থাকে।low.longitude= ১৮০ ডিগ্রি এবংhigh.longitude= -১৮০ ডিগ্রি হলে, দ্রাঘিমাংশের রেঞ্জ খালি থাকে।low.latitude>high.latitudeহলে, অক্ষাংশের রেঞ্জ খালি থাকে।
উভয় লো ও হাই ভ্যালু পূরণ করতে হবে এবং দেখানো বক্সটি ফাঁকা থাকলে চলবে না। খালি ভিউপোর্ট থাকলে সমস্যা হয়।
যেমন, এই ভিউপোর্টটি সম্পূর্ণভাবে নিউ ইয়র্ক সিটিকে অন্তর্ভুক্ত করে:
"locationBias": { "rectangle": { "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } } }
locationRestriction
শুধুমাত্র বিভাগ ভিত্তিক কোয়েরি সার্চ করার জন্য একটি নির্দিষ্ট এলাকা উল্লেখ করে, যা একাধিক জায়গা দেখাতে পারে (যেমন, "নিউ ইয়র্কের রেস্তোরাঁ" বা "শপিং মল")। নির্দিষ্ট এলাকার বাইরের ফলাফল দেখানো হয় না।
আয়তাকার ভিউপোর্ট হিসেবে অঞ্চলটি নির্দিষ্ট করুন। Viewport সংজ্ঞায়িত করার একটি উদাহরণ পেতে,
locationBias-এর বিবরণ দেখুন।আপনি
locationRestrictionবাlocationBiasনির্দিষ্ট করতে পারবেন, তবে দুটিই নয়।locationRestriction-কে এমন একটি অঞ্চল হিসেবে ভাবুন যেখানে ফলাফল থাকতে হবে এবংlocationBias-কে এমন একটি অঞ্চল হিসেবে ভাবুন যেখানে ফলাফল থাকার সম্ভাবনা আছে বা তার কাছাকাছি থাকতে পারে, তবে সেটি অঞ্চলের বাইরেও থাকতে পারে।-
maxResultCount (deprecated)
প্রতি পৃষ্ঠায় কতগুলি ফলাফল (১ থেকে ২০টির মধ্যে) দেখানো হবে তা নির্দিষ্ট করে। যেমন,
maxResultCount-এর ভ্যালু ৫ সেট করলে, প্রথম পৃষ্ঠায় সর্বাধিক ৫টি ফলাফল দেখানো হবে। কোয়েরি থেকে আরও ফলাফল পাওয়া গেলে, উত্তরে একটিnextPageTokenথাকে যা আপনি পরবর্তী পৃষ্ঠা অ্যাক্সেস করার জন্য পরবর্তী অনুরোধে পাস করতে পারেন। evOptions
উপলভ্য ইলেকট্রিক ভেইকেল (EV) চার্জিং কানেক্টর ও চার্জিং রেট শনাক্ত করার জন্য প্যারামিটার নির্দিষ্ট করে।
connectorTypes
কোনও জায়গায় উপলভ্য EV চার্জিং কানেক্টরের ধরন অনুযায়ী ফিল্টার করে। কোনও কানেক্টর কাজ করে না এমন জায়গা ফিল্টার করে বাদ দেওয়া হবে। EV চার্জিং কানেক্টরের যেসব ধরন কাজ করে তার মধ্যে রয়েছে কম্বাইন্ড (AC ও DC) চার্জার, Tesla চার্জার, GB/T-কমপ্লায়েন্ট চার্জার (চীনে EV ফাস্ট চার্জিংয়ের জন্য) এবং প্লাগ পয়েন্ট চার্জার। আরও তথ্যের জন্য, রেফারেন্স ডকুমেন্টেশন দেখুন।
- নির্দিষ্ট কাজ করে এমন কানেক্টরের জন্য ফলাফল ফিল্টার করতে,
connectorTypes-এর ভ্যালু সেট করুন। যেমন, J1772 টাইপ ১ কানেক্টর খুঁজতে,connectorTypes-কেEV_CONNECTOR_TYPE_J1772হিসেবে সেট করুন। - কাজ করে না এমন কানেক্টরের জন্য ফলাফল ফিল্টার করতে,
connectorTypes-এর মানEV_CONNECTOR_TYPE_OTHERহিসেবে সেট করুন। - ওয়াল আউটলেট হল এমন যেকোনও কানেক্টর ধরনের জন্য ফলাফল ফিল্টার করতে,
connectorTypes-এর মানEV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLETহিসেবে সেট করুন। - যেকোনও কানেক্টর ধরনের জন্য ফলাফল ফিল্টার করতে,
connectorTypes-এর মানEV_CONNECTOR_TYPE_UNSPECIFIEDহিসেবে সেট করুন অথবাconnectorTypes-এর কোনও মান সেট করবেন না।
- নির্দিষ্ট কাজ করে এমন কানেক্টরের জন্য ফলাফল ফিল্টার করতে,
minimumChargingRateKw
কিলোওয়াট (kW)-এ EV চার্জিংয়ের ন্যূনতম রেট অনুযায়ী জায়গা ফিল্টার করে। ন্যূনতম চার্জিং রেটের চেয়ে কম রেট চার্জ করা যেকোনও জায়গা ফিল্টার করে বাদ দেওয়া হয়। যেমন, কমপক্ষে ১০ কিলোওয়াট চার্জিং রেট সহ EV চার্জার খুঁজতে, এই প্যারামিটারকে "১০" হিসেবে সেট করতে পারেন।
minRating
ফলাফল শুধুমাত্র সেইসব কন্টেন্টের মধ্যে সীমাবদ্ধ রাখে যেগুলির গড় ব্যবহারকারী রেটিং এই সীমার চেয়ে বেশি বা সমান। মান অবশ্যই ০.০ থেকে ৫.০ (দুটিই অন্তর্ভুক্ত) হতে হবে এবং ০.৫ করে বাড়তে হবে। যেমন: ০, ০.৫, ১.০, ... , ৫.০ সহ। মানগুলি নিকটতম ০.৫ পর্যন্ত রাউন্ড করা হয়। যেমন, ০.৬ ভ্যালু ১.০-এর চেয়ে কম রেটিং সহ সব ফলাফল সরিয়ে দেয়।
openNow
trueহলে, কোয়েরি পাঠানোর সময় ব্যবসা খোলা আছে এমন জায়গাগুলির তথ্যই শুধু রিটার্ন করো।falseহলে, খোলা স্ট্যাটাস নির্বিশেষে সব ব্যবসা ফেরত দাও। Google Places ডেটাবেসে যেসব জায়গার খোলা থাকার সময় উল্লেখ করা নেই সেগুলি আপনি এই প্যারামিটারfalseহিসেবে সেট করলে রিটার্ন করা হয়।pageSize
প্রতি পৃষ্ঠায় কতগুলি ফলাফল (১ থেকে ২০টির মধ্যে) দেখানো হবে তা নির্দিষ্ট করে। যেমন,
pageSize-এর ভ্যালু ৫ সেট করলে, প্রথম পৃষ্ঠায় সর্বাধিক ৫টি ফলাফল দেখানো হবে। কোয়েরি থেকে আরও ফলাফল পাওয়া গেলে, উত্তরে একটিnextPageTokenঅন্তর্ভুক্ত থাকে যা আপনি পরবর্তী পৃষ্ঠায় অ্যাক্সেস করার জন্য পরবর্তী অনুরোধে পাস করতে পারেন।pageToken
আগের পৃষ্ঠার রেসপন্স বডি থেকে
nextPageTokenনির্দিষ্ট করে।-
priceLevels
নির্দিষ্ট প্রাইস লেভেলে চিহ্নিত করা জায়গাগুলিতে সার্চ সীমাবদ্ধ করুন। ডিফল্ট হিসেবে সব প্রাইস লেভেল বেছে নেওয়া হয়।
নিম্নলিখিত ধরনের জায়গার জন্য দামের লেভেল আশা করা যেতে পারে:
priceLevelsউল্লেখ করা থাকলে, কাজ করে না এমন ধরনের জায়গা উত্তরে অন্তর্ভুক্ত করা হবে না।PriceLevel-এর মাধ্যমে সংজ্ঞায়িত এক বা একাধিক ভ্যালুর অ্যারে উল্লেখ করুন।যেমন:
"priceLevels":["PRICE_LEVEL_INEXPENSIVE", "PRICE_LEVEL_MODERATE"]
rankPreference
কোয়েরির ধরনের উপর ভিত্তি করে উত্তরে ফলাফল কীভাবে র্যাঙ্ক করা হয় তা উল্লেখ করে:
- "নিউ ইয়র্ক সিটির রেস্তোরাঁ"-এর মতো বিভাগীয় কোয়েরির জন্য,
RELEVANCE(সার্চের প্রাসঙ্গিকতা অনুযায়ী ফলাফল র্যাঙ্ক করা) হল ডিফল্ট। আপনিrankPreferenceথেকেRELEVANCEঅথবাDISTANCE(দূরত্বের ভিত্তিতে ফলাফল র্যাঙ্ক করুন) সেট করতে পারবেন। - "ক্যালিফোর্নিয়ার মাউন্টেন ভিউ"-এর মতো অ-বিভাগীয় কোয়েরির ক্ষেত্রে, আমরা সাজেস্ট করি যে
আপনি
rankPreferenceসেট করবেন না।
- "নিউ ইয়র্ক সিটির রেস্তোরাঁ"-এর মতো বিভাগীয় কোয়েরির জন্য,
regionCode
উত্তর ফর্ম্যাট করার জন্য ব্যবহৃত অঞ্চল কোড, যা দুটি অক্ষরের CLDR কোড ভ্যালু হিসেবে নির্দিষ্ট করা আছে। এই প্যারামিটার সার্চ ফলাফলে পক্ষপাতদুষ্ট প্রভাবও ফেলতে পারে। কোনও ডিফল্ট ভ্যালু নেই।
formattedAddressফিল্ডের উত্তরে থাকা দেশের নামregionCode-এর সাথে মিললে,formattedAddressথেকে দেশের কোড বাদ দেওয়া হয়। এই প্যারামিটারadrFormatAddress-এর উপর কোনও প্রভাব ফেলে না, এতে উপলভ্য থাকলে সবসময় দেশের নাম অন্তর্ভুক্ত থাকে অথবাshortFormattedAddress-এর উপর কোনও প্রভাব ফেলে না, এতে কখনওই এটি অন্তর্ভুক্ত থাকে না।বেশিরভাগ CLDR কোড ISO 3166-1 কোডের মতো একই রকম, তবে কিছু উল্লেখযোগ্য ব্যতিক্রম আছে। যেমন, যুক্তরাজ্যের ccTLD হল "uk" (.co.uk) এবং এর ISO 3166-1 কোড হল "gb" (প্রযুক্তিগতভাবে এটি "গ্রেট ব্রিটেন ও উত্তর আয়ারল্যান্ডের যুক্তরাজ্য" এন্টিটির জন্য)। প্রযোজ্য আইনের উপর ভিত্তি করে প্যারামিটার ফলাফলে প্রভাব ফেলতে পারে।
strictTypeFiltering
includedTypeপ্যারামিটারের সাথে ব্যবহার করা হয়। এটিtrue-এ সেট করা থাকলে, শুধুমাত্রincludedType-এর মাধ্যমে নির্দিষ্ট করা ধরনের সাথে ম্যাচ করা জায়গাগুলিই রিটার্ন করা হয়। ফলস হলে, ডিফল্ট হিসেবে, উত্তরে এমন জায়গা থাকতে পারে যা নির্দিষ্ট ধরনের সাথে ম্যাচ করে না।
টেক্সট সার্চ (নতুন) সংক্রান্ত উদাহরণ
কোয়েরি স্ট্রিং ব্যবহার করে জায়গা খুঁজুন
"সিডনি, অস্ট্রেলিয়াতে ঝাল নিরামিষ খাবার"-এর জন্য টেক্সট সার্চ (নতুন) অনুরোধের উদাহরণ নিচে দেওয়া হল:
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'এছাড়াও, এই উদাহরণে X-Goog-FieldMask হেডার ব্যবহার করে
places.priceLevel ডেটা ফিল্ডকে
উত্তর
এর সাথে যোগ করা হয়েছে, তাই এটি এই ফর্ম্যাটে আছে:
{ "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,
এবং
ঐচ্ছিক প্যারামিটার-এ বর্ণনা করা অন্যান্য প্যারামিটার।
নির্দিষ্ট এলাকায় সার্চ সীমাবদ্ধ করা
কোনও এরিয়াতে সার্চ সীমাবদ্ধ করতে locationRestriction বা locationBias ব্যবহার করুন,
তবে দুটিই ব্যবহার করবেন না। locationRestriction
কে এমন একটি অঞ্চল হিসেবে ভাবুন যার মধ্যে ফলাফল থাকতে হবে এবং locationBias
কে এমন একটি অঞ্চল হিসেবে ভাবুন যার কাছাকাছি ফলাফল থাকতে হবে, তবে সেটি
অঞ্চলের বাইরেও হতে পারে।
locationRestriction ব্যবহার করে এলাকা সীমাবদ্ধ করা
নির্দিষ্ট অঞ্চলে কোয়েরির ফলাফল সীমাবদ্ধ করতে 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'
locationBias ব্যবহার করে কোনও জায়গার প্রতি পক্ষপাত
নিম্নলিখিত উদাহরণে, "নিরামিষ খাবার" সংক্রান্ত টেক্সট সার্চ (নতুন) কোয়েরি দেখানো হয়েছে। এই কোয়েরিটি ডাউনটাউন সান ফ্রান্সিসকোর মধ্যে কোনও পয়েন্ট থেকে ৫০০ মিটারের মধ্যে অবস্থিত লোকেশনের জন্য পক্ষপাতদুষ্ট। এই অনুরোধের মাধ্যমে খোলা আছে এমন জায়গার জন্য শুধুমাত্র প্রথম ১০টি ফলাফল দেখানো হয়।
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'
ন্যূনতম চার্জিং রেট সহ EV চার্জার সার্চ করা
minimumChargingRateKw ও connectorTypes ব্যবহার করে
আপনার EV-এর সাথে মানানসই উপলভ্য চার্জার আছে এমন জায়গা খুঁজুন।
নিচের উদাহরণে ক্যালিফোর্নিয়ার মাউন্টেন ভিউতে সর্বনিম্ন ১০ কিলোওয়াট চার্জিং রেট সহ Tesla এবং 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 } } ] }
ট্রানজিট স্টেশন সংক্রান্ত তথ্য পাওয়া
ট্রানজিট স্টেশন খুঁজে পেতে আপনি টেক্সট সার্চ (নতুন) ব্যবহার করতে পারবেন। রেসপন্স বডিতে স্টেশন সম্পর্কে তথ্য অন্তর্ভুক্ত থাকে, যার মধ্যে স্টেশনের নাম, অনুমোদিত ট্রানজিট এজেন্সি এবং স্টেশনে পরিষেবা প্রদানকারী ট্রানজিট লাইন অন্তর্ভুক্ত। এছাড়াও, উত্তরে একটি গাড়ির আইকন এবং রঙ অন্তর্ভুক্ত থাকে যা আপনি ট্রানজিট স্টেশনের তথ্য দেখাতে ব্যবহার করতে পারেন।
নিচে "Grand Central Station"-এর জন্য করা অনুরোধের একটি উদাহরণ দেওয়া হল:
curl -X POST \
-H "Content-Type: application/json" \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,places.transitStation" \
-d '{
"textQuery": "Grand Central Station"
}' \
"https://places.googleapis.com/v1/places:searchText"
রেসপন্স বডিতে ব্যাসার্ধের মধ্যে প্রতিটি স্টেশন, স্টেশন দ্বারা পরিবেশিত লাইন, সেই স্টপে ট্রানজিট এজেন্সি দ্বারা জারি করা সতর্কতা, এবং ছাড়ার তথ্য অন্তর্ভুক্ত থাকে:
{ "places": [ { "id": "ChIJhRwB-yFawokRi0AhGH87UTc", "displayName": { "text": "Grand Central", "languageCode": "en" }, "transitStation": { "displayName": { "text": "Grand Central", "languageCode": "en" }, "agencies": [ { "displayName": { "text": "Metro-North Railroad", "languageCode": "en" }, "url": "http://www.mta.info/mnr", "lines": [ { "id": "ChIJOXpD29y2wokRryDO0CocwK0", "vehicleType": "HEAVY_RAIL", "displayName": { "text": "Harlem", "languageCode": "en" }, "textColor": "#FFFFFF", "backgroundColor": "#0061AA", "vehicleIcon": { "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/rail2.svg" }, "alerts": [ { "effect": "OTHER", "texts": [ { "headline": { "text": "Information", "languageCode": "en" }, "summary": { "text": "Temporary platforms are in place at Botanical Garden, Williams Bridge, and Woodlawn for northbound travel. Build in extra travel time to reach the platform.", "languageCode": "en" }, "fullDescription": { "text": "What's Happening? We are renovating some Harlem Line stations in the Bronx. Learn more about the project here.", "languageCode": "en" } } ], "detailsUrls": [ { "url": "https://new.mta.info/" } ], "cause": "OTHER_CAUSE", "startTime": "2026-04-16T04:00:00Z", "endTime": "2026-12-01T04:45:00Z", "attribution": { "link": { "text": "new.mta.info", "url": "https://new.mta.info/" } }, "createTime": "2026-05-15T22:39:30Z", "severityLevel": "INFO" } ] }, ... ] }, ... ] "stops": [ { "id": "ChIJOfdrigFZwokRJPllLwfPrJY", "location": { "latitude": 40.752823, "longitude": -73.977195999999992 }, "wheelchairAccessibleEntrance": true } ], "departureBoards": [ { "displayType": "TIME_CENTRIC", "rows": [ { "departures": [ { "timedDeparture": { "scheduledTime": "2026-05-15T22:42:00Z", "timingType": "SCHEDULED", "predictedTime": "2026-05-15T22:42:00Z", "updateTime": "2026-05-15T22:38:50Z" }, "originallyScheduledStopId": "ChIJOfdrigFZwokRJPllLwfPrJY", "lineId": "ChIJAfBuQhwg6IkRYnFpClHxFrM" } ] }, ... ] } ] } }, { "id": "ChIJ_4EAi-pZwokRWe5T1JmmWmc", "displayName": { "text": "Grand Central Station", "languageCode": "en" } } ] }
প্রবেশপথ ও নেভিগেশন পয়েন্ট পাওয়া
আপনি কোনও গন্তব্যের প্রবেশপথ ও নেভিগেশন পয়েন্টের জন্য অনুরোধ করতে পারবেন। কোনও জায়গার প্রবেশ ও প্রস্থান পয়েন্টকে প্রবেশপথ বলা হয় (যেমন, এয়ারপোর্ট বা মলের বিভিন্ন গেট)। নেভিগেশন পয়েন্ট রাস্তার পাশে এমন লোকেশনকে সংজ্ঞায়িত করে যেখানে নেভিগেশন শেষ হওয়া উচিত, যা ব্যবহারকারীদের রাস্তার সঠিক দিকে বা নির্দিষ্ট ড্রপ-অফ পয়েন্টে নির্দেশ করার জন্য উপযোগী।
নেভিগেশন পয়েন্ট navigationPointToken রিটার্ন করে। আপনি এই টোকেনটি নেভিগেশন SDK (Android বা iOS-এর জন্য উপলভ্য) বা Routes API-তে পাস করতে পারেন যাতে ড্রাইভারকে সেই নির্দিষ্ট লোকেশনে গাইড করা যায়। আরও তথ্যের জন্য, নেভিগেশন পয়েন্ট টোকেন দেখুন।
নিচের উদাহরণে "San Francisco International Airport"-এর জন্য টেক্সট সার্চ (নতুন) অনুরোধ দেখানো হয়েছে, যার ফিল্ড মাস্কে entrances ও navigationPoints অন্তর্ভুক্ত রয়েছে:
curl -X POST \
-H "Content-Type: application/json" \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,places.entrances,places.navigationPoints" \
-d '{
"textQuery": "San Francisco International Airport",
"pageSize": 1
}' \
"https://places.googleapis.com/v1/places:searchText"
উত্তরে জায়গাটির প্রবেশপথ ও নেভিগেশন পয়েন্ট অন্তর্ভুক্ত থাকে:
{ "places": [ { "id": "ChIJVVVVVYx3j4ARP-3NGldc8qQ", "displayName": { "text": "San Francisco International Airport", "languageCode": "en" }, "entrances": [ { "location": { "latitude": 37.6172154, "longitude": -122.3839724 } }, { "location": { "latitude": 37.6174073, "longitude": -122.384196 } }, ... ], "navigationPoints": [ { "navigationPointToken": "ChIJoioBjMLOQkAR0A3yH_eYXsA...", "displayName": { "text": "International Terminal Departures Level", "languageCode": "en" }, "location": { "latitude": 37.6153121, "longitude": -122.3900833 }, "travelModes": ["WALK"] }, { "navigationPointToken": "ChIJy5JKws_OQkAROx0jNN2YXsA...", "displayName": { "text": "Domestic Garage - SFO Short Term Parking", "languageCode": "en" }, "location": { "latitude": 37.6157153, "longitude": -122.3885012 }, "travelModes": ["DRIVE", "WALK"], "usages": ["PARKING"] }, ... ] } ] }
এটি ব্যবহার করে দেখুন!
APIs Explorer আপনাকে স্যাম্পেল অনুরোধ করতে দেয় যাতে আপনি API এবং API বিকল্পের সাথে পরিচিত হতে পারেন।
পৃষ্ঠার ডানদিকে API আইকন api বেছে নিন।
ঐচ্ছিকভাবে অনুরোধের প্যারামিটার এডিট করুন।
এক্সিকিউট করুন বোতামটি বেছে নিন। ডায়ালগে, অনুরোধ করার জন্য আপনি যে অ্যাকাউন্ট ব্যবহার করতে চান সেটি বেছে নিন।
API এক্সপ্লোরার প্যানেলে, API এক্সপ্লোরার উইন্ডো বড় করতে, 'ফুলস্ক্রিন' আইকন ফুলস্ক্রিন বেছে নিন।