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

প্ল্যাটফর্ম বেছে নিন: Android iOS JavaScript ওয়েব পরিষেবা

ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA)-এর ডেভেলপার

ভূমিকা

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

প্রয়োজনীয় প্যারামিটার ছাড়াও, Text Search (New) আরও ভালো ফলাফল দেখানোর জন্য ঐচ্ছিক প্যারামিটার ব্যবহার করে কোয়েরি রিফাইন করার সুবিধা দেয়।

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

Text Search (New) সংক্রান্ত অনুরোধ

টেক্সট সার্চ (নতুন) অনুরোধ হল নিম্নলিখিত ফর্মের একটি HTTP POST অনুরোধ:

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

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

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

টেক্সট সার্চ (নতুন) সংক্রান্ত উত্তর

টেক্সট সার্চ (নতুন) রেসপন্স হিসেবে JSON অবজেক্ট রিটার্ন করে। উত্তরে:

  • places অ্যারেতে সব ম্যাচিং জায়গা রয়েছে।
  • অ্যারের প্রতিটি জায়গা Place অবজেক্ট দ্বারা দেখানো হয়। Place অবজেক্টে একটি জায়গার বিস্তারিত তথ্য থাকে।
  • অনুরোধে পাস করা FieldMask, Place অবজেক্টে ফেরত পাঠানো ফিল্ডের তালিকা নির্দিষ্ট করে।
  • একই ধরনের অনুরোধের জন্য জায়গার যে তালিকা দেখানো হয় তা যে সবসময় একই হবে তার কোনও গ্যারেন্টি নেই।

সম্পূর্ণ JSON অবজেক্টটি এই ফর্ম্যাটে থাকে:

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

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

  • FieldMask

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

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

    ফেরত পাঠানোর জন্য কমা দিয়ে আলাদা করা জায়গার ডেটার ধরনের তালিকা উল্লেখ করুন। যেমন, জায়গার ডিসপ্লে নাম ও ঠিকানা খুঁজে পেতে।

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

    সব ফিল্ড ফিরিয়ে আনতে * ব্যবহার করুন।

    X-Goog-FieldMask: *

    নিচে উল্লেখ করা ফিল্ডের মধ্যে এক বা একাধিক ফিল্ড নির্দিষ্ট করুন:

    • নিম্নলিখিত ফিল্ডগুলি Text Search Essentials ID Only SKU ট্রিগার করে:

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

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

      ফিল্ড এবং সেগুলির সাথে সম্পর্কিত SKU-এর সম্পূর্ণ তালিকার জন্য, জায়গার ডেটা ফিল্ড (নতুন) দেখুন।

    • নিম্নলিখিত ফিল্ডগুলি Text Search Pro SKU ট্রিগার করে:

      places.accessibilityOptions
      places.addressComponents
      places.addressDescriptor*
      places.adrFormatAddress
      places.businessStatus
      places.containingPlaces
      places.displayName
      places.formattedAddress
      places.googleMapsLinks
      places.googleMapsTypeLabel
      places.googleMapsUri
      places.iconBackgroundColor
      places.iconMaskBaseUri
      places.location
      places.openingDate
      places.photos
      places.plusCode
      places.postalAddress
      places.primaryType
      places.primaryTypeDisplayName
      places.pureServiceAreaBusiness
      places.shortFormattedAddress
      places.searchUri
      places.subDestinations
      places.timeZone
      places.types
      places.utcOffsetMinutes
      places.viewport

      * অ্যাড্রেস ডেসক্রিপ্টর সাধারণত ভারতের গ্রাহকদের জন্য উপলভ্য এবং অন্য কোথাও পরীক্ষামূলকভাবে উপলভ্য।

      ফিল্ড এবং সেগুলির সাথে সম্পর্কিত SKU-এর সম্পূর্ণ তালিকার জন্য, জায়গার ডেটা ফিল্ড (নতুন) দেখুন।

    • নিম্নলিখিত ফিল্ডগুলি Text Search Enterprise SKU ট্রিগার করে:

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

      ফিল্ড এবং সেগুলির সাথে সম্পর্কিত SKU-এর সম্পূর্ণ তালিকার জন্য, জায়গার ডেটা ফিল্ড (নতুন) দেখুন।

    • নিম্নলিখিত ফিল্ডগুলি Text Search Enterprise + Atmosphere SKU ট্রিগার করে:

      places.allowsDogs
      places.curbsidePickup
      places.delivery
      places.dineIn
      places.editorialSummary
      places.evChargeAmenitySummary
      places.evChargeOptions
      places.fuelOptions
      places.generativeSummary
      places.goodForChildren
      places.goodForGroups
      places.goodForWatchingSports
      places.liveMusic
      places.menuForChildren
      places.neighborhoodSummary
      places.parkingOptions
      places.paymentOptions
      places.outdoorSeating
      places.reservable
      places.restroom
      places.reviews
      places.reviewSummary
      routingSummaries*
      places.servesBeer
      places.servesBreakfast
      places.servesBrunch
      places.servesCocktails
      places.servesCoffee
      places.servesDessert
      places.servesDinner
      places.servesLunch
      places.servesVegetarianFood
      places.servesWine
      places.takeout

      * শুধুমাত্র টেক্সট সার্চ ও নিয়ারবাই সার্চ

      ফিল্ড এবং সেগুলির সাথে সম্পর্কিত SKU-এর সম্পূর্ণ তালিকার জন্য, জায়গার ডেটা ফিল্ড (নতুন) দেখুন।

  • textQuery

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

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

    কোয়েরির ধরন উদাহরণ
    একটি কোয়েরিতে অনেক বেশি ধারণা বা সীমাবদ্ধতা, যেমন একাধিক জায়গা, রাস্তা বা শহরের নাম "মার্কেট স্ট্রিট সান ফ্রান্সিসকো সান জোসে বিমানবন্দর"
    Google Maps-এ ডাক ঠিকানার এলিমেন্ট দেখানো হয়নি "কেয়ার অফ জন স্মিথ ১২৩ মেইন স্ট্রিট"
    "পোস্ট বক্স ১৩ সান ফ্রান্সিসকো"
    ব্যবসা, চেন বা বিভাগের নাম লোকেশনের সাথে যুক্ত করা যেখানে এইসব এন্টিটি উপলভ্য নয় "টেক্সাসের ডালাসের কাছে টেসকো"
    একাধিক ব্যাখ্যা সহ অস্পষ্ট কোয়েরি "চার্জার ড্রপ-অফ"
    ঐতিহাসিক নাম আর ব্যবহার করা হয় না "মিডলসেক্স যুক্তরাজ্য"
    নন-জিওস্পেশিয়াল এলিমেন্ট বা উদ্দেশ্য "ভেনচুরা হারবারে কতগুলি নৌকা আছে?"
    বেসরকারি বা ভ্যানিটি নাম "The Jenga"
    "The Helter Skelter"
    অক্ষাংশ ও দ্রাঘিমাংশ স্থানাঙ্ক "37.422131,-122.084801"

