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

উদ্দেশ্য

এই নথিটি উচ্চ মানের ঠিকানাগুলি ক্যাপচার করার উদ্দেশ্যে একটি ইকমার্স চেকআউটে স্থান স্বয়ংসম্পূর্ণ, ঠিকানা যাচাইকরণ API ¹ এবং মানচিত্রগুলিকে একত্রিত করার পদ্ধতিগুলি বর্ণনা করে৷

পূর্বশর্ত

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

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

এখন চেষ্টা করুন: Google ক্লাউড কনসোলে যান এবং ঠিকানা যাচাইকরণ API সক্ষম করুন৷

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

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

কেন আপনি চেকআউট এ ঠিকানা বৈধতা প্রয়োজন?

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

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

বাস্তবায়ন ওভারভিউ

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

1. প্রাথমিকভাবে ঠিকানা ক্যাপচার করতে স্থান স্বয়ংসম্পূর্ণ ব্যবহার করুন।
2. প্রবেশ করা ঠিকানা নিশ্চিত করতে ঠিকানা যাচাইকরণ API ব্যবহার করুন।
3. গ্রাহকদের ডেলিভারি আস্থা দিতে একটি মানচিত্রে প্রবেশ করা ঠিকানার অবস্থান প্রদর্শন করুন।

এর পরে, আমরা প্রতিটি ধাপে পৃথকভাবে অনুসন্ধান করব।

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

ঠিকানা এন্ট্রি ফর্মের প্রথম লাইনে JavaScript API ব্যবহার করে Place Autocomplete প্রয়োগ করুন।

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

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

একটি একক ইনপুট ক্ষেত্র ব্যবহার করে এই প্রবাহটি কীভাবে প্রদর্শিত হতে পারে তার একটি উদাহরণ এখানে রয়েছে:

ধাপ 2: ঠিকানা যাচাই করতে ঠিকানা যাচাইকরণ API ব্যবহার করুন

ব্যবহারকারী ঠিকানাটি প্রবেশ করার পরে, Google আপনাকে চেকআউটের সময় ঠিকানা যাচাইকরণ API এ কল করার পরামর্শ দেয় যাতে ঠিকানাটি বৈধ এবং সম্পূর্ণ। ব্যবহারকারীর ঠিকানা ফর্মের Next বা Continue বোতামে ক্লিক করার পরে ঠিকানা যাচাইকরণ API-এ একটি কল ট্রিগার করুন। এই বোতামটি প্রায়শই অর্থপ্রদানের পৃষ্ঠায় নিয়ে যায়।

Google প্রতিটি লেনদেনের জন্য ঠিকানা যাচাইকরণ API কল করার পরামর্শ দেয়।

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

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

ধাপ 3: ভিজ্যুয়াল নিশ্চিতকরণ প্রদান করুন

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

মানচিত্রটি চেকআউট প্রক্রিয়া চলাকালীন দেখানো যেতে পারে, বা লেনদেন নিশ্চিতকরণ ইমেলের মধ্যে পাঠানো যেতে পারে। এই উভয় ব্যবহারের ক্ষেত্রেই নিম্নলিখিত APIs দিয়ে সম্পন্ন করা যেতে পারে।

Maps JavaScript API ব্যবহারকারীর অবস্থান প্রদর্শনের জন্য একটি ইন্টারেক্টিভ মানচিত্র প্রদান করে।	মানচিত্র স্ট্যাটিক API ওয়েব পৃষ্ঠার মধ্যে বা পরবর্তী পর্যায়ে ইমেলে ইমেজ এম্বেড করার অনুমতি দেয়।

দ্রষ্টব্য: একটি প্রবেশ করা ঠিকানার অবস্থান দেখানোর জন্য ঠিকানা যাচাইকরণ API দ্বারা প্রত্যাবর্তিত জিওকোড ব্যবহার করুন৷

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

ঠিকানা যাচাইকরণ API প্রতিক্রিয়া তিনটি প্রধান পরিস্থিতিতে শ্রেণীবদ্ধ করা যেতে পারে:

• ফিক্স - ঠিকানাটি নিম্নমানের। আপনি আরো তথ্যের জন্য অনুরোধ করা উচিত.
• নিশ্চিত করুন — ঠিকানা উচ্চ মানের, কিন্তু ইনপুট ঠিকানা থেকে পরিবর্তন আছে। আপনি নিশ্চিতকরণের জন্য অনুরোধ করতে পারেন।
• স্বীকার করুন — ঠিকানা উচ্চ মানের। আপনি প্রদত্ত ঠিকানা গ্রহণ করতে পারেন.

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

পরামর্শ: বর্ধিত কম্পোনেন্ট লাইব্রেরিতে যুক্তিটি একটি ওপেন সোর্স ওয়েব কম্পোনেন্ট হিসেবেও পাওয়া যায়।

ঠিক করুন

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

যদি ঠিকানা যাচাইকরণ API থেকে প্রতিক্রিয়া একটি অবৈধ ঠিকানা নির্দেশ করে, গ্রাহককে তাদের প্রবেশ করা ডেটা পরীক্ষা করতে ঠিকানা এন্ট্রি ফর্মে পুনঃনির্দেশ করুন৷ ঠিকানা ঠিক করা হয়ে গেলে, সংশোধনগুলি বৈধ কিনা তা নিশ্চিত করতে আপনার পরিষেবাটি ঠিকানা যাচাইকরণ API-এ পুনরায় পাঠানো উচিত।

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

---

নিশ্চিত করুন

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

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

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

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

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

---

গ্রহণ করুন

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

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

আমরা অর্ডারের বিপরীতে ঠিকানা যাচাইকরণ API থেকে ফেরত ঠিকানা ডেটা ব্যবহার করার পরামর্শ দিই, কারণ এতে ছোটখাটো সংশোধন এবং সংযোজন থাকতে পারে, যেমন:

• ক্যাপিটালাইজেশন
• ফর্ম্যাটিং সংশোধন, উদাহরণস্বরূপ
  • স্ট্রিট থেকে সেন্ট
  • ঠিকানা উপাদান সঠিক ক্রম
• মার্কিন যুক্তরাষ্ট্রে ZIP+4।

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

---

বাস্তবায়ন বিবেচনা

আপনার ঠিকানা গ্রহণযোগ্যতা যুক্তি তৈরি করার সময়, নিশ্চিত করুন যে আপনার বাস্তবায়ন একটি অবৈধ ঠিকানা প্রবেশের কারণে গ্রাহকদের চেক আউট করতে বাধা দেয় না। এমনভাবে যুক্তি তৈরি করুন যা একটি অসীম লুপের সম্ভাবনাকে বাধা দেয় যদি API বারবার তাদের এন্ট্রি অবৈধ বলে নির্দেশ করে।

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

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

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

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

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

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

উপসংহার

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

পরবর্তী পদক্ষেপ

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

আরও পড়ার পরামর্শ দেওয়া হয়েছে:

• স্বয়ংসম্পূর্ণ ডকুমেন্টেশন রাখুন
• ঠিকানা যাচাইকরণ API ডকুমেন্টেশন
• গুগল ম্যাপ প্ল্যাটফর্ম রিপোর্টিং

অবদানকারী

হেনরিক ভালভ | সমাধান প্রকৌশলী
টমাস অ্যাংলারেট | সমাধান প্রকৌশলী
সার্থক গাঙ্গুলি | সমাধান প্রকৌশলী

---

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