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

পাঠ্য অনুসন্ধান (নতুন) একটি স্ট্রিংয়ের উপর ভিত্তি করে স্থানগুলির একটি সেট সম্পর্কে তথ্য প্রদান করে — উদাহরণস্বরূপ, "নিউ ইয়র্কের পিজা" বা "অটোয়ার কাছে জুতার দোকান" বা "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: *

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

  • নিম্নলিখিত ক্ষেত্রগুলি পাঠ্য অনুসন্ধানের প্রয়োজনীয় আইডি শুধুমাত্র 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.postalAddress
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 নির্দিষ্ট করে।

• মূল্যস্তর

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

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

  • খাদ্য এবং পানীয়
  • সেবা
  • কেনাকাটা

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

  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 এক্সপ্লোরার উইন্ডোটি প্রসারিত করতে ফুলস্ক্রিন আইকন পূর্ণস্ক্রীন নির্বাচন করুন।

পাঠ্য অনুসন্ধান (নতুন) একটি স্ট্রিংয়ের উপর ভিত্তি করে স্থানগুলির একটি সেট সম্পর্কে তথ্য প্রদান করে — উদাহরণস্বরূপ, "নিউ ইয়র্কের পিজা" বা "অটোয়ার কাছে জুতার দোকান" বা "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: *

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

  • নিম্নলিখিত ক্ষেত্রগুলি পাঠ্য অনুসন্ধানের প্রয়োজনীয় আইডি শুধুমাত্র 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.postalAddress
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 নির্দিষ্ট করে।

• প্রাইসিলভেলস

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

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

  • খাদ্য এবং পানীয়
  • সেবা
  • কেনাকাটা

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

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

  যেমন:

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

• র‌্যাঙ্কপ্রেসিফারেন্স

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

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

• অঞ্চলকোড

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

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

  বেশিরভাগ সিএলডিআর কোডগুলি কিছু উল্লেখযোগ্য ব্যতিক্রম সহ আইএসও 3166-1 কোডগুলির সাথে সমান। উদাহরণস্বরূপ, যুক্তরাজ্যের সিসিটিএলডি হ'ল "ইউকে" (.co.uk) যখন এর আইএসও 3166-1 কোডটি "জিবি" (প্রযুক্তিগতভাবে "গ্রেট ব্রিটেন এবং উত্তর আয়ারল্যান্ডের যুক্তরাজ্য" এর সত্তার জন্য)। প্যারামিটার প্রযোজ্য আইনের ভিত্তিতে ফলাফলগুলিকে প্রভাবিত করতে পারে।

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

  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'

এই উদাহরণটি places.priceLevel যুক্ত করতে X-Goog-FieldMask শিরোনামও ব্যবহার করে recepprecelevel ডেটা ক্ষেত্রটি প্রতিক্রিয়াতে যাতে এটি আকারে থাকে:

{
  "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 এবং al চ্ছিক পরামিতিগুলিতে বর্ণিত অন্যান্য পরামিতি।

একটি নির্দিষ্ট অঞ্চলে অনুসন্ধান সীমাবদ্ধ করুন

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

লোকেশন রেস্ট্রিকশন ব্যবহার করে অঞ্চল সীমাবদ্ধ করুন

নির্দিষ্ট অঞ্চলে ক্যোয়ারী ফলাফলগুলি সীমাবদ্ধ করতে 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'

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

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

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

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

নিম্নলিখিত উদাহরণটি প্রতি পৃষ্ঠায় 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"
}

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

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

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

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

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

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

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

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

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

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

একটি পাঠ্য অনুসন্ধানের অনুরোধ হ'ল নিম্নলিখিত ফর্মটির একটি HTTP পোস্ট অনুরোধ:

https://places.googleapis.com/v1/places:searchText

