পাঠ্য অনুসন্ধান (নতুন)

ভূমিকা

টেক্সট সার্চ (নতুন) একটি স্ট্রিং (উদাহরণস্বরূপ, "নিউ ইয়র্কের পিৎজা" অথবা "অটওয়ার কাছে জুতার দোকান" অথবা "১২৩ মেইন স্ট্রিট") এর উপর ভিত্তি করে স্থানের একটি সেট সম্পর্কে তথ্য প্রদান করে। পরিষেবাটি টেক্সট স্ট্রিং এবং সেট করা যেকোনো অবস্থানের পক্ষপাতের সাথে মিলে যাওয়া স্থানের একটি তালিকা সহ প্রতিক্রিয়া জানায়।

প্রয়োজনীয় প্যারামিটার ছাড়াও, টেক্সট সার্চ (নতুন) আরও ভালো ফলাফলের জন্য ঐচ্ছিক প্যারামিটার ব্যবহার করে কোয়েরিগুলি পরিশোধন করতে সহায়তা করে।

APIs Explorer আপনাকে লাইভ অনুরোধ করতে দেয় যাতে আপনি API এবং API বিকল্পগুলির সাথে পরিচিত হতে পারেন:

টেক্সট সার্চ (নতুন) অনুরোধ

একটি টেক্সট সার্চ (নতুন) অনুরোধ হল নিম্নলিখিত ফর্মের একটি 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: *

  নিম্নলিখিত ক্ষেত্রগুলির মধ্যে একটি বা একাধিক উল্লেখ করুন:

  • নিম্নলিখিত ক্ষেত্রগুলি টেক্সট সার্চ এসেনশিয়ালস আইডি অনলি SKU ট্রিগার করে:

    places.attributions
places.id
places.name ^*
    nextPageToken
places.movedPlace
places.movedPlaceId

    ^* places.name ফিল্ডে স্থানের রিসোর্সের নাম এই আকারে রয়েছে: places/ PLACE_ID । স্থানের টেক্সট নাম অ্যাক্সেস করতে Pro SKU-তে places.displayName ব্যবহার করুন।

  • নিম্নলিখিত ক্ষেত্রগুলি টেক্সট অনুসন্ধান প্রো 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.photos
places.plusCode
places.postalAddress
places.primaryType
places.primaryTypeDisplayName
places.pureServiceAreaBusiness
places.shortFormattedAddress
places.searchUri
places.subDestinations
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
    
    ^* শুধুমাত্র টেক্সট অনুসন্ধান এবং কাছাকাছি অনুসন্ধান

• টেক্সটকোয়েরি

  যে টেক্সট স্ট্রিংয়ে সার্চ করতে হবে। উদাহরণস্বরূপ, "রেস্তোরাঁ", "১২৩ মেইন স্ট্রিট", অথবা "সান ফ্রান্সিসকোতে দেখার জন্য সেরা জায়গা"। API এই স্ট্রিংয়ের উপর ভিত্তি করে প্রার্থীর মিলগুলি ফেরত দেয় এবং তাদের অনুভূত প্রাসঙ্গিকতার উপর ভিত্তি করে ফলাফলগুলি অর্ডার করে।

  টেক্সট সার্চ (নতুন) অস্পষ্ট প্রশ্নের জন্য নয় , যার মধ্যে নিম্নলিখিতগুলি অন্তর্ভুক্ত রয়েছে:

  কোয়েরির ধরণ	উদাহরণ
  অনেক বেশি ধারণা বা সীমাবদ্ধতা, যেমন একটি কোয়েরিতে একাধিক স্থান, রাস্তা বা শহরের নাম	"মার্কেট স্ট্রিট সান ফ্রান্সিসকো সান জোসে বিমানবন্দর"
  গুগল ম্যাপে পোস্টাল ঠিকানার উপাদানগুলি দেখানো হয়নি	"সি/ও জন স্মিথ ১২৩ মেইন স্ট্রিট" "পোস্ট বক্স ১৩ সান ফ্রান্সিসকো"
  ব্যবসা, চেইন, অথবা বিভাগগুলির নাম, যেখানে এই সত্তাগুলি উপলব্ধ নয় এমন স্থানগুলির সাথে মিলিত	"ডালাস, টেক্সাসের কাছে টেসকো"
  একাধিক ব্যাখ্যা সহ অস্পষ্ট প্রশ্ন	"চার্জার ড্রপ-অফ"
  ঐতিহাসিক নামগুলি আর ব্যবহার করা হয় না	"মিডলসেক্স যুক্তরাজ্য"
  অ-ভূ-স্থানিক উপাদান বা অভিপ্রায়	"ভেনচুরা বন্দরে কয়টি নৌকা আছে?"
  অনানুষ্ঠানিক বা অসার নাম	"দ্য জেঙ্গা" "দ্য হেল্টার স্কেল্টার"
  অক্ষাংশ এবং দ্রাঘিমাংশ স্থানাঙ্ক	"৩৭.৪২২১৩১,-১২২.০৮৪৮০১"

