চেক-আউটের জন্য ঠিকানা যাচাইকরণ

উদ্দেশ্য

এই ডকুমেন্টটি খুব ভাল কোয়ালিটির ঠিকানা ক্যাপচার করার উদ্দেশ্যে ই-কমার্স চেকআউটে প্লেস অটো-কমপ্লিট, ঠিকানা যাচাইকরণ API^১ এবং Maps একত্রিত করার পদ্ধতি বর্ণনা করে।

পূর্বশর্ত

Google নিম্নলিখিত বিষয়গুলির সাথে পরিচিত হওয়ার সাজেশন দেয়:

• জায়গা অটোমেটিক সম্পূর্ণ করা জাভাস্ক্রিপ্ট ডেভেলপার ডকুমেন্টেশন।
  • প্রযুক্তিগত দৃষ্টিকোণ থেকে বুঝুন কীভাবে জায়গা অটোমেটিক সম্পূর্ণ করার ফিচার কাজ করে এবং এর প্রয়োগের বিকল্পগুলি।
• Place Autocomplete-এর জন্য চেকআউট প্রয়োগ করার নির্দেশিকা।
  • ই-কমার্স চেকআউটে প্লেস অটো-কমপ্লিট প্রয়োগ করার পেশাদার পদ্ধতির উদাহরণ।
• Address Validation API প্রোডাক্ট ডকুমেন্টেশন, আপনার যাচাইকরণ লজিক তৈরি করুন-এর উপর ফোকাস করা হয়েছে।
  • Address Validation API কীভাবে কাজ করে তা টেকনিক্যাল দৃষ্টিকোণ থেকে বুঝুন এবং সেইসব সিগন্যাল পর্যালোচনা করুন যা ঠিকানা কোয়ালিটি নির্ধারণ করে।

এখনই চেষ্টা করুন: Google Cloud কনসোলে যান এবং Address Validation API চালু করুন।

ঠিকানা যাচাইকরণ কী?

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

চেক-আউটের সময় কেন ঠিকানা যাচাইকরণ প্রয়োজন?

অর্ডার করার প্রসেস চলাকালীন সঠিক ঠিকানা সংগ্রহ করুন:
এটি সফল ডেলিভারির প্রচার, সময়মতো ডেলিভারি বৃদ্ধি এবং ঠিকানা সংশোধন করার জন্য খরচ কমানোর একটি গুরুত্বপূর্ণ ধাপ।

গ্রাহকদের দ্রুত ও নির্ভুলভাবে ঠিকানা লিখতে সাহায্য করুন:
প্লেস অটোকমপ্লিট ফিচার ঠিকানা লেখার প্রসেস দ্রুত করে এবং ইনপুট সংক্রান্ত ভুল কমায়, এর ফলে গ্রাহকরা চেক-আউট প্রসেস সহজে সম্পূর্ণ করতে পারেন। Address Validation, ঠিকানার সামগ্রিক কোয়ালিটি সম্পর্কে মতামত দেয়, স্ট্যান্ডার্ডাইজেশন ও বানান ভুলের মতো সংশোধন করে এবং মেটাডেটা উন্নত করে, যেমন আবাসিক বা বাণিজ্যিক ইন্ডিকেটর প্রদান করা (বেছে নেওয়া অঞ্চলে উপলভ্য)।

এক নজরে প্রয়োগ

এই বিভাগে ই-কমার্স চেক-আউটের জন্য সাজেস্ট করা ঠিকানা লেখার ওয়ার্কফ্লো বর্ণনা করা হয়েছে। এই প্রসেসে তিনটি ধাপ রয়েছে:

1. প্রাথমিকভাবে ঠিকানা ক্যাপচার করতে 'প্লেস অটোকমপ্লিট' ব্যবহার করুন।
2. লেখা ঠিকানা কনফার্ম করতে Address Validation API ব্যবহার করুন।
3. গ্রাহকদের ডেলিভারি সম্পর্কে আত্মবিশ্বাস দিতে, ম্যাপে লেখা ঠিকানার লোকেশন দেখান।

এরপর, আমরা প্রতিটি ধাপ আলাদা করে আলোচনা করব।

ধাপ ১: ঠিকানা লেখার ফ্লো - Place Autocomplete পরিষেবা ব্যবহার করা

ঠিকানা লেখার ফর্মের প্রথম লাইনে জাভাস্ক্রিপ্ট API ব্যবহার করে জায়গা অটোমেটিক সম্পূর্ণ করা ফিচার প্রয়োগ করুন।

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

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

