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

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

ভূমিকা

প্লেসেস এপিআই (নতুন)-এ নিম্নলিখিত এপিআইগুলো অন্তর্ভুক্ত রয়েছে:

এই নথিতে এই নতুন এপিআইগুলোর একটি সংক্ষিপ্ত বিবরণ রয়েছে।

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

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

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

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

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

প্লেস ফটোস (নতুন) এপিআই-তে করা সমস্ত অনুরোধে অবশ্যই একটি ফটো রিসোর্স নাম অন্তর্ভুক্ত থাকতে হবে, যা ফেরতযোগ্য ফটোটিকে অনন্যভাবে শনাক্ত করে। আপনি নিম্নলিখিত পদ্ধতি ব্যবহার করে ফটো রিসোর্স নামটি পেতে পারেন:

Place Details (New), Text Search (New), বা Nearby Search (New) অনুরোধের প্রতিক্রিয়ায় ফটো রিসোর্সের নামটি অন্তর্ভুক্ত করতে, নিশ্চিত করুন যে আপনি অনুরোধটির ফিল্ড মাস্কে photos ফিল্ডটি অন্তর্ভুক্ত করেছেন।

টেক্সট সার্চ (নতুন) এবং কাছাকাছি সার্চ (নতুন)

Places API-তে দুটি সার্চ API অন্তর্ভুক্ত রয়েছে:

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

    কোনো স্থান অনুসন্ধানের জন্য আপনি একটি টেক্সট স্ট্রিং নির্দিষ্ট করতে পারেন। উদাহরণস্বরূপ: "সিডনি, অস্ট্রেলিয়ায় মশলাদার নিরামিষ খাবার" অথবা "পালো অল্টো, ক্যালিফোর্নিয়ার কাছে চমৎকার সামুদ্রিক খাবারের রেস্তোরাঁ"।

    আপনি মূল্যস্তর, বর্তমান খোলার অবস্থা, রেটিং বা নির্দিষ্ট স্থানের ধরনের মতো বিবরণ উল্লেখ করে অনুসন্ধানকে আরও পরিমার্জিত করতে পারেন। এছাড়াও আপনি ফলাফলকে একটি নির্দিষ্ট অবস্থানের দিকে পক্ষপাতদুষ্ট করতে, অথবা অনুসন্ধানকে একটি নির্দিষ্ট অবস্থানে সীমাবদ্ধ করতে পারেন।

  • কাছাকাছি অনুসন্ধান (নতুন)

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

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

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

স্বয়ংক্রিয় সম্পূর্ণতা (নতুন) এবং সেশন টোকেন

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

সেশন টোকেন হলো ব্যবহারকারী-সৃষ্ট স্ট্রিং যা অটোকমপ্লিট (নিউ) কলগুলোকে সেশন হিসেবে ট্র্যাক করে। বিলিংয়ের উদ্দেশ্যে, অটোকমপ্লিট (নিউ) একটি ব্যবহারকারীর অটোকমপ্লিট সার্চের কোয়েরি এবং সিলেকশন পর্যায়গুলোকে একটি স্বতন্ত্র সেশনে একত্রিত করতে সেশন টোকেন ব্যবহার করে।

নতুন ক্ষেত্র, বৈশিষ্ট্য এবং প্রবেশযোগ্যতার বিকল্প

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

ক্ষেত্র

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

মাঠ বর্ণনা
regularSecondaryOpeningHours নির্দিষ্ট কিছু কার্যক্রমের জন্য বিশেষ সময়কে বোঝায়। দ্বিতীয় পর্যায়ের খোলার সময় কোনো ব্যবসার মূল খোলার সময় থেকে ভিন্ন হয়। উদাহরণস্বরূপ, একটি রেস্তোরাঁ তার দ্বিতীয় পর্যায়ের খোলার সময় হিসেবে ড্রাইভ-থ্রু বা ডেলিভারির সময় নির্দিষ্ট করতে পারে।
paymentOptions স্থানটি যে সকল অর্থপ্রদানের বিকল্প গ্রহণ করে। একটি স্থান একাধিক অর্থপ্রদানের বিকল্প গ্রহণ করতে পারে। যদি অর্থপ্রদানের বিকল্পের ডেটা উপলব্ধ না থাকে, তাহলে অর্থপ্রদানের বিকল্পের ক্ষেত্রটি খালি থাকবে। বিকল্পগুলির মধ্যে নিম্নলিখিতগুলি অন্তর্ভুক্ত:
  • ক্রেডিট কার্ড
  • ডেবিট কার্ড
  • শুধুমাত্র নগদ
  • এনএফসি পেমেন্ট
parkingOptions স্থানটির পক্ষ থেকে পার্কিংয়ের ব্যবস্থা রয়েছে। বিকল্পগুলো নিম্নরূপ:
  • বিনামূল্যে পার্কিং লট
  • পেইড পার্কিং লট
  • রাস্তায় বিনামূল্যে পার্কিং
  • ভ্যালেট পার্কিং
  • গ্যারেজে বিনামূল্যে পার্কিং
  • পেইড গ্যারেজ পার্কিং
