একটি মৌলিক ঠিকানা বৈধতা প্রতিক্রিয়া বুঝতে

অ্যাড্রেস ভ্যালিডেশন এপিআই রেসপন্সে এই শীর্ষ-স্তরের প্রোপার্টিগুলো থাকে:

{
  // Address details determined by the API.
  "address": {},
  // Validation verdict.
  "verdict": {},
  // The geocode generated for the input address.
  "geocode": {},
  // Information indicating if the address is a business, residence, etc.
  "metadata": {},
  // Information about the address from the US Postal Service
  // ("US" and "PR" addresses only).
  "uspsData": {},
  // A unique identifier generated for every request to the API.
  "responseId": "ID"
}

verdict সম্পত্তি

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

"verdict": {
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "possibleNextAction": "ACCEPT",
  "addressComplete": true,
  "hasUnconfirmedComponents": false,
  "hasInferredComponents": true,
  "hasReplacedComponents": false
}

নিম্নলিখিত বিভাগগুলিতে verdict প্রপার্টির সমস্ত ফিল্ডের সারসংক্ষেপ দেওয়া হয়েছে।

রেফারেন্স গাইডে রায় দেখুন।

ঠিকানার সূক্ষ্মতা

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

verdict প্রপার্টিটি এই গ্র্যানুলারিটি সিগন্যালগুলো রিটার্ন করে:

  • inputGranularity — ম্যাপস জাভাস্ক্রিপ্ট এপিআই-এর অ্যাড্রেস ভ্যালিডেশনে পাঠানো ঠিকানা থেকে সংগৃহীত তথ্যের বিস্তারিত স্তরকে বর্ণনা করে। অনুরোধে ঠিকানার বিস্তারিত স্তর, ভ্যালিডেশন প্রতিক্রিয়ায় ঠিকানার বিস্তারিত স্তরকে প্রভাবিত করে। উদাহরণস্বরূপ, PREMISE স্তরের নিচে inputGranularity কোনো ঠিকানার validationGranularity সাধারণত PREMISE স্তরে পৌঁছায় না।
  • validationGranularity — এটি সেই গ্র্যানুলারিটি লেভেল, যে পর্যন্ত ম্যাপস জাভাস্ক্রিপ্ট এপিআই-এর অ্যাড্রেস ভ্যালিডেশন একটি ঠিকানাকে সম্পূর্ণরূপে যাচাই করতে পারে। বেশিরভাগ ক্ষেত্রে, PREMISE বা SUB_PREMISE গ্র্যানুলারিটি লেভেল একটি মানসম্মত ঠিকানাকে নির্দেশ করে, যা ডেলিভারিযোগ্য হওয়ার সম্ভাবনা বেশি।
  • geocodeGranularity — ঠিকানার সাথে যুক্ত জিওকোডের বিস্তারিত তথ্যের স্তর বর্ণনা করে। উদাহরণস্বরূপ, গুগলের রেকর্ডে একটি অ্যাপার্টমেন্ট নম্বরের অস্তিত্বের উল্লেখ থাকতে পারে, কিন্তু একটি বড় অ্যাপার্টমেন্ট কমপ্লেক্সের মধ্যে সেই নির্দিষ্ট অ্যাপার্টমেন্টটির সঠিক অবস্থানের উল্লেখ নাও থাকতে পারে। সেক্ষেত্রে, validationGranularity হয় SUB_PREMISE কিন্তু geocodeGranularity হয় PREMISE ।
রেফারেন্স গাইডে গ্র্যানুলারিটি দেখুন।

ঠিকানার সম্পূর্ণতা

রায়টি একটি উচ্চ-মানের ঠিকানার সংকেত হিসেবে addressComplete প্রপার্টিটি ফেরত দেয়, যার সুনির্দিষ্ট অর্থ হলো এতে কোনো অনুপস্থিত, অমীমাংসিত বা অপ্রত্যাশিত উপাদান নেই:

"verdict": {
    "inputGranularity": "PREMISE",
    "validationGranularity": "PREMISE",
    "geocodeGranularity": "PREMISE",
    "addressComplete": true
}

ঠিকানায় কোনো উপাদান অনুপস্থিত, অমীমাংসিত বা অপ্রত্যাশিত থাকলে, ফিল্ডটির মান false সেট করা হয়।

রেফারেন্স গাইডের Verdict এবং Address অংশের অধীনে addressComplete দেখুন।

ঠিকানার গুণমান

বেশ কিছু সম্ভাব্য ফিল্ড অ্যাড্রেসের উপাদানগুলিতে সমস্যা, অথবা সেগুলির পরিবর্তন, যেমন অনুমিত বা অনুপস্থিত অ্যাড্রেসের উপাদান নির্দেশ করে। উদাহরণস্বরূপ, নিম্নলিখিত verdict প্রপার্টিটি এমন একটি অ্যাড্রেস নির্দেশ করে যার উপাদানগুলি অপ্রমাণিত এবং addressComplete ফিল্ডটি অনুপস্থিত:

"verdict": {
    "inputGranularity": "PREMISE",
    "validationGranularity": "OTHER",
    "geocodeGranularity": "OTHER",
    "hasUnconfirmedComponents": true,
    "hasInferredComponents": true
}
রেফারেন্স গাইডে রায় দেখুন।

সম্ভাব্য পরবর্তী পদক্ষেপ

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

address এবং addressComponent বৈশিষ্ট্য

address প্রপার্টিটি অনুরোধে প্রদত্ত প্রক্রিয়াকৃত ঠিকানার ফরম্যাটিং প্রদান করে এবং এর সাথে ঠিকানার উপাদান-ভিত্তিক সারাংশও দেয়, যার মধ্যে ঠিকানার ভুল বানানযুক্ত অংশ, প্রতিস্থাপিত ভুল অংশ এবং অনুমানকৃত অনুপস্থিত অংশ অন্তর্ভুক্ত থাকে।

রেফারেন্স গাইডে Address দেখুন।

addressComponent প্রপার্টিটি হলো address এর একটি উপ-উপাদান, যা Maps JavaScript API-এর Address Validation দ্বারা প্রক্রিয়াকৃত ঠিকানার উপাদানগুলোর একটি বিস্তারিত তালিকা প্রদান করে। API প্রতিটি উপাদান ফিল্ডকে তার নাম, টাইপ এবং কনফার্মেশন লেভেল দ্বারা শনাক্ত করে।

রেফারেন্স গাইডে addressComponent দেখুন।

geocode প্রপার্টি

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

রেফারেন্স গাইডে Geocode দেখুন।

metadata প্রপার্টি

Maps JavaScript API-এর Address Validation দ্বারা প্রক্রিয়াকৃত প্রতিটি ঠিকানার জন্য এই প্রপার্টিটি পূরণ নাও হতে পারে, কিন্তু এটি নির্দেশ করে যে ঠিকানাটি আবাসিক, ব্যবসায়িক, নাকি একটি PO Box ধরনের।

ঠিকানা যাচাইকরণ এপিআই-এর আওতা এবং Address metadata রেফারেন্স দেখুন।

uspsData প্রপার্টি

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

মার্কিন যুক্তরাষ্ট্রের ঠিকানা পরিচালনা এবং USPSData এর রেফারেন্স দেখুন।