একটি ইনপুট ফিল্ড ব্যবহার করে এই ফ্লোটি কীভাবে দেখানো হতে পারে তার একটি উদাহরণ এখানে দেওয়া হল:

পরামর্শ: আপনি অটোকমপ্লিট (নতুন) ব্যবহার করলে, চেক-আউট ও ডেলিভারির জন্য অটোকমপ্লিট ফিচারের দামের সুবিধা নিতে, আপনার অটোকমপ্লিট ও Address Validation API কলে সেশন টোকেন ব্যবহার করুন।

ধাপ ২: ঠিকানা যাচাই করতে Address Validation API ব্যবহার করুন

ব্যবহারকারী ঠিকানা লেখার পরে, Google আপনাকে চেকআউটের সময় Address Validation API কল করার সাজেশন দেয় যাতে ঠিকানাটি সঠিক ও সম্পূর্ণ কিনা তা কনফার্ম করা যায়। ব্যবহারকারী ঠিকানা ফর্মের 'পরবর্তী' বা 'চালিয়ে যান' বোতামে ক্লিক করলে, Address Validation API-তে কল ট্রিগার করুন। এই বোতামটি প্রায়শই পেমেন্ট পৃষ্ঠায় নিয়ে যায়।

Google প্রতিটি ট্রানজ্যাকশনের জন্য Address Validation API কল করার সাজেশন দেয়।

নিচে দেওয়া ফ্লো ডায়াগ্রামটি চেক-আউটের মধ্যে ঠিকানা যাচাইকরণ API-এর এন্ড-টু-এন্ড ইন্টিগ্রেশনের একটি উদাহরণ দেখায়:

এই ডকুমেন্টে পরে ঠিকানা গ্রহণ করার পরিস্থিতি নিয়ে আলোচনা করা হয়েছে।

ধাপ ৩: ভিজ্যুয়াল কনফার্মেশন প্রদান করুন

ঠিকানা লেখার পরে, ম্যাপে ডেলিভারি লোকেশন দেখিয়ে ব্যবহারকারীকে সেটি কনফার্ম করতে বলুন। এর ফলে গ্রাহক অতিরিক্ত নিশ্চিন্তে থাকতে পারেন যে ঠিকানাটি সঠিক এবং এটি ডেলিভারি বা পিক-আপ ব্যর্থ হওয়ার সম্ভাবনা কমায়।

চেক-আউট প্রসেসের সময় ম্যাপ দেখানো হতে পারে অথবা ট্রানজ্যাকশন কনফার্মেশন ইমেলের মধ্যে পাঠানো হতে পারে। নিচে উল্লেখ করা API-এর সাহায্যে এই দুটি ব্যবহারিক কেস সম্পূর্ণ করা যেতে পারে।

Maps JavaScript API ব্যবহারকারীর লোকেশন দেখানোর জন্য একটি ইন্টার‍্যাক্টিভ ম্যাপ প্রদান করে।	Maps Static API ওয়েব পেজে বা পরে ইমেলে ছবি এম্বেড করার অনুমতি দেয়।

মনে রাখবেন: Address Validation API-এর মাধ্যমে পাওয়া জিওকোড ব্যবহার করে, লেখা ঠিকানার লোকেশন দেখানো হয়।

ডিপ ডাইভ - ঠিকানা গ্রহণ করা সংক্রান্ত পরিস্থিতি

Address Validation API-এর উত্তরকে তিনটি প্রধান বিভাগে ভাগ করা যায়:

• ঠিক করুন—ঠিকানাটি খারাপ কোয়ালিটির। আরও তথ্যের জন্য আপনার প্রম্পট করা উচিত।
• কনফার্ম করুন—ঠিকানাটি খুব ভাল কোয়ালিটির, তবে ইনপুট করা ঠিকানার থেকে আলাদা। আপনাকে কনফার্ম করার জন্য প্রম্পট দেখানো হতে পারে।
• গ্রহণ করুন—ঠিকানাটি খুব ভালো কোয়ালিটির। আপনি প্রদত্ত ঠিকানা গ্রহণ করতে পারেন।

এই ধারণাটি Address Validation API ডকুমেন্টের আপনার যাচাইকরণ লজিক তৈরি করুন বিভাগে কভার করা হয়েছে এবং আমরা এই বিভাগে প্রতিটি পরিস্থিতি নিয়ে আলোচনা করব।

পরামর্শ: এই লজিকটি ওপেন সোর্স ওয়েব কম্পোনেন্ট হিসেবেও উপলভ্য, এক্সটেন্ডেড কম্পোনেন্ট লাইব্রেরিতে।

