বৈধতা যুক্তি তৈরি করুন

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

সাধারণভাবে, API প্রতিক্রিয়া আপনার সিস্টেমের ঠিকানা পরিচালনা করার নিম্নলিখিত উপায়গুলি নির্ধারণ করে:

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

মূল উদ্দেশ্য

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

if (the API response indicates significant problems in the address)
    FIX - prompt the user to fix the address
else if (the API response indicates less significant problems in the address)
    CONFIRM - confirm with the user that the address is correct
else
    ACCEPT - continue with the address returned by the API.

সঠিক যুক্তি আপনার পরিস্থিতির উপর নির্ভর করে; আরও বিস্তারিত জানার জন্য বাস্তবায়ন নির্দেশিকা দেখুন। আপনি এই যুক্তির আমাদের ওপেন সোর্স বাস্তবায়নও ব্যবহার করতে পারেন, যা এক্সটেন্ডেড কম্পোনেন্ট লাইব্রেরিতে রয়েছে।

কর্মপ্রবাহের ওভারভিউ

নীচের টেবিলটি আপনার সিস্টেমের জন্য দুটি পদক্ষেপের সারসংক্ষেপ তুলে ধরেছে:

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

আপনার সিস্টেমের আচরণ
ঠিকানা ঠিক করো	verdict উত্তরে উল্লেখ করা হয়েছে যে গুরুত্বপূর্ণ তথ্য অনুপস্থিত যা প্রদান করা উচিত। API দ্বারা প্রদত্ত ঠিকানাটি সরবরাহযোগ্য মানের নাও হতে পারে। কর্মপ্রবাহ প্রয়োজনে ঠিকানার উপাদানগুলি পরীক্ষা করুন। গ্রাহককে ঠিকানা সংক্রান্ত সমস্যা সমাধানের জন্য অনুরোধ করুন। আপডেট করা ঠিকানার বৈধতার জন্য অনুরোধ করুন। ঠিকানা দিয়ে এগিয়ে যান। রায়ের সংকেত নিম্নলিখিত যেকোনো একটি প্রযোজ্য: validationGranularity OTHER তে সেট করা হয়েছে। addressComplete false ।
ঠিকানা নিশ্চিত করুন	verdict প্রতিক্রিয়াটি একটি বিতরণযোগ্য ঠিকানা নির্দেশ করে, কিন্তু মূল ইনপুটে পরিবর্তন করা হয়েছে: অনুমান করা ডেটা যা হয় বানান সংশোধন করা হয়েছে, অথবা এমন ডেটা যা নিশ্চিত করা যেতে পারে। কর্মপ্রবাহ প্রয়োজনীয় সংশোধন: প্রয়োজনে ঠিকানার উপাদানগুলি পরীক্ষা করুন। আপডেট করা ঠিকানার বৈধতার জন্য অনুরোধ করুন। ঠিকানা দিয়ে এগিয়ে যান। কোন সংশোধনের প্রয়োজন নেই: ঠিকানা দিয়ে এগিয়ে যান। রায়ের সংকেত নিম্নলিখিত সবগুলি প্রযোজ্য: validationGranularity ROUTE রয়েছে addressComplete true । hasInferredComponents ক্ষেত্রটি true অথবা hasReplacedComponents ক্ষেত্রটি true ।
ঠিকানা গ্রহণ করুন	ঠিকানা যাচাইকরণ API প্রতিক্রিয়াটি একটি চমৎকার মানের ঠিকানা নির্দেশ করে। কর্মপ্রবাহ ফেরত ঠিকানা দিয়ে এগিয়ে যান। রায়ের সংকেত নিম্নলিখিত সবগুলি প্রযোজ্য: validationGranularity তে PREMISE বা তার চেয়ে ভালো কিছু থাকে। addressComplete true । কোনও অনুমানকৃত বা প্রতিস্থাপিত উপাদান নেই ।

বাস্তবায়ন নির্দেশিকা

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

	নির্দেশনা	বিস্তারিত
