Places API (নতুন) সম্পর্কে

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

ভূমিকা

Places API (নতুন)-এ নিম্নলিখিত API অন্তর্ভুক্ত:

এই ডকুমেন্টে এইসব নতুন API-এর ওভারভিউ দেওয়া আছে।

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

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

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

Place Photos (নতুন)

প্লেস ফটো (নতুন) আপনাকে Google Places ডেটাবেসে স্টোর করা লক্ষ লক্ষ ফটোতে অ্যাক্সেস দিয়ে আপনার অ্যাপ্লিকেশনে খুব ভালো কোয়ালিটির ফটোগ্রাফিক কন্টেন্ট যোগ করতে দেয়। Place Photos (New) API ব্যবহার করে, আপনি ছবি অ্যাক্সেস করতে এবং আপনার অ্যাপ্লিকেশনের জন্য অপ্টিমাল সাইজে ছবি রিসাইজ করতে পারবেন।

Place Photos (New) API-তে করা সব অনুরোধে অবশ্যই একটি ফটো রিসোর্স নাম অন্তর্ভুক্ত করতে হবে, যা অনন্যভাবে ফেরত দেওয়ার জন্য ফটোটিকে শনাক্ত করে। আপনি এগুলি ব্যবহার করে ফটো রিসোর্সের নাম পেতে পারেন:

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

টেক্সট সার্চ (নতুন) ও নিয়ারবাই সার্চ (নতুন)

Places API (নতুন)-এ দুটি সার্চ API অন্তর্ভুক্ত:

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

    আপনাকে এমন একটি টেক্সট স্ট্রিং নির্দিষ্ট করতে দেয় যার মাধ্যমে কোনও জায়গা সার্চ করা যায়। যেমন: "সিডনি, অস্ট্রেলিয়াতে ঝাল নিরামিষ খাবার" অথবা "পালো অল্টো, ক্যালিফোর্নিয়ার কাছে সিফুডের ফাইন ডাইনিং"।

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

  • নিয়ারবাই সার্চ (নতুন)

    আপনাকে জায়গার ধরনের তালিকার সাথে সার্চ করার জন্য একটি অঞ্চল নির্দিষ্ট করতে দেয়। অঞ্চলটিকে একটি বৃত্ত হিসেবে নির্দিষ্ট করুন, যা কেন্দ্রবিন্দুর অক্ষাংশ ও দ্রাঘিমাংশ স্থানাঙ্ক এবং মিটারে ব্যাসার্ধ দ্বারা সংজ্ঞায়িত করা হয়।

    জায়গার বৈশিষ্ট্যকে সংজ্ঞায়িত করে এমন এক বা একাধিক জায়গার ধরন উল্লেখ করুন। যেমন, নির্দিষ্ট অঞ্চলে শপিং মলে অবস্থিত পিৎজা রেস্তোরাঁ খুঁজতে "pizza_restaurant" এবং "shopping_mall" উল্লেখ করুন।

দুটি সার্চের মধ্যে প্রধান পার্থক্য হল, টেক্সট সার্চ (নতুন) আপনাকে একটি ইচ্ছামতো সার্চ স্ট্রিং নির্দিষ্ট করতে দেয়, যেখানে আশেপাশের সার্চ (নতুন) ফিচারের জন্য সার্চ করার জন্য একটি নির্দিষ্ট এলাকার প্রয়োজন হয়।

অটোকমপ্লিট (নতুন) ও সেশন টোকেন

অটোমেটিক সম্পূর্ণ করা (নতুন) হল একটি ওয়েব পরিষেবা যা HTTP অনুরোধের উত্তরে স্থান ও কোয়েরি সংক্রান্ত পূর্বাভাস প্রদান করে। অনুরোধে, একটি টেক্সট সার্চ স্ট্রিং এবং ভৌগোলিক সীমা উল্লেখ করুন যা সার্চ এরিয়াকে নিয়ন্ত্রণ করে।

সেশন টোকেন হল ব্যবহারকারীর তৈরি করা স্ট্রিং যা সেশন হিসেবে অটোকমপ্লিট (নতুন) কল ট্র্যাক করে। অটোকমপ্লিট (নতুন) ফিচারটি বিলিংয়ের উদ্দেশ্যে কোনও ব্যবহারকারীর অটোকমপ্লিট সার্চের কোয়েরি ও বেছে নেওয়ার ফেজকে আলাদা সেশনে গ্রুপ করার জন্য সেশন টোকেন ব্যবহার করে।

নতুন ফিল্ড, অ্যাট্রিবিউট ও অ্যাক্সেসিবিলিটি বিকল্প

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

ফিল্ড

Places API (নতুন)-এ বেশ কিছু নতুন ফিল্ড অন্তর্ভুক্ত করা হয়েছে:

