কেন স্থান API ব্যবহার করুন
আপনার ব্যবহারকারীদের কাছে বিস্তারিত অবস্থান ডেটা সহজে উপলব্ধ করতে অবস্থান-সচেতন বৈশিষ্ট্যগুলি তৈরি করুন৷ Places API-এর মাধ্যমে উপলব্ধ ডেটা বাস্তব জগতের সবচেয়ে নির্ভুল, আপ-টু-ডেট এবং ব্যাপক স্থানের মডেলগুলির একটিতে তৈরি করা হয়েছে। এখানে অ্যাপ্লিকেশনগুলির জন্য উদাহরণ ব্যবহার করা হল:
- প্রধান মেট্রোপলিটন এলাকার মধ্যে কনডো ভাড়া প্রদর্শন করুন ফলাফলগুলি বিশেষভাবে শহরগুলিতে লক্ষ্য করে৷
- একটি পিকআপ বা ডেলিভারি স্ট্যাটাস আপডেটে স্থানের বিবরণ অন্তর্ভুক্ত করুন।
- ব্যবহারকারীর জমা দেওয়া ফটো এবং পর্যালোচনা সহ একটি এলাকার পার্কগুলির একটি তালিকা প্রদর্শন করুন৷
- যোগাযোগের তথ্য, রিভিউ, এবং পথের ধারে স্থাপনাগুলির জন্য মূল্য স্তর সহ ভ্রমণের পরিকল্পনা করা লোকেদের প্রদান করুন।
আপনি Places API দিয়ে কি করতে পারেন
আপনি আপনার অ্যাপ্লিকেশনগুলিতে নিম্নলিখিত বৈশিষ্ট্যগুলি অন্তর্ভুক্ত করতে Places API ব্যবহার করতে পারেন:
- বিভিন্ন ধরনের ব্যবহারকারীর প্রশ্ন থেকে স্থান অনুসন্ধান ফলাফল প্রদান করুন, যেমন টেক্সট ইনপুট, কাছাকাছি অবস্থান, এবং অস্পষ্ট বা শ্রেণীবদ্ধ ব্যবহারকারীর প্রশ্ন।
- বিভিন্ন ধরণের অনুসন্ধানের জন্য স্বয়ংসম্পূর্ণ বৈশিষ্ট্যগুলি সক্ষম করুন, হয় নির্দিষ্ট পাঠ্য প্রশ্ন বা শ্রেণীগত প্রশ্ন৷
- একটি স্থান সম্পর্কে ফেরত দেওয়া বিবরণের ধরন পরিমার্জন করুন, যেমন অপারেটিং ঘন্টা, একটি সারাংশ, ব্যবহারকারীর পর্যালোচনা এবং একটি ফটো৷
- আপনার অ্যাপ্লিকেশন দ্বারা পরিবেশিত অবস্থানে উচ্চ মানের ফটো যোগ করুন.
অনেক Google মানচিত্র প্ল্যাটফর্ম এপিআই প্লেস আইডি সমর্থন করে, যেখানে প্লেস আইডি অনন্যভাবে Google Places ডাটাবেসে এবং Google মানচিত্রে একটি স্থান চিহ্নিত করে। একটি স্থান আইডি পাওয়ার অনেক উপায় রয়েছে, যার মধ্যে রয়েছে স্থান API থেকে, কিন্তু এছাড়াও জিওকোডিং API , রুট API , এবং ঠিকানা যাচাইকরণ API থেকে।
একবার আপনার কাছে একটি জায়গার আইডি হয়ে গেলে, আপনি একটি নির্দিষ্ট স্থাপনা বা আগ্রহের স্থান, যেমন এর সম্পূর্ণ ঠিকানা, ফোন নম্বর, ব্যবহারকারীর রেটিং এবং পর্যালোচনা সম্পর্কে আরও বিশদ বিবরণের অনুরোধ করতে Places API ব্যবহার করতে পারেন৷
আপনার স্থান API এর সংস্করণ চয়ন করুন৷
Places API দুটি API সংস্করণ সমর্থন করে: Places API হল বিদ্যমান API এবং Places API (New) হল API-এর পরবর্তী প্রজন্মের সংস্করণ।
Places API (নতুন) প্রকাশের সাথে সাথে, আপনার প্রথম কাজ হল কোন API-এর সেট ব্যবহার করবেন তা নির্ধারণ করা। আপনি যদি একজন নতুন গ্রাহক হন বা ইতিমধ্যেই API ব্যবহার করে থাকেন তাহলে এটি সত্য। দুটি API-এর মধ্যে মূল পার্থক্য জানতে এই গাইডটি ব্যবহার করুন।
স্থান API কিভাবে কাজ করে
স্থান API (নতুন)
প্লেস এপিআই (নতুন) একটি নির্দিষ্ট পরিষেবার শেষ পয়েন্টের সাথে একটি স্ট্যান্ডার্ড ইউআরএল হিসাবে অনুরোধগুলি গ্রহণ করে, যেমন /places
বা places:searchText
এবং একটি JSON প্রতিক্রিয়া প্রদান করে। স্থান API (নতুন) API কী এবং OAuth টোকেন দ্বারা অনুমোদন সমর্থন করে। নিম্নলিখিত উদাহরণটি একটি API কী ব্যবহার করে একটি স্থান আইডির ঠিকানা উপাদানগুলি ফেরত দেওয়ার জন্য একটি স্থানের বিবরণ অনুরোধ করে:
https://places.googleapis.com/v1/places/GyuEmsRBfy61i59si0?fields=addressComponents &key=YOUR_API_KEY
স্থান API
Places API একটি নির্দিষ্ট পরিষেবার এন্ডপয়েন্ট সহ একটি স্ট্যান্ডার্ড URL হিসাবে অনুরোধগুলি গ্রহণ করে, যেমন /place
বা /photo
। এন্ডপয়েন্টগুলিও JSON বা XML, অনুরোধে উল্লেখ করা বিন্যাসের ধরন গ্রহণ করে। পরিষেবার অনুরোধ সেই নির্দিষ্ট শেষ পয়েন্টের সাথে প্রাসঙ্গিক পরামিতি ব্যবহার করে প্রত্যাবর্তিত ডেটা পরিমার্জন করে। নিম্নলিখিত উদাহরণটি JSON ফর্ম্যাটে একটি স্থান আইডির ঠিকানা উপাদানগুলি ফেরত দেওয়ার জন্য একটি স্থানের বিবরণ অনুরোধ করে:
https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJrTLr-GyuEmsRBfy61i59si0 &fields=address_components &key=YOUR_API_KEY
এই উদাহরণে, পরিষেবাটি অনুরোধ করা জায়গা খুঁজে পেতে এবং JSON ফর্ম্যাটে ঠিকানা উপাদানগুলি ফেরত দিতে প্রদত্ত স্থান আইডি ব্যবহার করে৷
সম্পদ
নিম্নলিখিত সারণী স্থান API-এর মাধ্যমে উপলব্ধ সংস্থানগুলিকে সংক্ষিপ্ত করে৷
স্থান API | স্থান API (নতুন) | দ্রষ্টব্য |
---|---|---|
স্থান খুঁজুন | পাঠ্য অনুসন্ধান (নতুন) | স্থান খুঁজুন এর কোন নতুন সংস্করণ নেই. পাঠ্য অনুসন্ধান (নতুন) এটি প্রতিস্থাপন করেছে। |
কাছাকাছি অনুসন্ধান | কাছাকাছি অনুসন্ধান (নতুন) | বিদ্যমান API ব্যবহার করে সমস্ত অনুরোধ যাতে একটি পাঠ্য ক্যোয়ারী অন্তর্ভুক্ত থাকে সেগুলি পাঠ্য অনুসন্ধান (নতুন) ব্যবহার করা উচিত কারণ কাছাকাছি অনুসন্ধান (নতুন) পাঠ্য ইনপুট সমর্থন করে না। |
পাঠ্য অনুসন্ধান | পাঠ্য অনুসন্ধান (নতুন) | |
স্থান বিবরণ | স্থানের বিবরণ (নতুন) | |
স্থান ফটো | স্থানের ছবি (নতুন) | |
স্বয়ংসম্পূর্ণ রাখুন | স্বয়ংসম্পূর্ণ (নতুন) | |
স্বয়ংসম্পূর্ণ ক্যোয়ারী | স্বয়ংসম্পূর্ণ (নতুন) | স্বয়ংসম্পূর্ণ (নতুন) তে সক্ষমতা যোগ করা হয়েছে |
কিভাবে Places API ব্যবহার করবেন
নীচের পদক্ষেপগুলি স্থান API পরিষেবা ব্যবহার করার জন্য একটি সাধারণ ব্যবহারের ক্ষেত্রে পরিস্থিতি কভার করে৷ আপনি আপনার সমাধান তৈরি করার সাথে সাথে আপনি অতিরিক্ত শেষ পয়েন্টগুলি ব্যবহার করতে পারেন, যেমন কাছাকাছি অনুসন্ধান এবং স্থানের ফটোগুলি৷1 | সেট আপ করুন | আপনার Google ক্লাউড প্রকল্প সেট আপ দিয়ে শুরু করুন এবং অনুসরণ করা সেটআপ নির্দেশাবলী সম্পূর্ণ করুন এবং তারপর আপনার API কী কীভাবে ব্যবহার করবেন তা শিখুন। Places API (নতুন), আপনি OAuth টোকেনও ব্যবহার করতে পারেন। |
2 | একটি মৌলিক পাঠ্য অনুসন্ধান চেষ্টা করুন | পাঠ্য অনুসন্ধান (নতুন) বা পাঠ্য অনুসন্ধান ব্যবহার করে একটি সাধারণ পাঠ্য অনুসন্ধান ইস্যু করুন। |
3 | আরো বিস্তারিত জানার জন্য জায়গা আইডি ব্যবহার করুন | অনেক Google মানচিত্র প্ল্যাটফর্ম API একটি প্রতিক্রিয়ার অংশ হিসাবে একটি স্থান আইডি প্রদান করে। একটি স্থান সম্পর্কে বিশদ বিবরণ পেতে স্থান আইডি ব্যবহার করুন. স্থানের বিবরণ (নতুন) এবং স্থানের বিবরণ দেখুন। |
4 | একটি জায়গার জন্য একটি ফটো পান | প্লেস ফটো পরিষেবা আপনাকে স্থান ডেটাবেসে সঞ্চিত লক্ষ লক্ষ ফটোতে অ্যাক্সেস দেয়৷ একটি স্থানের ফটোগুলি অ্যাক্সেস করতে স্থানের ছবি (নতুন) বা স্থানের বিবরণ ব্যবহার করুন৷ |