পোস্ট অনুরোধের অংশ হিসাবে জেএসএন অনুরোধ বডি বা শিরোনামে সমস্ত পরামিতি পাস করুন। যেমন:

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 অবজেক্টে একটি একক জায়গা সম্পর্কে বিশদ তথ্য রয়েছে।
• অনুরোধে পাস করা ফিল্ডমাস্ক Place অবজেক্টে ফিরে আসা ক্ষেত্রগুলির তালিকা নির্দিষ্ট করে।

সম্পূর্ণ JSON অবজেক্টটি আকারে রয়েছে:

{
  "places": [
    {
      object (Place)
    }
  ]
}

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

• ফিল্ডমাস্ক

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

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

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

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

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

  X-Goog-FieldMask: *

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

  • নিম্নলিখিত ক্ষেত্রগুলি পাঠ্য অনুসন্ধানের প্রয়োজনীয়তা আইডি কেবল স্কু ট্রিগার করে:

    places.attributions
places.id
places.name ^*
    nextPageToken
    
    ^* places.name ফিল্ডে প্লেস রিসোর্সের নাম ফর্মটিতে রয়েছে: places/ PLACE_ID । স্থানটির পাঠ্যের নাম অ্যাক্সেস করতে places.displayName ব্যবহার করুন।

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

    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.postalAddress
places.primaryType
places.primaryTypeDisplayName
places.pureServiceAreaBusiness
places.shortFormattedAddress
places.subDestinations
places.types
places.utcOffsetMinutes
places.viewport
    
    ^* places.googleMapsLinks

  • নিম্নলিখিত ক্ষেত্রগুলি পাঠ্য অনুসন্ধান এন্টারপ্রাইজ স্কু ট্রিগার করে:

    places.currentOpeningHours
places.currentSecondaryOpeningHours
places.internationalPhoneNumber
places.nationalPhoneNumber
places.priceLevel
places.priceRange
places.rating
places.regularOpeningHours
places.regularSecondaryOpeningHours
places.userRatingCount
places.websiteUri

  • নিম্নলিখিত ক্ষেত্রগুলি পাঠ্য অনুসন্ধান এন্টারপ্রাইজ প্লাস স্কু ট্রিগার করে:

    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 ^{routingumarary *}
    places.servesBeer
places.servesBreakfast
places.servesBrunch
places.servesCocktails
places.servesCoffee
places.servesDessert
places.servesDinner
places.servesLunch
places.servesVegetarianFood
places.servesWine
places.takeout
    
    ^* কেবল পাঠ্য অনুসন্ধান এবং কাছাকাছি অনুসন্ধান

• টেক্সটকিউরি

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

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

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

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

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

• অন্তর্ভুক্তিপার সার্ভিসারএবসিনেসগুলি

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

• ল্যাঙ্গুয়েজকোড

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

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

• লোকেশনবিয়াস

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

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

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

  • একটি বৃত্ত কেন্দ্র পয়েন্ট এবং মিটারে ব্যাসার্ধ দ্বারা সংজ্ঞায়িত করা হয়। ব্যাসার্ধটি অবশ্যই 0.0 এবং 50000.0 এর মধ্যে থাকতে হবে। ডিফল্ট ব্যাসার্ধ 0.0। যেমন:

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

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

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

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

• লোকেশন রেস্ট্রিকেশন

  অনুসন্ধানের জন্য একটি অঞ্চল নির্দিষ্ট করে। নির্দিষ্ট অঞ্চলের বাইরের ফলাফলগুলি ফেরত দেওয়া হয় না।

  অঞ্চলটিকে একটি আয়তক্ষেত্রাকার ভিউপোর্ট হিসাবে নির্দিষ্ট করুন। ভিউপোর্টটি সংজ্ঞায়িত করার উদাহরণের জন্য, locationBias বিবরণ দেখুন।

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

• ম্যাক্সরেসাল্টকাউন্ট (অবমূল্যায়িত)

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

• ইভোপশনস

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

  • কানেক্টরপেটস

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

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

  • ন্যূনতম চার্জিংরেটেকডাব্লু

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

• মিন্রেটিং

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

