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

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

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

মাইগ্রেশনের জন্য বিলিংয়ের সর্বোত্তম অনুশীলন

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

প্লেসেস এপিআই সক্রিয় করুন

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

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

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

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

এপিআই-নির্দিষ্ট পরিবর্তন

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

এই সারণিটি দেখায় কিভাবে প্লেসেস সার্ভিসের বৈশিষ্ট্যগুলো প্লেস ক্লাসের বৈশিষ্ট্যগুলোর সাথে সম্পর্কিত:

স্থান পরিষেবা (উত্তরাধিকার) স্থান শ্রেণী (নতুন)
ডেটা ক্ষেত্র স্থাপন করুন স্থান শ্রেণী ডেটা ক্ষেত্র
স্থানের প্রকারভেদ স্থানের প্রকারভেদ
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 লাইব্রেরি লোড করবে তা নির্ভর করে কোন বুটস্ট্র্যাপ লোডার ব্যবহার করা হচ্ছে তার উপর। যদি আপনার অ্যাপ ডাইনামিক লাইব্রেরি ইম্পোর্ট ব্যবহার করে, তাহলে আপনি রানটাইমে 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-এর সর্বশেষ সংস্করণ ব্যবহার করার জন্য স্থানান্তরিত করতে সাহায্য করার উদ্দেশ্যে এই বিভাগে নিম্নলিখিত নির্দেশিকাগুলি অন্তর্ভুক্ত করা হয়েছে: