জায়গার বিবরণ (নতুন)

প্ল্যাটফর্ম বেছে নিন: Android iOS JavaScript ওয়েব পরিষেবা
ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA)-এর ডেভেলপার

ভূমিকা

আপনার কাছে প্লেস আইডি থাকলে, আপনি কোনও নির্দিষ্ট প্রতিষ্ঠান বা আকর্ষণীয় স্থান সম্পর্কে আরও বিবরণ জানতে জায়গার বিবরণ (নতুন) অনুরোধ করতে পারেন। Place Details (New) অনুরোধের মাধ্যমে নির্দিষ্ট করা জায়গা সম্পর্কে আরও বিস্তারিত তথ্য পাওয়া যায় যেমন, সম্পূর্ণ ঠিকানা, ফোন নম্বর, ব্যবহারকারীর রেটিং ও রিভিউ।

প্লেস আইডি পাওয়ার অনেক উপায় আছে। আপনি এগুলি ব্যবহার করতে পারেন:

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

জায়গার বিবরণ (নতুন) সংক্রান্ত অনুরোধ

Place Details (New) অনুরোধ হল এই ফর্ম্যাটে একটি HTTP GET অনুরোধ:

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

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

https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw?fields=id,displayName&key=API_KEY

অথবা curl কমান্ডে:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

Place Details (New) রেসপন্স

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

  • রেসপন্সটি একটি Place অবজেক্ট দ্বারা উপস্থাপিত হয়। Place অবজেক্টে জায়গা সম্পর্কে বিস্তারিত তথ্য থাকে।
  • অনুরোধে পাস করা FieldMask, Place অবজেক্টে ফেরত আসা ফিল্ডের তালিকা নির্দিষ্ট করে।

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

{
  "name": "places/ChIJkR8FdQNB0VQRm64T_lv1g1g",
  "id": "ChIJkR8FdQNB0VQRm64T_lv1g1g",
  "displayName": {
    "text": "Trinidad"
  }
  ...
}

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

  • FieldMask

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

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

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

    X-Goog-FieldMask: displayName,formattedAddress

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

    X-Goog-FieldMask: *

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

    • নিম্নলিখিত ফিল্ডগুলি Place Details Essentials IDs Only SKU ট্রিগার করে:

      attributions
      consumerAlert
      id
      movedPlace
      movedPlaceId
      name*
      photos

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

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

    • নিম্নলিখিত ফিল্ডগুলি জায়গার বিবরণ সংক্রান্ত প্রয়োজনীয় SKU ট্রিগার করে:

      addressComponents
      addressDescriptor*
      adrFormatAddress
      formattedAddress
      location
      plusCode
      postalAddress
      shortFormattedAddress
      types
      viewport

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

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

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

      accessibilityOptions
      businessStatus
      containingPlaces
      displayName
      googleMapsLinks
      googleMapsTypeLabel
      googleMapsUri
      iconBackgroundColor
      iconMaskBaseUri
      openingDate
      primaryType
      primaryTypeDisplayName
      pureServiceAreaBusiness
      subDestinations
      timeZone
      utcOffsetMinutes

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

    • নিম্নলিখিত ফিল্ডগুলি জায়গার বিবরণ Enterprise SKU ট্রিগার করে:

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

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

    • নিম্নলিখিত ফিল্ডগুলি জায়গার বিবরণ Enterprise + Atmosphere SKU ট্রিগার করে:

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

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

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

  • placeId

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

    places/PLACE_ID স্ট্রিংটিকে জায়গার রিসোর্সের নামও বলা হয়। জায়গার বিবরণ (নতুন), নিয়ারবাই Search (নতুন) এবং টেক্সট সার্চ (নতুন) অনুরোধের উত্তরে, এই স্ট্রিং উত্তরের name ফিল্ডে থাকে। স্ট্যান্ডঅ্যালোন জায়গার আইডি উত্তরের id ফিল্ডে থাকে।

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

  • languageCode

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

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

    উত্তরের ফর্ম্যাট করার জন্য ব্যবহৃত অঞ্চল কোড, যা দুটি অক্ষর বিশিষ্ট 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" এন্টিটির জন্য)। প্রযোজ্য আইনের উপর ভিত্তি করে প্যারামিটার ফলাফলে প্রভাব ফেলতে পারে।

  • sessionToken

    সেশন টোকেন হল ব্যবহারকারীর তৈরি করা স্ট্রিং যা অটোমেটিক সম্পূর্ণ (নতুন) কলকে "সেশন" হিসেবে ট্র্যাক করে। অটোকমপ্লিট (নতুন) সেশন টোকেন ব্যবহার করে কোয়েরি গ্রুপ করে এবং বিলিংয়ের উদ্দেশ্যে ব্যবহারকারীর অটোকমপ্লিট সার্চের জায়গা বেছে নেওয়ার ধাপগুলিকে একটি পৃথক সেশনে রাখে। সেশন টোকেনগুলি জায়গার বিবরণ (নতুন) কলে পাস করা হয় যা অটোমেটিক সম্পূর্ণ (নতুন) কল অনুসরণ করে। আরও তথ্যের জন্য, সেশন টোকেন দেখুন।

জায়গার বিবরণ (নতুন) সংক্রান্ত উদাহরণ

নিচের উদাহরণে placeId-এর মাধ্যমে কোনও জায়গার বিবরণ অনুরোধ করা হয়েছে:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

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

{
  "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "displayName": {
    "text": "Googleplex",
    "languageCode": "en"
  }
}

অতিরিক্ত তথ্য ফেরত পেতে ফিল্ড মাস্কে আরও ডেটার ধরন যোগ করুন। যেমন, উত্তরে ঠিকানা ও Plus Code যোগ করতে formattedAddress,plusCode লিখুন:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,formattedAddress,plusCode" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

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

{
  "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
  "plusCode": {
    "globalCode": "849VCWC7+RW",
    "compoundCode": "CWC7+RW Mountain View, CA, USA"
  },
  "displayName": {
    "text": "Googleplex",
    "languageCode": "en"
  }
}

রেটিং, রিভিউয়ের সংখ্যা ও রিভিউ পান

কোনও ব্যবসার গড় স্টার রেটিং, মোট রেটিংয়ের সংখ্যা (মোট রিভিউ) বা গ্রাহকের রিভিউ টেক্সট পেতে, আপনার X-Goog-FieldMask হেডারে সংশ্লিষ্ট ফিল্ডগুলি অন্তর্ভুক্ত করুন:

  • rating এবং userRatingCount: জায়গার গড় রেটিং (1.0 থেকে 5.0 পর্যন্ত) এবং মোট রিভিউয়ের সংখ্যা দেখায়। এইসব ফিল্ডের জন্য অনুরোধ করা হলে, জায়গার বিবরণ Enterprise SKU ট্রিগার হয়।
  • reviews এবং reviewSummary: ব্যবহারকারীর জমা দেওয়া সর্বাধিক পাঁচটি Review অবজেক্ট এবং রিভিউয়ের AI-জেনারেটেড সারসংক্ষেপ দেখায়। এইসব ফিল্ডের জন্য অনুরোধ করলে জায়গার বিবরণ Enterprise + Atmosphere SKU ট্রিগার হয়।

আপনার অ্যাপের যদি শুধু স্টার রেটিং এবং মোট রিভিউ সংখ্যা প্রয়োজন হয়, তাহলে reviews ছাড়া rating এবং userRatingCount অনুরোধ করুন যাতে অনুরোধটি Place Details Enterprise SKU টিয়ারে থাকে:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,rating,userRatingCount" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

এছাড়াও, ব্যবহারকারীর জমা দেওয়া সর্বাধিক পাঁচটি Review অবজেক্ট ফিরিয়ে আনতে, ফিল্ড মাস্কে reviews যোগ করুন ( জায়গার বিবরণ Enterprise + Atmosphere SKU টিয়ারে বিল করা হয়):

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,rating,userRatingCount,reviews" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

উত্তরে রেটিং, মোট রেটিংয়ের সংখ্যা এবং reviews অ্যারে অন্তর্ভুক্ত থাকে:

{
  "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "displayName": {
    "text": "Googleplex",
    "languageCode": "en"
  },
  "rating": 4.2,
  "userRatingCount": 2594,
  "reviews": [
    {
      "name": "places/ChIJj61dQgK6j4AR4GeTYWZsKWw/reviews/...",
      "relativePublishTimeDescription": "a month ago",
      "rating": 5,
      "text": {
        "text": "Iconic tech campus with visitor areas and cafes.",
        "languageCode": "en"
      },
      "authorAttribution": {
        "displayName": "Alex Rivera"
      }
    }
  ]
}

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

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

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

  curl -X GET https://places.googleapis.com/v1/places/ChIJ8WvuSB7Lj4ARFyHppkxDRQ4 \
  -H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
  -H "X-Goog-FieldMask: name,displayName,addressDescriptor"

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

  {
    "name": "places/ChIJ8WvuSB7Lj4ARFyHppkxDRQ4",
    "displayName": {
      "text": "Macy's",
      "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": 220.29175
        },
        {
          "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": 329.45178
        },
        {
          "name": "places/ChIJmx1c5x7Lj4ARJXJy_CU_JbE",
          "placeId": "ChIJmx1c5x7Lj4ARJXJy_CU_JbE",
          "displayName": {
            "text": "Monroe Parking Garage",
            "languageCode": "en"
          },
          "types": [
            "establishment",
            "parking",
            "point_of_interest"
          ],
          "straightLineDistanceMeters": 227.05153
        },
        {
          "name": "places/ChIJxcwBziHLj4ARUQLAvtzkRCM",
          "placeId": "ChIJxcwBziHLj4ARUQLAvtzkRCM",
          "displayName": {
            "text": "Studios Inn by Daiwa Living California Inc.",
            "languageCode": "en"
          },
          "types": [
            "establishment",
            "lodging",
            "point_of_interest",
            "real_estate_agency"
          ],
          "straightLineDistanceMeters": 299.9955
        },
        {
          "name": "places/ChIJWWIlNx7Lj4ARpe1E0ob-_GI",
          "placeId": "ChIJWWIlNx7Lj4ARpe1E0ob-_GI",
          "displayName": {
            "text": "Din Tai Fung",
            "languageCode": "en"
          },
          "types": [
            "establishment",
            "food",
            "point_of_interest",
            "restaurant"
          ],
          "straightLineDistanceMeters": 157.70943
        }
      ],
      "areas": [
        {
          "name": "places/ChIJb3F-EB7Lj4ARnHApQ_Hu1gI",
          "placeId": "ChIJb3F-EB7Lj4ARnHApQ_Hu1gI",
          "displayName": {
            "text": "Westfield Valley Fair",
            "languageCode": "en"
          },
          "containment": "WITHIN"
        },
        {
          "name": "places/ChIJXYuykB_Lj4AR1Ot8nU5q26Q",
          "placeId": "ChIJXYuykB_Lj4AR1Ot8nU5q26Q",
          "displayName": {
            "text": "Valley Fair",
            "languageCode": "en"
          },
          "containment": "WITHIN"
        },
        {
          "name": "places/ChIJtYoUX2DLj4ARKoKOb1G0CpM",
          "placeId": "ChIJtYoUX2DLj4ARKoKOb1G0CpM",
          "displayName": {
            "text": "Central San Jose",
            "languageCode": "en"
          },
          "containment": "WITHIN"
        }
      ]
    }
  }

স্থানান্তরিত জায়গার বিবরণ পান

আপনার অ্যাপে উল্লেখ করা কোনও জায়গা যদি স্থানান্তরিত হয়ে থাকে, তাহলে আপনি movedPlace এবং movedPlaceId ফিল্ড ব্যবহার করে নতুন জায়গাটির বিবরণ পেতে পারেন।

যেসব জায়গা স্থায়ীভাবে বন্ধ, সেগুলির ক্ষেত্রে Place Details (New) রেসপন্স বডিতে businessStatus ফিল্ডে CLOSED_PERMANENTLY রিটার্ন করে এবং movedPlace ও movedPlaceId ফিল্ড বাদ দেয়।