এর সমাধান করুন

এই বিভাগে দেখানো হয়েছে যে কীভাবে ঠিকানা ইনপুট করার সময় হওয়া ভুল ঠিক করতে হয়। Address Validation API-এর মাধ্যমে ফেরত পাঠানো নির্দিষ্ট সিগন্যাল সম্পর্কে তথ্য পেতে, যা খারাপ কোয়ালিটির ঠিকানা নির্দেশ করে, আপনার যাচাইকরণ লজিক ডকুমেন্টেশন তৈরি করুন-এ ঠিকানা ঠিক করুন দেখুন।

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

এছাড়াও, আপনি addressComponents লেভেলে ফিরে আসা সিগন্যাল ব্যবহার করে নির্দিষ্ট ঠিকানা লাইনের ত্রুটিগুলি হাইলাইট করতে পারেন। এর একটি উদাহরণ ডানদিকের স্ক্রিনশটে দেখা যেতে পারে।

---

কনফার্ম করুন

এই বিভাগে দেখানো হয়েছে কীভাবে ঠিকানা কনফার্ম করতে হয়। ঠিকানা যাচাইকরণ API, কোনও ঠিকানা কনফার্ম করতে হবে তা বোঝাতে যে নির্দিষ্ট সিগন্যাল দেয়, সেই সম্পর্কে তথ্য পেতে, আপনার যাচাইকরণ লজিক ডকুমেন্টেশনে ঠিকানা কনফার্ম করুন লিঙ্কে দেখুন।

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

গ্রাহককে তথ্য দেখানোর জন্য ইন্টারস্টিশিয়াল মোডাল ব্যবহার করুন, এর ফলে এগিয়ে যাওয়ার জন্য তিনটি বিকল্প পাবেন:

1. API-এর মাধ্যমে পাওয়া ঠিকানা কনফার্ম করুন এবং চেক-আউট প্রসেস সংশোধিত ঠিকানা ব্যবহার করে চলতে থাকে।
2. Address Validation API-এর করা সংশোধন উপেক্ষা করে, আসল ঠিকানা বেছে নিন। চেক-আউট প্রসেস স্বাভাবিকভাবে চলতে পারে এবং আপনার প্রসেস অনুমতি দিলে, শিপিং করার আগে ডাউনস্ট্রিম পর্যালোচনার জন্য অর্ডারটি ফ্ল্যাগ করা যেতে পারে।
3. গ্রাহক বাতিল করলে বা মোডাল থেকে বেরিয়ে গেলে, তাকে চেক-আউট প্রসেসের ঠিকানা লেখার ধাপে ফিরিয়ে আনা হয়, যেখানে তিনি আবার প্রথম থেকে ঠিকানা লিখে প্রসেসটি আবার শুরু করতে পারেন।

এর একটি উদাহরণ ডানদিকের স্ক্রিনশটে দেখা যেতে পারে।

---

সম্মতি জানান

এই বিভাগে কীভাবে ঠিকানা গ্রহণ করতে হয় তা দেখানো হয়েছে। Address Validation API-এর মাধ্যমে পাঠানো নির্দিষ্ট সিগন্যাল সম্পর্কে তথ্য পেতে, যা থেকে বোঝা যায় যে ঠিকানাটি সঠিক এবং সেটি গ্রহণ করা উচিত, আপনার যাচাইকরণ লজিক ডকুমেন্টেশন তৈরি করুন-এর মধ্যে ঠিকানা গ্রহণ করুন দেখুন।

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

আমরা সাজেস্ট করি যে আপনি অর্ডারের জন্য Address Validation API থেকে পাওয়া অ্যাড্রেস ডেটা ব্যবহার করুন, কারণ এতে ছোটখাটো সংশোধন ও সংযোজন থাকতে পারে, যেমন:

• বড় হাতের অক্ষর
• ফর্ম্যাটিং সংক্রান্ত সংশোধন, যেমন
  • Street থেকে St
  • ঠিকানার উপাদানগুলি সঠিক ক্রমে সাজানো
• মার্কিন যুক্তরাষ্ট্রে ZIP+4.

পরামর্শ: পেমেন্ট ক্যাপচার পৃষ্ঠায় গ্রাহককে ঠিকানা দেখাতে ভুলবেন না, এমনকি এর প্রতি কোনও মনোযোগ আকর্ষণ না করা হলেও।

---

প্রয়োগ সংক্রান্ত বিবেচ্য বিষয়

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