• ওপেননো

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

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

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

• পেজ টোকেন

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

• প্রাইসিলভেলস

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

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

  • খাদ্য এবং পানীয়
  • সেবা
  • কেনাকাটা

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

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

  যেমন:

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

• র‌্যাঙ্কপ্রেসিফারেন্স

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

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

• অঞ্চলকোড

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

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

  বেশিরভাগ সিএলডিআর কোডগুলি কিছু উল্লেখযোগ্য ব্যতিক্রম সহ আইএসও 3166-1 কোডগুলির সাথে সমান। উদাহরণস্বরূপ, যুক্তরাজ্যের সিসিটিএলডি হ'ল "ইউকে" (.co.uk) যখন এর আইএসও 3166-1 কোডটি "জিবি" (প্রযুক্তিগতভাবে "গ্রেট ব্রিটেন এবং উত্তর আয়ারল্যান্ডের যুক্তরাজ্য" এর সত্তার জন্য)। প্যারামিটার প্রযোজ্য আইনের ভিত্তিতে ফলাফলগুলিকে প্রভাবিত করতে পারে।

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

  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'

এই উদাহরণটি places.priceLevel যুক্ত করতে X-Goog-FieldMask শিরোনামও ব্যবহার করে recepprecelevel ডেটা ক্ষেত্রটি প্রতিক্রিয়াতে যাতে এটি আকারে থাকে:

{
  "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 এবং al চ্ছিক পরামিতিগুলিতে বর্ণিত অন্যান্য পরামিতি।

একটি নির্দিষ্ট অঞ্চলে অনুসন্ধান সীমাবদ্ধ করুন

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

লোকেশন রেস্ট্রিকশন ব্যবহার করে অঞ্চল সীমাবদ্ধ করুন

নির্দিষ্ট অঞ্চলে ক্যোয়ারী ফলাফলগুলি সীমাবদ্ধ করতে 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'

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

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

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

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

নিম্নলিখিত উদাহরণটি প্রতি পৃষ্ঠায় 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"
}

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

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

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

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

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

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

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

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

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

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

একটি পাঠ্য অনুসন্ধানের অনুরোধ হ'ল নিম্নলিখিত ফর্মটির একটি HTTP পোস্ট অনুরোধ:

https://places.googleapis.com/v1/places:searchText

পোস্ট অনুরোধের অংশ হিসাবে জেএসএন অনুরোধ বডি বা শিরোনামে সমস্ত পরামিতি পাস করুন। যেমন:

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 অবজেক্টে একটি একক জায়গা সম্পর্কে বিশদ তথ্য রয়েছে।
• অনুরোধে পাস করা ফিল্ডমাস্ক Place অবজেক্টে ফিরে আসা ক্ষেত্রগুলির তালিকা নির্দিষ্ট করে।

সম্পূর্ণ JSON অবজেক্টটি আকারে রয়েছে:

{
  "places": [
    {
      object (Place)
    }
  ]
}

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

• ফিল্ডমাস্ক

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

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

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

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

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

  X-Goog-FieldMask: *

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

  • নিম্নলিখিত ক্ষেত্রগুলি পাঠ্য অনুসন্ধানের প্রয়োজনীয়তা আইডি কেবল স্কু ট্রিগার করে:

    places.attributions
places.id
places.name ^*
    nextPageToken
    
    ^* places.name ফিল্ডে প্লেস রিসোর্সের নাম ফর্মটিতে রয়েছে: places/ PLACE_ID । স্থানটির পাঠ্যের নাম অ্যাক্সেস করতে places.displayName ব্যবহার করুন।

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

    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.postalAddress
places.primaryType
places.primaryTypeDisplayName
places.pureServiceAreaBusiness
places.shortFormattedAddress
places.subDestinations
places.types
places.utcOffsetMinutes
places.viewport
    
    ^* places.googleMapsLinks

  • নিম্নলিখিত ক্ষেত্রগুলি পাঠ্য অনুসন্ধান এন্টারপ্রাইজ স্কু ট্রিগার করে:

    places.currentOpeningHours
