মাইগ্রেশন ওভারভিউ

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

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

মাইগ্রেশনের জন্য বিলিং সংক্রান্ত পেশাদার পদ্ধতি

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

Places API চালু করুন

Place ক্লাস Places API পরিষেবার উপর নির্ভর করে। নতুন Place ক্লাসের ফিচার ব্যবহার করতে, আপনাকে প্রথমে আপনার Google Cloud প্রোজেক্টে Places API (নতুন) চালু করতে হবে। আরও তথ্যের জন্য, শুরু করুন বিকল্প দেখুন।

সাধারণ পরিবর্তন

PlacesService এবং Place-এর মধ্যে প্রধান পার্থক্যগুলি নিম্নলিখিত সারণীতে তালিকাভুক্ত করা হয়েছে:

PlacesService (লিগ্যাসি) Place (নতুন)
ফলাফল অবজেক্ট ও উত্তর ম্যানেজ করার জন্য google.maps.places.PlacesServiceStatus পদ্ধতিতে কলব্যাক ব্যবহার করতে হয়। Promises ব্যবহার করে এবং অ্যাসিঙ্ক্রোনাসভাবে কাজ করে।
পদ্ধতিগুলির জন্য PlacesServiceStatus চেক প্রয়োজন। স্ট্যাটাস চেক করার প্রয়োজন নেই, স্ট্যান্ডার্ড এরর হ্যান্ডলিং ব্যবহার করতে পারেন।
স্নেক কেস ব্যবহার করে জায়গার ডেটা ফিল্ড ফর্ম্যাট করা হয়। জায়গার ডেটা ফিল্ড ক্যামেল কেস ব্যবহার করে ফর্ম্যাট করা হয়।
জায়গার ধরন এবং জায়গার ডেটা ফিল্ডের একটি নির্দিষ্ট সেটের মধ্যে সীমাবদ্ধ। নিয়মিত আপডেট করা জায়গার ধরন এবং জায়গার ডেটা ফিল্ড-এর আরও বেশি বিকল্প প্রদান করে।

API-নির্দিষ্ট পরিবর্তন

Place ক্লাস Places লাইব্রেরি ব্যবহার করার জন্য একটি API প্রদান করে এবং Promises-এর মতো আধুনিক ব্যবহারের প্যাটার্নকে সমর্থন করে। Place ক্লাস, পুরনো Places পরিষেবার মতো একই ধরনের জায়গা ডেটা ফিল্ড ও জায়গার ধরন দেখায় এবং এতে জায়গা ডেটা ফিল্ড ও জায়গার ধরনের জন্য অনেক নতুন ভ্যালু অন্তর্ভুক্ত থাকে।

এই সারণীটি দেখায় কিভাবে Places Service-এর বৈশিষ্ট্যগুলি Place ক্লাসের সাথে ম্যাপ করে:

Places Service (লিগ্যাসি) জায়গার ক্লাস (নতুন)
জায়গার ডেটা ফিল্ড Place Class ডেটা ফিল্ড
জায়গার ধরন জায়গার ধরন
PlacesService.findPlaceFromQuery() Place.searchByText()
PlacesService.findPlaceFromPhoneNumber() Place.searchByText()
PlacesService.textSearch() Place.searchByText()
PlacesService.nearbySearch() Place.searchNearby()
PlacesService.getDetails() Place.fetchFields()
Places.AutocompletionRequest Places.AutocompleteRequest
Places.AutocompletePrediction Places.PlacePrediction
Autocomplete ক্লাস PlaceAutocompleteElement ক্লাস
SearchBox ক্লাস ---

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-এর নতুন ভার্সন ব্যবহার করার জন্য আপনার অ্যাপ মাইগ্রেট করতে সাহায্য করার জন্য এই বিভাগে নিম্নলিখিত নির্দেশিকাগুলি অন্তর্ভুক্ত রয়েছে: