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

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

ভূমিকা

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

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

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

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

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

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-পরিচালিত সারসংক্ষেপ জায়গার বিবরণ (নতুন), টেক্সট সার্চ (নতুন), এবং নিয়ারবাই Search (নতুন)-এ কাজ করে। Places API (New) রেসপন্সে নিম্নলিখিত AI-পরিচালিত সারসংক্ষেপ উপলভ্য:

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

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

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

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