আপনার অ্যাপ্লিকেশানে উপলব্ধ Android বৈশিষ্ট্যগুলির জন্য স্থানগুলি SDK সংস্করণ নম্বর (যেমন 3.5.0) এর সংমিশ্রণ দ্বারা নির্ধারিত হয় যা আপনি আপনার অ্যাপ কনফিগারেশনে নির্দিষ্ট করেছেন, আপনার API কী-তে সক্ষম APIগুলি এবং আপনি কীভাবে আপনার অ্যাপ শুরু করবেন . এই গাইডটি সংস্করণগুলির মধ্যে পার্থক্য এবং আপনার অ্যাপে কোন সংস্করণগুলি সক্ষম করা আছে তা কীভাবে নির্বাচন করবেন তা ব্যাখ্যা করে৷
SDK সংস্করণ নম্বর
আপনার অ্যাপ-স্তরের build.gradle ফাইলে আপনি যে SDK-এর ভার্সন নম্বর উল্লেখ করেছেন তা নির্ধারণ করে যে কোনও নির্দিষ্ট রিলিজে যোগ করা বৈশিষ্ট্যগুলিতে আপনার অ্যাপের অ্যাক্সেস আছে কিনা। উদাহরণস্বরূপ, স্বয়ংসম্পূর্ণ (নতুন) শুধুমাত্র SDK সংস্করণ 3.5.0 বা তার বেশি সংস্করণে উপলব্ধ।
প্রতিটি SDK সংস্করণে প্রবর্তিত পরিবর্তন সম্পর্কে আরও তথ্যের জন্য, Android রিলিজ নোটের জন্য স্থান SDK দেখুন।
Android এর জন্য Places SDK-এর জন্য এপিআই সংস্করণ
একটি SDK সংস্করণ নম্বর নির্দিষ্ট করার পাশাপাশি, আপনাকে অবশ্যই প্লেসেস API পরিষেবা নির্বাচন করতে হবে যা SDK Google ক্লাউড কনসোলে কল করে: হয় Places API বা Places API (নতুন)৷ SDK সংস্করণ নম্বরের সাথে, আপনি যে API পরিষেবাটি নির্বাচন করেন তা নির্ধারণ করে যে নির্দিষ্ট বৈশিষ্ট্যগুলির কোন সংস্করণ আপনার অ্যাপে উপলব্ধ, যেমন স্বয়ংসম্পূর্ণ বা স্বয়ংসম্পূর্ণ (নতুন)। যদিও আপনি শুধুমাত্র একটি SDK সংস্করণ নম্বর নির্দিষ্ট করতে পারেন, আপনি একই সময়ে আপনার API কী-তে Places API এবং Places API (নতুন) উভয়ই সক্ষম করতে পারেন এবং তারপরে আপনি SDK চালু করতে যে পদ্ধতিটি ব্যবহার করেন তার মাধ্যমে SDK কোন পরিষেবাটি কল করবে তা নির্বাচন করুন আপনার অ্যাপ। যাইহোক, বেশিরভাগ ক্ষেত্রে, আপনি Places API (নতুন) সক্ষম করতে এবং আপনার অ্যাপে SDK বৈশিষ্ট্যগুলির (নতুন) সংস্করণগুলি ব্যবহার করতে চাইবেন৷
আপনার SDK সংস্করণ এবং API পরিষেবাগুলি নির্বাচন করুন৷
আপনার অ্যাপে কোন SDK বৈশিষ্ট্যগুলি উপলব্ধ তা নির্বাচন করতে, নিম্নলিখিতগুলি করুন:
- আপনার Google ক্লাউড প্রজেক্টে, Places API, Places API (নতুন), বা উভয়ই সক্ষম করুন৷ আরও তথ্যের জন্য, APIs সক্ষম করুন দেখুন
- আপনার API কী বিধিনিষেধে, Places API, Places API (নতুন), বা উভয়ই সক্ষম করুন৷ আরও তথ্যের জন্য, API কী সীমাবদ্ধ করা দেখুন।
অ্যাপ-স্তরের build.gradle ফাইলে, একটি সংস্করণ নম্বর উল্লেখ করুন। আরও তথ্যের জন্য, ইনস্টলেশন দেখুন।
Places.initializeWithNewPlacesApiEnabled()অথবাPlaces.initialize()পদ্ধতিতে কল করে আপনার অ্যাপ চালু করুন।
স্থান API পরিষেবা নির্বাচন করার বিষয়ে আরও তথ্যের জন্য, আপনার Google ক্লাউড প্রকল্প সেট আপ করুন দেখুন।
প্রতিটি সংস্করণে SDK বৈশিষ্ট্য উপলব্ধ
নিম্নলিখিত সারণী দেখায় যে প্রতিটি SDK বৈশিষ্ট্যের জন্য কোন SDK এবং API সংস্করণ প্রয়োজন:
| বৈশিষ্ট্য | এপিআই কী-তে স্থান API সক্ষম করা হয়েছে | সূচনা পদ্ধতি | ন্যূনতম SDK সংস্করণ |
|---|---|---|---|
| স্বয়ংসম্পূর্ণ (নতুন) | স্থান API (নতুন) | initializeWithNewPlacesApiEnabled() | 3.5.0 |
| স্থানের বিবরণ (নতুন) | স্থান API (নতুন) | initializeWithNewPlacesApiEnabled() | 3.3.0 |
| কাছাকাছি অনুসন্ধান (নতুন) | স্থান API (নতুন) | initializeWithNewPlacesApiEnabled() | 3.5.0 |
| স্থানের ছবি (নতুন) | স্থান API (নতুন) | initializeWithNewPlacesApiEnabled() | 3.4.0 |
| পাঠ্য অনুসন্ধান (নতুন) | স্থান API (নতুন) | initializeWithNewPlacesApiEnabled() | 3.3.0 |
| স্বয়ংসম্পূর্ণ রাখুন | স্থান API | initialize() | |
| বর্তমান স্থান | স্থান API | initialize() | |
| স্থান বিবরণ | স্থান API | initialize() | |
| স্থান ফটো | স্থান API | initialize() |
কোন সংস্করণগুলি সক্ষম করতে হবে তা বেছে নেওয়ার জন্য বিবেচনা
কোন সংস্করণটি বেছে নেবেন তা সিদ্ধান্ত নিতে সাহায্য করতে নিম্নলিখিত বিবেচনা করুন:
- আপনি যদি একজন নতুন গ্রাহক হন তবে Android এর জন্য Places SDK দিয়ে শুরু করছেন, তাহলে Places API (নতুন) এবং নতুন SDK দিয়ে শুরু করুন৷
- আপনি যদি একজন বিদ্যমান গ্রাহক হন, তাহলে আপনি বিদ্যমান SDK ব্যবহার চালিয়ে যেতে পারেন। যাইহোক, Android (নতুন) এর জন্য প্লেসেস SDK-এর কর্মক্ষমতা উন্নতি এবং বৈশিষ্ট্য বর্ধনের সুবিধা নিতে, আপনার নতুন SDK ব্যবহার করা উচিত। নতুন SDK-এ যাওয়ার সময় কোনও স্থানান্তরের প্রয়োজন নেই, শুধু আপনার SDK সংস্করণ এবং API পরিষেবাগুলি নির্বাচন করুন- এর ধাপগুলি অনুসরণ করুন৷
- Android এর জন্য Places SDK-এ (নতুন), সেশন টোকেনগুলি 3.5.0 সংস্করণ থেকে পাওয়া যায়। আরও তথ্যের জন্য, সেশন টোকেন দেখুন।
- প্লেস স্বয়ংসম্পূর্ণ উইজেটগুলি ব্যবহার করে করা কলগুলিকে সর্বদা প্লেস স্বয়ংসম্পূর্ণ বলা হয়, স্থান স্বয়ংসম্পূর্ণ নয় (নতুন); উইজেট কল প্রারম্ভিক পদ্ধতি দ্বারা প্রভাবিত হয় না।
- স্থান ফটো (নতুন) শুধুমাত্র একটি বিটম্যাপ ছবিতে একটি URI ফেরত দেয়, যখন স্থান ফটো শুধুমাত্র একটি বিটম্যাপ চিত্র প্রদান করে।
- বর্তমান স্থান শুধুমাত্র Android এর জন্য স্থান SDK-এ উপলব্ধ, Android এর জন্য স্থান SDK নয় (নতুন)।
Android এর জন্য স্থান SDK-এ বর্ধিতকরণ (নতুন)
এই বিভাগে Android (নতুন) এর জন্য স্থান SDK-তে যোগ করা মূল বৈশিষ্ট্যগুলি কভার করে৷
Google ক্লাউড স্ট্যান্ডার্ড প্ল্যাটফর্মে প্রয়োগ করা হয়েছে
Android এর জন্য স্থান SDK (নতুন) Google ক্লাউডে পরিষেবা পরিকাঠামোতে প্রয়োগ করা হয়েছে। এই বাস্তবায়ন আরও নিরাপদ এবং বিশ্বস্ত প্ল্যাটফর্ম নিয়ে আসে। এই স্ট্যান্ডার্ড ডিজাইনটি SDK জুড়ে সামঞ্জস্যের একটি স্তর নিয়ে আসে যা Android (নতুন) এর জন্য স্থান SDK এর সাথে বিকাশের দক্ষতা উন্নত করে।
উন্নত কর্মক্ষমতা
Android এর জন্য স্থানগুলি SDK (নতুন) উন্নত কর্মক্ষমতা প্রদান করে, যা বিদ্যমান SDK ব্যবহার করে এমন অ্যাপগুলিকে প্রতিস্থাপন করা সার্থক করে তোলে৷
নতুন বৈশিষ্ট্য
Android এর জন্য স্থান SDK (নতুন) সমস্ত SDK বৈশিষ্ট্যগুলির সর্বশেষ সংস্করণ অন্তর্ভুক্ত করে:
- স্বয়ংসম্পূর্ণ (নতুন)
- স্থানের বিবরণ (নতুন)
- কাছাকাছি অনুসন্ধান (নতুন)
- স্থানের ছবি (নতুন)
- পাঠ্য অনুসন্ধান (নতুন)
নতুন পাঠ্য অনুসন্ধান পরিষেবা
পাঠ্য অনুসন্ধান (নতুন) একটি স্ট্রিংয়ের উপর ভিত্তি করে স্থানগুলির একটি সেট সম্পর্কে তথ্য প্রদান করে — যেমন "নিউ ইয়র্কের পিজা" বা "অটোয়ার কাছে জুতার দোকান" বা "123 প্রধান রাস্তা"। পরিষেবাটি পাঠ্য স্ট্রিংয়ের সাথে মেলে এমন স্থানগুলির একটি তালিকা এবং সেট করা যেকোন অবস্থানের পক্ষপাতের সাথে প্রতিক্রিয়া জানায়৷
স্থাপন করা বিবরণ (নতুন) এবং স্থানের ফটোতে (নতুন) নতুন প্রতিক্রিয়া ডেটা যোগ করা হয়েছে
স্থানের বিবরণ (নতুন) এখন প্রতিক্রিয়া
Placeঅবজেক্টে নতুন পর্যালোচনা ক্লাস অন্তর্ভুক্ত করে। এই ক্ষেত্রটিকে সমর্থন করার জন্য প্লেস ক্লাসে নতুনgetReviews()পদ্ধতি রয়েছে। একটি জায়গার জন্য পাঁচটি পর্যন্ত রিভিউ ফেরত দিতেgetReviews()এ কল করুন।স্থান ফটো (নতুন)
PhotoMetadataক্লাসেAuthorAttributionsযোগ করে।AuthorAttributionsএAuthorAttributionঅবজেক্টের একটিListরয়েছে।
নতুন URI প্রতিক্রিয়া স্থানের ফটোতে যোগ করা হয়েছে (নতুন)
আপনি এখন একটি ইমেজ বিটম্যাপে একটি URI ফেরত দিতে প্লেস ফটো (নতুন) ব্যবহার করতে পারেন। পূর্বে, আপনি শুধুমাত্র ইমেজ বিটম্যাপ নিজেই ফেরত দিতে পারেন।
সরলীকৃত মূল্য
Android (নতুন) এর জন্য Places SDK-এর মাধ্যমে মূল্য নির্ধারন সহজ করা হয়েছে যাতে আপনি শুধুমাত্র আপনার ব্যবহার করা ডেটার জন্য অর্থ প্রদান করেন। সরলীকৃত মূল্য ক্ষেত্র তালিকা ব্যবহার করে প্রয়োগ করা হয়, যাকে ফিল্ড মাস্কও বলা হয়।
স্থানের বিবরণ এবং পাঠ্য অনুসন্ধানের সাথে আপনি প্রতিক্রিয়াতে ফিরে আসার জন্য ক্ষেত্রগুলির তালিকা নিয়ন্ত্রণ করতে ক্ষেত্র তালিকা ব্যবহার করেন। তারপরে আপনাকে শুধুমাত্র অনুরোধ করা ডেটার জন্য বিল দেওয়া হবে। আপনি অপ্রয়োজনীয় ডেটার অনুরোধ করবেন না তা নিশ্চিত করার জন্য একটি ফিল্ড তালিকা ব্যবহার করা একটি ভাল ডিজাইন অনুশীলন, যা অপ্রয়োজনীয় প্রক্রিয়াকরণের সময় এবং বিলিং চার্জ এড়াতে সহায়তা করে।
উভয় SDK-এর বিশদ মূল্যের তথ্যের জন্য, ব্যবহার এবং বিলিং দেখুন।
প্রসারিত স্থান প্রকার
নতুন SDK নিম্নলিখিত সারণীতে দেখানো স্থানের ধরনগুলি যোগ করে৷ এই প্রকারগুলি স্থানের বিবরণ এবং পাঠ্য অনুসন্ধান প্রতিক্রিয়ার অংশ হিসাবে ফেরত দেওয়া হয়৷ আপনি পাঠ্য অনুসন্ধানের সাথে অনুসন্ধানে এই নতুন প্রকারগুলি এবং বিদ্যমান প্রকারগুলিও ব্যবহার করতে পারেন৷ নতুন প্রকারগুলি সারণি A- তে অন্তর্ভুক্ত করা হয়েছে।
| টাইপ | |||
|---|---|---|---|
| আমেরিকান_রেস্তোরাঁ | ডিসকাউন্ট_স্টোর | আইসক্রিম_শপ | স্যান্ডউইচ_শপ |
| বিনোদন_কেন্দ্র | কুকুর_পার্ক | ভারতীয়_রেস্তোরাঁ | স্কুল_জেলা |
| অ্যাথলেটিক_ফিল্ড | বৈদ্যুতিক_যান_চার্জিং_স্টেশন | ইন্দোনেশিয়ান_রেস্তোরাঁ | সীফুড_রেস্তোরাঁ |
| auto_parts_store | ঘটনা_স্থল | ইতালিয়ান_রেস্তোরাঁ | ski_resort |
| ব্যাঙ্কোয়েট_হল | বর্ধিত_থাকার_হোটেল | জাপানি_রেস্তোরাঁ | স্প্যানিশ_রেস্তোরাঁ |
| বারবিকিউ_রেস্তোরাঁ | খামার | Korean_restaurant | খেলাধুলার_সামগ্রীর_স্টোর |
| নাপিত_শপ | খামার | লেবানিজ_রেস্তোরাঁ | ক্রীড়া_ক্লাব |
| বিছানা_এবং_ব্রেকফাস্ট | ফাস্ট_ফুড_রেস্তোরাঁ | মেরিনা | ক্রীড়া_কমপ্লেক্স |
| ব্রাজিলিয়ান_রেস্তোরাঁ | ফেরি_টার্মিনাল | বাজার | স্টেক_হাউস |
| ব্রেকফাস্ট_রেস্তোরাঁ | ফিটনেস_সেন্টার | মেডিকেল_ল্যাব | সুশি_রেস্তোরাঁ |
| brunch_restaurant | ফ্রেঞ্চ_রেস্তোরাঁ | ভূমধ্যসাগরীয়_রেস্তোরাঁ | সুইমিংপুল |
| বাস_স্টপ | উপহার_শপ | mexican_restaurant | দর্জি |
| ক্যাম্পিং_কেবিন | গলফ_কোর্স | মধ্য_পূর্ব_রেস্তোরাঁ | টেলিকমিউনিকেশন_সার্ভিস_প্রোভাইডার |
| সেল_ফোন_স্টোর | গ্রীক_রেস্তোরাঁ | মোটেল | থাই_রেস্তোরাঁ |
| চাইল্ড_কেয়ার_এজেন্সি | মুদি দোকান | জাতীয়_পার্ক | ট্রানজিট_ডিপো |
| চাইনিজ_রেস্তোরাঁ | গেস্ট_হাউস | পার্ক_এন্ড_রাইড | ট্রাক_স্টপ |
| কফি_শপ | hair_salon | পারফর্মিং_আর্টস_থিয়েটার | তুর্কি_রেস্তোরাঁ |
| কমিউনিটি_সেন্টার | হ্যামবার্গার_রেস্তোরাঁ | পিজা_রেস্তোরাঁ | নিরামিষ_রেস্তোরাঁ |
| পরামর্শদাতা | হেলিপোর্ট | খেলার মাঠ | নিরামিষ_রেস্তোরাঁ |
| সম্মেলন_কেন্দ্র | হাইকিং_এরিয়া | প্রিস্কুল | ভিয়েতনামী_রেস্তোরাঁ |
| কুটির | ঐতিহাসিক_ল্যান্ডমার্ক | ব্যক্তিগত_অতিথি_রুম | ভিজিটর_সেন্টার |
| কুরিয়ার_সার্ভিস | বাড়ির_উন্নতি_স্টোর | ramen_restaurant | বিবাহের_স্থল |
| সাংস্কৃতিক_কেন্দ্র | ছাত্রাবাস | resort_hotel | পাইকারী বিক্রেতা |
| ডেন্টাল_ক্লিনিক | হোটেল | rest_stop |
এই নতুন ধরনেরগুলির সাথে, Places API (নতুন) নিম্নলিখিত প্রকারগুলিকে স্থান API-এর জন্য টেবিল 2 থেকে স্থান API (নতুন) এর জন্য টেবিল A-তে স্থানান্তরিত করেছে। তার মানে আপনি এখন অনুসন্ধানের অংশ হিসাবে এই ধরনের ব্যবহার করতে পারেন:
-
country -
administrative_area_level_1 -
administrative_area_level_2 -
postal_code -
locality