Places API দুটি API সংস্করণ সমর্থন করে: Places API হল বিদ্যমান API এবং Places API (New) হল API-এর পরবর্তী প্রজন্মের সংস্করণ।
Places API (নতুন) প্রকাশের সাথে সাথে, আপনার প্রথম কাজ হল কোন API-এর সেট ব্যবহার করবেন তা নির্ধারণ করা। আপনি যদি একজন নতুন গ্রাহক হন বা ইতিমধ্যেই API ব্যবহার করে থাকেন তাহলে এটি সত্য। দুটি API-এর মধ্যে মূল পার্থক্য বুঝতে এই গাইডটি ব্যবহার করুন।
API-এর তালিকা
নিম্নলিখিত সারণী API-এর উভয় সেটের তালিকা করে। আপনি যদি একজন বিদ্যমান গ্রাহক হন, তাহলে নতুন API নির্ধারণ করতে এই টেবিলটি ব্যবহার করুন যা আপনি বর্তমানে ব্যবহার করছেন এমন একটি API প্রতিস্থাপন করে।
| স্থান API | স্থান API (নতুন) | দ্রষ্টব্য |
|---|---|---|
| স্থান খুঁজুন | পাঠ্য অনুসন্ধান (নতুন) | স্থান খুঁজুন এর কোন নতুন সংস্করণ নেই. পাঠ্য অনুসন্ধান (নতুন) এটি প্রতিস্থাপন করেছে। |
| কাছাকাছি অনুসন্ধান | কাছাকাছি অনুসন্ধান (নতুন) | বিদ্যমান API ব্যবহার করে সমস্ত অনুরোধ যাতে একটি পাঠ্য ক্যোয়ারী অন্তর্ভুক্ত থাকে সেগুলি পাঠ্য অনুসন্ধান (নতুন) ব্যবহার করা উচিত কারণ কাছাকাছি অনুসন্ধান (নতুন) পাঠ্য ইনপুট সমর্থন করে না। |
| পাঠ্য অনুসন্ধান | পাঠ্য অনুসন্ধান (নতুন) | |
| স্থান বিবরণ | স্থানের বিবরণ (নতুন) | |
| স্থান ফটো | স্থানের ছবি (নতুন) | |
| স্বয়ংসম্পূর্ণ রাখুন | স্বয়ংসম্পূর্ণ (নতুন) | |
| স্বয়ংসম্পূর্ণ ক্যোয়ারী | স্বয়ংসম্পূর্ণ (নতুন) | স্বয়ংসম্পূর্ণ (নতুন) তে সক্ষমতা যোগ করা হয়েছে |
স্থান API পরিষেবার সংস্করণ যা আপনি আপনার API কী-তে সক্ষম করেন তা আপনার অ্যাপ দ্বারা ব্যবহৃত APIগুলিকে নিয়ন্ত্রণ করে:
স্থান API : বিদ্যমান API সক্রিয় করে। আপনার অ্যাপের জন্য ব্যবহৃত API কী-এর সাথে যুক্ত প্রকল্পের জন্য শুধুমাত্র Places API সক্ষম করা থাকলে, আপনার অ্যাপের নতুন API-এ অ্যাক্সেস থাকবে না।
Places API (নতুন) : iOS (নতুন) এর জন্য Places SDK-তে যোগ করা মূল বৈশিষ্ট্যগুলিতে বর্ণিত সমস্ত নতুন API এবং বৈশিষ্ট্যগুলিকে সক্ষম করে৷ আপনার অ্যাপের বিদ্যমান এপিআই-এ অ্যাক্সেস থাকবে না।
উভয়ই : iOS এর জন্য স্থান SDK (নতুন) এবং iOS এর জন্য স্থান SDK উভয়ের জন্য সমস্ত বৈশিষ্ট্য এবং API সক্ষম করে৷
স্থান API পরিষেবা নির্বাচন করার বিষয়ে আরও তথ্যের জন্য, আপনার Google ক্লাউড প্রকল্প সেট আপ করুন দেখুন।
নতুন API-এ স্থানান্তর করুন
আপনি যদি একটি বিদ্যমান API ব্যবহার করেন এবং নতুন API-এ স্থানান্তর করতে চান তবে প্রতিটি API-এর জন্য নিম্নলিখিত মাইগ্রেশন নির্দেশিকাগুলি দেখুন:
- কাছাকাছি অনুসন্ধানে স্থানান্তরিত করুন (নতুন)
- পাঠ্য অনুসন্ধানে স্থানান্তর করুন (নতুন)
- স্থানের বিবরণে স্থানান্তর করুন (নতুন)
- স্থানের ফটোতে স্থানান্তর করুন (নতুন)
- স্বয়ংসম্পূর্ণ (নতুন) এ স্থানান্তর করুন
স্থান API (নতুন) তে মূল বৈশিষ্ট্য যোগ করা হয়েছে
এই বিভাগে স্থান API (নতুন) যোগ করা মূল বৈশিষ্ট্যগুলি কভার করে৷
Google ক্লাউড স্ট্যান্ডার্ড প্ল্যাটফর্মে প্রয়োগ করা হয়েছে
Places API (নতুন) Google ক্লাউডে পরিষেবা পরিকাঠামোতে প্রয়োগ করা হয়েছে। এই বাস্তবায়নটি OAuth-এর মতো উন্নত নিরাপত্তা বিকল্প সহ আরও নিরাপদ এবং বিশ্বস্ত প্ল্যাটফর্ম নিয়ে আসে। এই স্ট্যান্ডার্ড এপিআই ডিজাইনটি এপিআই জুড়ে ধারাবাহিকতার একটি স্তর নিয়ে আসে যা প্লেসেস এপিআই (নতুন) এর সাথে বিকাশের দক্ষতা উন্নত করে।
উন্নত কর্মক্ষমতা
প্লেসেস এপিআই (নতুন) উন্নত কর্মক্ষমতা প্রদান করে, যা বিদ্যমান Places API ব্যবহার করে এমন অ্যাপগুলিকে প্রতিস্থাপন করা সার্থক করে তোলে।
সরলীকৃত মূল্য
প্লেস এপিআই (নতুন) দিয়ে দাম সরলীকৃত করা হয়েছে যাতে আপনি শুধুমাত্র আপনার ব্যবহার করা ডেটার জন্য অর্থ প্রদান করেন। সরলীকৃত মূল্য একটি ফিল্ড মাস্ক ব্যবহার করে প্রয়োগ করা হয়।
স্থানের বিশদ বিবরণ (নতুন), কাছাকাছি অনুসন্ধান (নতুন), এবং পাঠ্য অনুসন্ধান (নতুন) সহ আপনি প্রতিক্রিয়ায় ফিরে আসার জন্য ক্ষেত্রগুলির তালিকা নিয়ন্ত্রণ করতে ফিল্ড মাস্ক ব্যবহার করেন। তারপরে আপনাকে শুধুমাত্র অনুরোধ করা ডেটার জন্য বিল দেওয়া হবে। আপনি অপ্রয়োজনীয় ডেটার অনুরোধ করবেন না তা নিশ্চিত করার জন্য ফিল্ড মাস্কিং ব্যবহার করা একটি ভাল ডিজাইন অনুশীলন, যা অপ্রয়োজনীয় প্রক্রিয়াকরণের সময় এবং বিলিং চার্জ এড়াতে সহায়তা করে।
একটি স্থানের জন্য ধারাবাহিক প্রতিক্রিয়া ডেটা
বিদ্যমান APIগুলির সাথে, স্থানের বিশদ বিবরণ, কাছাকাছি অনুসন্ধান, এবং পাঠ্য অনুসন্ধান APIগুলি একটি স্থানের জন্য বিভিন্ন প্রতিক্রিয়া ডেটা প্রদান করে৷ প্লেসেস এপিআই (নতুন) রেসপন্সকে স্ট্যান্ডার্ডাইজ করে তাই এই এপিআই সব একটি জায়গার জন্য একই ডেটা ফেরত দেয়।
প্রসারিত স্থান প্রকার
API প্রতিক্রিয়াতে এখন একটি স্থানের প্রাথমিক প্রকার থাকতে পারে। প্রতিটি স্থানের একটি একক টাইপ মান থাকতে পারে যা স্থানের প্রাথমিক প্রকার হিসাবে নির্দিষ্ট করা হয়, যেমনটি টেবিল A- তে তালিকাভুক্ত।
এছাড়াও, নতুন API নীচের সারণীতে দেখানো স্থানের প্রকারগুলি যোগ করে৷ আপনি কাছাকাছি অনুসন্ধান (নতুন) এবং পাঠ্য অনুসন্ধান (নতুন) এর সাথে অনুসন্ধানে এই নতুন প্রকারগুলি এবং বিদ্যমান প্রকারগুলি ব্যবহার করতে পারেন৷ নতুন প্রকারগুলি সমস্ত সারণি 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
গতিশীল স্থান ডেটা
প্লেস এপিআই (নতুন) গতিশীল প্রতিক্রিয়া ডেটা সমর্থন করে, যেমন একটি EV চার্জিং স্টেশনের প্রাপ্যতা বা একটি গ্যাস স্টেশনের জন্য সর্বশেষ জ্বালানির দাম। গতিশীল ব্যবহারকারীর অভিজ্ঞতা তৈরি করতে এই প্রতিক্রিয়া ক্ষেত্রগুলি ব্যবহার করুন।
আপনি কোন API নির্বাচন করবেন?
আপনি অ্যাপ ডেভেলপমেন্ট শুরু করার আগে, আপনাকে অবশ্যই আপনার API বেছে নিতে হবে:
আপনি যদি একজন নতুন গ্রাহক হয়ে থাকেন সবেমাত্র Places API দিয়ে শুরু করছেন, তাহলে নতুন API দিয়ে শুরু করুন।
আপনি যদি একজন নতুন গ্রাহক হন এবং এখনও একটি বিদ্যমান API-এর প্রতিস্থাপন না করা হয় , যেমন Place Autocomplete বা Query Autocomplete, তাহলে আপনি নতুন এবং বিদ্যমান APIগুলির সংমিশ্রণ ব্যবহার করতে পারেন৷
আপনি যদি একজন বিদ্যমান গ্রাহক হন, তাহলে আপনি বিদ্যমান API ব্যবহার চালিয়ে যেতে পারেন। যাইহোক, প্লেসেস এপিআই (নতুন) এর পারফরম্যান্সের উন্নতি এবং বৈশিষ্ট্য বর্ধনের সুবিধা নিতে, আপনি নতুন এপিআইগুলিতে স্থানান্তর করতে পারেন।
মাইগ্রেশন সম্পর্কে আরও তথ্যের জন্য, মাইগ্রেশন ওভারভিউ দেখুন।