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

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

ভূমিকা

Places API (নতুন) তে নিম্নলিখিত API গুলি অন্তর্ভুক্ত রয়েছে:

এই নথিতে এই নতুন API গুলির একটি সারসংক্ষেপ রয়েছে।

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

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

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

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

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

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

স্থানের বিবরণ (নতুন), পাঠ্য অনুসন্ধান (নতুন), অথবা কাছাকাছি অনুসন্ধান (নতুন) অনুরোধের প্রতিক্রিয়ায় ছবির সংস্থানের নাম অন্তর্ভুক্ত করতে, অনুরোধের ফিল্ড মাস্কে photos ক্ষেত্রটি অন্তর্ভুক্ত করুন।

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

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

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

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

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

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

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

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

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

স্বয়ংক্রিয় (নতুন) এবং সেশন টোকেন

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

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

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

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

ক্ষেত্র

Places API (নতুন) তে বেশ কিছু নতুন ক্ষেত্র অন্তর্ভুক্ত রয়েছে:

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

গুণাবলী

Places API (নতুন) তে বেশ কিছু নতুন বৈশিষ্ট্য অন্তর্ভুক্ত রয়েছে:

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

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

Places API (নতুন) তে নিম্নলিখিত অ্যাক্সেসিবিলিটি বিকল্প ক্ষেত্রগুলি অন্তর্ভুক্ত রয়েছে:

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

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

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

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

প্লেস এপিআইতে এআই-চালিত বৈশিষ্ট্য যোগ করা হয়েছে (নতুন)

AI-চালিত সারাংশগুলি Place Details (New) , Text Search (New) এবং Nearby Search (New) দ্বারা সমর্থিত। নিম্নলিখিত AI-চালিত সারাংশগুলি Places API (New) প্রতিক্রিয়াগুলিতে উপলব্ধ:

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

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

নতুন স্থান API গুলিতে স্থানান্তর করুন

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