একবার আপনার কাছে একটি স্থান আইডি হয়ে গেলে, আপনি একটি স্থানের বিবরণ (নতুন) অনুরোধ শুরু করার মাধ্যমে একটি নির্দিষ্ট স্থাপনা বা আগ্রহের স্থান সম্পর্কে আরও বিশদ অনুরোধ করতে পারেন। একটি স্থানের বিবরণ (নতুন) অনুরোধ নির্দেশিত স্থান সম্পর্কে আরও ব্যাপক তথ্য প্রদান করে যেমন এর সম্পূর্ণ ঠিকানা, ফোন নম্বর, ব্যবহারকারীর রেটিং এবং পর্যালোচনা।
একটি স্থান আইডি প্রাপ্ত করার অনেক উপায় আছে. আপনি ব্যবহার করতে পারেন:
- পাঠ্য অনুসন্ধান (নতুন) বা কাছাকাছি অনুসন্ধান (নতুন)
- জিওকোডিং API
- রুট API
- ঠিকানা যাচাইকরণ API
- স্বয়ংসম্পূর্ণ রাখুন
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 :
attributions
,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
চিলড্রেন ,paymentOptions
parkingOptions
,reservable
outdoorSeating
,reviews
,servesBeer
,restroom
পরিবেশনservesBreakfast
, ব্রাঞ্চ পরিবেশন করে , ককটেলservesBrunch
, কফিservesCocktails
করে ,servesDessert
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 বিকল্পগুলির সাথে পরিচিত হতে পারেন।
একটি অনুরোধ করতে:
- API আইকন নির্বাচন করুন,
, পৃষ্ঠার ডানদিকে।
- ঐচ্ছিকভাবে
name
পরামিতি সেট করুন:places/PLACE_ID
- ঐচ্ছিকভাবে প্রসারিত করুন স্ট্যান্ডার্ড প্যারামিটার দেখান এবং ফিল্ড মাস্কে
fields
প্যারামিটার সেট করুন। - এক্সিকিউট বোতাম নির্বাচন করুন। পপ-আপে, আপনি অনুরোধ করতে যে অ্যাকাউন্টটি ব্যবহার করতে চান সেটি বেছে নিন।
API এক্সপ্লোরার প্যানেলে, প্রসারিত আইকন নির্বাচন করুন,
, API এক্সপ্লোরার উইন্ডো প্রসারিত করতে।