places.currentSecondaryOpeningHours
places.internationalPhoneNumber
places.nationalPhoneNumber
places.priceLevel
places.priceRange
places.rating
places.regularOpeningHours
places.regularSecondaryOpeningHours
places.userRatingCount
places.websiteUri

  • নিম্নলিখিত ক্ষেত্রগুলি পাঠ্য অনুসন্ধান এন্টারপ্রাইজ প্লাস স্কু ট্রিগার করে:

    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 ^{routingumarary *}
    places.servesBeer
places.servesBreakfast
places.servesBrunch
places.servesCocktails
places.servesCoffee
places.servesDessert
places.servesDinner
places.servesLunch
places.servesVegetarianFood
places.servesWine
places.takeout
    
    ^* কেবল পাঠ্য অনুসন্ধান এবং কাছাকাছি অনুসন্ধান

• টেক্সটকিউরি

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

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

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

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

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

• অন্তর্ভুক্তিপার সার্ভিসারএবসিনেসগুলি

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

• ল্যাঙ্গুয়েজকোড

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

  • সমর্থিত ভাষার তালিকা দেখুন। গুগল প্রায়শই সমর্থিত ভাষাগুলি আপডেট করে, সুতরাং এই তালিকাটি সম্পূর্ণ নাও হতে পারে।
  • যদি languageCode সরবরাহ না করা হয় তবে এপিআই ডিফল্টগুলি en । আপনি যদি কোনও অবৈধ ভাষার কোড নির্দিষ্ট করে থাকেন তবে এপিআই একটি INVALID_ARGUMENT ত্রুটি প্রদান করে।
  • এপিআই একটি রাস্তার ঠিকানা সরবরাহ করার জন্য যথাসাধ্য চেষ্টা করে যা ব্যবহারকারী এবং স্থানীয় উভয়ের জন্যই পঠনযোগ্য। এই লক্ষ্য অর্জনের জন্য, এটি স্থানীয় ভাষায় রাস্তার ঠিকানাগুলি ফিরিয়ে দেয়, প্রয়োজনে ব্যবহারকারীর দ্বারা পাঠযোগ্য কোনও স্ক্রিপ্টে অনুলিপি করে পছন্দসই ভাষা পর্যবেক্ষণ করে। অন্যান্য সমস্ত ঠিকানা পছন্দসই ভাষায় ফিরে আসে। ঠিকানা উপাদানগুলি সমস্ত একই ভাষায় ফিরে আসে, যা প্রথম উপাদান থেকে বেছে নেওয়া হয়।
  • If a name is not available in the preferred language, the API uses the closest match.
  • The preferred language has a small influence on the set of results that the API chooses to return, and the order in which they are returned. The geocoder interprets abbreviations differently depending on language, such as the abbreviations for street types, or synonyms that may be valid in one language but not in another.

• locationBias

  Specifies an area to search. This location serves as a bias which means results around the specified location can be returned, including results outside the specified area.

  You can specify locationRestriction or locationBias , but not both. Think of locationRestriction as specifying the region which the results must be within, and locationBias as specifying the region that the results will likely be inside or near but can be outside of the area.

  Specify the region as a rectangular Viewport or as a circle .

  • A circle is defined by center point and radius in meters. The radius must be between 0.0 and 50000.0, inclusive. The default radius is 0.0. যেমন:

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

  • A rectangle is a latitude-longitude viewport, represented as two diagonally opposite low and high points. The low point marks the southwest corner of the rectangle, and the high point represents the northeast corner of the rectangle.

    A viewport is considered a closed region, meaning it includes its boundary. The latitude bounds must range between -90 to 90 degrees inclusive, and the longitude bounds must range between -180 to 180 degrees inclusive:

    • If low = high , the viewport consists of that single point.
    • If low.longitude > high.longitude , the longitude range is inverted (the viewport crosses the 180 degree longitude line).
    • If low.longitude = -180 degrees and high.longitude = 180 degrees, the viewport includes all longitudes.
    • If low.longitude = 180 degrees and high.longitude = -180 degrees, the longitude range is empty.
    • If low.latitude > high.latitude , the latitude range is empty.

    Both low and high must be populated, and the represented box cannot be empty. An empty viewport results in an error.

    For example, this viewport fully encloses New York City:

    "locationBias": {
      "rectangle": {
        "low": {
          "latitude": 40.477398,
          "longitude": -74.259087
        },
        "high": {
          "latitude": 40.91618,
          "longitude": -73.70018
        }
      }
    }

