এই নির্দেশিকাটি পুরনো Places Service এবং নতুন Place ক্লাসের মধ্যে মূল পার্থক্যগুলি হাইলাইট করে। প্লেস ক্লাসে আপগ্রেড করলে, উন্নত পারফর্ম্যান্স ও নতুন প্রাইসিং মডেল সহ অনেক সুবিধা পাওয়া যায়। Places-এর সুবিধা সবচেয়ে ভালোভাবে পেতে এবং আপনার অ্যাপ যাতে আপ-টু-ডেট থাকে তা নিশ্চিত করতে, এই নির্দেশিকায় উল্লেখ করা পরিবর্তনগুলি সম্পর্কে জানুন।
মাইগ্রেশনের জন্য বিলিং সংক্রান্ত পেশাদার পদ্ধতি
আপনার API ব্যবহার যদি এত বেশি হয় যে সেকেন্ড-টিয়ার প্রাইসিংয়ে চলে যেতে হয়, তাহলে এই নির্দেশিকা প্রযোজ্য হবে। API-এর নতুন ভার্সনে মাইগ্রেট করার সময়, আপনাকে অন্য SKU-এর জন্য বিল করা হয়। ট্রানজিশনের মাস জুড়ে খরচ বৃদ্ধি এড়াতে, আমরা সাজেস্ট করি যে প্রোডাকশনে নতুন API-তে যতটা সম্ভব মাসের শুরুতে পরিবর্তন করুন। এর ফলে, মাইগ্রেশন চলাকালীন আপনি সবচেয়ে সাশ্রয়ী মাসিক প্রাইসিং টিয়ারে পৌঁছাতে পারবেন। মূল্যের বিভিন্ন লেভেল সম্পর্কে জানতে, মূল্য সংক্রান্ত পৃষ্ঠা ও মূল্য সংক্রান্ত প্রায়শই জিজ্ঞাসিত প্রশ্ন দেখুন।
Places API চালু করুন
Place ক্লাস Places API পরিষেবার উপর নির্ভর করে। নতুন Place ক্লাসের ফিচার ব্যবহার করতে, আপনাকে প্রথমে আপনার Google Cloud প্রোজেক্টে Places API (নতুন) চালু করতে হবে। আরও তথ্যের জন্য, শুরু করুন দেখুন।
সাধারণ পরিবর্তন
PlacesService
ও Place-এর মধ্যে প্রধান পার্থক্যগুলি নিম্নলিখিত সারণীতে তালিকাভুক্ত করা হয়েছে:
PlacesService (লিগ্যাসি) |
Place (নতুন) |
|---|---|
ফলাফল অবজেক্ট এবং উত্তর ম্যানেজ করার জন্য
google.maps.places.PlacesServiceStatus পদ্ধতিতে কলব্যাক ব্যবহার করতে হয়। |
প্রমিস ব্যবহার করে এবং অ্যাসিঙ্ক্রোনাস পদ্ধতিতে কাজ করে। |
পদ্ধতিগুলির জন্য একটি PlacesServiceStatus চেক প্রয়োজন। |
স্ট্যাটাস চেক করার প্রয়োজন নেই, স্ট্যান্ডার্ড এরর হ্যান্ডলিং ব্যবহার করতে পারেন। |
| স্নেক কেস ব্যবহার করে জায়গার ডেটা ফিল্ড ফর্ম্যাট করা হয়। | জায়গার ডেটা ফিল্ড ক্যামেল কেস ব্যবহার করে ফর্ম্যাট করা হয়। |
| জায়গার ধরন এবং জায়গার ডেটা ফিল্ডের একটি নির্দিষ্ট সেটের মধ্যে সীমাবদ্ধ। | নিয়মিত আপডেট করা জায়গার ধরন ও জায়গা সংক্রান্ত ডেটা ফিল্ডের একটি বর্ধিত নির্বাচন প্রদান করে। |
API-নির্দিষ্ট পরিবর্তন
Place ক্লাস, Places লাইব্রেরি ব্যবহার করার জন্য API প্রদান করে এবং Promises-এর মতো আধুনিক ব্যবহারের প্যাটার্ন কাজ করে। Place ক্লাস, পুরনো Places পরিষেবার মতো একই জায়গার ডেটা ফিল্ড ও জায়গার ধরন দেখায় এবং জায়গার ডেটা ফিল্ড ও জায়গার ধরনের জন্য অনেক নতুন ভ্যালু অন্তর্ভুক্ত করে।
এই সারণীটি দেখায় কিভাবে Places Service-এর বৈশিষ্ট্য Place ক্লাসের সাথে ম্যাপ করে:
Places লাইব্রেরি লোড করুন
আপনার অ্যাপ কীভাবে Places লাইব্রেরি লোড করে তা নির্ভর করে কোন বুটস্ট্র্যাপ লোডার ব্যবহার করা হচ্ছে তার উপর। আপনার অ্যাপ ডায়নামিক লাইব্রেরি ইমপোর্ট ব্যবহার করলে,
আপনি রানটাইমে প্রয়োজনীয় লাইব্রেরি লোড করতে পারবেন, এর জন্য await অপারেটর ব্যবহার করে
importLibrary() কল করতে হবে, যেমন এখানে দেখানো হয়েছে:
const { Place } = await google.maps.importLibrary("places");
আপনার অ্যাপ সরাসরি স্ক্রিপ্ট লোডিং ট্যাগ ব্যবহার করলে,
লোডার স্ক্রিপ্টে places লাইব্রেরির জন্য অনুরোধ করুন:
<script async
src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&loading=async&libraries=places&callback=initMap">
</script>Maps JavaScript API লোড করা সম্পর্কে আরও জানুন।
Places API-এর নতুন ভার্সন ব্যবহার করার জন্য আপনার অ্যাপ মাইগ্রেট করতে সাহায্য করার জন্য এই বিভাগে নিম্নলিখিত নির্দেশিকা অন্তর্ভুক্ত রয়েছে:
- জায়গার বিবরণে মাইগ্রেট করুন
- টেক্সট সার্চে (নতুন) মাইগ্রেট করুন
- নিয়ারবাই সার্চ (নতুন) ফিচারে মাইগ্রেট করুন
- প্লেস ফটোতে মাইগ্রেট করা
- জায়গার রিভিউতে মাইগ্রেট করুন
- 'জায়গা অটোমেটিক সম্পূর্ণ করা' ফিচারে মাইগ্রেট করা