এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

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

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

সাধারণ উদাহরণ: ঠিক করুন

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

Missing city and postal code

এই উদাহরণটি এমন একটি এন্ট্রিকে চিত্রিত করে যেখানে শুধুমাত্র রাস্তার ঠিকানা আছে, কোন শহর বা পোস্টাল কোড নেই।

ঠিকানা প্রবেশ	অঞ্চল
21 45 40 তম রাস্তা	USA

শহর এবং পোস্টাল কোড অনুপস্থিত জন্য রায়

নীচের উদাহরণটি প্রতিক্রিয়া থেকে গুরুত্বপূর্ণ সংকেতগুলির উপর জোর দেয়।

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "OTHER",
  "geocodeGranularity": "OTHER",
  "hasUnconfirmedComponents": true,
  "possibleNextAction": "FIX"
}

possibleNextAction একটি প্রাথমিক ইঙ্গিত দেয় যে ঠিকানাটি বিতরণযোগ্য নাও হতে পারে। অন্যান্য হাইলাইট করা উপাদানগুলিও এই সম্ভাবনাকে সমর্থন করে, তাই আপনি আরও জানতে addressComponents জিজ্ঞাসা করতে পারেন:

{
  "componentName": {
    "text": "21",
    "languageCode": "en"
  },
  "componentType": "street_number",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
},
{
  "componentName": {
    "text": "45 40th street",
    "languageCode": "en"
  },
  "componentType": "route",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
},
{
  "componentName": {
    "text": "United States",
    "languageCode": "en"
  },
  "componentType": "country",
  "confirmationLevel": "CONFIRMED"
}

The Address Validation API returns only the country (United States) as CONFIRMED . এটি UNCONFIRMED_BUT_PLAUSIBLE হিসাবে অন্যান্য সমস্ত ঠিকানা উপাদান প্রদান করে, ডেটাতে কিছু গুরুত্বপূর্ণ বাদ দিয়ে, যেমন স্থানীয়তা এবং পোস্টাল কোড।

রাস্তার নম্বর অনুপস্থিত

This example shows a missing street number.

ঠিকানা দেওয়া হয়েছে	অঞ্চল
বাকিংহাম প্যালেস রোড, SW1W 9TQ লন্ডন	যুক্তরাজ্য

Verdict for missing street number

{
    "inputGranularity": "PREMISE_PROXIMITY",
    "validationGranularity": "ROUTE",
    "geocodeGranularity": "ROUTE",
    "possibleNextAction": "FIX"
}

Once again, the possibleNextAction provides an initial indication that the address might not be deliverable. তদ্ব্যতীত, validationGranularity হল ROUTE , যা রাস্তার সাথে একটি মিল নির্দেশ করে, কিন্তু প্রিমাইজে যাওয়ার জন্য যথেষ্ট তথ্য নয়। উপরন্তু, addressComplete সম্পত্তি রায় থেকে অনুপস্থিত, এবং তাই এটি false । A further query of the address object reveals a missing component type:

"missingComponentTypes": [
        "street_number"
      ]

এজ-কেস উদাহরণ: ঠিক করুন

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

Unconfirmed street number

এই পরিস্থিতিতে, ঠিকানা যাচাইকরণ API সরবরাহকৃত রাস্তার নম্বর নিশ্চিত করতে পারে না, তবুও এটি নির্দেশ করে যে ঠিকানাটি সম্পূর্ণ।

ঠিকানা প্রবেশ	অঞ্চল
84 Buckingham Palace Road, SW1W 9TQ, London	যুক্তরাজ্য

Verdict for unconfirmed street number

নীচের উদাহরণটি গুরুত্বপূর্ণ সংকেতগুলির উপর জোর দেয়।

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE_PROXIMITY",
  "geocodeGranularity": "PREMISE_PROXIMITY",
  "addressComplete" : true,
  "hasUnconfirmedComponents": true,
  "possibleNextAction": "ACCEPT"
}

এটি একটি বৈধতা গ্রানুলারিটির সংমিশ্রণটি শুধুমাত্র অপ্রমাণিত উপাদানগুলির সাথে প্রিমাইজ-লেভেল আনুমানিকতার সাথে তদন্ত করার জন্য মূল্যবান। A query of the addressComponents property shows the following unconfirmed componentType :

{
  "componentName": {
    "text": "84",
    "languageCode": "en"
  },
  "componentType": "street_number",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}

এখানে, street_number confirmation_level UNCONFIRMED_BUT_PLAUSIBLE এ সেট করা হয়েছে। অনিশ্চিত মানে পরিষেবাটি তার ডেটাসেটের 84 নম্বর রাস্তার সাথে মেলে না, এবং যুক্তিসঙ্গত মানে হল যে উপাদান ডেটা এখনও বৈধ হতে পারে।

অ্যাকশন: আপনি হয় ইনপুটটি প্রবেশ করান হিসাবে গ্রহণ করতে পারেন, অথবা প্রবেশ করা রাস্তার নম্বরটি উদ্দেশ্য বা ত্রুটি ছিল কিনা তা নির্ধারণ করতে গ্রাহকের সাথে নিশ্চিত করতে পারেন। আপনার প্রতিক্রিয়া আপনার ডেলিভারির সাথে যুক্ত ঝুঁকির স্তরের উপর নির্ভর করে। আপনার বৈধতা যুক্তি তৈরিতে বাস্তবায়ন নির্দেশিকা দেখুন।

অনুপস্থিত subpremise

এই দৃশ্যটি এমন একটি ঠিকানা বর্ণনা করে যেটিতে শুধুমাত্র একটি উপপ্রমাস নেই, যেমন একটি অ্যাপার্টমেন্ট বা বিভাগ নম্বর। Otherwise, the Address Validation API can fully validate the address. যেমনটি হয় যখন কোনো ঠিকানা উপাদান অনুপস্থিত থাকে, addressComplete false এবং তাই রায়ের ম্যানুয়াল পরিদর্শনে উপস্থিত নয়।

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

ঠিকানা প্রবেশ	অঞ্চল
1 Doctor Carlton B Goodlett Place, San Francisco, CA 94102	USA

Verdict for missing subpremise

এই উদাহরণে, রায়টি addressComplete সম্পত্তি প্রদর্শন করে না, তাই এটি false । Because of this, you know that at least one address element is unexpected, unresolved, or missing.

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "hasInferredComponents": true,
  "possibleNextAction": "CONFIRM_ADD_SUBPREMISES"
}

An address query reveals the following:

"missingComponentTypes": [
        "subpremise"
      ]

আরও অনুসন্ধানের পরে, ইউএসপিএস ডেটা D এর একটি dpvConfirmation কোড প্রদান করে, যা একটি অনুপস্থিত সাবপ্রিমাইজও নির্দেশ করে।