• locationRestriction

  Specifies an area to search. Results outside the specified area are not returned.

  Specify the region as a rectangular Viewport . For an example of defining the Viewport, see the description of locationBias .

  You can specify locationRestriction or locationBias , but not both. Think of locationRestriction as specifying the region which the results must be within, and locationBias as specifying the region that the results will likely be inside or near but can be outside of the area.

• maxResultCount (deprecated)

  Specifies the number of results (between 1 and 20) to display per page. For example, setting a maxResultCount value of 5 will return up to 5 results on the first page. If there are more results that can be returned from the query, the response includes a nextPageToken that you can pass into a subsequent request to access the next page.

• evOptions

  Specifies parameters for identifying available electric vehicle (EV) charging connectors and charging rates.

  • connectorTypes

    Filters by the type of EV charging connector available at a place. A place that does not support any of the connector types will be filtered out. Supported EV charging connector types include combined (AC and DC) chargers, Tesla chargers, GB/T-compliant chargers (for EV fast charging in China), and wall outlet chargers. For more information, see the reference documentation.

    • To filter results for a specific supported connector , set connectorTypes to that value. For example, to find J1772 type 1 connectors, set connectorTypes to EV_CONNECTOR_TYPE_J1772 .
    • To filter results for unsupported connectors, set connectorTypes to EV_CONNECTOR_TYPE_OTHER .
    • To filter results for any connector type that is a wall outlet, set connectorTypes to EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET .
    • To filter results for any connector type, either set connectorTypes to EV_CONNECTOR_TYPE_UNSPECIFIED or don't set a value for connectorTypes .

  • minimumChargingRateKw

    Filters places by minimum EV charging rate in kilowatts (kW). Any places with charging a rate less than the minimum charging rate are filtered out. For example, to find EV chargers with charging rates that are at least 10 kW, you can set this parameter to "10."

• minRating

  Restricts results to only those whose average user rating is greater than or equal to this limit. Values must be between 0.0 and 5.0 (inclusive) in increments of 0.5. For example: 0, 0.5, 1.0, ... , 5.0 inclusive. Values are rounded up to the nearest 0.5. For example, a value of 0.6 eliminates all results with a rating less than 1.0.

• openNow

  If true , return only those places that are open for business at the time the query is sent. If false , return all businesses regardless of open status. Places that don't specify opening hours in the Google Places database are returned if you set this parameter to false .

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

  Specifies the number of results (between 1 and 20) to display per page. For example, setting a pageSize value of 5 will return up to 5 results on the first page. If there are more results that can be returned from the query, the response includes a nextPageToken that you can pass into a subsequent request to access the next page.

• পেজ টোকেন

  Specifies the nextPageToken from the response body of the previous page.

• priceLevels

  Restrict the search to places that are marked at certain price levels. The default is to select all price levels.

  Price levels can be expected for places of the following types:

  • খাদ্য এবং পানীয়
  • সেবা
  • কেনাকাটা

  Places of non-supported types won't be included in the response if priceLevels is specified.

  Specify an array of one or more of values defined by PriceLevel .

  যেমন:

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

