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

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

একটি স্থান আইডি প্রাপ্ত করার অনেক উপায় আছে. তুমি ব্যবহার করতে পার:

API এক্সপ্লোরার আপনাকে লাইভ অনুরোধ করতে দেয় যাতে আপনি 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 কমান্ডে:

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 :

      id , name * , photos

      * name ক্ষেত্রের ফর্মে স্থান সম্পদের নাম রয়েছে: places/ PLACE_ID । স্থানের পাঠ্য নাম অ্যাক্সেস করতে displayName ব্যবহার করুন৷

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

      addressComponents , adrFormatAddress , formattedAddress , location , plusCode , shortFormattedAddress , types , viewport

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

      accessibilityOptions , businessStatus , displayName , googleMapsUri , iconBackgroundColor , iconMaskBaseUri , primaryType , primaryTypeDisplayName , subDestinations , utcOffsetMinutes

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

      currentOpeningHours , currentSecondaryOpeningHours , internationalPhoneNumber , nationalPhoneNumber , priceLevel , rating , regularOpeningHours , regularSecondaryOpeningHours , userRatingCount , websiteUri

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

      allowsDogs , curbsidePickup , delivery , dineIn , editorialSummary , evChargeOptions fuelOptions ফুয়েল অপশন , goodForChildren , goodForGroups , goodForWatchingSports , liveMusic মিউজিক , menuForChildren , parkingOptions রুম , outdoorSeating restroom , reservable পার্ক paymentOptions , পরিবেশন করা বিয়ার , প্রাতঃরাশ পরিবেশন করে , reviews servesBreakfast servesBeer , ককটেল servesBrunch , servesCocktails , servesDesserts servesCoffee servesDinner , servesLunch , servesVegetarianFood , servesWine , takeout

  • placeId

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

    স্ট্রিং places/ PLACE_ID স্থান সম্পদের নামও বলা হয়। একটি স্থানের বিবরণ (নতুন), কাছাকাছি অনুসন্ধান (নতুন), এবং পাঠ্য অনুসন্ধান (নতুন) অনুরোধের প্রতিক্রিয়াতে, এই স্ট্রিংটি প্রতিক্রিয়ার name ক্ষেত্রে রয়েছে। স্বতন্ত্র স্থান আইডি প্রতিক্রিয়ার id ক্ষেত্রের মধ্যে রয়েছে।

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

  • ভাষা কোড

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

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

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

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

একটি অনুরোধ করতে:

  1. ঐচ্ছিকভাবে name প্যারামিটারটি এতে সেট করুন:
    places/PLACE_ID
  2. ঐচ্ছিকভাবে প্রসারিত করুন স্ট্যান্ডার্ড প্যারামিটার দেখান এবং ফিল্ড মাস্কে fields প্যারামিটার সেট করুন।
  3. এক্সিকিউট বোতাম নির্বাচন করুন। পপ-আপে, আপনি অনুরোধ করতে যে অ্যাকাউন্টটি ব্যবহার করতে চান সেটি বেছে নিন।