ঐচ্ছিক প্যারামিটার

  • includeFutureOpeningBusinesses

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

    ব্যবসার স্ট্যাটাস ফিরিয়ে আনতে, আপনার অনুরোধের ফিল্ড মাস্কে places.businessStatus অন্তর্ভুক্ত করুন। ব্যবসা খোলার সম্ভাব্য তারিখ জানতে, আপনার অনুরোধের ফিল্ড মাস্কে places.openingDate অন্তর্ভুক্ত করুন।

  • includedType

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

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

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

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

  • includePureServiceAreaBusinesses

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

  • languageCode

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

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

  • locationBias

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

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

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

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

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

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

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

      • low = high হলে, ভিউপোর্টে সেই একটিমাত্র পয়েন্ট থাকে।
      • low.longitude > high.longitude হলে, দ্রাঘিমাংশের রেঞ্জ উল্টে যায় (ভিউ পোর্ট ১৮০ ডিগ্রি দ্রাঘিমাংশ রেখা অতিক্রম করে)।
      • low.longitude = -১৮০ ডিগ্রি এবং high.longitude = ১৮০ ডিগ্রি হলে, ভিউপোর্টে সব দ্রাঘিমাংশ অন্তর্ভুক্ত থাকে।
      • low.longitude = ১৮০ ডিগ্রি এবং high.longitude = -১৮০ ডিগ্রি হলে, দ্রাঘিমাংশের রেঞ্জ খালি থাকে।
      • low.latitude > high.latitude হলে, অক্ষাংশের রেঞ্জ খালি থাকে।

      সর্বনিম্ন ও সর্বোচ্চ, দুটিই পূরণ করতে হবে এবং দেখানো বক্সটি ফাঁকা রাখা যাবে না। ভিউ পোর্ট খালি থাকলে সমস্যা হয়।

      যেমন, এই ভিউপোর্ট নিউ ইয়র্ক সিটিকে সম্পূর্ণভাবে কভার করে:

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

  • locationRestriction

    শুধুমাত্র বিভাগীয় কোয়েরি সার্চ করার জন্য একটি এলাকা নির্দিষ্ট করে, যা একাধিক জায়গা দেখাতে পারে (যেমন, "নিউ ইয়র্কের রেস্তোরাঁ" বা "শপিং মল")। নির্দিষ্ট করা এলাকার বাইরে ফলাফল দেখানো হয় না।

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

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

  • evOptions

    উপলভ্য ইলেকট্রিক ভেইকেল (EV) চার্জিং কানেক্টর এবং চার্জিং রেট শনাক্ত করার জন্য প্যারামিটার নির্দিষ্ট করে।

    • connectorTypes

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

      • নির্দিষ্ট কাজ করে এমন কানেক্টর-এর জন্য ফলাফল ফিল্টার করতে, connectorTypes-কে সেই ভ্যালুতে সেট করুন। যেমন, J1772 টাইপ ১ কানেক্টর খুঁজতে, connectorTypes-কে EV_CONNECTOR_TYPE_J1772-এ সেট করুন।
      • কাজ করে না এমন কানেক্টরের জন্য ফলাফল ফিল্টার করতে, connectorTypes-কে EV_CONNECTOR_TYPE_OTHER-এ সেট করুন।
      • প্লাগ পয়েন্টের মতো যেকোনও কানেক্টর টাইপের জন্য ফলাফল ফিল্টার করতে, connectorTypes থেকে EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET সেট করুন।
      • যেকোনও কানেক্টর টাইপের জন্য ফলাফল ফিল্টার করতে, হয় connectorTypes-কে EV_CONNECTOR_TYPE_UNSPECIFIED-এ সেট করুন অথবা connectorTypes-এর জন্য কোনও ভ্যালু সেট করবেন না।

    • minimumChargingRateKw

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

  • minRating

    শুধুমাত্র সেইসব ফলাফল দেখায় যেগুলির গড় ব্যবহারকারী রেটিং এই সীমার চেয়ে বেশি বা সমান। মান অবশ্যই ০.০ থেকে ৫.০ (অন্তর্ভুক্ত) এর মধ্যে হতে হবে ০.৫ এর ইনক্রিমেন্টে। যেমন: ০, ০.৫, ১.০, ... , ৫.০ সহ। ভ্যালু ০.৫-এর নিকটবর্তী পূর্ণ সংখ্যায় রাউন্ড-আপ করা হয়। যেমন, ০.৬ ভ্যালু ১.০-এর কম রেটিং থাকা সব ফলাফল বাদ দেয়।

  • openNow

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

  • pageSize

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

    এই ফিল্ডটি বন্ধ হয়ে যাওয়া maxResultCount ফিল্ডের পরিবর্তে ব্যবহার করা হয়। আপনি pageSize এবং maxResultCount, দুটিই উল্লেখ করলে, API pageSize ব্যবহার করে এবং maxResultCount উপেক্ষা করে।

  • pageToken

    আগের পৃষ্ঠার উত্তর বডি থেকে nextPageToken নির্দিষ্ট করে।

  • priceLevels

    নির্দিষ্ট দামের লেভেলে চিহ্নিত করা আছে এমন জায়গায় সার্চ সীমিত করুন। ডিফল্ট হিসেবে সব দামের লেভেল বেছে নেওয়া হয়।

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

    priceLevels উল্লেখ করা থাকলে, কাজ করে না এমন ধরনের জায়গা উত্তরে অন্তর্ভুক্ত করা হবে না।

    PriceLevel-এর মাধ্যমে সংজ্ঞায়িত এক বা একাধিক ভ্যালুর অ্যারে উল্লেখ করুন।

    যেমন:

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

  • rankPreference

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

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

  • regionCode

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

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

    বেশিরভাগ CLDR কোড ISO 3166-1 কোডের মতোই, তবে কিছু ব্যতিক্রম আছে। যেমন, যুক্তরাজ্যের ccTLD হল "uk" (.co.uk) এবং এর ISO 3166-1 কোড হল "gb" (টেকনিক্যালি "গ্রেট ব্রিটেন ও উত্তর আয়ারল্যান্ডের যুক্তরাজ্য" এন্টিটির জন্য)। প্রযোজ্য আইনের উপর ভিত্তি করে প্যারামিটার ফলাফলে প্রভাব ফেলতে পারে।

  • strictTypeFiltering

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

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