ঐচ্ছিক পরামিতি

• অন্তর্ভুক্তপ্রকার

  সারণি A দ্বারা সংজ্ঞায়িত নির্দিষ্ট ধরণের সাথে মিলে যাওয়া স্থানগুলিতে ফলাফলগুলিকে পক্ষপাত করে। শুধুমাত্র একটি প্রকার নির্দিষ্ট করা যেতে পারে। উদাহরণস্বরূপ:

  • "includedType":"bar"
  • "includedType":"pharmacy"

  টেক্সট সার্চ (নতুন) প্রযোজ্যতার উপর নির্ভর করে নির্দিষ্ট কিছু প্রশ্নের জন্য টাইপ ফিল্টারিং প্রয়োগ করে। উদাহরণস্বরূপ, নির্দিষ্ট ঠিকানার ("১২৩ মেইন স্ট্রিট") প্রশ্নের ক্ষেত্রে টাইপ ফিল্টারিং প্রয়োগ নাও করা যেতে পারে, তবে টাইপ ফিল্টারিং প্রায় সবসময় শ্রেণীবদ্ধ প্রশ্নের ক্ষেত্রে প্রয়োগ করা হয় ("কাছাকাছি দোকান" বা "শপিং মল")।

  সকল প্রশ্নের ক্ষেত্রে টাইপ ফিল্টারিং প্রয়োগ করতে, strictTypeFiltering true তে সেট করুন।

• অন্তর্ভুক্ত করুনবিশুদ্ধ পরিষেবাক্ষেত্রব্যবসা

  যদি true তে সেট করা থাকে, তাহলে প্রতিক্রিয়ায় এমন ব্যবসাগুলি অন্তর্ভুক্ত থাকে যারা সরাসরি গ্রাহকদের কাছে যান বা বিতরণ করেন, কিন্তু তাদের কোনও বাস্তব ব্যবসার অবস্থান নেই। যদি false তে সেট করা থাকে, তাহলে API শুধুমাত্র সেই ব্যবসাগুলি ফেরত দেয় যেখানে একটি বাস্তব ব্যবসার অবস্থান রয়েছে।