ফিল্ড বিবরণ
regularSecondaryOpeningHours নির্দিষ্ট অপারেশনের জন্য বিশেষ সময় বর্ণনা করে। সেকেন্ডারি খোলা থাকার সময় ব্যবসার মূল সময়ের থেকে আলাদা হয়। যেমন, কোনও রেস্তোরাঁ ড্রাইভ-থ্রু খোলা থাকার সময় বা ডেলিভারি সময়কে সেকেন্ডারি সময় হিসেবে উল্লেখ করতে পারে।
paymentOptions এই জায়গা যেসব পেমেন্ট বিকল্প গ্রহণ করে। কোনও জায়গায় একাধিক পেমেন্টের বিকল্প গ্রহণ করা হতে পারে। পেমেন্টের বিকল্প সংক্রান্ত ডেটা উপলভ্য না থাকলে, পেমেন্টের বিকল্প ফিল্ড সেট করা থাকবে না। বিকল্পগুলির মধ্যে নিম্নলিখিতগুলি অন্তর্ভুক্ত:
  • ক্রেডিট কার্ড
  • ডেবিট কার্ড
  • শুধুমাত্র নগদ
  • NFC পেমেন্ট
parkingOptions জায়গাটির দেওয়া পার্কিংয়ের বিকল্প। বিকল্পগুলির মধ্যে নিম্নলিখিতগুলি অন্তর্ভুক্ত:
  • বিনামূল্যে পার্কিংয়ের জায়গা
  • পেড পার্কিং লট
  • বিনামূল্যে স্ট্রিট পার্কিং
  • ভ্যালে পার্কিংয়ের সুবিধা
  • ফ্রি গ্যারেজ পার্কিং
  • পেড গ্যারেজ পার্কিং
subDestinations নির্দিষ্ট জায়গার সাথে সম্পর্কিত অনন্য জায়গা। যেমন, এয়ারপোর্ট টার্মিনালকে এয়ারপোর্টের সাব-ডেস্টিনেশন হিসেবে বিবেচনা করা হয়।
fuelOptions কোনও পেট্রোল পাম্পে উপলভ্য ফুয়েল বিকল্প সম্পর্কে সবচেয়ে সাম্প্রতিক তথ্য। এই তথ্য নিয়মিত আপডেট করা হয়। বিকল্পগুলির মধ্যে নিম্নলিখিতগুলি অন্তর্ভুক্ত:
  • ডিজেল
  • সাধারণ আনলিডেড
  • মিডগ্রেড
  • প্রিমিয়াম
  • SP91
  • SP91 E10
  • SP92
  • SP95 E10
  • SP98
  • SP99
  • SP100
  • এলপিজি (LPG)
  • E80
  • E85
  • মিথেইন
  • বায়োডিজেল
  • ট্রাকের ডিজেল
evChargeOptions এই স্টেশনে ইলেকট্রিক ভেইকেল (EV) চার্জারের সংখ্যা। যদিও কিছু EV চার্জারে একাধিক কানেক্টর থাকে, প্রতিটি চার্জার শুধুমাত্র একবারে একটি গাড়ি চার্জ করতে পারে; এর ফলে, এই ফিল্ডটি কোনও নির্দিষ্ট সময়ে উপলভ্য EV চার্জারের সংখ্যা দেখায়।
shortFormattedAddress কোনও জায়গার জন্য ছোট, মানুষের-পঠনযোগ্য ঠিকানা।
primaryType প্রদত্ত ফলাফলের প্রাথমিক ধরন। যেমন, কোনও জায়গাকে cafe বা airport হিসেবে শ্রেণীবদ্ধ করা হতে পারে। কোনও জায়গার শুধুমাত্র একটিই প্রাথমিক ধরন থাকতে পারে। সম্ভাব্য ভ্যালুর সম্পূর্ণ তালিকা দেখতে, কাজ করে এমন ধরন দেখুন।
primaryTypeDisplayName প্রাইমারি ধরনের ডিসপ্লে নাম, প্রযোজ্য হলে অনুরোধের ভাষায় লোকালাইজ করা। সম্ভাব্য ভ্যালুর সম্পূর্ণ তালিকা পেতে, কাজ করে এমন ধরন দেখুন।
entrances গন্তব্যের প্রবেশপথ। প্রবেশপথ হল একটি অক্ষাংশ/দ্রাঘিমাংশ কোঅর্ডিনেট পেয়ার যা কোনও জায়গার প্রবেশ ও প্রস্থান পয়েন্টের লোকেশনকে নির্ধারণ করে।
navigationPoints গন্তব্যের জন্য নেভিগেশন পয়েন্ট। নেভিগেশন পয়েন্ট হল রাস্তার পাশে এমন একটি লোকেশন যেখানে নেভিগেশন শেষ হতে পারে, এর মধ্যে ট্রাভেল মোড ও ব্যবহার অন্তর্ভুক্ত।

অ্যাট্রিবিউট

Places API (নতুন)-এ একাধিক নতুন অ্যাট্রিবিউট অন্তর্ভুক্ত রয়েছে:

অ্যাট্রিবিউট বিবরণ
outdoorSeating এই জায়গায় বাইরে বসার ব্যবস্থা আছে।
liveMusic এই জায়গায় লাইভ মিউজিকের ব্যবস্থা আছে।
menuForChildren এই জায়গায় বাচ্চাদের জন্য মেনু আছে।
servesCocktails এই জায়গায় ককটেল পরিবেশন করা হয়।
servesDessert এই জায়গায় ডেজার্ট পরিবেশন করা হয়।
servesCoffee এই জায়গায় কফি পরিবেশন করা হয়।
goodForChildren বাচ্চাদের জন্য জায়গাটি ভালো।
allowsDogs জায়গাটিতে কুকুর নিয়ে যাওয়ার অনুমতি আছে।
restroom জায়গাটিতে টয়লেট আছে।
goodForGroups এই জায়গা গ্রুপে যাওয়ার পক্ষে উপযুক্ত।
goodForWatchingSports জায়গাটি খেলা দেখার জন্য উপযুক্ত।

অ্যাক্সেসিবিলিটি বিকল্প

Places API (নতুন)-এ অ্যাক্সেসিবিলিটি বিকল্পের নিম্নলিখিত ফিল্ড অন্তর্ভুক্ত থাকে:

ফিল্ড বিবরণ
wheelchairAccessibleParking জায়গাটিতে হুইলচেয়ার ব্যবহার করার উপযোগী পার্কিংয়ের সুবিধা আছে।
wheelchairAccessibleEntrance জায়গাটিতে হুইলচেয়ারের উপযুক্ত প্রবেশপথ আছে।
wheelchairAccessibleRestroom জায়গাটিতে হুইলচেয়ার ব্যবহার করার উপযোগী শৌচালয় আছে।
wheelchairAccessibleSeating জায়গাটিতে হুইলচেয়ার ব্যবহার করার উপযোগী বসার ব্যবস্থা আছে।

AI-পাওয়ার্ড সারসংক্ষেপ

Places API (নতুন) AI-এর মাধ্যমে পরিচালিত সারসংক্ষেপ, Gemini মডেলের ফিচার ব্যবহার করে জায়গা ও এলাকার সারসংক্ষেপ প্রদান করে, যা ব্যবহারকারীদের কোথায় যেতে হবে সেই সিদ্ধান্ত নিতে সাহায্য করে।

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

Places API (নতুন)-এ AI-এর মাধ্যমে পরিচালিত ফিচার যোগ করা হয়েছে

AI-এর মাধ্যমে পরিচালিত সারসংক্ষেপ জায়গার বিবরণ (নতুন), টেক্সট সার্চ (নতুন), এবং আশেপাশের সার্চ (নতুন)-এ কাজ করে। Places API (নতুন) উত্তরে নিম্নলিখিত AI-পরিচালিত সারসংক্ষেপ উপলভ্য:

  • জায়গার সারসংক্ষেপ, যা নির্দিষ্ট জায়গা সম্পর্কিত সংক্ষিপ্ত সারসংক্ষেপ।
  • রিভিউয়ের সারসংক্ষেপ, যা হল কোনও জায়গা সম্পর্কে রিভিউয়াররা যা বলেছেন তার সহজে বোধগম্য সারসংক্ষেপ।
  • এলাকার সারসংক্ষেপ, যা আশেপাশের এবং জনপ্রিয় জায়গাগুলির ওভারভিউ প্রদান করে। এর মধ্যে আশেপাশের এলাকার সারসংক্ষেপ ও EV চার্জিং স্টেশনের সারসংক্ষেপ অন্তর্ভুক্ত।

উপলভ্য লেটেস্ট তথ্যের ভিত্তিতে এগুলি যাতে ফ্রেশ থাকে তা নিশ্চিত করতে Google প্রায়ই এইসব সারসংক্ষেপ রিজেনারেট করে। আপনি Places API (New) অনুরোধ করলে, আপনার অ্যাপে সবচেয়ে নতুন ডেটা দেখতে পাবেন।

Places API (নতুন)-এ মাইগ্রেট করুন

আপনি যদি আগে থেকেই Places API (Legacy) গ্রাহক হন এবং আপনার অ্যাপকে Places API (নতুন) ব্যবহার করার জন্য মাইগ্রেট করতে চান, তাহলে নিম্নলিখিত মাইগ্রেশন ডকুমেন্টেশন দেখুন: