ঠিকানা যাচাইকরণ API ওভারভিউ

Address Validation Overview

ঠিকানা যাচাইকরণ API হল একটি পরিষেবা যা একটি ঠিকানা গ্রহণ করে। এটি ঠিকানা উপাদান সনাক্ত করে এবং তাদের যাচাই করে। এটি মেল করার জন্য ঠিকানাটিকেও প্রমিত করে এবং এটির জন্য সর্বোত্তম পরিচিত অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্ক খুঁজে পায়। ঐচ্ছিকভাবে, মার্কিন যুক্তরাষ্ট্র এবং পুয়ের্তো রিকোর ঠিকানাগুলির জন্য, আপনি কোডিং অ্যাকুরেসি সাপোর্ট সিস্টেম (CASS™) সক্ষম করতে পারেন৷

কেন ঠিকানা যাচাইকরণ API ব্যবহার করুন

ঠিকানা যাচাইকরণ API এর সাহায্যে, আপনি ডেলিভারির পূর্বাভাস উন্নত করতে পারেন এবং ডেলিভারি ব্যর্থতা কমাতে পারেন, যার ফলে উন্নত গ্রাহক অভিজ্ঞতা প্রদান করা হয়। আপনি খারাপ ঠিকানাগুলি ধরতে এবং ঠিকানার বৈশিষ্ট্য সম্পর্কে আরও ভাল সচেতনতা অর্জনের মাধ্যমে এটি করেন।

জিওকোডিং API আপনার প্রয়োজনের জন্য একটি ভাল মিল হতে পারে যদি আপনার পৃথক ঠিকানা উপাদানগুলিকে যাচাই করার প্রয়োজন না হয়। জিওকোডিং API ঠিকানাগুলিকে অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্কে রূপান্তর করে, যেখানে ঠিকানা যাচাইকরণ API ঠিকানাগুলিকে সঠিকতার জন্য যাচাই করে। বিশদ তুলনার জন্য আর্কিটেকচার সেন্টারে Google মানচিত্র প্ল্যাটফর্ম ব্যবহার করে অবস্থান যাচাইকরণের ক্ষমতা দেখুন।

আপনি ঠিকানা যাচাইকরণ API দিয়ে কি করতে পারেন

ঠিকানা যাচাইকরণ API এর সাহায্যে, আপনি নির্ধারণ করতে পারেন যে ঠিকানাটি একটি আসল স্থানকে নির্দেশ করে কিনা। যদি ঠিকানাটি একটি বাস্তব স্থানের উল্লেখ না করে, তাহলে API সম্ভবত ভুল উপাদান সনাক্ত করতে পারে যা আপনি আপনার গ্রাহকদের সংশোধন করতে উপস্থাপন করতে পারেন। API ব্যবহার করে এখানে একটি নমুনা ওয়ার্কফ্লো রয়েছে:

  1. গ্রাহক একটি ঠিকানা প্রবেশ করান - নিম্নলিখিত চিত্রটি একটি সাধারণ ফর্ম দেখায় যা একটি গ্রাহককে একটি ঠিকানা প্রবেশ করতে দেয়, সম্ভবত একটি চেকআউট প্রবাহের অংশ হিসাবে৷
    গ্রাহকের দেওয়া ঠিকানা।

  2. অ্যাপ এপিআই-এ ঠিকানা পাঠায় - অ্যাড্রেস ভ্যালিডেশন এপিআই-তে ইনপুট হিসেবে অ্যাপ্লিকেশানটি এই ঠিকানাটি পাস করে।

  3. API ঠিকানাটিকে যাচাই করে এবং মানসম্মত করে - এর প্রতিক্রিয়াতে, ঠিকানা যাচাইকরণ API API দ্বারা নির্ধারিত সম্পূর্ণ ঠিকানা প্রদান করে, বা কোথায় তথ্য অনুপস্থিত তা নির্দেশ করে।

  4. গ্রাহক প্রস্তাবিত ঠিকানা সংশোধন করে বা নিশ্চিত করে - API কী ফেরত দেয় তার উপর নির্ভর করে, আপনি গ্রাহককে নিম্নলিখিত প্রম্পটগুলি প্রদান করতে পারেন:

    • নিশ্চিত করার জন্য গ্রাহকের জন্য একটি প্রস্তাবিত ঠিকানা উপস্থাপন করুন:
      API দ্বারা নির্ধারিত ঠিকানাটি নিশ্চিত করতে গ্রাহককে বলুন।

    • অনুপস্থিত তথ্য যোগ করার জন্য গ্রাহককে অনুরোধ করুন:
      অনুপস্থিত ঠিকানা তথ্য লিখতে গ্রাহককে অনুরোধ করুন।

    • অনুপস্থিত বা ভুল তথ্যের কারণে API ইনপুট ঠিকানা যাচাই করতে অক্ষম হলে ঠিকানাটি ঠিক করতে ব্যবহারকারীকে অনুরোধ করুন:
      ঠিকানার তথ্য ঠিক করতে গ্রাহককে অনুরোধ করুন।