• ভাষা কোড

  যে ভাষায় ফলাফল দেখাতে হবে।

  • সমর্থিত ভাষার তালিকা দেখুন। গুগল প্রায়শই সমর্থিত ভাষাগুলি আপডেট করে, তাই এই তালিকাটি সম্পূর্ণ নাও হতে পারে।
  • যদি languageCode সরবরাহ করা না থাকে, তাহলে API ডিফল্টভাবে en তে সেট করা হবে। যদি আপনি একটি অবৈধ ভাষা কোড উল্লেখ করেন, তাহলে API একটি INVALID_ARGUMENT ত্রুটি প্রদান করবে।
  • API এমন একটি রাস্তার ঠিকানা প্রদানের জন্য যথাসাধ্য চেষ্টা করে যা ব্যবহারকারী এবং স্থানীয় উভয়ের জন্যই পঠনযোগ্য। এই লক্ষ্য অর্জনের জন্য, এটি স্থানীয় ভাষায় রাস্তার ঠিকানাগুলি ফেরত দেয়, প্রয়োজনে ব্যবহারকারীর দ্বারা পঠনযোগ্য স্ক্রিপ্টে লিপ্যন্তরিত করে, পছন্দের ভাষা পর্যবেক্ষণ করে। অন্যান্য সমস্ত ঠিকানা পছন্দের ভাষায় ফেরত দেওয়া হয়। ঠিকানার উপাদানগুলি একই ভাষায় ফেরত দেওয়া হয়, যা প্রথম উপাদান থেকে নির্বাচিত হয়।
  • যদি পছন্দের ভাষায় কোনও নাম পাওয়া না যায়, তাহলে API সবচেয়ে কাছের মিল ব্যবহার করে।
  • API কোন ফলাফলগুলি ফেরত দিতে বেছে নেয় এবং কোন ক্রমে সেগুলি ফেরত দেওয়া হয় তার উপর পছন্দের ভাষার প্রভাব খুব কম থাকে। জিওকোডার ভাষার উপর নির্ভর করে সংক্ষিপ্ত রূপগুলিকে ভিন্নভাবে ব্যাখ্যা করে, যেমন রাস্তার ধরণের সংক্ষিপ্ত রূপ, অথবা প্রতিশব্দ যা এক ভাষায় বৈধ হতে পারে কিন্তু অন্য ভাষায় নয়।

• অবস্থান পক্ষপাত

  অনুসন্ধানের জন্য একটি এলাকা নির্দিষ্ট করে। এই অবস্থানটি একটি পক্ষপাত হিসেবে কাজ করে যার অর্থ নির্দিষ্ট স্থানের চারপাশের ফলাফলগুলি ফেরত পাঠানো যেতে পারে, নির্দিষ্ট এলাকার বাইরের ফলাফল সহ।

  আপনি locationRestriction অথবা locationBias নির্দিষ্ট করতে পারেন, কিন্তু দুটোই নয়। locationRestriction বলতে সেই অঞ্চলকে বোঝায় যেখানে ফলাফলগুলি থাকা আবশ্যক, এবং locationBias বলতে সেই অঞ্চলকে বোঝায় যেখানে ফলাফলগুলি সম্ভবত ভিতরে বা কাছাকাছি থাকবে কিন্তু এলাকার বাইরেও থাকতে পারে।

  অঞ্চলটিকে একটি আয়তক্ষেত্রাকার ভিউপোর্ট অথবা একটি বৃত্ত হিসেবে উল্লেখ করুন।

  • একটি বৃত্তকে কেন্দ্রবিন্দু এবং মিটারে ব্যাসার্ধ দ্বারা সংজ্ঞায়িত করা হয়। ব্যাসার্ধটি 0.0 এবং 50000.0 এর মধ্যে হতে হবে, যার মধ্যে রয়েছে। ডিফল্ট ব্যাসার্ধ হল 0.0। উদাহরণস্বরূপ:

    "locationBias": {
      "circle": {
        "center": {
          "latitude": 37.7937,
          "longitude": -122.3965
        },
        "radius": 500.0
      }
    }

  • একটি আয়তক্ষেত্র হল একটি অক্ষাংশ-দ্রাঘিমাংশ ভিউপোর্ট, যা দুটি তির্যক বিপরীত নিম্ন এবং উচ্চ বিন্দু হিসাবে প্রতিনিধিত্ব করে। নিম্ন বিন্দুটি আয়তক্ষেত্রের দক্ষিণ-পশ্চিম কোণকে চিহ্নিত করে এবং উচ্চ বিন্দুটি আয়তক্ষেত্রের উত্তর-পূর্ব কোণকে প্রতিনিধিত্ব করে।

    একটি ভিউপোর্টকে একটি বদ্ধ অঞ্চল হিসেবে বিবেচনা করা হয়, যার অর্থ এটি তার সীমানা অন্তর্ভুক্ত করে। অক্ষাংশ সীমানা -৯০ থেকে ৯০ ডিগ্রির মধ্যে হতে হবে এবং দ্রাঘিমাংশ সীমানা -১৮০ থেকে ১৮০ ডিগ্রির মধ্যে হতে হবে:

    • যদি low = high , তাহলে ভিউপোর্টটি সেই একক বিন্দু দিয়ে গঠিত।
    • যদি low.longitude > high.longitude হয়, তাহলে দ্রাঘিমাংশ পরিসর উল্টানো হয় (ভিউপোর্টটি 180 ডিগ্রি দ্রাঘিমাংশ রেখা অতিক্রম করে)।
    • যদি low.longitude = -180 degrees এবং high.longitude = 180 degrees হয়, তাহলে ভিউপোর্টে সমস্ত দ্রাঘিমাংশ অন্তর্ভুক্ত থাকবে।
    • যদি low.longitude = ১৮০ ডিগ্রি এবং high.longitude = -১৮০ ডিগ্রি হয়, তাহলে দ্রাঘিমাংশ পরিসর খালি থাকবে।
    • যদি 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) চার্জিং সংযোগকারী এবং চার্জিং হার সনাক্ত করার জন্য পরামিতি নির্দিষ্ট করে।

  • সংযোগকারীর ধরণ

    কোনও জায়গায় উপলব্ধ EV চার্জিং সংযোগকারীর ধরণ অনুযায়ী ফিল্টার করা হবে। যে জায়গায় কোনও সংযোগকারীর ধরণ সমর্থন করে না, সে জায়গায় ফিল্টার করা হবে। সমর্থিত EV চার্জিং সংযোগকারীর ধরণগুলির মধ্যে রয়েছে সম্মিলিত (AC এবং DC) চার্জার, টেসলা চার্জার, GB/T-সম্মত চার্জার (চীনে EV দ্রুত চার্জিংয়ের জন্য) এবং ওয়াল আউটলেট চার্জার। আরও তথ্যের জন্য, রেফারেন্স ডকুমেন্টেশন দেখুন।

    • একটি নির্দিষ্ট সমর্থিত সংযোগকারীর ফলাফল ফিল্টার করতে, connectorTypes সেই মানে সেট করুন। উদাহরণস্বরূপ, J1772 টাইপ 1 সংযোগকারী খুঁজে পেতে, connectorTypes EV_CONNECTOR_TYPE_J1772 এ সেট করুন।
    • অসমর্থিত সংযোগকারীর ফলাফল ফিল্টার করতে, connectorTypes EV_CONNECTOR_TYPE_OTHER এ সেট করুন।
    • যেকোনো ধরণের সংযোগকারীর ফলাফল ফিল্টার করতে যা ওয়াল আউটলেট, connectorTypes EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET এ সেট করুন।
    • যেকোনো সংযোগকারীর ধরণের ফলাফল ফিল্টার করতে, হয় connectorTypes EV_CONNECTOR_TYPE_UNSPECIFIED এ সেট করুন অথবা connectorTypes এর জন্য কোনও মান সেট করবেন না।

  • সর্বনিম্ন চার্জিং রেটKw

    কিলোওয়াট (kW) তে সর্বনিম্ন EV চার্জিং হার অনুসারে স্থানগুলি ফিল্টার করে। সর্বনিম্ন চার্জিং হারের চেয়ে কম চার্জিং হার সহ যে কোনও স্থান ফিল্টার করা হয়। উদাহরণস্বরূপ, কমপক্ষে 10 kW চার্জিং হার সহ EV চার্জারগুলি খুঁজে পেতে, আপনি এই প্যারামিটারটি "10" তে সেট করতে পারেন।

• মিনিম্যাটিং

  শুধুমাত্র সেইসব ফলাফলের ক্ষেত্রে সীমাবদ্ধ যাদের গড় ব্যবহারকারী রেটিং এই সীমার চেয়ে বেশি বা সমান। মানগুলি 0.5 বৃদ্ধির সাথে 0.0 এবং 5.0 (সমেত) এর মধ্যে হতে হবে। উদাহরণস্বরূপ: 0, 0.5, 1.0, ... , 5.0 সহ। মানগুলি নিকটতম 0.5 পর্যন্ত পূর্ণসংখ্যা করা হয়। উদাহরণস্বরূপ, 0.6 এর মান 1.0 এর কম রেটিং সহ সমস্ত ফলাফলকে বাদ দেয়।

• এখন খুলুন

  যদি true , তাহলে শুধুমাত্র সেইসব স্থান ফেরত দিন যেগুলি কোয়েরি পাঠানোর সময় ব্যবসার জন্য খোলা ছিল। যদি false , তাহলে খোলা অবস্থা নির্বিশেষে সমস্ত ব্যবসা ফেরত দিন। যদি আপনি এই প্যারামিটারটি false তে সেট করেন তবে Google Places ডাটাবেসে খোলার সময় নির্দিষ্ট না করা স্থানগুলি ফেরত দেওয়া হবে।

• পৃষ্ঠার আকার

  প্রতি পৃষ্ঠায় প্রদর্শিত ফলাফলের সংখ্যা (১ থেকে ২০ এর মধ্যে) নির্দিষ্ট করে। উদাহরণস্বরূপ, pageSize মান ৫ সেট করলে প্রথম পৃষ্ঠায় সর্বোচ্চ ৫টি ফলাফল আসবে। যদি কোয়েরি থেকে আরও ফলাফল পাওয়া যায়, তাহলে উত্তরে একটি nextPageToken থাকবে যা আপনি পরবর্তী পৃষ্ঠায় প্রবেশের জন্য পরবর্তী অনুরোধে পাঠাতে পারবেন।

• পেজটোকেন

  পূর্ববর্তী পৃষ্ঠার প্রতিক্রিয়া অংশ থেকে nextPageToken নির্দিষ্ট করে।

• মূল্যস্তর

  নির্দিষ্ট মূল্য স্তরে চিহ্নিত স্থানগুলিতে অনুসন্ধান সীমাবদ্ধ রাখুন। ডিফল্টভাবে সমস্ত মূল্য স্তর নির্বাচন করা হয়।

  নিম্নলিখিত ধরণের জায়গাগুলির জন্য দামের স্তর আশা করা যেতে পারে:

  • খাদ্য ও পানীয়
  • সেবা
  • শপিং

  যদি priceLevels নির্দিষ্ট করা থাকে, তাহলে অ-সমর্থিত ধরণের স্থানগুলি প্রতিক্রিয়ায় অন্তর্ভুক্ত করা হবে না।

  PriceLevel দ্বারা সংজ্ঞায়িত এক বা একাধিক মানের একটি অ্যারে নির্দিষ্ট করুন।

  উদাহরণস্বরূপ:

  "priceLevels":["PRICE_LEVEL_INEXPENSIVE", "PRICE_LEVEL_MODERATE"]

• পদমর্যাদাপ্রেফারেন্স

  কোয়েরির ধরণের উপর ভিত্তি করে প্রতিক্রিয়াতে ফলাফলগুলি কীভাবে র‍্যাঙ্ক করা হয় তা নির্দিষ্ট করে:

  • "নিউ ইয়র্ক সিটির রেস্তোরাঁ" এর মতো একটি শ্রেণীবদ্ধ প্রশ্নের জন্য, RELEVANCE (সার্চ প্রাসঙ্গিকতা অনুসারে ফলাফলের র‌্যাঙ্ক) হল ডিফল্ট। আপনি rankPreference RELEVANCE অথবা DISTANCE (দূরত্ব অনুসারে ফলাফলের র‌্যাঙ্ক) এ সেট করতে পারেন।
  • "মাউন্টেন ভিউ, ক্যালিফোর্নিয়া" এর মতো অ-শ্রেণীবদ্ধ প্রশ্নের জন্য, আমরা আপনাকে rankPreference সেট না করে রাখার পরামর্শ দিচ্ছি।

