উদ্দেশ্য
এই ডকুমেন্টটি উচ্চমানের ঠিকানা ক্যাপচার করার উদ্দেশ্যে একটি ই-কমার্স চেকআউটে প্লেস অটোকম্পলিট, অ্যাড্রেস ভ্যালিডেশন API 1 এবং ম্যাপ একত্রিত করার পদ্ধতি বর্ণনা করে।
পূর্বশর্ত
গুগল নিম্নলিখিত বিষয়গুলির সাথে পরিচিত হওয়ার পরামর্শ দেয়:
- স্বয়ংক্রিয়ভাবে সম্পন্ন জাভাস্ক্রিপ্ট ডেভেলপার ডকুমেন্টেশন রাখুন ।
- প্রযুক্তিগত দৃষ্টিকোণ থেকে বুঝুন কিভাবে Place Autocomplete কাজ করে এবং এর বাস্তবায়নের বিকল্পগুলি।
- প্লেস অটোকম্পলিটের জন্য বাস্তবায়ন নির্দেশিকা দেখুন ।
- ই-কমার্স চেকআউটে প্লেস অটোকম্পলিট বাস্তবায়নের সেরা অনুশীলনের উদাহরণ।
- ঠিকানা যাচাইকরণ API পণ্য ডকুমেন্টেশন , আপনার বৈধতা যুক্তি তৈরি করুন এর উপর ফোকাস সহ।
- কারিগরি দৃষ্টিকোণ থেকে বুঝুন কিভাবে ঠিকানা যাচাইকরণ API কাজ করে, এবং ঠিকানার মান নির্ধারণকারী সংকেতগুলি পর্যালোচনা করুন।
ঠিকানা যাচাইকরণ কী?
ঠিকানা যাচাইকরণ API হল এমন একটি পরিষেবা যা একটি ঠিকানা গ্রহণ করে। এটি ঠিকানার উপাদানগুলি সনাক্ত করে এবং তাদের যাচাই করে। এটি মেইলিংয়ের জন্য ঠিকানাটিকে মানসম্মত করে এবং এর জন্য সর্বাধিক পরিচিত অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্ক খুঁজে বের করে। ঐচ্ছিকভাবে, মার্কিন যুক্তরাষ্ট্র এবং পুয়ের্তো রিকোর ঠিকানাগুলির জন্য, আপনি কোডিং অ্যাকুরেসি সাপোর্ট সিস্টেম (CASS™) সক্ষম করতে পারেন।চেকআউটের সময় ঠিকানা যাচাইকরণের প্রয়োজন কেন?
অর্ডার প্রক্রিয়ার সময় সঠিক ঠিকানা সংগ্রহ করুন:
এটি সফল ডেলিভারি প্রচারের জন্য একটি গুরুত্বপূর্ণ পদক্ষেপ, সময়মতো পূরণ বৃদ্ধি করে এবং ব্যয়বহুল ঠিকানা সংশোধন চার্জ হ্রাস করে।
গ্রাহকদের দ্রুত এবং নির্ভুলভাবে ঠিকানা লিখতে নির্দেশ দিন:
প্লেস অটোকম্পলিট ঠিকানা প্রবেশের গতি বাড়ায় এবং ইনপুট ত্রুটি হ্রাস করে, যার ফলে গ্রাহকরা সহজেই চেকআউটের মাধ্যমে যেতে পারেন। ঠিকানা যাচাইকরণ সামগ্রিক ঠিকানার গুণমান সম্পর্কে প্রতিক্রিয়া দেয়, মানককরণ এবং বানান ভুলের মতো সংশোধন করে এবং মেটাডেটা উন্নত করে, যেমন একটি আবাসিক বা বাণিজ্যিক সূচক প্রদান করা ( নির্বাচিত অঞ্চলে উপলব্ধ)।
বাস্তবায়নের সারসংক্ষেপ
এই বিভাগে ই-কমার্স চেকআউটের জন্য প্রস্তাবিত ঠিকানা প্রবেশের কর্মপ্রবাহের রূপরেখা দেওয়া হয়েছে। প্রক্রিয়াটি তিনটি ধাপ নিয়ে গঠিত:
- ঠিকানাটি প্রাথমিকভাবে ক্যাপচার করতে প্লেস অটোকম্পলিট ব্যবহার করুন।
- প্রবেশ করানো ঠিকানা নিশ্চিত করতে ঠিকানা যাচাইকরণ API ব্যবহার করুন।
- গ্রাহকদের ডেলিভারির আত্মবিশ্বাস বাড়াতে, প্রবেশ করানো ঠিকানার অবস্থান মানচিত্রে প্রদর্শন করুন।
এরপর, আমরা প্রতিটি ধাপ আলাদাভাবে আলোচনা করব।
ধাপ ১: ঠিকানা প্রবেশের প্রবাহ - প্লেস অটোকম্পলিট পরিষেবা ব্যবহার করে
ঠিকানা এন্ট্রি ফর্মের প্রথম লাইনে জাভাস্ক্রিপ্ট API ব্যবহার করে প্লেস অটোকম্পলিট বাস্তবায়ন করুন।
গ্রাহকরা যখন তাদের ঠিকানার বিবরণ প্রবেশ করান, তখন প্লেস অটোকম্পলিট তাদের পরামর্শ প্রদান করে। জাভাস্ক্রিপ্ট এপিআই ব্যবহার করে বাস্তবায়িত হলে, ব্যবহারকারীরা টাইপ করা শুরু করার সাথে সাথে ঠিকানা এন্ট্রি ফর্ম ক্ষেত্রের নীচে একটি ড্রপ-ডাউন প্রদর্শিত হয়, যেখানে প্রতিটি কীস্ট্রোকের সাথে আপডেট হওয়া অটোকম্পলিট পরিষেবার ফলাফল দেখানো হয়। ব্যবহারকারী ঠিকানা খুঁজে পাওয়ার জন্য পর্যাপ্ত তথ্য প্রবেশ করানোর পরে, তারা ড্রপ-ডাউন থেকে এটি নির্বাচন করে। এই ক্রিয়াটি স্বয়ংক্রিয়ভাবে ফর্ম ক্ষেত্রগুলিতে ঠিকানার ডেটা পূরণ করে।
প্লেস অটোকম্পলিট ব্যবহার করে আপনি ব্যবহারকারীকে দুটি ফর্ম এন্ট্রি স্টাইল প্রদান করতে পারেন: হয় সমস্ত ঠিকানা ক্ষেত্র সহ একটি ডিসপ্লে, অথবা একটি একক ইনপুট ক্ষেত্র সহ একটি ডিসপ্লে। এই একক ইনপুট ক্ষেত্রটি ব্যবহারকারীকে ঠিকানার উপাদানগুলি পৃথকভাবে প্রবেশ করার পরিবর্তে টাইপ করার সাথে সাথে অনুসন্ধান শুরু করতে প্ররোচিত করে। একবার অটোকম্পলিট ঠিকানাটি পূরণ করলে, কর্মপ্রবাহ ঠিকানার ডেটা সহ ফর্ম ক্ষেত্রগুলিকে প্রসারিত করে, গ্রাহককে পর্যালোচনা এবং সম্পাদনা করার অনুমতি দেয়, উদাহরণস্বরূপ একটি অ্যাপার্টমেন্ট বা ইউনিট নম্বর যোগ করা।
একটি একক ইনপুট ক্ষেত্র ব্যবহার করে এই প্রবাহটি কীভাবে প্রদর্শিত হতে পারে তার একটি উদাহরণ এখানে দেওয়া হল:
ধাপ ২: ঠিকানা যাচাই করতে ঠিকানা যাচাইকরণ API ব্যবহার করুন
ব্যবহারকারী ঠিকানাটি প্রবেশ করানোর পর, Google আপনাকে চেকআউটের সময় ঠিকানা যাচাইকরণ API-তে কল করার পরামর্শ দেয় যাতে ঠিকানাটি বৈধ এবং সম্পূর্ণ কিনা তা নিশ্চিত করা যায়। ব্যবহারকারী ঠিকানা ফর্মের পরবর্তী বা চালিয়ে যান বোতামে ক্লিক করার পরে ঠিকানা যাচাইকরণ API-তে একটি কল ট্রিগার করুন। এই বোতামটি প্রায়শই পেমেন্ট পৃষ্ঠায় নিয়ে যায়।
গুগল প্রতিটি লেনদেনের জন্য ঠিকানা যাচাইকরণ API কল করার পরামর্শ দেয়।
নিম্নলিখিত ফ্লো ডায়াগ্রামটি চেকআউটের মধ্যে ঠিকানা যাচাইকরণ API-এর এন্ড-টু-এন্ড ইন্টিগ্রেশনের একটি উদাহরণ দেখায়:
এই নথিতে ঠিকানা গ্রহণের পরিস্থিতি সম্পর্কে পরে আলোচনা করা হয়েছে।
ধাপ ৩: ভিজ্যুয়াল নিশ্চিতকরণ প্রদান করুন
ঠিকানা লেখার পর, ব্যবহারকারীকে ডেলিভারির স্থানটি মানচিত্রে প্রদর্শন করে ভিজ্যুয়াল নিশ্চিতকরণ প্রদান করুন। এটি গ্রাহককে অতিরিক্ত নিশ্চয়তা দেয় যে ঠিকানাটি সঠিক, এবং এটি ডেলিভারি বা পিকআপ ব্যর্থতা হ্রাস করে।
চেকআউট প্রক্রিয়ার সময় মানচিত্রটি দেখানো যেতে পারে, অথবা লেনদেন নিশ্চিতকরণ ইমেলের মধ্যে পাঠানো যেতে পারে। এই উভয় ব্যবহারের ক্ষেত্রে নিম্নলিখিত API গুলি ব্যবহার করা যেতে পারে।
| ম্যাপস জাভাস্ক্রিপ্ট এপিআই ব্যবহারকারীর অবস্থান প্রদর্শনের জন্য একটি ইন্টারেক্টিভ মানচিত্র প্রদান করে। | ম্যাপস স্ট্যাটিক এপিআই ওয়েব পৃষ্ঠার মধ্যে অথবা পরবর্তী পর্যায়ে ইমেলে ছবি এম্বেড করার অনুমতি দেয়। |
|---|---|
 |  |
