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

পাঠ্য অনুসন্ধান (নতুন) একটি স্ট্রিংয়ের উপর ভিত্তি করে স্থানগুলির একটি সেট সম্পর্কে তথ্য প্রদান করে — উদাহরণস্বরূপ, "নিউ ইয়র্কের পিজা" বা "অটোয়ার কাছে জুতার দোকান" বা "123 প্রধান রাস্তা"। পরিষেবাটি পাঠ্য স্ট্রিংয়ের সাথে মেলে এমন স্থানগুলির একটি তালিকা এবং সেট করা যেকোন অবস্থানের পক্ষপাতের সাথে প্রতিক্রিয়া জানায়৷

পরিষেবাটি একটি স্বয়ংক্রিয় সিস্টেমে অস্পষ্ট ঠিকানা প্রশ্ন করার জন্য বিশেষভাবে উপযোগী, এবং স্ট্রিংয়ের অ-ঠিকানা উপাদানগুলি ব্যবসার পাশাপাশি ঠিকানাগুলির সাথে মেলে। অস্পষ্ট ঠিকানা প্রশ্নের উদাহরণ হল খারাপভাবে ফর্ম্যাট করা ঠিকানা বা অনুরোধ যাতে ব্যবসার নামগুলির মতো নন-অ্যাড্রেস উপাদান অন্তর্ভুক্ত থাকে। নিম্নলিখিত সারণীতে প্রথম দুটি উদাহরণের মতো অনুরোধগুলি শূন্য ফলাফল দিতে পারে যদি না কোনো অবস্থান — যেমন অঞ্চল, অবস্থানের সীমাবদ্ধতা, বা অবস্থানের পক্ষপাত — সেট করা না থাকে।

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

পাঠ্য অনুসন্ধান অনুরোধ

একটি পাঠ্য অনুসন্ধান অনুরোধ হল নিম্নলিখিত ফর্মের একটি 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)
    }
  ]
}

প্রয়োজনীয় পরামিতি

• ফিল্ডমাস্ক

  একটি প্রতিক্রিয়া ক্ষেত্র মাস্ক তৈরি করে প্রতিক্রিয়াতে ফিরে আসার জন্য ক্ষেত্রগুলির তালিকা নির্দিষ্ট করুন। URL প্যারামিটার $fields বা fields ব্যবহার করে বা HTTP শিরোনাম X-Goog-FieldMask ব্যবহার করে পদ্ধতিতে প্রতিক্রিয়া ক্ষেত্র মাস্ক পাস করুন। প্রতিক্রিয়ায় প্রত্যাবর্তিত ক্ষেত্রগুলির কোনও ডিফল্ট তালিকা নেই। আপনি যদি ফিল্ড মাস্ক বাদ দেন, তবে পদ্ধতিটি একটি ত্রুটি প্রদান করে।

  আপনি অপ্রয়োজনীয় ডেটার অনুরোধ করবেন না তা নিশ্চিত করার জন্য ফিল্ড মাস্কিং একটি ভাল ডিজাইন অনুশীলন, যা অপ্রয়োজনীয় প্রক্রিয়াকরণের সময় এবং বিলিং চার্জ এড়াতে সহায়তা করে।

  প্রত্যাবর্তনের জন্য স্থান ডেটা প্রকারের একটি কমা-বিভক্ত তালিকা নির্দিষ্ট করুন৷ উদাহরণস্বরূপ, প্রদর্শনের নাম এবং স্থানের ঠিকানা পুনরুদ্ধার করতে।

  X-Goog-FieldMask: places.displayName,places.formattedAddress

  সমস্ত ক্ষেত্র পুনরুদ্ধার করতে * ব্যবহার করুন।

  X-Goog-FieldMask: *

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

  • নিম্নলিখিত ক্ষেত্রগুলি পাঠ্য অনুসন্ধানকে ট্রিগার করে (শুধুমাত্র ID) SKU :

    places.attributions