কোয়েরি স্ট্রিং ব্যবহার করে জায়গা খুঁজুন

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

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

মনে রাখবেন যে X-Goog-FieldMask হেডার নির্দিষ্ট করে যে উত্তরে নিম্নলিখিত ডেটা ফিল্ড রয়েছে: places.displayName,places.formattedAddress। তারপর উত্তরটি এই ফর্ম্যাটে পাওয়া যায়:

{
  "places": [
    {
      "formattedAddress": "367 Pitt St, Sydney NSW 2000, Australia",
      "displayName": {
        "text": "Mother Chu's Vegetarian Kitchen",
        "languageCode": "en"
      }
    },
    {
      "formattedAddress": "175 First Ave, Five Dock NSW 2046, Australia",
      "displayName": {
        "text": "Veggo Sizzle - Vegan & Vegetarian Restaurant, Five Dock, Sydney",
        "languageCode": "en"
      }
    },
    ...
  ]
}

অতিরিক্ত তথ্য ফেরত পেতে ফিল্ড মাস্কে আরও ডেটার ধরন যোগ করুন। যেমন, উত্তরে রেস্তোরাঁর ধরন ও ওয়েব অ্যাড্রেস অন্তর্ভুক্ত করতে places.types,places.websiteUri যোগ করুন:

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

উত্তরটি এখন এই ফর্মে আছে:

{
  "places": [
    {
      "types": [
        "vegetarian_restaurant",
        "vegan_restaurant",
        "chinese_restaurant",
        "restaurant",
        "food",
        "point_of_interest",
        "establishment"
      ],
      "formattedAddress": "367 Pitt St, Sydney NSW 2000, Australia",
      "websiteUri": "http://www.motherchusvegetarian.com.au/",
      "displayName": {
        "text": "Mother Chu's Vegetarian Kitchen",
        "languageCode": "en"
      }
    },
    {
      "types": [
        "vegan_restaurant",
        "thai_restaurant",
        "vegetarian_restaurant",
        "indian_restaurant",
        "italian_restaurant",
        "american_restaurant",
        "restaurant",
        "food",
        "point_of_interest",
        "establishment"
      ],
      "formattedAddress": "175 First Ave, Five Dock NSW 2046, Australia",
      "websiteUri": "http://www.veggosizzle.com.au/",
      "displayName": {
        "text": "Veggo Sizzle - Vegan & Vegetarian Restaurant, Five Dock, Sydney",
        "languageCode": "en"
      }
    },
    ...
  ]
}

মূল্যের লেভেল অনুযায়ী জায়গা ফিল্টার করুন

রেস্তোরাঁ অনুযায়ী ফলাফল ফিল্টার করতে priceLevel বিকল্প ব্যবহার করুন যেগুলি সস্তা বা মাঝারি দামের হিসেবে সংজ্ঞায়িত:

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

এই উদাহরণে X-Goog-FieldMask হেডার ব্যবহার করে places.priceLevel ডেটা ফিল্ডকে উত্তরে যোগ করা হয়েছে, তাই এটি এই ফর্মে আছে:

{
  "places": [
    {
      "formattedAddress": "367 Pitt St, Sydney NSW 2000, Australia",
      "priceLevel": "PRICE_LEVEL_MODERATE",
      "displayName": {
        "text": "Mother Chu's Vegetarian Kitchen",
        "languageCode": "en"
      }
    },
    {
      "formattedAddress": "115 King St, Newtown NSW 2042, Australia",
      "priceLevel": "PRICE_LEVEL_MODERATE",
      "displayName": {
        "text": "Green Mushroom",
        "languageCode": "en"
      }
    },
    ...
  ]
}

আপনার সার্চ রিফাইন করতে অতিরিক্ত বিকল্প যোগ করুন, যেমন includedType, minRating, rankPreference, openNow, এবং ঐচ্ছিক প্যারামিটার-এ বর্ণনা করা অন্যান্য প্যারামিটার।

নির্দিষ্ট এলাকায় সার্চ সীমাবদ্ধ করুন

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

locationRestriction ব্যবহার করে এলাকা সীমাবদ্ধ করুন

নির্দিষ্ট অঞ্চলে কোয়েরির ফলাফল সীমাবদ্ধ করতে locationRestriction প্যারামিটার ব্যবহার করুন। আপনার অনুরোধের মূল অংশে, low এবং high অক্ষাংশ ও দ্রাঘিমাংশের মান উল্লেখ করুন যা অঞ্চলের সীমানা নির্ধারণ করে।

নিম্নলিখিত উদাহরণে নিউ ইয়র্ক সিটিতে "নিরামিষ খাবার" সংক্রান্ত টেক্সট সার্চ (নতুন) অনুরোধ দেখানো হয়েছে। এই অনুরোধ শুধুমাত্র খোলা আছে এমন জায়গার জন্য প্রথম ১০টি ফলাফল ফেরত দেয়।

curl -X POST -d '{
  "textQuery" : "vegetarian food",
  "pageSize" : "10",
  "locationRestriction": {
    "rectangle": {
      "low": {
        "latitude": 40.477398,
        "longitude": -74.259087
      },
      "high": {
        "latitude": 40.91618,
        "longitude": -73.70018
      }
    }
  }
}' \
  -H 'Content-Type: application/json' \
  -H 'X-Goog-Api-Key: API_KEY' \
  -H 'X-Goog-FieldMask: places.id,places.formattedAddress' \
  'https://places.googleapis.com/v1/places:searchText'

locationBias ব্যবহার করে কোনও এলাকার দিকে পক্ষপাতিত্ব করা

নিম্নলিখিত উদাহরণে সান ফ্রান্সিসকোর ডাউনটাউনের একটি পয়েন্টের ৫০০ মিটারের মধ্যে "নিরামিষ খাবার" লোকেশন বায়াস সহ টেক্সট সার্চ (নতুন) অনুরোধ দেখানো হয়েছে। এই অনুরোধ শুধুমাত্র খোলা আছে এমন জায়গার জন্য প্রথম ১০টি ফলাফল ফেরত দেয়।

curl -X POST -d '{
  "textQuery" : "vegetarian food",
  "openNow": true,
  "pageSize": 10,
  "locationBias": {
    "circle": {
      "center": {"latitude": 37.7937, "longitude": -122.3965},
      "radius": 500.0
    }
  },
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress' \
'https://places.googleapis.com/v1/places:searchText'

ন্যূনতম চার্জিং রেট সহ EV চার্জার সার্চ করা

আপনার EV-এর সাথে মানানসই চার্জার আছে এমন জায়গা খুঁজতে minimumChargingRateKw এবং connectorTypes ব্যবহার করুন।

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

curl -X POST -d '{
    "textQuery": "EV Charging Station Mountain View",
    "pageSize": 4,
    "evOptions": {
      "minimumChargingRateKw": 10,
      "connectorTypes": ["EV_CONNECTOR_TYPE_J1772","EV_CONNECTOR_TYPE_TESLA"]
    }
  }' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H "X-Goog-FieldMask: places.displayName,places.evChargeOptions" \
'https://places.googleapis.com/v1/places:searchText'

অনুরোধটি নিম্নলিখিত উত্তর প্রদান করে:

{
  "places": [
    {
      "displayName": {
        "text": "EVgo Charging Station",
        "languageCode": "en"
      },
      "evChargeOptions": {
        "connectorCount": 16,
        "connectorAggregation": [
          {
            "type": "EV_CONNECTOR_TYPE_CHADEMO",
            "maxChargeRateKw": 100,
            "count": 8,
            "availableCount": 5,
            "outOfServiceCount": 0,
            "availabilityLastUpdateTime": "2024-01-10T19:10:00Z"
          },
          {
            "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1",
            "maxChargeRateKw": 100,
            "count": 2,
            "availableCount": 2,
            "outOfServiceCount": 0,
            "availabilityLastUpdateTime": "2024-01-10T19:10:00Z"
          },
          ...
        ]
      }
    },
    {
      "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"
          }
        ]
      }
    },
    ...
  ]
}

পরিষেবা প্রদানকারী ব্যবসা সার্চ করুন

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"
      }
    },
    {
      "displayName": {
        "text": "Starboy Plumbing Inc.",
        "languageCode": "en"
      }
    },
    ...
  ]
}

প্রতি পৃষ্ঠায় কতগুলি ফলাফল দেখানো হবে তা উল্লেখ করুন

প্রতি পৃষ্ঠায় কতগুলি ফলাফল দেখানো হবে তা উল্লেখ করতে pageSize প্যারামিটার ব্যবহার করুন। রেসপন্স বডিতে nextPageToken প্যারামিটার একটি টোকেন প্রদান করে যা ফলাফলের পরবর্তী পৃষ্ঠা অ্যাক্সেস করার জন্য পরবর্তী কলে ব্যবহার করা যেতে পারে।

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

 curl -X POST -d '{
  "textQuery": "pizza in New York",
  "pageSize": 5
  }' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H "X-Goog-FieldMask: places.id,nextPageToken" \
'https://places.googleapis.com/v1/places:searchText'

{
  "places": [
    {
      "id": "ChIJifIePKtZwokRVZ-UdRGkZzs"
    },
    {
      "id": "ChIJPxPd_P1YwokRfzLhSiACEoU"
    },
    ...
  ],
  "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"
    },
    ...
  ],
  "nextPageToken": "AeCrKXvPd6uUy-oj96W2OaqEe2pUD8QTxOM8-sKfUcFsC9t2Wey5qivrKGoGSxcZnyc7RPmaFfAktslrKbUh31ZDTkL0upRmaxA7c_c"
}

ঠিকানার বিবরণ পান

ঠিকানার বিবরণ কোনও জায়গার লোকেশন সম্পর্কে সম্পর্কিত তথ্য প্রদান করে, যার মধ্যে আশেপাশের ল্যান্ডমার্ক এবং সংশ্লিষ্ট এলাকা অন্তর্ভুক্ত থাকে।

নিম্নলিখিত উদাহরণে, দীঘার একটি মলের কাছাকাছি জায়গার জন্য টেক্সট সার্চ (নতুন) অনুরোধ দেখানো হয়েছে। এই উদাহরণে, আপনি ফিল্ডে addressDescriptors অন্তর্ভুক্ত করেছেন মাস্ক:

curl -X POST -d '{
  "textQuery": "clothes",
  "maxResultCount": 5,
  "locationBias": {
    "circle": {
      "center": {
        "latitude": 37.321328,
        "longitude": -121.946275
      }
    }
  },
  "rankPreference":"RANK_PREFERENCE_UNSPECIFIED"
}' \
-H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.displayName,places.addressDescriptor" \
https://places.googleapis.com/v1/places:searchText

উত্তরে অনুরোধে উল্লেখ করা জায়গা, কাছাকাছি ল্যান্ডমার্কের তালিকা ও জায়গা থেকে সেগুলির দূরত্ব এবং এলাকার তালিকা ও জায়গার সাথে সেগুলির কন্টেনমেন্ট সম্পর্ক অন্তর্ভুক্ত থাকে:

  {
  "places": [
    {
      "displayName": {
        "text": "Urban Outfitters",
        "languageCode": "en"
      },
      "addressDescriptor": {
        "landmarks": [
          {
            "name": "places/ChIJVVVVUB7Lj4ARXyb4HFVDV8s",
            "placeId": "ChIJVVVVUB7Lj4ARXyb4HFVDV8s",
            "displayName": {
              "text": "Westfield Valley Fair",
              "languageCode": "en"
            },
            "types": [
              "clothing_store",
              "department_store",
              "establishment",
              "food",
              "movie_theater",
              "point_of_interest",
              "restaurant",
              "shoe_store",
              "shopping_mall",
              "store"
            ],
            "spatialRelationship": "WITHIN",
            "straightLineDistanceMeters": 133.72855
          },
          {
            "name": "places/ChIJ62_oCR7Lj4AR_MGWkSPotD4",
            "placeId": "ChIJ62_oCR7Lj4AR_MGWkSPotD4",
            "displayName": {
              "text": "Nordstrom",
              "languageCode": "en"
            },
            "types": [
              "clothing_store",
              "department_store",
              "establishment",
              "point_of_interest",
              "shoe_store",
              "store"
            ],
            "straightLineDistanceMeters": 250.99161
          },
          ...
        ],
        "areas": [
          {
            "name": "places/ChIJb3F-EB7Lj4ARnHApQ_Hu1gI",
            "placeId": "ChIJb3F-EB7Lj4ARnHApQ_Hu1gI",
            "displayName": {
              "text": "Westfield Valley Fair",
              "languageCode": "en"
            },
            "containment": "WITHIN"
          },
          {
            "name": "places/ChIJXYuykB_Lj4AR1Ot8nU5q26Q",
            "placeId": "ChIJXYuykB_Lj4AR1Ot8nU5q26Q",
            "displayName": {
              "text": "Valley Fair",
              "languageCode": "en"
            },
            "containment": "WITHIN"
          },
          ...
        ]
      }
    },
    ...
  ]
}