Google সাজেস্ট করে যে আপনি গ্রাহকদের তাদের ঠিকানা লেখার জন্য সর্বাধিক দুটি সুযোগ দিন এবং দ্বিতীয় প্রচেষ্টায়, তাদের লেখা গ্রহণ করুন, এমনকি এটি যাচাই না করলেও চলবে। দ্বিতীয় প্রচেষ্টায়, যাচাইকরণ নির্বিশেষে তাদের এগিয়ে যেতে দেওয়া।

দ্বিতীয় প্রচেষ্টা গ্রহণ করার জন্য সাজেস্ট করা দুটি পদ্ধতি:

• এগিয়ে যেতে বাধ্য করা: গ্রাহককে একটি মোডাল দেখান যাতে বলা থাকে যে ঠিকানাটি ভেরিফাই করা যাচ্ছে না, তবে গ্রাহককে তার টাইপ করা ঠিকানা দিয়ে চালিয়ে যাওয়ার বিকল্প দিন।
• নীরবে গ্রহণ করা: কনফার্মেশন ধাপ ছাড়াই দ্বিতীয় প্রচেষ্টা অটোমেটিক গ্রহণ করা হবে, এমনকি ঠিকানাটি সম্পূর্ণ যাচাই করা না গেলেও।

সম্ভব হলে, আপনার সিস্টেম এমনভাবে ডিজাইন করুন যাতে যাচাই করা যায়নি এমন ঠিকানা ফ্ল্যাগ করা যায়, যাতে অর্ডার শিপ করার আগে গ্রাহক পরিষেবা প্রতিনিধি সেগুলি পর্যালোচনা করতে পারেন। এই অতিরিক্ত ব্যবস্থাটি নিশ্চিত করে যে আপনি কোনও ভুল মিস করবেন না।

নতুন বিল্ডিং নির্মাণ এই চেক কেন সাজেস্ট করা হয় তার একটি ভাল উদাহরণ। নতুন বিল্ডিংয়ের নির্মাণ কাজ শেষ হওয়া এবং ডাক ঠিকানার ডেটাবেসে সেই বিল্ডিংয়ের ঠিকানা পপুলেট হওয়ার মধ্যে সময়ের ব্যবধান থাকতে পারে। গ্রাহকদের কাছে চেক-আউট পৃষ্ঠার মাধ্যমে জোরপূর্বক এগিয়ে যাওয়ার বিকল্প থাকা উচিত তাদের টাইপ করা ঠিকানা সহ, এমনকি এটি যাচাই না করলেও।

চেক-আউট সেশন সম্পূর্ণ হয়ে গেলে, ঐচ্ছিকভাবে provideValidationFeedback পদ্ধতি ব্যবহার করে নির্দিষ্ট ঠিকানা যাচাইকরণের প্রচেষ্টা সম্পর্কে Google-কে মতামত পাঠান।

উপসংহার

এই ডকুমেন্টে চেক-আউট ফ্লো প্রয়োগ করার একটি ওভারভিউ দেওয়া হয়েছে অটোফিল, ঠিকানা যাচাইকরণ এবং Google Maps-এ ভিজ্যুয়াল কনফার্মেশন। সাজেস্ট করা ঠিকানা এন্ট্রি ফ্লো অনুসরণ করে, আপনার ইমপ্লিমেন্টেশন ডিজাইন করার জন্য শুরুর পয়েন্ট হিসেবে এই ডকুমেন্ট ব্যবহার করুন।

পরবর্তী ধাপ

আরও পড়ার জন্য সাজেস্ট করা বিষয়:

• জায়গা অটোমেটিক সম্পূর্ণ করা সংক্রান্ত ডকুমেন্টেশন
• Address Validation API ডকুমেন্টেশন
• Google Maps Platform রিপোর্টিং

অবদানকারী

হেনরিক ভালভ | সলিউশন ইঞ্জিনিয়ার
থমাস অ্যাঙ্গলেরেট | সলিউশন ইঞ্জিনিয়ার
সার্থক গাঙ্গুলি | সলিউশন ইঞ্জিনিয়ার

---

1. মার্কিন যুক্তরাষ্ট্রের পোস্টাল সার্ভিসের নন-এক্সক্লুসিভ লাইসেন্সধারী। নিম্নলিখিত ট্রেডমার্ক(গুলি) United States Postal Service®-এর মালিকানাধীন এবং অনুমতি নিয়ে ব্যবহার করা হয়: CASS™, USPS®, DPV®। ↩