places.id
places.name ^*
    nextPageToken
    
    ^* places.name ক্ষেত্রের ফর্মে জায়গার সম্পদের নাম রয়েছে: places/ PLACE_ID । জায়গার টেক্সট নাম অ্যাক্সেস করতে places.displayName ব্যবহার করুন।

  • নিম্নলিখিত ক্ষেত্রগুলি পাঠ্য অনুসন্ধান (বেসিক) SKU ট্রিগার করে:

    places.accessibilityOptions
places.addressComponents
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.primaryType
places.primaryTypeDisplayName
places.pureServiceAreaBusiness
places.shortFormattedAddress
places.subDestinations
places.types
places.utcOffsetMinutes
places.viewport
    
    ^* places.googleMapsLinks ক্ষেত্রটি GA-এর পূর্ববর্তী পর্যায়ে রয়েছে এবং কোন চার্জ নেই, যার অর্থ বিলিং $0, প্রিভিউ চলাকালীন ব্যবহারের জন্য।

  • নিম্নলিখিত ক্ষেত্রগুলি পাঠ্য অনুসন্ধান (উন্নত) 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.evChargeOptions
places.fuelOptions
places.goodForChildren
places.goodForGroups
places.goodForWatchingSports
places.liveMusic
places.menuForChildren
places.parkingOptions
places.paymentOptions
places.outdoorSeating
places.reservable
places.restroom
places.reviews
places.routingSummaries ^*
    places.servesBeer
places.servesBreakfast
places.servesBrunch
places.servesCocktails
places.servesCoffee
places.servesDessert
places.servesDinner
places.servesLunch
places.servesVegetarianFood
places.servesWine
places.takeout
    
    ^* শুধুমাত্র পাঠ্য অনুসন্ধান এবং কাছাকাছি অনুসন্ধান

• textQuery

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

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

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

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

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

• PureServiceAreaBusinesses অন্তর্ভুক্ত

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

• ভাষা কোড

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

  • সমর্থিত ভাষার তালিকা দেখুন। Google প্রায়ই সমর্থিত ভাষা আপডেট করে, তাই এই তালিকাটি সম্পূর্ণ নাও হতে পারে।
  • 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
      }
    }

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

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

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

  প্রতি পৃষ্ঠায় প্রদর্শিত ফলাফলের সংখ্যা (1 এবং 20 এর মধ্যে) নির্দিষ্ট করে। উদাহরণস্বরূপ, 5 এর একটি maxResultCount মান সেট করলে প্রথম পৃষ্ঠায় 5টি পর্যন্ত ফলাফল পাওয়া যাবে। যদি ক্যোয়ারী থেকে আরও বেশি ফলাফল পাওয়া যায়, তাহলে প্রতিক্রিয়াতে একটি nextPageToken অন্তর্ভুক্ত থাকে যা আপনি পরবর্তী পৃষ্ঠায় অ্যাক্সেস করার জন্য পরবর্তী অনুরোধে পাস করতে পারেন।

• বিকল্প

  উপলব্ধ বৈদ্যুতিক যান (EV) চার্জিং সংযোগকারী এবং চার্জিং হার সনাক্ত করার জন্য পরামিতি নির্দিষ্ট করে।

  • সংযোগকারী প্রকার

    একটি জায়গায় উপলব্ধ EV চার্জিং সংযোগকারীর ধরন অনুসারে ফিল্টার। একটি স্থান যা সংযোগকারী প্রকারের কোনো সমর্থন করে না ফিল্টার আউট করা হবে. সমর্থিত EV চার্জিং সংযোগকারী প্রকারের মধ্যে রয়েছে সম্মিলিত (AC এবং DC) চার্জার, Tesla চার্জার, 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

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

• মিন রেটিং

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

• এখন খুলুন

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

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

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

• পেজ টোকেন

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

• মূল্যস্তর

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

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

  যেমন:

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

