জিওকোডিং হল ঠিকানা (যেমন রাস্তার ঠিকানা) ভৌগোলিক কোঅর্ডিনেটে (অক্ষাংশ ও দ্রাঘিমাংশ) পরিবর্তন করার প্রসেস, যা আপনি ম্যাপে মার্কার বসাতে বা ম্যাপের পজিশন ঠিক করতে ব্যবহার করতে পারেন। এই ডকুমেন্টের মূল উদ্দেশ্য হল ঠিকানা জিওকোড করার সময় কোন কোন বিষয় বিবেচনা করতে হবে তা স্পষ্ট করা। এটি Geocoding API ব্যবহার করার উপযুক্ত সময় এবং Places API-এর জায়গা অটোমেটিক সম্পূর্ণ করার পরিষেবা ব্যবহার করার সুবিধাজনক সময় সম্পর্কে বর্ণনা করে।
সাধারণত, সম্পূর্ণ ঠিকানা জিওকোড করার সময় Geocoding API ব্যবহার করুন (যেমন, "48 Pirrama Rd, Pyrmont, NSW, Australia")। অস্পষ্ট (অসম্পূর্ণ) ঠিকানা জিওকোড করার সময় অথবা লেটেন্সি-সেনসিটিভ অ্যাপ্লিকেশনের জন্য, যেমন ব্যবহারকারীর ইনপুটের উত্তর দেওয়ার সময়, Places API Place Autocomplete পরিষেবা ব্যবহার করুন।
ব্যবহারের ক্ষেত্র ও API সংক্রান্ত সাজেশন
| ব্যবহার ও API সংক্রান্ত সাজেশন | |
|---|---|
| ফিজিক্যাল অ্যারাইভাল, উন্নত ডেস্টিনেশন সিলেকশন, লাস্ট-মাইল ডেলিভারি, রাইডশেয়ার পিক-আপ/ড্রপ-অফ, বিল্ডিংয়ের প্রবেশপথ বা ক্যাম্পাস নেভিগেশন | বিল্ডিংয়ের প্রবেশপথ, রুট করা যায় এমন নেভিগেশন পয়েন্ট, বিল্ডিংয়ের আউটলাইন এবং আশেপাশের ল্যান্ডমার্ক খুঁজে পেতে Geocoding API v4-এ গন্তব্য খুঁজুন (SearchDestinations) পদ্ধতি ব্যবহার করুন। জিওকোডিং পদ্ধতি বেছে নিন দেখুন। |
| ব্যবহারকারীর ইনপুটের রিয়েল-টাইম উত্তর দেওয়া (এর মধ্যে ব্যবহারকারীর লেখা অস্পষ্ট, অসম্পূর্ণ, খারাপভাবে ফর্ম্যাট করা বা ভুল বানান সহ ঠিকানা অন্তর্ভুক্ত) | কোনও জায়গার আইডি পেতে Places API-এর Place Autocomplete পরিষেবা ব্যবহার করুন, তারপর SearchDestinations (হাইপারলোকাল বিবরণের জন্য) অথবা GeocodePlace (প্রাথমিক কোঅর্ডিনেটের জন্য) কল করুন। |
| অটোমেটেড সিস্টেম সম্পূর্ণ, দ্ব্যর্থহীন, ডাক ঠিকানা প্রসেস করে (যেমন, “48 Pirrama Rd, Pyrmont, NSW, Australia”) | Geocoding API v4 ওয়েব পরিষেবা ব্যবহার করুন (হাইপারলোকাল বিবরণের জন্য SearchDestinations অথবা কোঅর্ডিনেট লুকআপের জন্য GeocodeAddress)। |
| অটোমেটেড সিস্টেম অস্পষ্ট কোয়েরি প্রসেস করছে (যেমন, অসম্পূর্ণ, ভুল ফর্ম্যাট বা ভুল বানান সহ ঠিকানা) | অটোমেটিক সিস্টেমকে Geocoding API ওয়েব সার্ভিস ব্যবহার করার সাজেশন দেওয়া হয়। তবে, ব্যবহারকারীর ইনপুট থেকে প্রাপ্ত অস্পষ্ট, অসম্পূর্ণ বা ভুল বানান সহ কোয়েরির উচ্চ হার সহ অটোমেটিক সিস্টেমগুলি ইন্টার্যাক্টিভ প্লেস অটোকমপ্লিট উইজেট যোগ করার মাধ্যমে উপকৃত হতে পারে যাতে ব্যবহারকারীরা একটি ফলাফল বেছে নিতে পারেন এবং এইভাবে কোনও ঠিকানার ভুল বানান এড়াতে পারেন। |
| ঠিকানা স্ট্রিং হিসেবে উল্লেখ করা উৎস, গন্তব্য বা ওয়েপয়েন্ট সহ Directions API (পুরনো) বা Distance Matrix API (পুরনো) ব্যবহার করার সময় লেটেন্সি সংক্রান্ত সমস্যা | Places API-এর Place Autocomplete পরিষেবা ব্যবহার করে জায়গার আইডি পান, তারপর সেই আইডি Directions API (Legacy) বা Distance Matrix API (Legacy)-তে পাস করুন। এর ফলে জিওকোডিং লেটেন্সি কমে যাবে। |
ব্যবহারকারীর ইনপুটের উত্তর দিন
ব্যবহারকারীর ইনপুটে রিয়েল-টাইমে উত্তর দেয় এমন অ্যাপ্লিকেশনের ক্ষেত্রে দুটি প্রধান বিষয় বিবেচনা করতে হয় যা API বেছে নেওয়ার ক্ষেত্রে প্রভাব ফেলে:
- ব্যবহারকারীর ইনপুটে সাধারণত একটি ঠিকানা ধীরে ধীরে লিখতে হয় (যেমন "১২৩ মেইন স্ট্রিট"), তাই অসম্পূর্ণ, অস্পষ্ট ঠিকানা জিওকোড করতে পারা উপকারী কারণ এটি ব্যবহারকারীকে দ্রুত ফলাফল পেতে সাহায্য করে।
- ব্যবহারকারীর ইনপুটের ভিত্তিতে উত্তর দেয় এমন অ্যাপ্লিকেশন লেটেন্সি-সেনসিটিভ হয়।
এই দুটি বিষয় বিবেচনা করে Places API-তে জায়গা অটোমেটিক সম্পূর্ণ করার পরিষেবা ব্যবহারকারীর ইনপুটের উত্তর দেওয়ার জন্য আদর্শ। 'জায়গা অটোমেটিক সম্পূর্ণ করা' ফিচারটি একাধিক সম্ভাব্য বিকল্প দেখানোর জন্য এবং ব্যবহারকারীকে সেগুলির মধ্যে থেকে বেছে নেওয়ার অনুমতি দেওয়ার জন্য ডিজাইন করা হয়েছে। ব্যবসা বাদ দিয়ে শুধুমাত্র জিওকোড বা ঠিকানা সার্চ করার জন্য Places API-কে সীমাবদ্ধ করা যেতে পারে। এছাড়াও, অটোকমপ্লিট লুকআপ ফাংশন কোনও নির্দিষ্ট লোকেশনের জন্য ফলাফল দেখানোর ক্ষেত্রে পক্ষপাতদুষ্ট হতে পারে। Places API একটি প্লেস আইডি রিটার্ন করে যা Geocoding API ওয়েব সার্ভিসে সম্পূর্ণ দ্ব্যর্থহীন লোকেশন হিসেবে পাস করা যেতে পারে, যা পরে সম্পূর্ণ ঠিকানার বিবরণ রিটার্ন করে এবং ঠিকানাটি latlng-এ জিওকোড করে। এছাড়াও, জায়গার আইডি অন্যান্য API-তে পাস করা যেতে পারে, যেমন Directions API (Legacy) এবং Distance Matrix API (Legacy) (লেটেন্সি কমান দেখুন)।
Geocoding API-তে ঠিকানা জিওকোডিংয়ের ক্ষেত্রে অনেক বেশি লেটেন্সি থাকে এবং অসম্পূর্ণ বা অস্পষ্ট কোয়েরির জন্য কম সঠিক ফলাফল দেখায়, তাই ব্যবহারকারীর ইনপুটের জন্য রিয়েল-টাইমে উত্তর দিতে হয় এমন অ্যাপ্লিকেশনের ক্ষেত্রে এটি সাজেস্ট করা হয় না।
Android, iOS, JavaScript এবং Places API-এর জন্য 'জায়গা অটোমেটিক সম্পূর্ণ করা' পরিষেবা সম্পর্কে আরও তথ্য পান।
অটোমেটেড সিস্টেম
অটোমেটেড সিস্টেম সম্পূর্ণ, দ্ব্যর্থহীন, ডাক ঠিকানা প্রসেস করছে: দ্ব্যর্থহীন কোয়েরি যেমন সম্পূর্ণ ডাক ঠিকানা স্ট্রিং (যেমন, "48 Pirrama Rd, Pyrmont, NSW, Australia") Geocoding API ওয়েব পরিষেবা সবচেয়ে ভালোভাবে ম্যানেজ করে। অ্যাড্রেস জিওকোডিং ব্যাকএন্ড বিশ্বব্যাপী আরও বেশি অ্যাড্রেস কভার করে এবং এই ধরনের সম্পূর্ণ, দ্ব্যর্থহীন কোয়েরির জন্য খুব ভাল কোয়ালিটির ফলাফল দেখানোর জন্য অপ্টিমাইজ করা হয়েছে।
অটোমেটিক সিস্টেম অস্পষ্ট কোয়েরি প্রসেস করছে: অস্পষ্ট কোয়েরি হল সেগুলি যেগুলিতে খারাপভাবে ফর্ম্যাট করা ঠিকানা, অসম্পূর্ণ ঠিকানা বা বানান ভুল থাকে। অটোমেটিক সিস্টেমের জন্য, আমরা Geocoding API ওয়েব পরিষেবা ব্যবহার করার সাজেশন দিই। তবে, Geocoding API অস্পষ্ট কোয়েরি সামলানোর জন্য ডিজাইন করা হয়নি এবং অস্পষ্ট কোয়েরির উত্তরে কম সঠিক ফলাফল বা কোনও ফলাফল নাও দেখাতে পারে। আপনার অটোমেটিক সিস্টেম যদি ব্যবহারকারীর ইনপুট থেকে প্রাপ্ত অস্পষ্ট কোয়েরি প্রচুর পরিমাণে প্রসেস করে, তাহলে Places API-তে জায়গা অটোমেটিক সম্পূর্ণ করার পরিষেবা ব্যবহার করে আপনার অ্যাপে একটি ইন্টার্যাক্টিভ এলিমেন্ট যোগ করলে আপনি উপকৃত হতে পারেন, কারণ এটি একাধিক সম্ভাব্য বিকল্প দেখানোর জন্য এবং ব্যবহারকারীকে সেগুলির মধ্যে থেকে বেছে নেওয়ার অনুমতি দেওয়ার জন্য ডিজাইন করা হয়েছে। Places API একটি প্লেস আইডি রিটার্ন করে যা Geocoding API ওয়েব সার্ভিসে সম্পূর্ণ দ্ব্যর্থহীন লোকেশন হিসেবে পাস করা যেতে পারে, যা তারপর সম্পূর্ণ ঠিকানার বিবরণ রিটার্ন করে এবং ঠিকানাটি latlng-এ জিওকোড করে। Android, iOS, JavaScript এবং Places API-এর জন্য 'জায়গা অটোমেটিক সম্পূর্ণ করা' পরিষেবা সম্পর্কে আরও তথ্য পান।
Directions API (Legacy) এবং Distance Matrix API (Legacy)-এর জন্য লেটেন্সি কমান
শুরু, গন্তব্য বা ওয়েপয়েন্ট অ্যাড্রেস স্ট্রিং হিসেবে উল্লেখ করা হলে, Directions API (Legacy) এবং Distance Matrix API (Legacy) দিকনির্দেশ গণনা করার আগে এইসব অ্যাড্রেস জিওকোড করার জন্য Geocoding API-এর মতো একই ব্যাকএন্ড ব্যবহার করে। এটি latlngs বা প্লেস আইডি হিসেবে একই লোকেশন নির্দিষ্ট করার তুলনায় লেটেন্সি উল্লেখযোগ্যভাবে বৃদ্ধি করে।
আপনার অ্যাপ্লিকেশন যদি লেটেন্সি-সংবেদনশীল পরিস্থিতিতে Directions API (Legacy) বা Distance Matrix API (Legacy) ব্যবহার করে, যেমন ব্যবহারকারীর ইনপুটের উত্তর দেওয়া এবং আপনার উৎস, গন্তব্য বা ওয়েপয়েন্ট প্রাথমিকভাবে অ্যাড্রেস স্ট্রিং হিসেবে নির্দিষ্ট করা থাকে, তাহলে আমরা সাজেস্ট করি যে আপনি Places API-এর Place Autocomplete পরিষেবা ব্যবহার করে অ্যাড্রেস স্ট্রিংগুলিকে প্লেস আইডিতে কনভার্ট করে লেটেন্সি কম করুন, তারপর প্লেস আইডিগুলি Directions API (Legacy) বা Distance Matrix API (Legacy)-তে পাস করুন। Android, iOS, JavaScript এবং Places API-এর জন্য জায়গা অটোমেটিক সম্পূর্ণ করার পরিষেবা সম্পর্কে আরও তথ্য পান। এছাড়াও, জায়গা অটোমেটিক সম্পূর্ণ করা ও দিকনির্দেশের জাভাস্ক্রিপ্ট উদাহরণ দেখুন।
উপসংহার
আপনার ব্যবহারের উপর নির্ভর করে, আপনি Geocoding API একা ব্যবহার করতে পারেন অথবা জায়গা অটোমেটিক সম্পূর্ণ করা পরিষেবার সাথে এটি একত্রিত করতে পারেন। এটি আপনাকে এমন অ্যাপ তৈরি করতে দেয় যা সঠিক জিওকোডিং ফলাফল এবং কম লেটেন্সি অফার করে।
সমস্যা ও আবার চেষ্টা করা ম্যানেজ করুন
আপনি UNKNOWN_ERROR রেসপন্স পেলে, এগুলি ক্ষণস্থায়ী ত্রুটির কারণে হয়
এবং অল্প বিলম্বের পরে আবার চেষ্টা করে সবচেয়ে ভালভাবে সমাধান করা হয়। আমরা সাজেস্ট করি যে আপনি
Google Maps Platform ওয়েব পরিষেবা
ক্লায়েন্ট লাইব্রেরি ব্যবহার করুন, যার মধ্যে আবার চেষ্টা করার লজিক এবং Google Maps Platform প্রিমিয়াম প্ল্যান
যাচাইকরণের সুবিধা অন্তর্ভুক্ত আছে।
Google Maps পরিষেবার জন্য
Java ক্লায়েন্ট,
Python ক্লায়েন্ট,
Go ক্লায়েন্ট
এবং Node.js ক্লায়েন্ট
হল কমিউনিটি-সমর্থিত ক্লায়েন্ট লাইব্রেরি, যা GitHub-এ ডাউনলোড ও কন্ট্রিবিউট করার জন্য উপলভ্য,
যেখানে আপনি ইনস্টলেশন সংক্রান্ত নির্দেশাবলী এবং
স্যাম্পেল কোডও পাবেন।
আপনি যদি উত্তর হিসেবে OVER_QUERY_LIMIT স্ট্যাটাস কোড পান, তাহলে আপনি
API-এর জন্য ব্যবহারের সীমা অতিক্রম করেছেন। আমরা সাজেস্ট করি যে
আপনি এইসব
ব্যবহার অপ্টিমাইজেশন স্ট্র্যাটেজি ব্যবহার করে দেখুন।