ভবিষ্যতে খুলবে এমন ব্যবসা খুঁজুন

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

curl -X POST \
-H "Content-Type: application/json" \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,places.businessStatus,places.openingDate" \
-d '{
  "textQuery": "Roberts Greenhouse and Tree Farm",
  "includeFutureOpeningBusinesses": true,
  "maxResultCount": 20,
  "locationBias": {
    "circle": {
      "center": {"latitude": 44.9755100, "longitude": -116.2842180},
      "radius": 20
    }
  }
}' \
"https://places.googleapis.com/v1/places:searchText"

এই উত্তরে এমন ব্যবসা অন্তর্ভুক্ত আছে যা ভবিষ্যতে খোলা হবে, সাথে ব্যবসার স্ট্যাটাস এবং সম্ভাব্য খোলার তারিখও আছে:

{
  "places": [
    {
      "id": "ChIJp1-VoKWJplQRMz8g-7Wa3Do",
      "businessStatus": "FUTURE_OPENING",
      "displayName": {
        "text": "Roberts Greenhouse and Tree Farm",
        "languageCode": "en"
      },
      "openingDate": {
        "year": 2026,
        "month": 4,
        "day": 15
      }
    }
  ]
}

ট্রানজিট স্টেশন সংক্রান্ত তথ্য পান

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

"গ্র্যান্ড সেন্ট্রাল স্টেশন" সংক্রান্ত অনুরোধের উদাহরণ নিচে দেওয়া হল:

curl -X POST \
-H "Content-Type: application/json" \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,places.transitStation" \
-d '{
  "textQuery": "Grand Central Station"
}' \
"https://places.googleapis.com/v1/places:searchText"

রেসপন্স বডিতে ব্যাসার্ধের মধ্যে প্রতিটি স্টেশন, স্টেশন দ্বারা পরিবেশিত লাইন, সেই স্টপে ট্রানজিট এজেন্সি দ্বারা জারি করা সতর্কতা, এবং ছাড়ার তথ্য অন্তর্ভুক্ত থাকে:

{
  "places": [
    {
      "id": "ChIJhRwB-yFawokRi0AhGH87UTc",
      "displayName": {
        "text": "Grand Central",
        "languageCode": "en"
      },
      "transitStation": {
        "displayName": {
          "text": "Grand Central",
          "languageCode": "en"
        },
        "agencies": [
          {
            "displayName": {
              "text": "Metro-North Railroad",
              "languageCode": "en"
            },
            "url": "http://www.mta.info/mnr",
            "lines": [
              {
                "id": "ChIJOXpD29y2wokRryDO0CocwK0",
                "vehicleType": "HEAVY_RAIL",
                "displayName": {
                  "text": "Harlem",
                  "languageCode": "en"
                },
                "textColor": "#FFFFFF",
                "backgroundColor": "#0061AA",
                "vehicleIcon": {
                  "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/rail2.svg"
                },
                "alerts": [
                  {
                    "effect": "OTHER",
                    "texts": [
                      {
                        "headline": {
                          "text": "Information",
                          "languageCode": "en"
                        },
                        "summary": {
                          "text": "Temporary platforms are in place at Botanical Garden, Williams Bridge, and Woodlawn for northbound travel. Build in extra travel time to reach the platform.",
                          "languageCode": "en"
                        },
                        "fullDescription": {
                          "text": "What's Happening? We are renovating some Harlem Line stations in the Bronx. Learn more about the project here.",
                          "languageCode": "en"
                        }
                      }
                    ],
                    "detailsUrls": [
                      {
                        "url": "https://new.mta.info/"
                      }
                    ],
                    "cause": "OTHER_CAUSE",
                    "startTime": "2026-04-16T04:00:00Z",
                    "endTime": "2026-12-01T04:45:00Z",
                    "attribution": {
                      "link": {
                        "text": "new.mta.info",
                        "url": "https://new.mta.info/"
                      }
                    },
                    "createTime": "2026-05-15T22:39:30Z",
                    "severityLevel": "INFO"
                  }
                ]
              },
              ...
            ]
          },
          ...
        ]
        "stops": [
          {
            "id": "ChIJOfdrigFZwokRJPllLwfPrJY",
            "location": {
              "latitude": 40.752823,
              "longitude": -73.977195999999992
            },
            "wheelchairAccessibleEntrance": true
          }
        ],
        "departureBoards": [
          {
            "displayType": "TIME_CENTRIC",
            "rows": [
              {
                "departures": [
                  {
                    "timedDeparture": {
                      "scheduledTime": "2026-05-15T22:42:00Z",
                      "timingType": "SCHEDULED",
                      "predictedTime": "2026-05-15T22:42:00Z",
                      "updateTime": "2026-05-15T22:38:50Z"
                    },
                    "originallyScheduledStopId": "ChIJOfdrigFZwokRJPllLwfPrJY",
                    "lineId": "ChIJAfBuQhwg6IkRYnFpClHxFrM"
                  }
                ]
              },
              ...
            ]
          }
        ]
      }
    },
    {
      "id": "ChIJ_4EAi-pZwokRWe5T1JmmWmc",
      "displayName": {
        "text": "Grand Central Station",
        "languageCode": "en"
      }
    }
  ]
}

প্রবেশপথ ও নেভিগেশন পয়েন্ট পান

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

নেভিগেশন পয়েন্ট navigationPointToken রিটার্ন করে। ড্রাইভারদের নির্দিষ্ট লোকেশনে নিয়ে যাওয়ার জন্য আপনি এই টোকেন Navigation SDK (Android বা iOS-এর জন্য উপলভ্য) বা Routes API-তে পাস করতে পারবেন। আরও তথ্যের জন্য, নেভিগেশন পয়েন্ট টোকেন দেখুন।

নিচের উদাহরণে "San Francisco International Airport"-এর জন্য টেক্সট সার্চ (নতুন) অনুরোধ দেখানো হয়েছে, যার ফিল্ড মাস্কে entrances ও navigationPoints অন্তর্ভুক্ত আছে:

curl -X POST \
-H "Content-Type: application/json" \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,places.entrances,places.navigationPoints" \
-d '{
  "textQuery": "San Francisco International Airport",
  "pageSize": 1
}' \
"https://places.googleapis.com/v1/places:searchText"

উত্তরে জায়গার প্রবেশপথ ও নেভিগেশন পয়েন্ট অন্তর্ভুক্ত আছে:

{
  "places": [
    {
      "id": "ChIJVVVVVYx3j4ARP-3NGldc8qQ",
      "displayName": {
        "text": "San Francisco International Airport",
        "languageCode": "en"
      },
      "entrances": [
        {
          "location": {
            "latitude": 37.6172154,
            "longitude": -122.3839724
          }
        },
        {
          "location": {
            "latitude": 37.6174073,
            "longitude": -122.384196
          }
        },
        ...
      ],
      "navigationPoints": [
        {
          "navigationPointToken": "ChIJoioBjMLOQkAR0A3yH_eYXsA...",
          "displayName": {
            "text": "International Terminal Departures Level",
            "languageCode": "en"
          },
          "location": {
            "latitude": 37.6153121,
            "longitude": -122.3900833
          },
          "travelModes": ["WALK"]
        },
        {
          "navigationPointToken": "ChIJy5JKws_OQkAROx0jNN2YXsA...",
          "displayName": {
            "text": "Domestic Garage - SFO Short Term Parking",
            "languageCode": "en"
          },
          "location": {
            "latitude": 37.6157153,
            "longitude": -122.3885012
          },
          "travelModes": ["DRIVE", "WALK"],
          "usages": ["PARKING"]
        },
        ...
      ]
    }
  ]
}

এটি ব্যবহার করে দেখুন!

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

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

  2. ঐচ্ছিকভাবে, অনুরোধের প্যারামিটার এডিট করুন।

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

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