ডিপ ডাইভ - অ্যাড্রেস গ্রহণের পরিস্থিতি
ঠিকানা যাচাইকরণ API প্রতিক্রিয়াগুলিকে তিনটি প্রধান পরিস্থিতিতে শ্রেণীবদ্ধ করা যেতে পারে:
- ঠিক করুন — ঠিকানাটি নিম্নমানের। আরও তথ্যের জন্য আপনার অনুরোধ করা উচিত।
- নিশ্চিত করুন — ঠিকানাটি উচ্চমানের, তবে ইনপুট ঠিকানা থেকে পরিবর্তন হয়েছে। আপনি নিশ্চিতকরণের জন্য অনুরোধ করতে পারেন।
- Accept —ঠিকানাটি উচ্চমানের। আপনি প্রদত্ত ঠিকানাটি গ্রহণ করতে পারেন।
এই ধারণাটি ঠিকানা বৈধকরণ API ডক্সের " আপনার বৈধতা যুক্তি তৈরি করুন" বিভাগে কভার করা হয়েছে এবং আমরা এই বিভাগে প্রতিটি পরিস্থিতি নিয়ে আলোচনা করব।
ঠিক করুন
এই বিভাগে দেখানো হয়েছে কিভাবে একটি ঠিকানা ইনপুট ঠিক করতে হয়। ঠিকানা যাচাইকরণ API নিম্নমানের ঠিকানা নির্দেশ করার জন্য যে নির্দিষ্ট সংকেতগুলি ফেরত দেয় সে সম্পর্কে তথ্যের জন্য, "আপনার বৈধতা লজিক ডকুমেন্টেশন তৈরি করুন" বিভাগে একটি ঠিকানা ঠিক করুন দেখুন।
যদি ঠিকানা যাচাইকরণ API থেকে আসা প্রতিক্রিয়া একটি অবৈধ ঠিকানা নির্দেশ করে, তাহলে গ্রাহককে তাদের প্রবেশ করানো ডেটা পরীক্ষা করার জন্য ঠিকানা এন্ট্রি ফর্মে পুনঃনির্দেশিত করুন। ঠিকানাটি ঠিক হয়ে গেলে, আপনার পরিষেবাটি ঠিকানা যাচাইকরণ API-তে পুনরায় পাঠাতে হবে যাতে সংশোধনগুলি বৈধ হয় তা নিশ্চিত করা যায়।
আপনি addressComponents স্তরে ফিরে আসা সংকেতগুলি ব্যবহার করে নির্দিষ্ট ঠিকানা লাইন ত্রুটিগুলিও হাইলাইট করতে পারেন। এর একটি উদাহরণ ডানদিকের স্ক্রিনশটে দেখা যাবে।
নিশ্চিত করুন
এই বিভাগটি দেখায় কিভাবে একটি ঠিকানা নিশ্চিত করতে হয়। ঠিকানা যাচাইকরণ API কোন নির্দিষ্ট সংকেত ফেরত পাঠায় যা নির্দেশ করে যে একটি ঠিকানা নিশ্চিত করা উচিত, সে সম্পর্কে তথ্যের জন্য, "আপনার বৈধতা লজিক ডকুমেন্টেশন তৈরি করুন" বিভাগে একটি ঠিকানা নিশ্চিত করুন দেখুন।
প্রায়শই আপনার সিস্টেম ব্যবহারকারীকে ঠিকানা নিশ্চিত করার জন্য অনুরোধ করবে। উদাহরণস্বরূপ, একজন গ্রাহক শহরের নামের বানান ভুল করে ফেলেন, যা পরে ঠিকানা যাচাইকরণ API দ্বারা সংশোধন করা হবে। আপনার গ্রাহকের সাথে এই সংশোধনটি নিশ্চিত করা উচিত। কারণ API দ্বারা করা পরিবর্তনগুলি মূলত যা প্রবেশ করানো হয়েছিল তা মৌলিকভাবে পরিবর্তন করতে পারে।
গ্রাহকের কাছে তথ্য প্রদর্শনের জন্য একটি ইন্টারস্টিশিয়াল মডেল ব্যবহার করুন, যা এগিয়ে যাওয়ার জন্য তিনটি বিকল্প সক্ষম করে:
- API দ্বারা ফেরত দেওয়া ঠিকানাটি নিশ্চিত করুন, এবং সংশোধন করা ঠিকানা ব্যবহার করে চেকআউট প্রক্রিয়া চলতে থাকবে।
- ঠিকানা যাচাইকরণ API থেকে সংশোধন উপেক্ষা করে, মূলত যে ঠিকানাটি প্রবেশ করানো হয়েছিল সেটি নির্বাচন করুন। চেকআউট প্রক্রিয়াটি স্বাভাবিকভাবেই চলতে পারে এবং আপনার প্রক্রিয়া যদি অনুমতি দেয় তবে অর্ডারটি শিপিংয়ের আগে ডাউনস্ট্রিম পর্যালোচনার জন্য ফ্ল্যাগ করা যেতে পারে।
- গ্রাহক মোডালটি বাতিল করেন অথবা তা থেকে সরে আসেন, তাদের চেকআউট প্রক্রিয়ার ঠিকানা প্রবেশের পর্যায়ে ফিরিয়ে দেন, যেখানে তারা পুনরায় ঠিকানাটি প্রবেশ করতে পারেন, প্রক্রিয়াটি আবার শুরু করে।
এর একটি উদাহরণ ডানদিকের স্ক্রিনশটে দেখা যাবে।
গ্রহণ করুন
এই বিভাগটি দেখায় কিভাবে একটি ঠিকানা গ্রহণ করতে হয়। ঠিকানা যাচাইকরণ API কোন নির্দিষ্ট সংকেতগুলি ফেরত দেয় যা নির্দেশ করে যে একটি ঠিকানা ভাল মানের এবং গ্রহণ করা উচিত, সে সম্পর্কে তথ্যের জন্য, আপনার বৈধতা লজিক ডকুমেন্টেশন তৈরি করুন-এ একটি ঠিকানা গ্রহণ করুন দেখুন।
এই পরিস্থিতিতে, চেকআউট প্রক্রিয়াটি পরবর্তী পর্যায়ে চলে যাবে, সম্ভবত পেমেন্ট ক্যাপচার, যেখানে গ্রাহককে ঠিকানার মানের বিষয়ে কোনও অনুরোধ জানানো হবে না। API নিশ্চিত করেছে যে গ্রাহকের প্রবেশ করানো ঠিকানাটি ভালো মানের এবং ডেলিভারিযোগ্য।
আমরা অর্ডারের বিপরীতে ঠিকানা যাচাইকরণ API থেকে ফেরত ঠিকানার ডেটা ব্যবহার করার পরামর্শ দিচ্ছি, কারণ এতে ছোটখাটো সংশোধন এবং সংযোজন থাকতে পারে, যেমন:
- বড় হাতের অক্ষর
- বিন্যাস সংশোধন, উদাহরণস্বরূপ
- স্ট্রিট টু স্ট্রিটে
- ঠিকানা উপাদানগুলির সঠিক ক্রম
- মার্কিন যুক্তরাষ্ট্রে জিপ+৪।
বাস্তবায়ন বিবেচনা
আপনার ঠিকানা গ্রহণের লজিক তৈরি করার সময়, নিশ্চিত করুন যে আপনার বাস্তবায়ন গ্রাহকদের একটি অবৈধ ঠিকানা প্রবেশের কারণে চেক আউট করতে বাধা দিচ্ছে না। এমনভাবে লজিক তৈরি করুন যাতে API বারবার তাদের এন্ট্রি অবৈধ বলে নির্দেশ করলে একটি অসীম লুপের সম্ভাবনা রোধ করা যায়।
গুগল আপনাকে সুপারিশ করছে যে আপনি গ্রাহকদের তাদের ঠিকানা প্রবেশের জন্য দুটি সুযোগ দিন এবং দ্বিতীয় প্রচেষ্টায়, তাদের প্রবেশপত্র গ্রহণ করুন, এমনকি যদি এটি বৈধ নাও হয়। দ্বিতীয় প্রচেষ্টায়, লক্ষ্য হল বৈধতা নির্বিশেষে তাদের এগিয়ে যেতে দেওয়া।
দ্বিতীয় প্রচেষ্টা গ্রহণের জন্য দুটি প্রস্তাবিত পদ্ধতি:
- জোর করে এগিয়ে যাওয়া: গ্রাহককে ঠিকানাটি বৈধ নয় এমন একটি মডেল দেখান, তবে তাদের টাইপ করা ঠিকানাটি চালিয়ে যাওয়ার বিকল্পটি মঞ্জুর করুন।
- নীরব গ্রহণ: ঠিকানাটি সম্পূর্ণরূপে যাচাই না হলেও, নিশ্চিতকরণ পদক্ষেপ ছাড়াই দ্বিতীয় প্রচেষ্টা স্বয়ংক্রিয়ভাবে গ্রহণ করুন।
যদি সম্ভব হয়, তাহলে আপনার সিস্টেমটি এমনভাবে ডিজাইন করুন যেগুলি বৈধ নয় এমন ঠিকানাগুলিকে চিহ্নিত করুন, যাতে একজন গ্রাহক পরিষেবা প্রতিনিধি অর্ডার পাঠানোর আগে সেগুলি পর্যালোচনা করতে পারেন। এই অতিরিক্ত ব্যবস্থা নিশ্চিত করে যে আপনি কোনও ভুল ধরতে পারবেন।
নতুন ভবন নির্মাণের মাধ্যমে কেন এই চেকটি সুপারিশ করা হচ্ছে তার একটি ভালো উদাহরণ পাওয়া যায়। নতুন ভবন নির্মাণ শেষ হওয়ার পর থেকে ডাক ঠিকানা ডাটাবেসে ভবনের ঠিকানা পূরণের মধ্যে একটি ব্যবধান থাকতে পারে। গ্রাহকদের তাদের টাইপ করা ঠিকানা সহ চেকআউট পৃষ্ঠাটি জোর করে এগিয়ে যাওয়ার বিকল্প থাকা উচিত, এমনকি যদি এটি যাচাই নাও হয়।
একবার চেকআউট সেশন সম্পন্ন হয়ে গেলে, নির্দিষ্ট ঠিকানা যাচাইকরণ প্রচেষ্টা সম্পর্কে Google-কে প্রতিক্রিয়া পাঠাতে ঐচ্ছিকভাবে provideValidationFeedback পদ্ধতি ব্যবহার করুন।
উপসংহার
এই ডকুমেন্টে গুগল ম্যাপে অটোকম্পলিট, অ্যাড্রেস ভ্যালিডেশন এবং ভিজ্যুয়াল কনফার্মেশন বাস্তবায়নের একটি সারসংক্ষেপ দেওয়া হয়েছে। প্রস্তাবিত অ্যাড্রেস এন্ট্রি ফ্লো অনুসরণ করে আপনার বাস্তবায়ন ডিজাইন করার জন্য এই ডকুমেন্টটিকে একটি সূচনা বিন্দু হিসেবে ব্যবহার করুন।
পরবর্তী পদক্ষেপ
নির্ভরযোগ্য ঠিকানা সহ চেকআউট, ডেলিভারি এবং অপারেশন উন্নত করুন শ্বেতপত্র ডাউনলোড করুন এবং ঠিকানা যাচাইকরণ ওয়েবিনার সহ চেকআউট, ডেলিভারি এবং অপারেশন উন্নত করুন দেখুন।
আরও পড়ার পরামর্শ দেওয়া হচ্ছে:
- স্বয়ংক্রিয়ভাবে সম্পূর্ণ ডকুমেন্টেশন রাখুন
- ঠিকানা যাচাইকরণ API ডকুমেন্টেশন
- গুগল ম্যাপস প্ল্যাটফর্ম রিপোর্টিং
অবদানকারীরা
হেনরিক ভালভ | সলিউশন ইঞ্জিনিয়ার
টমাস অ্যাংলারেট | সলিউশন ইঞ্জিনিয়ার
সার্থক গাঙ্গুলি | সমাধান প্রকৌশলী
মার্কিন যুক্তরাষ্ট্রের ডাক পরিষেবার নন-এক্সক্লুসিভ লাইসেন্সধারী। নিম্নলিখিত ট্রেডমার্ক(গুলি) মার্কিন যুক্তরাষ্ট্রের ডাক পরিষেবা® এর মালিকানাধীন এবং অনুমতিক্রমে ব্যবহৃত হয়: CASS™, USPS®, DPV®। ↩