উদ্দেশ্য
এই ডকুমেন্টে উচ্চ মানের ঠিকানা সংগ্রহের উদ্দেশ্যে একটি ইকমার্স চেকআউটে প্লেস অটোকমপ্লিট, অ্যাড্রেস ভ্যালিডেশন এপিআই ১ এবং ম্যাপস একত্রিত করার পদ্ধতি বর্ণনা করা হয়েছে।
পূর্বশর্ত
গুগল নিম্নলিখিত বিষয়গুলির সাথে পরিচিতি রাখার পরামর্শ দেয়:
- জাভাস্ক্রিপ্ট ডেভেলপার ডকুমেন্টেশনে স্বয়ংক্রিয় পূরণের ব্যবস্থা করুন ।
- প্রযুক্তিগত দৃষ্টিকোণ থেকে প্লেস অটোকমপ্লিট কীভাবে কাজ করে এবং এটি বাস্তবায়নের বিকল্পগুলো কী কী, তা বুঝুন।
- Place Autocomplete-এর বাস্তবায়ন নির্দেশিকাটি দেখুন ।
- ইকমার্স চেকআউটে প্লেস অটোকমপ্লিট বাস্তবায়নের সেরা অনুশীলনের উদাহরণ।
- অ্যাড্রেস ভ্যালিডেশন এপিআই প্রোডাক্ট ডকুমেন্টেশন , যেখানে আপনার ভ্যালিডেশন লজিক তৈরির উপর বিশেষ আলোকপাত করা হয়েছে।
- প্রযুক্তিগত দৃষ্টিকোণ থেকে অ্যাড্রেস ভ্যালিডেশন এপিআই কীভাবে কাজ করে তা বুঝুন এবং অ্যাড্রেসের গুণমান নির্ধারণকারী সংকেতগুলো পর্যালোচনা করুন।
ঠিকানা যাচাইকরণ বলতে কী বোঝায়?
অ্যাড্রেস ভ্যালিডেশন এপিআই হলো একটি পরিষেবা যা একটি ঠিকানা গ্রহণ করে। এটি ঠিকানার উপাদানগুলো শনাক্ত করে এবং সেগুলোকে যাচাই করে। এটি চিঠিপত্র পাঠানোর জন্য ঠিকানাটিকে একটি নির্দিষ্ট মানে নিয়ে আসে এবং এর জন্য সবচেয়ে পরিচিত অক্ষাংশ/দ্রাঘিমাংশের স্থানাঙ্ক খুঁজে বের করে। ঐচ্ছিকভাবে, মার্কিন যুক্তরাষ্ট্র এবং পুয়ের্তো রিকোর ঠিকানার জন্য, আপনি কোডিং অ্যাকুরেসি সাপোর্ট সিস্টেম (CASS™) সক্রিয় করতে পারেন।চেকআউটের সময় ঠিকানা যাচাইকরণের প্রয়োজন কেন?
অর্ডার করার সময় সঠিক ঠিকানা সংগ্রহ করুন:
এটি সফল ডেলিভারি ত্বরান্বিত করার একটি গুরুত্বপূর্ণ পদক্ষেপ, যা সময়মতো অর্ডার পূরণের হার বাড়ায় এবং ঠিকানা সংশোধনের ব্যয়বহুল চার্জ হ্রাস করে।
গ্রাহকদের দ্রুত ও নির্ভুলভাবে ঠিকানা লিখতে সাহায্য করুন:
প্লেস অটোকমপ্লিট ঠিকানা লেখার গতি বাড়ায় এবং ভুলের পরিমাণ কমায়, ফলে গ্রাহকরা সহজেই চেকআউট সম্পন্ন করতে পারেন। অ্যাড্রেস ভ্যালিডেশন ঠিকানার সার্বিক মান সম্পর্কে মতামত দেয়, প্রমিতকরণ ও বানান ভুলের মতো বিষয়গুলো সংশোধন করে এবং মেটাডেটা উন্নত করে, যেমন আবাসিক বা বাণিজ্যিক নির্দেশক প্রদান করা ( নির্বাচিত কিছু অঞ্চলে উপলব্ধ)।
বাস্তবায়ন ওভারভিউ
এই বিভাগে ইকমার্স চেকআউটের জন্য প্রস্তাবিত ঠিকানা এন্ট্রি কর্মপ্রবাহের রূপরেখা দেওয়া হয়েছে। এই প্রক্রিয়াটি তিনটি ধাপ নিয়ে গঠিত:
- প্রাথমিকভাবে ঠিকানাটি সংগ্রহ করতে প্লেস অটোকমপ্লিট ব্যবহার করুন।
- প্রবেশ করানো ঠিকানাটি নিশ্চিত করতে অ্যাড্রেস ভ্যালিডেশন এপিআই ব্যবহার করুন।
- গ্রাহকদের ডেলিভারির ব্যাপারে আস্থা দিতে, প্রবেশ করানো ঠিকানাটির অবস্থান একটি মানচিত্রে প্রদর্শন করুন।
এরপরে, আমরা প্রতিটি ধাপ নিয়ে আলাদাভাবে বিস্তারিত আলোচনা করব।
ধাপ ১: ঠিকানা এন্ট্রি প্রক্রিয়া - প্লেস অটোকমপ্লিট পরিষেবা ব্যবহার করে
ঠিকানা লেখার ফর্মের প্রথম লাইনে জাভাস্ক্রিপ্ট এপিআই ব্যবহার করে প্লেস অটোকমপ্লিট প্রয়োগ করুন।
প্লেস অটোকমপ্লিট গ্রাহককে তাদের ঠিকানা লেখার সময় সাজেশন বা পরামর্শ প্রদান করে। জাভাস্ক্রিপ্ট এপিআই ব্যবহার করে এটি প্রয়োগ করা হলে, ব্যবহারকারীরা টাইপ করা শুরু করার সাথে সাথে ঠিকানা লেখার ফর্ম ফিল্ডের নিচে একটি ড্রপ-ডাউন মেনু প্রদর্শিত হয়। এই মেনুতে অটোকমপ্লিট সার্ভিস থেকে প্রাপ্ত ফলাফলগুলো দেখানো হয়, যা প্রতিটি কীস্ট্রোকের সাথে সাথে আপডেট হতে থাকে। ব্যবহারকারী ঠিকানাটি খুঁজে পাওয়ার জন্য যথেষ্ট তথ্য প্রবেশ করানোর পর, ড্রপ-ডাউন থেকে সেটি নির্বাচন করেন। এই কাজটি স্বয়ংক্রিয়ভাবে ফর্মের ফিল্ডগুলোতে ঠিকানার তথ্য দিয়ে পূরণ করে দেয়।
প্লেস অটোকমপ্লিট-এর মাধ্যমে আপনি ব্যবহারকারীকে দুটি ফর্ম এন্ট্রি স্টাইল দিতে পারেন: হয় সমস্ত ঠিকানা ফিল্ড সহ একটি ডিসপ্লে, অথবা একটিমাত্র ইনপুট ফিল্ড সহ একটি ডিসপ্লে। এই একক ইনপুট ফিল্ডটি ব্যবহারকারীকে ঠিকানার উপাদানগুলি আলাদাভাবে প্রবেশ করানোর পরিবর্তে, টাইপ করার সাথে সাথেই অনুসন্ধান শুরু করতে উৎসাহিত করে। অটোকমপ্লিট ঠিকানাটি পূরণ করে দিলে, ওয়ার্কফ্লোটি ঠিকানার ডেটা দিয়ে ফর্ম ফিল্ডগুলিকে প্রসারিত করে, যা গ্রাহককে পর্যালোচনা করতে এবং সম্পাদনা করার সুযোগ দেয়, যেমন একটি অ্যাপার্টমেন্ট বা ইউনিট নম্বর যোগ করা।
একটিমাত্র ইনপুট ফিল্ড ব্যবহার করে এই প্রবাহটি কেমন হতে পারে তার একটি উদাহরণ এখানে দেওয়া হলো:
ধাপ ২: ঠিকানা যাচাই করতে অ্যাড্রেস ভ্যালিডেশন এপিআই (Address Validation API) ব্যবহার করুন।
ব্যবহারকারী ঠিকানা প্রবেশ করানোর পর, ঠিকানাটি বৈধ ও সম্পূর্ণ কিনা তা নিশ্চিত করতে চেকআউটের সময় অ্যাড্রেস ভ্যালিডেশন এপিআই (Address Validation API) কল করার জন্য গুগল পরামর্শ দেয়। ব্যবহারকারী অ্যাড্রেস ফর্মে থাকা 'Next' বা 'Continue' বোতামে ক্লিক করার সাথে সাথে অ্যাড্রেস ভ্যালিডেশন এপিআই-তে একটি কল ট্রিগার করুন। এই বোতামটি প্রায়শই পেমেন্ট পেজে নিয়ে যায়।
গুগল প্রতিটি লেনদেনের জন্য অ্যাড্রেস ভ্যালিডেশন এপিআই কল করার পরামর্শ দেয়।
নিম্নলিখিত ফ্লো ডায়াগ্রামটি একটি চেকআউটের মধ্যে অ্যাড্রেস ভ্যালিডেশন এপিআই-এর এন্ড-টু-এন্ড ইন্টিগ্রেশনের একটি উদাহরণ তুলে ধরেছে:
এই নথিতে পরবর্তীতে ঠিকানা গ্রহণের পরিস্থিতিগুলো নিয়ে আলোচনা করা হয়েছে।
ধাপ ৩: চাক্ষুষ নিশ্চিতকরণ প্রদান করুন
ঠিকানা দেওয়ার পর, মানচিত্রে ডেলিভারির স্থানটি প্রদর্শন করে ব্যবহারকারীকে দৃশ্যমান নিশ্চিতকরণ প্রদান করুন। এটি গ্রাহককে ঠিকানাটি সঠিক হওয়ার বিষয়ে অতিরিক্ত আশ্বাস দেয় এবং ডেলিভারি বা পিকআপ ব্যর্থতার হার কমায়।
মানচিত্রটি চেকআউট প্রক্রিয়ার সময় দেখানো যেতে পারে, অথবা লেনদেন নিশ্চিতকরণ ইমেলের সাথে পাঠানো যেতে পারে। এই উভয় ব্যবহারই নিম্নলিখিত API-গুলোর মাধ্যমে সম্পন্ন করা সম্ভব।
| Maps JavaScript API ব্যবহারকারীর অবস্থান দেখানোর জন্য একটি ইন্টারেক্টিভ মানচিত্র প্রদান করে। | ম্যাপস স্ট্যাটিক এপিআই ব্যবহার করে ওয়েব পেজের ভেতরে অথবা পরবর্তীতে ইমেইলে ছবি যুক্ত করা যায়। |
|---|---|
 |  |
গভীর বিশ্লেষণ - ঠিকানা গ্রহণের পরিস্থিতি
ঠিকানা যাচাইকরণ এপিআই প্রতিক্রিয়াগুলিকে তিনটি প্রধান পরিস্থিতিতে শ্রেণীবদ্ধ করা যেতে পারে:
- ফিক্স — ঠিকানাটি নিম্নমানের। আপনার আরও তথ্যের জন্য অনুরোধ করা উচিত।
- নিশ্চিত করুন — ঠিকানাটি উচ্চ মানের, কিন্তু প্রদত্ত ঠিকানা থেকে এতে পরিবর্তন রয়েছে। নিশ্চিতকরণের জন্য আপনাকে অনুরোধ করা হতে পারে।
- করুন — ঠিকানাটি উন্নত মানের। আপনি প্রদত্ত ঠিকানাটি গ্রহণ করতে পারেন।
এই ধারণাটি অ্যাড্রেস ভ্যালিডেশন এপিআই ডক্সের 'আপনার ভ্যালিডেশন লজিক তৈরি করুন' বিভাগে আলোচনা করা হয়েছে, এবং আমরা এই বিভাগে প্রতিটি পরিস্থিতি নিয়ে আলোচনা করব।
ঠিক করুন
এই বিভাগে দেখানো হয়েছে কীভাবে একটি অ্যাড্রেস ইনপুট ঠিক করতে হয়। অ্যাড্রেস ভ্যালিডেশন এপিআই (Address Validation API) একটি নিম্নমানের অ্যাড্রেস নির্দেশ করতে যে নির্দিষ্ট সংকেতগুলো প্রদান করে, সে সম্পর্কে তথ্যের জন্য 'Build your validation logic' ডকুমেন্টেশনের ' Fix an address' অংশটি দেখুন।
অ্যাড্রেস ভ্যালিডেশন এপিআই (Address Validation API) থেকে প্রাপ্ত প্রতিক্রিয়া যদি একটি অবৈধ ঠিকানা নির্দেশ করে, তবে গ্রাহককে তাদের প্রবেশ করানো তথ্য যাচাই করার জন্য ঠিকানা এন্ট্রি ফর্মে পুনঃনির্দেশিত করুন। ঠিকানাটি সংশোধন করা হয়ে গেলে, করা সংশোধনগুলো বৈধ কিনা তা নিশ্চিত করার জন্য আপনার পরিষেবাটি অ্যাড্রেস ভ্যালিডেশন এপিআই-তে পুনরায় পাঠাবে।
আপনি addressComponents লেভেলে ফেরত আসা সিগন্যালগুলো ব্যবহার করে নির্দিষ্ট অ্যাড্রেস লাইনের ত্রুটিগুলোও হাইলাইট করতে পারেন। এর একটি উদাহরণ ডানদিকের স্ক্রিনশটে দেখা যাবে।
নিশ্চিত করুন
এই বিভাগে একটি ঠিকানা কীভাবে নিশ্চিত করতে হয় তা দেখানো হয়েছে। কোনো ঠিকানা নিশ্চিত করা প্রয়োজন তা বোঝাতে অ্যাড্রেস ভ্যালিডেশন এপিআই যে নির্দিষ্ট সংকেতগুলো প্রদান করে, সে সম্পর্কে তথ্যের জন্য 'আপনার ভ্যালিডেশন লজিক তৈরি করুন' ডকুমেন্টেশনের ' একটি ঠিকানা নিশ্চিত করুন' অংশটি দেখুন।
প্রায়শই আপনার সিস্টেম কোনো ব্যবহারকারীকে ঠিকানা নিশ্চিত করতে বলতে পারে। উদাহরণস্বরূপ, কোনো গ্রাহক শহরের নাম ভুল লিখলে, অ্যাড্রেস ভ্যালিডেশন এপিআই (Address Validation API) দ্বারা তা সংশোধন করা হবে। এই সংশোধনের বিষয়টি আপনার গ্রাহকের সাথে নিশ্চিত করা উচিত। এর কারণ হলো, এপিআই দ্বারা করা পরিবর্তনগুলো শুরুতে দেওয়া তথ্যকে মৌলিকভাবে বদলে দিতে পারে।
গ্রাহককে তথ্য দেখানোর জন্য একটি ইন্টারস্টিশিয়াল মোডাল ব্যবহার করুন, যা এগিয়ে যাওয়ার জন্য তিনটি বিকল্প প্রদান করবে:
- এপিআই থেকে প্রাপ্ত ঠিকানাটি নিশ্চিত করুন, এবং সংশোধিত ঠিকানাটি ব্যবহার করে চেকআউট প্রক্রিয়াটি চলতে থাকবে।
- অ্যাড্রেস ভ্যালিডেশন এপিআই (Address Validation API) থেকে পাওয়া সংশোধন উপেক্ষা করে, প্রথমে যেভাবে ঠিকানাটি প্রবেশ করানো হয়েছিল সেভাবেই নির্বাচন করুন। চেকআউট প্রক্রিয়াটি স্বাভাবিকভাবে চলতে পারে এবং আপনার প্রক্রিয়া অনুমতি দিলে, শিপিংয়ের আগে পরবর্তী পর্যালোচনার জন্য অর্ডারটিকে চিহ্নিত করা যেতে পারে।
- গ্রাহক মোডালটি বাতিল করেন বা বেরিয়ে আসেন, যা তাদের চেকআউট প্রক্রিয়ার ঠিকানা লেখার পর্যায়ে ফিরিয়ে নিয়ে যায়, যেখানে তারা প্রথম থেকে ঠিকানাটি পুনরায় লিখে প্রক্রিয়াটি আবার শুরু করতে পারেন।
এর একটি উদাহরণ ডানদিকের স্ক্রিনশটটিতে দেখা যায়।
গ্রহণ করুন
এই বিভাগে একটি ঠিকানা কীভাবে গ্রহণ করতে হয় তা দেখানো হয়েছে। একটি ঠিকানা ভালো মানের এবং গ্রহণ করার যোগ্য তা বোঝাতে অ্যাড্রেস ভ্যালিডেশন এপিআই যে নির্দিষ্ট সংকেতগুলো প্রদান করে, সে সম্পর্কে তথ্যের জন্য 'আপনার ভ্যালিডেশন লজিক তৈরি করুন' ডকুমেন্টেশনের ' একটি ঠিকানা গ্রহণ করুন' অংশটি দেখুন।
এই পরিস্থিতিতে, ঠিকানার গুণমান সম্পর্কে গ্রাহককে কোনো জিজ্ঞাসা না করেই চেকআউট প্রক্রিয়াটি পরবর্তী ধাপে, অর্থাৎ পেমেন্ট ক্যাপচারে, চলে যাওয়া উচিত। এপিআই নিশ্চিত করেছে যে গ্রাহকের দেওয়া ঠিকানাটি ভালো মানের এবং ডেলিভারিযোগ্য।
আমরা অর্ডারটির ক্ষেত্রে অ্যাড্রেস ভ্যালিডেশন এপিআই থেকে প্রাপ্ত ঠিকানার ডেটা ব্যবহার করার পরামর্শ দিই, কারণ এতে নিম্নলিখিতের মতো ছোটখাটো সংশোধন ও সংযোজন থাকতে পারে:
- মূলধন
- উদাহরণস্বরূপ, বিন্যাস সংশোধন।
- স্ট্রিট থেকে সেন্ট
- ঠিকানার উপাদানগুলির সঠিক ক্রম
- মার্কিন যুক্তরাষ্ট্রে ZIP+4।
বাস্তবায়ন বিবেচনা
আপনার ঠিকানা গ্রহণের লজিক তৈরি করার সময়, নিশ্চিত করুন যেন আপনার ইমপ্লিমেন্টেশনটি ভুল ঠিকানা দেওয়ার কারণে গ্রাহকদের চেকআউট করতে বাধা না দেয়। লজিকটি এমনভাবে তৈরি করুন যাতে এপিআই বারবার গ্রাহকের দেওয়া ঠিকানাটি ভুল বলে জানালেও একটি অসীম লুপ তৈরি হওয়ার সম্ভাবনা না থাকে।
গুগলের পরামর্শ হলো, গ্রাহকদের তাদের ঠিকানা লেখার জন্য সর্বোচ্চ দুটি সুযোগ দিন এবং দ্বিতীয় প্রচেষ্টায়, ঠিকানাটি যাচাই না হলেও তাদের দেওয়া ঠিকানাটি গ্রহণ করুন। দ্বিতীয় প্রচেষ্টার মূল উদ্দেশ্য হলো, যাচাইকরণ নির্বিশেষে তাদেরকে সামনে এগিয়ে যেতে দেওয়া।
দ্বিতীয় প্রচেষ্টাটি গ্রহণ করার জন্য দুটি প্রস্তাবিত পদ্ধতি:
- জোরপূর্বক এগিয়ে যান: গ্রাহককে একটি মোডাল দেখান যেখানে ব্যাখ্যা করা হবে যে ঠিকানাটি যাচাই করা যাচ্ছে না, কিন্তু তাদের টাইপ করা ঠিকানা দিয়ে চালিয়ে যাওয়ার বিকল্প দিন।
- নীরব স্বীকৃতি: ঠিকানাটি সম্পূর্ণভাবে যাচাই না হলেও, কোনো নিশ্চিতকরণ ধাপ ছাড়াই দ্বিতীয় প্রচেষ্টাটি স্বয়ংক্রিয়ভাবে গ্রহণ করুন।
সম্ভব হলে, আপনার সিস্টেমটি এমনভাবে ডিজাইন করুন যাতে যাচাইযোগ্য নয় এমন ঠিকানাগুলো চিহ্নিত করা যায়, ফলে অর্ডার পাঠানোর আগে একজন গ্রাহক পরিষেবা প্রতিনিধি সেগুলো পর্যালোচনা করতে পারবেন। এই অতিরিক্ত ব্যবস্থাটি যেকোনো ভুল ধরতে সাহায্য করে।
নতুন ভবন নির্মাণের ক্ষেত্রে এই যাচাইয়ের সুপারিশ করা হয়। নতুন ভবন নির্মাণ শেষ হওয়া এবং ডাক ঠিকানার ডেটাবেসে সেই ভবনের ঠিকানা যুক্ত হওয়ার মধ্যে একটি ব্যবধান থাকতে পারে। গ্রাহকদের টাইপ করা ঠিকানা দিয়ে চেকআউট পৃষ্ঠায় জোর করে এগিয়ে যাওয়ার সুযোগ থাকা উচিত, এমনকি যদি তা যাচাই না-ও হয়।
একবার চেকআউট সেশন সম্পন্ন হয়ে গেলে, ঐচ্ছিকভাবে কোনো নির্দিষ্ট ঠিকানা যাচাইয়ের প্রচেষ্টা সম্পর্কে গুগলকে প্রতিক্রিয়া পাঠাতে provideValidationFeedback পদ্ধতিটি ব্যবহার করুন।
উপসংহার
এই ডকুমেন্টে গুগল ম্যাপ ব্যবহার করে অটোকমপ্লিট, অ্যাড্রেস ভ্যালিডেশন এবং ভিজ্যুয়াল কনফার্মেশন প্রয়োগ করা একটি চেকআউট ফ্লো-এর সংক্ষিপ্ত বিবরণ দেওয়া হয়েছে। প্রস্তাবিত অ্যাড্রেস এন্ট্রি ফ্লো অনুসরণ করে আপনার নিজস্ব ইমপ্লিমেন্টেশন ডিজাইন করার জন্য এই ডকুমেন্টটিকে একটি সূচনা বিন্দু হিসেবে ব্যবহার করুন।
পরবর্তী পদক্ষেপ
আরও পড়ার জন্য পরামর্শ:
- স্বয়ংক্রিয় সম্পূর্ণকরণ ডকুমেন্টেশন স্থাপন করুন
- ঠিকানা যাচাইকরণ এপিআই ডকুমেন্টেশন
- গুগল ম্যাপস প্ল্যাটফর্ম রিপোর্টিং
অবদানকারীরা
হেনরিক ভালভ | সলিউশনস ইঞ্জিনিয়ার
টমাস অ্যাংলারেট | সলিউশনস ইঞ্জিনিয়ার
সার্থক গাঙ্গুলি | সমাধান প্রকৌশলী
ইউনাইটেড স্টেটস পোস্টাল সার্ভিসের অ-একচেটিয়া লাইসেন্সধারী। নিম্নলিখিত ট্রেডমার্ক(গুলি) ইউনাইটেড স্টেটস পোস্টাল সার্ভিস®-এর মালিকানাধীন এবং অনুমতিক্রমে ব্যবহৃত: CASS™, USPS®, DPV®। ↩