ঠিকানা যাচাইকরণ API কিভাবে কাজ করে

ঠিকানা যাচাইকরণ একটি JSON বডি আকারে ঠিকানা সহ একটি POST অনুরোধ গ্রহণ করে। এটি ঠিকানাটিকে তার পৃথক উপাদানগুলিতে আলাদা করে এবং তারপরে নিম্নলিখিত চেক এবং সংশোধন করে:

  • সঠিক —উপলভ্য উপ-প্রাঙ্গণ সহ উপাদান-স্তরের বৈধতা পরীক্ষা প্রদান করে।
  • সম্পূর্ণ — অনুপস্থিত বা ভুল ঠিকানা উপাদান অনুমান করার প্রচেষ্টা।
  • ভাল-ফরম্যাট করা — ঠিকানা উপাদানগুলির জন্য বিন্যাস পরিষ্কার করে এবং মানক করে।

অ্যাড্রেস ভ্যালিডেশন এপিআই অ্যাকশনে দেখতে ডেমো ব্যবহার করে দেখুন ।

সম্পদ

নিম্নলিখিত সারণীটি ঠিকানা যাচাইকরণ API এর মাধ্যমে উপলব্ধ সংস্থানগুলির সংক্ষিপ্ত বিবরণ দেয় এবং এটি যে ডেটা প্রদান করে। নির্দিষ্ট বিবরণের জন্য, ঠিকানা যাচাইকরণ API রেফারেন্স দেখুন।

তথ্য সম্পদ ডেটা ফিরে এসেছে

JSON বিন্যাসে ঠিকানা উপাদান.

একটি ঠিকানা যাচাই দেখুন.

সম্পূর্ণ, বৈধ ঠিকানা (যদি সম্ভব হয়)।

প্রতিটি ঠিকানা উপাদানের বৈধতা অবস্থা.

যেখানে একটি ঠিকানার জন্য উপলব্ধ:

  • জিওকোড
  • ঠিকানা নির্ভুলতা
  • ডাক পরিষেবা ডেটা, যেখানে উপলব্ধ।

যাচাইকরণ প্রতিক্রিয়া বুঝতে দেখুন।

ঠিকানা যাচাইকরণ API কীভাবে ব্যবহার করবেন

1 ডেমো চেষ্টা করুন সঠিক এবং ভুল উভয় ঠিকানার বিভিন্ন ফর্ম সহ ডেমোটি অন্বেষণ করুন ৷ ডেমো পরিষেবা থেকে রিটার্ন মান এবং সেইসাথে JSON ফর্ম্যাটেড API প্রতিক্রিয়া উভয় অন্বেষণ করার জন্য একটি দরকারী উপায় প্রদান করে।
2 কভারেজ চেক করুন ঠিকানা যাচাইকরণ API কোন দেশ এবং অঞ্চলগুলিকে সমর্থন করে তা দেখতে কভারেজের বিবরণ পর্যালোচনা করুন৷
3 সেট আপ করুন আপনার Google ক্লাউড প্রকল্প সেট আপ দিয়ে শুরু করুন এবং অনুসরণ করা নির্দেশাবলী সম্পূর্ণ করুন৷
4 একটি ঠিকানা বৈধতা অনুরোধ একটি সাধারণ ঠিকানা দিয়ে শুরু করুন এবং তারপরে, অতিরিক্ত নির্ভুলতার জন্য, আপনি CASS সক্ষম করতে পারেন (শুধুমাত্র US এবং PR ঠিকানাগুলির জন্য)। একটি ঠিকানা বৈধতা অনুরোধ দেখুন.
5 একটি প্রতিক্রিয়া প্রক্রিয়া ঠিকানা যাচাইকরণ API প্রতিক্রিয়া দুটি বৈশিষ্ট্য প্রদান করে, যার প্রতিটি আপনি বিভিন্ন উপায়ে ব্যবহার করেন। একটি মৌলিক প্রতিক্রিয়া বুঝতে দেখুন.
6 যাচাইকরণের সঠিকতা উন্নত করুন আপনি ঠিকানা যাচাইকরণ API প্রতিক্রিয়াগুলিতে প্রতিক্রিয়া প্রদান করে ঠিকানার নির্ভুলতা উন্নত করতে সহায়তা করতে পারেন। আপডেট করা ঠিকানা হ্যান্ডেল দেখুন।

উপলব্ধ ক্লায়েন্ট লাইব্রেরি

ঠিকানা যাচাইকরণ API-এর জন্য উপলব্ধ ক্লায়েন্ট লাইব্রেরিগুলির একটি তালিকার জন্য, ক্লায়েন্ট লাইব্রেরিগুলি দেখুন।

CASS™ সম্পর্কে

ইউনাইটেড স্টেটস পোস্টাল সার্ভিস® (USPS®) 1 ঠিকানা বৈধতা প্রদানকারীদের সমর্থন ও প্রত্যয়িত করার জন্য কোডিং সঠিকতা সমর্থন সিস্টেম (CASS™) বজায় রাখে। একটি CASS সার্টিফাইড™ পরিষেবা, যেমন ঠিকানা যাচাইকরণ API, একটি ঠিকানা থেকে অনুপস্থিত তথ্য পূরণ করার, এটিকে মানককরণ করার এবং আপনাকে সবচেয়ে বর্তমান এবং সবচেয়ে সঠিক ঠিকানা দেওয়ার জন্য এটি আপডেট করার ক্ষমতার জন্য নিশ্চিত করা হয়েছে৷

CASS ডিফল্টরূপে সক্রিয় নয় এবং শুধুমাত্র "US" এবং "PR" অঞ্চলের জন্য সমর্থিত৷ CASS সক্ষম করতে, একটি বৈধতা অনুরোধের অংশ হিসাবে enableUspsCass true সেট করুন৷ আরও তথ্যের জন্য, একটি ঠিকানা যাচাই করুন দেখুন।

USPS পরিষেবাগুলির আমাদের ব্যবহারের অংশ হিসাবে, USPS কৃত্রিমভাবে তৈরি ঠিকানাগুলির জন্য অনুরোধগুলি মূল্যায়ন করে৷ যদি ইউএসপিএস একটি ইনপুট ঠিকানাকে কৃত্রিমভাবে তৈরি করা হয়েছে বলে শনাক্ত করে, তাহলে Google-কে গ্রাহকের জন্য ঠিকানা যাচাই করা বন্ধ করতে হবে এবং অবশ্যই গ্রাহকের যোগাযোগের তথ্য (নাম এবং ঠিকানা), প্রাসঙ্গিক ইনপুট ঠিকানা এবং ইউএসপিএস-কে একত্রিত ব্যবহার ডেটা রিপোর্ট করতে হবে। API ব্যবহার করে আপনি এই পরিষেবার নির্দিষ্ট শর্তাবলীতে সম্মত হন।

এরপর কি

  1. Google মানচিত্র প্ল্যাটফর্ম হল ইউনাইটেড স্টেটস পোস্টাল সার্ভিস® এর একটি অ-এক্সক্লুসিভ লাইসেন্সধারী। নিম্নলিখিত ট্রেডমার্ক(গুলি) ইউনাইটেড স্টেটস পোস্টাল সার্ভিস® এর মালিকানাধীন এবং অনুমতি নিয়ে ব্যবহার করা হয়: ইউনাইটেড স্টেটস পোস্টাল সার্ভিস®, CASS™, CASS সার্টিফাইড™। ↩