• অঞ্চল কোড

  প্রতিক্রিয়া ফর্ম্যাট করতে ব্যবহৃত অঞ্চল কোড, দুই-অক্ষরের CLDR কোড মান হিসাবে নির্দিষ্ট করা হয়েছে। এই প্যারামিটারটি অনুসন্ধান ফলাফলের উপর পক্ষপাতের প্রভাবও ফেলতে পারে। কোনও ডিফল্ট মান নেই।

  যদি প্রতিক্রিয়ায় formattedAddress ক্ষেত্রের দেশের নাম regionCode সাথে মিলে যায়, তাহলে formattedAddress থেকে দেশের কোড বাদ দেওয়া হবে। এই প্যারামিটারটি adrFormatAddress এর উপর কোন প্রভাব ফেলে না, যা সর্বদা দেশের নাম অন্তর্ভুক্ত করে যখন উপলব্ধ থাকে, অথবা shortFormattedAddress উপর, যা কখনও অন্তর্ভুক্ত করে না।

  বেশিরভাগ CLDR কোড ISO 3166-1 কোডের অনুরূপ, কিছু উল্লেখযোগ্য ব্যতিক্রম ছাড়া। উদাহরণস্বরূপ, যুক্তরাজ্যের ccTLD হল "uk" (.co.uk) যেখানে এর ISO 3166-1 কোড হল "gb" (প্রযুক্তিগতভাবে "The United Kingdom of Great Britain and Northern Ireland" এর সত্তার জন্য)। প্রযোজ্য আইনের উপর ভিত্তি করে প্যারামিটারটি ফলাফলকে প্রভাবিত করতে পারে।

• স্ট্রিকটাইপফিল্টারিং

  includedType প্যারামিটারের সাথে ব্যবহার করা হয়। true তে সেট করা হলে, শুধুমাত্র includedType দ্বারা নির্দিষ্ট করা নির্দিষ্ট ধরণের সাথে মেলে এমন স্থানগুলি ফেরত দেওয়া হয়। যখন false, ডিফল্ট, প্রতিক্রিয়াতে এমন স্থান থাকতে পারে যা নির্দিষ্ট ধরণের সাথে মেলে না।

টেক্সট সার্চ (নতুন) উদাহরণ

কোয়েরি স্ট্রিং অনুসারে একটি স্থান খুঁজুন

নিচের উদাহরণে "অস্ট্রেলিয়ার সিডনিতে মশলাদার নিরামিষ খাবার" এর জন্য একটি টেক্সট অনুসন্ধান (নতুন) অনুরোধ দেখানো হয়েছে:

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 প্যারামিটার ব্যবহার করুন। আপনার অনুরোধের মূল অংশে, অঞ্চলের সীমানা নির্ধারণকারী 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'

সর্বনিম্ন চার্জিং হার সহ EV চার্জারগুলি অনুসন্ধান করুন

আপনার EV-এর সাথে সামঞ্জস্যপূর্ণ চার্জার সহ স্থানগুলি অনুসন্ধান করতে minimumChargingRateKw এবং connectorTypes ব্যবহার করুন।

নিচের উদাহরণটি মাউন্টেন ভিউ, ক্যালিফোর্নিয়ায় ন্যূনতম ১০ কিলোওয়াট চার্জিং রেট সহ টেসলা এবং J1772 টাইপ 1 EV চার্জিং সংযোগকারীর জন্য একটি অনুরোধ দেখায়। মাত্র চারটি ফলাফল পাওয়া গেছে।

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"
}

পরবর্তী পৃষ্ঠার ফলাফল অ্যাক্সেস করতে, অনুরোধের বডিতে nextPageToken পাস করতে pageToken ব্যবহার করুন:

 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"
          }
        ]
      }
    },
    /.../
  ]
}

চেষ্টা করে দেখুন!

APIs Explorer আপনাকে নমুনা অনুরোধ করতে দেয় যাতে আপনি API এবং API বিকল্পগুলির সাথে পরিচিত হতে পারেন।

1. পৃষ্ঠার ডান দিকে API আইকন API নির্বাচন করুন।

2. ঐচ্ছিকভাবে অনুরোধের প্যারামিটারগুলি সম্পাদনা করুন।

3. এক্সিকিউট বোতামটি নির্বাচন করুন। ডায়ালগে, অনুরোধটি করার জন্য আপনি যে অ্যাকাউন্টটি ব্যবহার করতে চান তা নির্বাচন করুন।

4. APIs Explorer প্যানেলে, APIs Explorer উইন্ডোটি প্রসারিত করতে ফুলস্ক্রিন আইকন ফুলস্ক্রিন নির্বাচন করুন।