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

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

স্থান API সক্ষম করুন৷

প্লেস ক্লাস প্লেস এপিআই পরিষেবার উপর নির্ভর করে। নতুন প্লেস ক্লাসের বৈশিষ্ট্যগুলি ব্যবহার করতে, আপনাকে প্রথমে আপনার Google ক্লাউড প্রকল্পে Places API (নতুন) সক্ষম করতে হবে৷ আরও তথ্যের জন্য, শুরু করুন দেখুন।

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

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

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

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

প্লেস ক্লাস প্লেস লাইব্রেরি ব্যবহার করার জন্য একটি API প্রদান করে এবং প্রতিশ্রুতির মতো আধুনিক ব্যবহারের ধরণগুলিকে সমর্থন করে। প্লেস ক্লাস লিগ্যাসি প্লেসেস সার্ভিসের মতো একই স্থানের ডেটা ক্ষেত্র এবং স্থানের ধরন প্রকাশ করে এবং স্থান ডেটা ক্ষেত্র এবং স্থানের প্রকারের জন্য অনেক নতুন মান অন্তর্ভুক্ত করে।

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

স্থান পরিষেবা (উত্তরাধিকার) স্থান ক্লাস (নতুন)
ডেটা ক্ষেত্রগুলি রাখুন ক্লাস ডেটা ক্ষেত্রগুলি রাখুন
স্থান প্রকার স্থান প্রকার
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 ক্লাস ---

স্থান লাইব্রেরি লোড করুন

আপনার অ্যাপ কীভাবে স্থান লাইব্রেরি লোড করে তা নির্ভর করে কোন বুটস্ট্র্যাপ লোডার ব্যবহার করা হচ্ছে তার উপর। যদি আপনার অ্যাপ ডায়নামিক লাইব্রেরি ইম্পোর্ট ব্যবহার করে, তাহলে আপনি importLibrary() কল করতে await অপারেটর ব্যবহার করে রানটাইমে প্রয়োজনীয় লাইব্রেরি লোড করতে পারেন, যেমনটি এখানে দেখানো হয়েছে:

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 লোড করার বিষয়ে আরও জানুন।

স্থান API-এর নতুন সংস্করণ ব্যবহার করার জন্য আপনার অ্যাপগুলিকে স্থানান্তরিত করতে আপনাকে সাহায্য করার জন্য এই বিভাগে নিম্নলিখিত নির্দেশিকাগুলি অন্তর্ভুক্ত রয়েছে:

,

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

স্থান API সক্ষম করুন৷

প্লেস ক্লাস প্লেস এপিআই পরিষেবার উপর নির্ভর করে। নতুন প্লেস ক্লাসের বৈশিষ্ট্যগুলি ব্যবহার করতে, আপনাকে প্রথমে আপনার Google ক্লাউড প্রকল্পে Places API (নতুন) সক্ষম করতে হবে৷ আরও তথ্যের জন্য, শুরু করুন দেখুন।

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

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

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

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

প্লেস ক্লাস প্লেস লাইব্রেরি ব্যবহার করার জন্য একটি API প্রদান করে এবং প্রতিশ্রুতির মতো আধুনিক ব্যবহারের ধরণগুলিকে সমর্থন করে। প্লেস ক্লাস লিগ্যাসি প্লেসেস সার্ভিসের মতো একই স্থানের ডেটা ক্ষেত্র এবং স্থানের ধরন প্রকাশ করে এবং স্থান ডেটা ক্ষেত্র এবং স্থানের প্রকারের জন্য অনেক নতুন মান অন্তর্ভুক্ত করে।

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

স্থান পরিষেবা (উত্তরাধিকার) স্থান ক্লাস (নতুন)
ডেটা ক্ষেত্রগুলি রাখুন ক্লাস ডেটা ক্ষেত্রগুলি রাখুন
স্থান প্রকার স্থান প্রকার
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 ক্লাস ---

স্থান লাইব্রেরি লোড করুন

আপনার অ্যাপ কীভাবে স্থান লাইব্রেরি লোড করে তা নির্ভর করে কোন বুটস্ট্র্যাপ লোডার ব্যবহার করা হচ্ছে তার উপর। যদি আপনার অ্যাপ ডায়নামিক লাইব্রেরি ইম্পোর্ট ব্যবহার করে, তাহলে আপনি importLibrary() কল করতে await অপারেটর ব্যবহার করে রানটাইমে প্রয়োজনীয় লাইব্রেরি লোড করতে পারেন, যেমনটি এখানে দেখানো হয়েছে:

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 লোড করার বিষয়ে আরও জানুন।

স্থান API-এর নতুন সংস্করণ ব্যবহার করার জন্য আপনার অ্যাপগুলিকে স্থানান্তরিত করতে আপনাকে সাহায্য করার জন্য এই বিভাগে নিম্নলিখিত নির্দেশিকাগুলি অন্তর্ভুক্ত রয়েছে: