স্থানের বিবরণ (নতুন)

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

ভূমিকা

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

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

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

স্থানের বিবরণ (নতুন) অনুরোধ

একটি স্থান বিবরণী (নতুন) অনুরোধ হল একটি HTTP GET অনুরোধ যা এই আকারে থাকে:

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

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

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

অথবা একটি কার্ল কমান্ডে:

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

স্থানের বিবরণ (নতুন) প্রতিক্রিয়া

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

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

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

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

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

  • ফিল্ডমাস্ক

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

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

    স্থানের ডেটা প্রকারের একটি কমা দ্বারা পৃথক তালিকা উল্লেখ করুন যা ফেরত পাঠানো হবে। উদাহরণস্বরূপ, স্থানের প্রদর্শন নাম এবং ঠিকানা পুনরুদ্ধার করতে।

    X-Goog-FieldMask: displayName,formattedAddress

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

    X-Goog-FieldMask: *

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

    • নিম্নলিখিত ক্ষেত্রগুলি স্থানের বিবরণ অপরিহার্য আইডি শুধুমাত্র SKU ট্রিগার করে:

      attributions
      id
      moved_place
      moved_place_id
      name *
      photos

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

    • নিম্নলিখিত ক্ষেত্রগুলি স্থানের বিবরণ অপরিহার্য SKU ট্রিগার করে:

      addressComponents
      addressDescriptor *
      adrFormatAddress
      formattedAddress
      location
      plusCode
      postalAddress
      shortFormattedAddress
      types
      viewport

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

    • নিম্নলিখিত ক্ষেত্রগুলি স্থান বিবরণ প্রো SKU ট্রিগার করে:

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

    • নিম্নলিখিত ক্ষেত্রগুলি স্থান বিবরণী এন্টারপ্রাইজ SKU ট্রিগার করে:

      currentOpeningHours
      currentSecondaryOpeningHours
      internationalPhoneNumber
      nationalPhoneNumber
      priceLevel
      priceRange
      rating
      regularOpeningHours
      regularSecondaryOpeningHours
      userRatingCount
      websiteUri

    • নিম্নলিখিত ক্ষেত্রগুলি স্থান বিবরণী এন্টারপ্রাইজ + বায়ুমণ্ডল 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

      * শুধুমাত্র টেক্সট অনুসন্ধান এবং কাছাকাছি অনুসন্ধান

  • স্থান আইডি

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

    স্ট্রিং places/ PLACE_ID place resource name ও বলা হয়। Place Details (New), Nearby Search (New), এবং Text Search (New) অনুরোধের প্রতিক্রিয়ায়, এই স্ট্রিংটি প্রতিক্রিয়ার name ক্ষেত্রে থাকে। স্বতন্ত্র স্থান ID প্রতিক্রিয়ার id ক্ষেত্রে থাকে।

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

  • ভাষা কোড

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

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

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

  • সেশনটোকেন

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

স্থানের বিবরণ (নতুন) উদাহরণ

নিচের উদাহরণে 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"
  }
}

অতিরিক্ত তথ্য ফেরত দিতে ফিল্ড মাস্কে আরও ডেটা টাইপ যোগ করুন। উদাহরণস্বরূপ, উত্তরে ঠিকানা এবং প্লাস কোড অন্তর্ভুক্ত করতে 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"
  }
}

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

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

নিচের উদাহরণটি সান জোসে মলে একটি ডিপার্টমেন্ট স্টোরের জন্য একটি স্থান বিবরণ (নতুন) অনুরোধ দেখায়। এই উদাহরণে, আপনি ফিল্ড মাস্কে 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 ক্ষেত্রগুলি ব্যবহার করতে পারেন।

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

নতুন স্থানে স্থানান্তরিত স্থানের জন্য, স্থান বিবরণ (নতুন) businessStatus ক্ষেত্রে CLOSED_PERMANENTLY প্রদান করে এবং প্রতিক্রিয়া বডির movedPlace এবং movedPlaceId ক্ষেত্রে নতুন অবস্থান প্রদান করে।

যেসব স্থান স্থানান্তরিত হয়নি , তাদের জন্য Place Details (New) প্রতিক্রিয়া বডিতে movedPlace বা movedPlaceId ফেরত দেয় না।

কানাডার কুইবেকের মার্চে আইজিএ সেন্ট-ক্যানুট সম্পর্কে তথ্য স্থানের অনুরোধের উদাহরণ নিম্নরূপ:

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 ক্ষেত্রের মধ্যে Place রিসোর্সের নামটি ব্যবহার করুন।

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

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

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

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

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

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

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