ঝুঁকির মাত্রা	সংশোধনের জন্য অনুরোধ জানানো এবং প্রবেশ করানো ঠিকানা গ্রহণ করার মধ্যে ভারসাম্য বজায় রাখার সময় আপনার পরিস্থিতির প্রতি সহনশীলতার মাত্রা বিবেচনা করুন।	ঠিকানা যাচাইকরণ API বিভিন্ন ধরণের সংকেত প্রদান করে যা আপনি আপনার যাচাইকরণ প্রক্রিয়াটি অপ্টিমাইজ করার জন্য আপনার ঝুঁকি স্তরের সাথে অন্তর্ভুক্ত করতে পারেন। উদাহরণস্বরূপ, যদি কোনও ঠিকানার একটি অনিশ্চিত রাস্তার নম্বর থাকে, তবুও আপনি এটি গ্রহণ করতে পারেন। অন্যদিকে, যদি আপনার ব্যবসার পরিচালনার জন্য আরও স্পষ্ট ঠিকানার প্রয়োজন হয়, তাহলে আপনি আপনার ব্যবহারকারীকে অনুরোধ করতে পারেন। যে কোনও বিভাগে পড়তে পারে এমন একটি উদাহরণের জন্য, Accept address - examples - এ Non-US unconfirmed street number দেখুন।
ঠিকানা গ্রহণ করুন	গ্রাহক যদি প্রম্পটে সাড়া না দেন, তাহলে আপনার সিস্টেমকে মূল এন্ট্রি গ্রহণ করার অনুমতি দেওয়া একটি ভালো অভ্যাস।	এই ক্ষেত্রে, গ্রাহক এমন কোনও ঠিকানা প্রবেশ করিয়ে থাকতে পারেন যা সিস্টেমে নেই, যেমন নতুন নির্মাণের জন্য।

ডেমোটি ব্যবহার করে দেখুন। উপরে বর্ণিত ফিক্স, কনফার্ম, অ্যাকসেপ্ট ফ্লো প্রক্রিয়াটি বুঝতে সাহায্য করার জন্য এই ডকুমেন্টের বাকি অংশে বিভিন্ন উদাহরণ ব্যবহার করা হয়েছে। আপনি ম্যাপস জাভাস্ক্রিপ্ট এপিআই ডেমোতে অ্যাড্রেস ভ্যালিডেশনে এই উদাহরণগুলি প্রবেশ করিয়ে ফলাফলগুলি অন্বেষণ করতে পারেন।

ঠিকানা ঠিক করুন

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

সিগন্যাল ঠিক করুন

ঠিকানা যাচাইকরণ API আপনাকে জানাতে বেশ কয়েকটি সংকেত প্রদান করে যে কোনও ঠিকানা ঠিক করা উচিত কিনা।

১. বৈধতা গ্র্যানুলারিটি এবং অনুপস্থিত উপাদান

এই দুটি সংকেত একটি সমস্যাযুক্ত ঠিকানার সর্বোত্তম ইঙ্গিত প্রদান করে:

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

2. অন্যান্য সংকেত

ঠিকানা যাচাইকরণ API নির্দিষ্ট সমস্যাগুলি নির্ণয়ে সহায়তা করার জন্য অন্যান্য সংকেতও প্রদান করে:

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

৩. মার্কিন ঠিকানা সংকেত

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

dpvConfirmation	হয় N , D , অথবা খালি।

dpvConfirmation সম্পর্কে বিস্তারিত জানার জন্য, মার্কিন যুক্তরাষ্ট্রের ঠিকানাগুলি পরিচালনা করুন দেখুন।

ঠিকানার উদাহরণ ঠিক করুন

ঠিকানা নিশ্চিত করুন

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

গ্রাহককে সঠিক প্রম্পটিং প্রদানের জন্য, আপনার লজিক পরিষেবা দ্বারা চিহ্নিত উপাদানগুলিকে সনাক্ত করবে যাতে API কোন ক্রিয়া বা ফ্ল্যাগ উপাদানটিতে প্রয়োগ করেছে তা নির্ধারণ করা যায়, যেমন inferred , replaced , অথবা spellCorrected । রেফারেন্সে AddressComponent দেখুন।

দ্রষ্টব্য: গ্রাহকের সাথে ঠিকানাটি নিশ্চিত করবেন নাকি বৈধ হিসেবে গ্রহণ করবেন তা সিদ্ধান্ত নেওয়ার সময় আপনার ঝুঁকির মাত্রা বিবেচনা করুন।