• rankPreference

  Specifies how the results are ranked in the response based on the type of query:

  • For a categorical query such as "Restaurants in New York City", RELEVANCE (rank results by search relevance) is the default. You can set rankPreference to RELEVANCE or DISTANCE (rank results by distance).
  • For a non-categorical query such as "Mountain View, CA", we recommend that you leave rankPreference unset.

• regionCode

  The region code used to format the response, specified as a two-character CLDR code value. This parameter can also have a bias effect on the search results. কোন ডিফল্ট মান নেই।

  If the country name of the formattedAddress field in the response matches the regionCode , the country code is omitted from formattedAddress . This parameter has no effect on adrFormatAddress , which always includes the country name when available, or on shortFormattedAddress , which never includes it.

  Most CLDR codes are identical to ISO 3166-1 codes, with some notable exceptions. For example, the United Kingdom's ccTLD is "uk" (.co.uk) while its ISO 3166-1 code is "gb" (technically for the entity of "The United Kingdom of Great Britain and Northern Ireland"). The parameter can affect results based on applicable law.

• strictTypeFiltering

  Used with the includedType parameter. When set to true , only places that match the specified types specified by includeType are returned. When false, the default, the response can contain places that don't match the specified types.

Text Search examples

Find a place by query string

The following example shows a Text Search request for "Spicy Vegetarian Food in Sydney, Australia":

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress' \
'https://places.googleapis.com/v1/places:searchText'

Note that the X-Goog-FieldMask header specifies that the response contains the following data fields: places.displayName,places.formattedAddress . The response is then in the form:

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

Add more data types to the field mask to return additional information. For example, add places.types,places.websiteUri to include the restaurant type and Web address in the response :

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'

The response is now in the form:

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

Filter places by price level

Use the priceLevel option to filter the results to restaurants defined as inexpensive or moderately expensive:

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'

This example also uses the X-Goog-FieldMask header to add the places.priceLevel data field to the response so it is in the form:

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

Add additional options to refine your search, such as includedType , minRating , rankPreference , openNow , and other parameters described in Optional parameters .

Restrict search to a specified area

Use locationRestriction or locationBias , but not both, to restrict a search to an area. Think of locationRestriction as specifying the region which the results must be within, and locationBias as specifying the region that the results must be near but can be outside of the area.

Restrict area using locationRestriction

Use the locationRestriction parameter to restrict query results to a specified region. In your request body, specify the low and high latitude and longitude values that define the region boundary.

The following example shows a Text Search request for "vegetarian food" in New York City. This request only returns the first 10 results for places that are open.

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'

Bias to an area using locationBias

The following example shows a Text Search request for "vegetarian food" biased to a location within 500 meters of a point in downtown San Francisco. This request only returns the first 10 results for places that are open.

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'

Search for EV chargers with a minimum charging rate

Use minimumChargingRateKw and connectorTypes to search for places with available chargers that are compatible with your EV.

The following example shows a request for Tesla and J1772 type 1 EV charging connectors with a minimum charging rate of 10 kW in Mountain View, CA. Only four results are returned.

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'

The request returns the following response:

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

Search for service area businesses

Use the includePureServiceAreaBusinesses parameter to search for businesses without a physical service address (for example, a mobile cleaning service or a food truck).

The following example shows a request for plumbers in San Francisco:

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'

In the response, businesses without a physical service address don't include the formattedAddress field:

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

Specify a number of results to return per page

Use the pageSize parameter to specify a number of results to return per page. The nextPageToken parameter in the response body provides a token that can be used in subsequent calls to access the next page of results.

The following example shows a request for "pizza in New York" limited to 5 results per page:

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

To access the next page of results, use pageToken to pass in the nextPageToken in the request body:

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

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

The APIs Explorer lets you make sample requests so that you can get familiar with the API and the API options.

1. Select the API icon api on the right side of the page.

2. Optionally edit the request parameters.

3. Select the Execute button. In the dialog, choose the account that you want to use to make the request.

4. In the APIs Explorer panel, select the fullscreen icon fullscreen to expand the APIs Explorer window.