যেসব জায়গা নতুন লোকেশনে সরিয়ে নিয়ে যাওয়া হয়েছে, সেগুলির ক্ষেত্রে Place Details (New) API রেসপন্স বডির businessStatus ফিল্ডে CLOSED_PERMANENTLY এবং movedPlace ও movedPlaceId ফিল্ডে নতুন লোকেশন দেখায়।

যেসব জায়গা সরানো হয়নি, সেগুলির ক্ষেত্রে Place Details (New) রেসপন্স বডিতে movedPlace বা movedPlaceId দেখায় না।

নিম্নলিখিত উদাহরণে কানাডার কুইবেকে Marche IGA St-Canut-এর জায়গা সংক্রান্ত তথ্য চাওয়া হয়েছে:

curl -X  GET -H 'Content-Type: application/json' \
-H 'x-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: id,displayName,businessStatus,movedPlace,movedPlaceId' \
https://places.googleapis.com/v1/places/ChIJUfQdGInVzkwRzAjmjzWB7CQ

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

{
  "id": "ChIJUfQdGInVzkwRzAjmjzWB7CQ",
  "businessStatus": "CLOSED_PERMANENTLY",
  "displayName": {
    "text": "Marche IGA St-Canut",
    "languageCode": "en"
  },
  "movedPlace": "places/ChIJ36QT7n8qz0wRDqVZ_UBlUlQ",
  "movedPlaceId": "ChIJ36QT7n8qz0wRDqVZ_UBlUlQ"
}

নতুন জায়গা সম্পর্কে বিবরণ পেতে, নতুন জায়গার বিবরণ (নতুন) সংক্রান্ত অনুরোধের movedPlace ফিল্ডে জায়গার রিসোর্স নাম ব্যবহার করুন।

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

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

ভবিষ্যতে খুলতে পারে এমন ব্যবসার বিবরণ আপনি অনুরোধ করতে পারেন। প্রত্যাশিত খোলার তারিখে অন্তত মাস উল্লেখ থাকলে এবং তা ৯০ দিনের কম দূরে হলে, নিয়ারবাই Search (নতুন) openingDate ফিল্ড পূরণ করবে।

নিচের উদাহরণে, Idaho-র New Meadows-এ ভবিষ্যতে খুলবে এমন ব্যবসার জন্য নিয়ারবাই Search (নতুন) অনুরোধ দেখানো হয়েছে:

curl -X GET \
-H "Content-Type: application/json" \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,businessStatus,openingDate" \
"https://places.googleapis.com/v1/places/ChIJp1-VoKWJplQRMz8g-7Wa3Do"

উত্তরে জায়গার ব্যবসার স্ট্যাটাস এবং খোলার সম্ভাব্য তারিখ অন্তর্ভুক্ত থাকে:

{
  "id": "ChIJp1-VoKWJplQRMz8g-7Wa3Do",
  "businessStatus": "FUTURE_OPENING",
  "openingDate": {
    "year": 2026,
    "month": 4,
    "day": 15
  }
}

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

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

নিম্নলিখিত উদাহরণে গ্র্যান্ড সেন্ট্রাল স্টেশনের জন্য ট্রানজিট স্টেশন সংক্রান্ত তথ্যের অনুরোধ দেখানো হয়েছে:

curl -X GET \
-H "Content-Type: application/json" \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,transitStation" \
"https://places.googleapis.com/v1/places/ChIJLVaKiQFZwokRgcybX3K6Pzg"

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

  {
  "id": "ChIJLVaKiQFZwokRgcybX3K6Pzg",
  "displayName": {
    "text": "Grand Central",
    "languageCode": "en"
  },
  "transitStation": {
    "displayName": {
      "text": "Grand Central",
      "languageCode": "en"
    },
    "agencies": [
      {
        "displayName": {
          "text": "MTA New York City Transit",
          "languageCode": "en"
        },
        "url": "http://www.mta.info/",
        "lines": [
          {
            "id": "ChIJ420yFwBZwokR903kVZLSsFc",
            "vehicleType": "SUBWAY",
            "displayName": {
              "text": "42 St Shuttle",
              "languageCode": "en"
            },
            "shortDisplayName": {
              "text": "S",
              "languageCode": "en"
            },
            "textColor": "#FFFFFF",
            "backgroundColor": "#808183",
            "url": "https://www.mta.info/schedules/subway/42-st-shuttle",
            "icon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/us-ny-mta/S.svg",
              "nameIncluded": true
            },
            "vehicleIcon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/subway2.svg"
            }
          },
          {
            "id": "ChIJDdd_uEdfwokRHbLvWrdBdDM",
            "vehicleType": "SUBWAY",
            "displayName": {
              "text": "5 Train (Lexington Av Express)",
              "languageCode": "en"
            },
            "shortDisplayName": {
              "text": "5 Line",
              "languageCode": "en"
            },
            "textColor": "#FFFFFF",
            "backgroundColor": "#00933C",
            "url": "https://www.mta.info/schedules/subway/5-train",
            "icon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/us-ny-mta/5.svg",
              "nameIncluded": true
            },
            "vehicleIcon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/subway2.svg"
            }
          }
          ...
        ]
      },
      {
        "displayName": {
          "text": "MTA",
          "languageCode": "en"
        },
        "url": "https://new.mta.info/",
        "lines": [
          {
            "id": "ChIJcwVpzKpZwokR24EBeh8arww",
            "vehicleType": "BUS",
            "displayName": {
              "text": "United Nations - W 42 St Pier",
              "languageCode": "en"
            },
            "shortDisplayName": {
              "text": "M42",
              "languageCode": "en"
            },
            "textColor": "#FFFFFF",
            "backgroundColor": "#1D59B3",
            "vehicleIcon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/bus2.svg"
            }
          }
        ]
      },
      {
        "displayName": {
          "text": "Long Island Rail Road",
          "languageCode": "en"
        },
        "url": "http://www.mta.info/lirr",
        "lines": [
          {
            "id": "ChIJv9m8uWM56IkRUcVBQ6Q_In0",
            "vehicleType": "HEAVY_RAIL",
            "displayName": {
              "text": "Ronkonkoma Branch",
              "languageCode": "en"
            },
            "shortDisplayName": {
              "text": "LIRR",
              "languageCode": "en"
            },
            "textColor": "#FFFFFF",
            "backgroundColor": "#A626AA",
            "vehicleIcon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/rail2.svg"
            }
          }
          ...
        ]
      }
    ],
    "stops": [
      {
        "id": "ChIJRcemlf1YwokRhFqqw5jKBFM",
        "stopCode": {
          "text": "GCT"
        },
        "location": {
          "latitude": 40.755161,
          "longitude": -73.975456
        },
        "wheelchairAccessibleEntrance": true
      },
      {
        "id": "ChIJ57l2zANZwokRD1pyhuwpfKY",
        "signageText": {
          "text": "34 St-Hudson Yards & Main St-Flushing, Queens, 7",
          "languageCode": "en"
        },
        "location": {
          "latitude": 40.750983,
          "longitude": -73.9750686
        },
        "wheelchairAccessibleEntrance": true
      },
      {
        "id": "ChIJoVXJgQFZwokR1yzq_WVuEuc",
        "displayName": {
          "text": "E 42 St/Park Av",
          "languageCode": "en"
        },
        "location": {
          "latitude": 40.7518199,
          "longitude": -73.9771918
        },
        "wheelchairAccessibleEntrance": true
      }
      ...
    ]
  }
}

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

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

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

নিম্নলিখিত উদাহরণে সান ফ্রান্সিসকো আন্তর্জাতিক বিমানবন্দরের (প্লেস আইডি ChIJVVVVVYx3j4ARP-3NGldc8qQ) বিবরণ চাওয়া হয়েছে, যার মধ্যে ফিল্ড মাস্কে entrances এবং navigationPoints অন্তর্ভুক্ত রয়েছে:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,entrances,navigationPoints" \
https://places.googleapis.com/v1/places/ChIJVVVVVYx3j4ARP-3NGldc8qQ

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

{
  "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 উইন্ডো বড় করতে ফুলস্ক্রিন আইকন ফুলস্ক্রিন বেছে নিন।