সিগন্যাল নিশ্চিত করুন

ঠিকানা যাচাইকরণ API আপনাকে জানাতে বেশ কয়েকটি সংকেত প্রদান করে যে কোনও ঠিকানা নিশ্চিত করা উচিত কিনা।

১. ভ্যালিডেশন গ্রানুলারিটি

ROUTE বা তার চেয়ে ভালো মানের একটি validationGranularity গ্রহণযোগ্য, তবে PREMISE বা SUBPREMISE যেকোনো একটি ডেলিভারিযোগ্যতার একটি শক্তিশালী সংকেত প্রদান করে।

2. অন্যান্য সংকেত

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

অনুমানিত তথ্য	যখন hasInferredComponents ক্ষেত্রটি true হয়, তখন আপনি জানেন যে API অন্যান্য ঠিকানা উপাদান থেকে তথ্য সংগ্রহ করেছে।
প্রতিস্থাপিত ডেটা	যখন hasReplacedComponents ক্ষেত্রটি true হয়, তখন API প্রবেশ করানো ডেটাকে এমন ডেটা দিয়ে প্রতিস্থাপন করে যা ঠিকানাটিকে বৈধ বলে মনে করে।

৩. মার্কিন ঠিকানা সংকেত

শুধুমাত্র মার্কিন ঠিকানার ক্ষেত্রে প্রযোজ্য কিছু ক্ষেত্র নির্দেশ করে যে আপনার যুক্তি গ্রাহকের সাথে বিশদ নিশ্চিত করবে। নিম্নলিখিতগুলির যেকোনো একটি প্রযোজ্য:

dpvConfirmation	S dpvConfirmation সম্পর্কে বিস্তারিত জানার জন্য, মার্কিন যুক্তরাষ্ট্রের ঠিকানাগুলি পরিচালনা করুন দেখুন।
ঠিকানার প্রতিক্রিয়া	subpremise মান সহ missingComponentTypes ফিল্ড রয়েছে। দ্রষ্টব্য : যদি ক্ষেত্রটিতে subpremise ব্যতীত অন্য প্রকার থাকে, তাহলে ক্রিয়াটি ফিক্স ঠিকানা বিভাগে পড়বে। জিওকোডিং ডকুমেন্টেশনে ঠিকানার প্রকারের সম্পূর্ণ তালিকা দেখুন।

ঠিকানার উদাহরণ নিশ্চিত করুন

ঠিকানা গ্রহণ করুন

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

সংকেত গ্রহণ করুন

ঠিকানা যাচাইকরণ API আপনাকে জানাতে বেশ কয়েকটি সংকেত প্রদান করে যে কোনও ঠিকানা নিশ্চিত করা উচিত কিনা।

১. ভ্যালিডেশন গ্রানুলারিটি

PREMISE বা তার চেয়ে ভালো একটি validationGranularity গ্রহণযোগ্য, তবে কিছু ক্ষেত্রে, ROUTE এখনও একটি ডেলিভারিযোগ্য ঠিকানা নির্দেশ করে।

2. অন্যান্য সংকেত

একটি উচ্চমানের ঠিকানার রায়ে নিম্নলিখিত বিষয়গুলিও অন্তর্ভুক্ত করা উচিত:

• কোনও প্রতিস্থাপিত ডেটা নেই । এই ক্ষেত্রে, hasReplacedComponents: FALSE ।
• কোন অনুমানকৃত উপাদান নেই । এই ক্ষেত্রে, hasInferredComponents: FALSE ।

৩. মার্কিন ঠিকানা সংকেত

শুধুমাত্র মার্কিন ঠিকানার ক্ষেত্রে প্রযোজ্য কিছু ক্ষেত্র উচ্চমানের ঠিকানা নির্দেশ করে যেখানে ডেলিভারি করা যেতে পারে। একটি গ্রহণযোগ্য মার্কিন ঠিকানার জন্য, আপনার নিম্নলিখিতগুলি দেখা উচিত:

dpvConfirmation	Y dpvConfirmation সম্পর্কে বিস্তারিত জানার জন্য, মার্কিন যুক্তরাষ্ট্রের ঠিকানাগুলি পরিচালনা করুন দেখুন।

ঠিকানার উদাহরণ গ্রহণ করুন