• র‍্যাঙ্ক পছন্দ

  প্রশ্নের প্রকারের উপর ভিত্তি করে প্রতিক্রিয়াতে ফলাফলগুলিকে কীভাবে স্থান দেওয়া হয় তা নির্দিষ্ট করে:

  • "নিউ ইয়র্ক সিটির রেস্তোরাঁ" এর মতো একটি সুনির্দিষ্ট প্রশ্নের জন্য, RELEVANCE (অনুসন্ধানের প্রাসঙ্গিকতা অনুসারে র্যাঙ্ক ফলাফল) ডিফল্ট। আপনি RELEVANCE বা DISTANCE (দূরত্ব অনুসারে র‌্যাঙ্ক ফলাফল) rankPreference সেট করতে পারেন।
  • "মাউন্টেন ভিউ, CA"-এর মতো একটি অ-শ্রেণীগত প্রশ্নের জন্য, আমরা সুপারিশ করছি যে আপনি 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 সেট করা হলে, শুধুমাত্র includeType দ্বারা নির্দিষ্ট করা নির্দিষ্ট প্রকারের সাথে মেলে এমন স্থানগুলি ফেরত দেওয়া হয়। মিথ্যা হলে, ডিফল্ট, প্রতিক্রিয়াতে এমন স্থান থাকতে পারে যা নির্দিষ্ট প্রকারের সাথে মেলে না।

পাঠ্য অনুসন্ধানের উদাহরণ

ক্যোয়ারী স্ট্রিং দ্বারা একটি স্থান খুঁজুন

নিম্নলিখিত উদাহরণটি "সিডনি, অস্ট্রেলিয়ায় মসলাযুক্ত নিরামিষ খাবার" এর জন্য একটি পাঠ্য অনুসন্ধানের অনুরোধ দেখায়:

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 অক্ষাংশ এবং দ্রাঘিমাংশের মানগুলি নির্দিষ্ট করুন যা অঞ্চলের সীমানা নির্ধারণ করে৷

নিম্নলিখিত উদাহরণটি নিউ ইয়র্ক সিটিতে "নিরামিষাশী খাবার" এর জন্য একটি পাঠ্য অনুসন্ধানের অনুরোধ দেখায়৷ এই অনুরোধটি খোলা জায়গাগুলির জন্য শুধুমাত্র প্রথম 10টি ফলাফল প্রদান করে৷

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'

অবস্থান বিয়াস ব্যবহার করে একটি এলাকায় পক্ষপাত

নিম্নলিখিত উদাহরণটি সান ফ্রান্সিসকো শহরের কেন্দ্রস্থলে একটি পয়েন্টের 500 মিটারের মধ্যে একটি অবস্থানের জন্য পক্ষপাতদুষ্ট "নিরামিষাশী খাবার" এর জন্য একটি পাঠ্য অনুসন্ধানের অনুরোধ দেখায়। এই অনুরোধটি খোলা জায়গাগুলির জন্য শুধুমাত্র প্রথম 10টি ফলাফল প্রদান করে৷

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 ব্যবহার করুন৷

নিম্নলিখিত উদাহরণটি মাউন্টেন ভিউ, CA-তে ন্যূনতম 10 কিলোওয়াট চার্জিং রেট সহ Tesla এবং 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 প্যারামিটার ব্যবহার করুন।

নিম্নলিখিত উদাহরণটি সান ফ্রান্সিসকোতে plumbersের জন্য একটি অনুরোধ দেখায়:

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 প্যারামিটারটি একটি টোকেন প্রদান করে যা পরবর্তী কলগুলিতে ফলাফলের পরবর্তী পৃষ্ঠায় অ্যাক্সেস করতে ব্যবহার করা যেতে পারে।

নিম্নলিখিত উদাহরণটি প্রতি পৃষ্ঠায় 5টি ফলাফলের মধ্যে সীমাবদ্ধ "নিউ ইয়র্কে পিজা" এর জন্য একটি অনুরোধ দেখায়:

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

এটা চেষ্টা করুন!

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

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

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

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

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