ভূমিকা
অ্যাড্রেস ভ্যালিডেশন এপিআই হলো একটি পরিষেবা যা একটি ঠিকানা গ্রহণ করে। এটি ঠিকানার উপাদানগুলো শনাক্ত করে এবং সেগুলোকে যাচাই করে। এটি চিঠিপত্র পাঠানোর জন্য ঠিকানাটিকে একটি নির্দিষ্ট মানে নিয়ে আসে এবং এর জন্য সবচেয়ে পরিচিত অক্ষাংশ/দ্রাঘিমাংশের স্থানাঙ্ক খুঁজে বের করে। ঐচ্ছিকভাবে, মার্কিন যুক্তরাষ্ট্র এবং পুয়ের্তো রিকোর ঠিকানার জন্য, আপনি কোডিং অ্যাকুরেসি সাপোর্ট সিস্টেম (CASS™) সক্রিয় করতে পারেন।কেন অ্যাড্রেস ভ্যালিডেশন এপিআই ব্যবহার করবেন
অ্যাড্রেস ভ্যালিডেশন এপিআই-এর মাধ্যমে, আপনি ডেলিভারির পূর্বাভাসযোগ্যতা উন্নত করতে এবং ডেলিভারি ব্যর্থতা কমাতে পারেন, যার ফলে গ্রাহক অভিজ্ঞতা আরও উন্নত হয়। ভুল ঠিকানা শনাক্ত করে এবং ঠিকানার বৈশিষ্ট্য সম্পর্কে আরও ভালোভাবে জেনে আপনি এটি করতে পারেন।
অন্যান্য বিবেচ্য বিষয়
অ্যাড্রেস ভ্যালিডেশন এপিআই ঠিকানার সঠিকতা যাচাই করে। জিওকোডিং এপিআই ঠিকানাগুলোকে অক্ষাংশ ও দ্রাঘিমাংশ স্থানাঙ্কে রূপান্তর করে । বিস্তারিত তুলনার জন্য আর্কিটেকচার সেন্টারে ‘গুগল ম্যাপস প্ল্যাটফর্ম ব্যবহার করে ভবনের অবস্থান যাচাইকরণ ক্ষমতা’ দেখুন।
যদি আপনার ঠিকানার প্রতিটি অংশ আলাদাভাবে যাচাই করার প্রয়োজন না হয়, অথবা যদি আপনার অতি-স্থানীয় গন্তব্যের বিবরণ, যেমন—ভবনের প্রবেশপথ, ভবনের রূপরেখা এবং দিকনির্দেশনা বিন্দুর প্রয়োজন হয়, তাহলে জিওকোডিং এপিআই আপনার প্রয়োজনের জন্য আরও উপযুক্ত হতে পারে।
জিওকোডিং এপিআই ভি৪-এ SearchDestinations মেথডটি চালু করা হয়েছে, যা ভবনের প্রবেশপথ, নেভিগেশন পয়েন্ট এবং ভবনের রূপরেখার স্থানাঙ্ক ফেরত দেয়। আরও বিস্তারিত জানতে জিওকোডিং এপিআই ভি৪-এর ‘গন্তব্য অনুসন্ধান’ অংশটি দেখুন।
অ্যাড্রেস ভ্যালিডেশন এপিআই দিয়ে আপনি যা করতে পারেন
অ্যাড্রেস ভ্যালিডেশন এপিআই (Address Validation API) ব্যবহার করে আপনি যাচাই করতে পারবেন যে কোনো ঠিকানা একটি বাস্তব স্থানের কিনা। যদি ঠিকানাটি কোনো বাস্তব স্থানের না হয়, তবে এপিআইটি সম্ভাব্য ভুল উপাদানগুলো শনাক্ত করতে পারে, যা আপনি আপনার গ্রাহকদের কাছে সংশোধনের জন্য উপস্থাপন করতে পারেন। এপিআই ব্যবহার করে একটি নমুনা কর্মপ্রবাহ নিচে দেওয়া হলো:
গ্রাহক ঠিকানা প্রবেশ করান – নিচের ছবিতে একটি সাধারণ ফর্ম দেখানো হয়েছে, যা গ্রাহককে ঠিকানা প্রবেশ করানোর সুযোগ দেয়, সম্ভবত চেকআউট প্রক্রিয়ার একটি অংশ হিসেবে।
অ্যাপটি এপিআই-তে ঠিকানা পাঠায় – অ্যাপ্লিকেশনটি এই ঠিকানাটিকে অ্যাড্রেস ভ্যালিডেশন এপিআই-এর ইনপুট হিসেবে প্রেরণ করে।
এপিআই ঠিকানা যাচাই ও মানসম্মত করে – অ্যাড্রেস ভ্যালিডেশন এপিআই তার প্রতিক্রিয়ায়, এপিআই দ্বারা নির্ধারিত সম্পূর্ণ ঠিকানাটি ফেরত দেয়, অথবা কোথায় তথ্য অনুপস্থিত তা নির্দেশ করে।
গ্রাহক ঠিকানা নিশ্চিত বা সংশোধন করেন – এপিআই (API) থেকে প্রাপ্ত তথ্যের উপর নির্ভর করে, আপনি গ্রাহককে নিম্নলিখিত নির্দেশাবলী প্রদান করতে পারেন: ক. প্রস্তাবিত ঠিকানাটি নিশ্চিত করুন। খ. অনুপস্থিত তথ্য প্রদান করুন। গ. ঠিকানাটি সংশোধন করুন।
অ্যাড্রেস ভ্যালিডেশন এপিআই কীভাবে কাজ করে
ঠিকানা যাচাইকরণ প্রক্রিয়াটি JSON বডি আকারে ঠিকানা সহ একটি POST অনুরোধ গ্রহণ করে। এটি ঠিকানাটিকে তার স্বতন্ত্র উপাদানগুলিতে বিভক্ত করে এবং তারপর নিম্নলিখিত পদক্ষেপগুলি গ্রহণ করার চেষ্টা করে:
- সংশোধন করে — উপাদান-স্তরের বৈধতা যাচাই প্রদান করে, যেখানে উপলব্ধ থাকলে উপ-প্রাঙ্গণও অন্তর্ভুক্ত থাকে।
- সম্পূর্ণ করে — ঠিকানার অনুপস্থিত বা ভুল উপাদানগুলো অনুমান করার প্রচেষ্টা।
- ফরম্যাট — ঠিকানার উপাদানগুলোর ফরম্যাটকে পরিমার্জিত ও মানসম্মত করে।
সম্পদ
নিম্নলিখিত সারণিতে অ্যাড্রেস ভ্যালিডেশন এপিআই (Address Validation API)-এর মাধ্যমে উপলব্ধ রিসোর্সসমূহ এবং এর দ্বারা প্রদত্ত ডেটার একটি সারসংক্ষেপ দেওয়া হয়েছে। নির্দিষ্ট বিবরণের জন্য, অ্যাড্রেস ভ্যালিডেশন এপিআই রেফারেন্স (Address Validation API reference ) দেখুন।
| ডেটা রিসোর্স | ফেরত আসা ডেটা |
|---|---|
JSON ফরম্যাটে ঠিকানার উপাদানসমূহ। ঠিকানা যাচাই করুন দেখুন। | সম্পূর্ণ ও যাচাইকৃত ঠিকানা (যদি সম্ভব হয়)। ঠিকানার প্রতিটি উপাদানের বৈধতার অবস্থা। ঠিকানার জন্য যেখানে উপলব্ধ:
|
অ্যাড্রেস ভ্যালিডেশন এপিআই কীভাবে ব্যবহার করবেন
| ১ | ডেমোটি চেষ্টা করে দেখুন | সঠিক ও ভুল উভয় ধরনের বিভিন্ন ঠিকানা ফর্ম ব্যবহার করে ডেমোটি অন্বেষণ করুন । এই ডেমোটি সার্ভিস থেকে প্রাপ্ত রিটার্ন ভ্যালু এবং JSON ফরম্যাটে থাকা API রেসপন্স, উভয়ই পরখ করে দেখার একটি কার্যকর উপায়। |
| ২ | কভারেজ পরীক্ষা করুন | অ্যাড্রেস ভ্যালিডেশন এপিআই কোন কোন দেশ ও অঞ্চলকে সমর্থন করে তা দেখতে কভারেজের বিবরণ পর্যালোচনা করুন। |
| ৩ | প্রস্তুত হন | আপনার গুগল ক্লাউড প্রজেক্ট সেট আপ করার মাধ্যমে শুরু করুন এবং পরবর্তী নির্দেশাবলী সম্পূর্ণ করুন। |
| ৪ | ঠিকানা যাচাইকরণের জন্য অনুরোধ করুন | একটি সাধারণ ঠিকানা দিয়ে শুরু করুন এবং তারপর, অতিরিক্ত নির্ভুলতার জন্য, আপনি CASS সক্রিয় করতে পারেন (শুধুমাত্র মার্কিন যুক্তরাষ্ট্র এবং পিআর ঠিকানার জন্য)। ঠিকানা যাচাইকরণের অনুরোধ দেখুন। |
| ৫ | একটি প্রতিক্রিয়া প্রক্রিয়া করুন | অ্যাড্রেস ভ্যালিডেশন এপিআই রেসপন্স দুটি প্রপার্টি প্রদান করে, যেগুলোর প্রতিটি ভিন্ন ভিন্ন উপায়ে ব্যবহার করা হয়। একটি বেসিক রেসপন্স বুঝুন দেখুন। |
| ৬ | যাচাইকরণের নির্ভুলতা উন্নত করুন | অ্যাড্রেস ভ্যালিডেশন এপিআই (Address Validation API) রেসপন্সের উপর মতামত দিয়ে আপনি ঠিকানার নির্ভুলতা উন্নত করতে সাহায্য করতে পারেন। আপডেট করা ঠিকানাগুলি কীভাবে সামলাবেন তা দেখুন। |
উপলব্ধ ক্লায়েন্ট লাইব্রেরি
অ্যাড্রেস ভ্যালিডেশন এপিআই-এর জন্য উপলব্ধ ক্লায়েন্ট লাইব্রেরিগুলির তালিকার জন্য, ক্লায়েন্ট লাইব্রেরিগুলি দেখুন।
CASS™ সম্পর্কে
ইউনাইটেড স্টেটস পোস্টাল সার্ভিস® ( USPS® ) ঠিকানা যাচাইকরণ প্রদানকারীদের সহায়তা ও প্রত্যয়ন করার জন্য কোডিং অ্যাকুরেসি সাপোর্ট সিস্টেম (CASS™) পরিচালনা করে। অ্যাড্রেস ভ্যালিডেশন এপিআই-এর মতো একটি CASS সার্টিফাইড™ পরিষেবা, ঠিকানা থেকে অনুপস্থিত তথ্য পূরণ করতে, সেটিকে মানসম্মত করতে এবং আপনাকে সবচেয়ে সাম্প্রতিক ও নির্ভুল ঠিকানা দেওয়ার জন্য আপডেট করার ক্ষমতার জন্য নিশ্চিত করা হয়েছে।
CASS ডিফল্টরূপে সক্রিয় থাকে না এবং এটি শুধুমাত্র "US" এবং "PR" অঞ্চলের জন্য সমর্থিত। CASS সক্রিয় করতে, একটি ভ্যালিডেশন অনুরোধের অংশ হিসাবে enableUspsCass true তে সেট করুন। আরও তথ্যের জন্য, "একটি ঠিকানা যাচাই করুন " দেখুন।
USPS পরিষেবা ব্যবহারের অংশ হিসেবে, USPS কৃত্রিমভাবে তৈরি করা ঠিকানার অনুরোধগুলো মূল্যায়ন করে। যদি USPS কোনো ইনপুট ঠিকানাকে কৃত্রিমভাবে তৈরি করা হিসেবে শনাক্ত করে, তাহলে Google সেই গ্রাহকের জন্য ঠিকানা যাচাই করা বন্ধ করতে বাধ্য থাকবে এবং গ্রাহকের যোগাযোগের তথ্য (নাম ও ঠিকানা), প্রাসঙ্গিক ইনপুট ঠিকানা এবং সামগ্রিক ব্যবহারের ডেটা USPS-কে জানাতে হবে। API ব্যবহার করার মাধ্যমে আপনি এই পরিষেবা-নির্দিষ্ট শর্তাবলীতে সম্মতি দিচ্ছেন।
এরপর কী?
- ডেমোটি ব্যবহার করে দেখুন : ডেমোতে যান
- কভারেজ এলাকা পর্যালোচনা করুন : দেশ ও অঞ্চলের কভারেজ বিবরণে যান
- আপনার প্রথম যাচাইকরণ অনুরোধটি চেষ্টা করুন : ঠিকানা যাচাইকরণ অনুরোধ পাঠান -এ যান।
- বিপুল পরিমাণে ঠিকানা প্রক্রিয়া করুন : বিপুল পরিমাণে ঠিকানা প্রক্রিয়া করতে অ্যাড্রেস ভ্যালিডেশন এপিআই (Address Validation API) ব্যবহার করুন।
গুগল ম্যাপস প্ল্যাটফর্ম হলো ইউনাইটেড স্টেটস পোস্টাল সার্ভিস®-এর একজন নন-এক্সক্লুসিভ লাইসেন্সধারী। নিম্নলিখিত ট্রেডমার্ক(গুলি) ইউনাইটেড স্টেটস পোস্টাল সার্ভিস®-এর মালিকানাধীন এবং অনুমতিক্রমে ব্যবহৃত হয়: ইউনাইটেড স্টেটস পোস্টাল সার্ভিস®, CASS™, CASS সার্টিফাইড™। ↩