subDestinations কোনো নির্দিষ্ট স্থানের সাথে সম্পর্কিত স্বতন্ত্র স্থান। উদাহরণস্বরূপ, বিমানবন্দর টার্মিনালগুলোকে একটি বিমানবন্দরের উপ-গন্তব্যস্থল হিসেবে বিবেচনা করা হয়।
fuelOptions গ্যাস স্টেশনে উপলব্ধ জ্বালানির বিকল্পগুলো সম্পর্কে সর্বশেষ তথ্য। এই তথ্য নিয়মিত আপডেট করা হয়। বিকল্পগুলোর মধ্যে নিম্নলিখিতগুলো অন্তর্ভুক্ত:
  • ডিজেল
  • নিয়মিত সীসাহীন
  • মধ্যম গ্রেড
  • প্রিমিয়াম
  • এসপি৯১
  • এসপি৯১ ই১০
  • এসপি৯২
  • এসপি৯৫ ই১০
  • এসপি৯৮
  • এসপি৯৯
  • এসপি১০০
  • এলপিজি
  • E80
  • E85
  • মিথেন
  • বায়োডিজেল
  • ট্রাক ডিজেল
evChargeOptions এই স্টেশনে বৈদ্যুতিক গাড়ির (EV) চার্জারের সংখ্যা। যদিও কিছু EV চার্জারে একাধিক সংযোগকারী থাকে, প্রতিটি চার্জার একবারে কেবল একটি গাড়ি চার্জ করতে পারে; ফলে, এই ক্ষেত্রটি একটি নির্দিষ্ট সময়ে উপলব্ধ EV চার্জারের সংখ্যা নির্দেশ করে।
shortFormattedAddress কোনো স্থানের একটি সংক্ষিপ্ত ও সহজে পঠনযোগ্য ঠিকানা।
primaryType প্রদত্ত ফলাফলের প্রাথমিক ধরণ। উদাহরণস্বরূপ, একটি স্থানকে cafe বা airport হিসাবে শ্রেণীবদ্ধ করা যেতে পারে। একটি স্থানের কেবল একটিই প্রাথমিক ধরণ থাকতে পারে। সম্ভাব্য মানগুলির সম্পূর্ণ তালিকার জন্য, সমর্থিত ধরণসমূহ দেখুন।
primaryTypeDisplayName প্রাথমিক টাইপের প্রদর্শিত নাম, যা প্রযোজ্য ক্ষেত্রে অনুরোধের ভাষায় স্থানীয়করণ করা হয়। সম্ভাব্য মানগুলির সম্পূর্ণ তালিকার জন্য, সমর্থিত টাইপসমূহ দেখুন।

বৈশিষ্ট্য

প্লেসেস এপিআই (নতুন)-এ বেশ কিছু নতুন অ্যাট্রিবিউট অন্তর্ভুক্ত করা হয়েছে:

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

অ্যাক্সেসযোগ্যতার বিকল্পগুলি

প্লেসেস এপিআই (নতুন)-এ নিম্নলিখিত অ্যাক্সেসিবিলিটি অপশন ফিল্ডগুলো অন্তর্ভুক্ত রয়েছে:

মাঠ বর্ণনা
wheelchairAccessibleParking স্থানটিতে হুইলচেয়ার ব্যবহারকারীদের জন্য পার্কিংয়ের ব্যবস্থা রয়েছে।
wheelchairAccessibleEntrance স্থানটিতে হুইলচেয়ার ব্যবহারকারীদের জন্য প্রবেশযোগ্য একটি প্রবেশপথ রয়েছে।
wheelchairAccessibleRestroom এই স্থানে হুইলচেয়ার ব্যবহারকারীদের জন্য প্রবেশযোগ্য শৌচাগার রয়েছে।
wheelchairAccessibleSeating স্থানটিতে হুইলচেয়ার ব্যবহারকারীদের জন্য উপযুক্ত বসার ব্যবস্থা রয়েছে।

এআই-চালিত সারাংশ

প্লেসেস এপিআই (নতুন) হলো একটি এআই-চালিত সারাংশ যা জেমিনি মডেলের সক্ষমতা ব্যবহার করে বিভিন্ন স্থান ও এলাকা সম্পর্কে এমন সারসংক্ষেপ প্রদান করে, যা ব্যবহারকারীদের কোথায় যাবেন সে বিষয়ে সিদ্ধান্ত নিতে সাহায্য করে।

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

প্লেসেস এপিআই-তে এআই-চালিত ফিচার যুক্ত করা হয়েছে (নতুন)

প্লেস ডিটেইলস (নতুন) , টেক্সট সার্চ (নতুন) , এবং নিয়ারবাই সার্চ (নতুন) দ্বারা এআই-চালিত সারাংশ সমর্থিত। প্লেসেস এপিআই (নতুন) রেসপন্সে নিম্নলিখিত এআই-চালিত সারাংশগুলো উপলব্ধ:

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

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

নতুন স্থান এপিআইগুলিতে স্থানান্তরিত করুন

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