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

ঠিকানা যাচাইকরণ API প্রতিক্রিয়াতে এই শীর্ষ-স্তরের বৈশিষ্ট্যগুলি রয়েছে:

{
  // 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 — Maps JavaScript API-তে ঠিকানা যাচাইকরণে প্রেরিত ঠিকানা থেকে প্রাপ্ত বিশদের স্তর বর্ণনা করে। অনুরোধে ঠিকানার বিশদের স্তর যাচাইকরণ প্রতিক্রিয়ায় ঠিকানার বিশদের স্তরকে প্রভাবিত করে। উদাহরণস্বরূপ, PREMISE স্তরের নীচে inputGranularity সহ একটি ঠিকানা সাধারণত PREMISE স্তরে validationGranularity ফলাফল দেয় না।
  • validationGranularity — Maps JavaScript API-তে ঠিকানা যাচাইকরণ যে গ্র্যানুলারিটি স্তরে ঠিকানাটিকে সম্পূর্ণরূপে যাচাই করতে পারে। বেশিরভাগ ক্ষেত্রে, PREMISE বা SUB_PREMISE এর গ্র্যানুলারিটি স্তর এমন একটি গুণমানের ঠিকানা নির্দেশ করে যা সম্ভবত বিতরণযোগ্য।
  • geocodeGranularity — ঠিকানার সাথে সম্পর্কিত জিওকোডের বিশদের স্তর বর্ণনা করে। উদাহরণস্বরূপ, গুগল রেকর্ডগুলি একটি অ্যাপার্টমেন্ট নম্বরের অস্তিত্ব নির্দেশ করতে পারে, কিন্তু একটি বৃহৎ অ্যাপার্টমেন্ট কমপ্লেক্সের মধ্যে সেই নির্দিষ্ট অ্যাপার্টমেন্টের জন্য একটি সুনির্দিষ্ট অবস্থান নির্দেশ করতে পারে না। সেক্ষেত্রে, validationGranularity হল SUB_PREMISE কিন্তু geocodeGranularity হল PREMISE ।
রেফারেন্স গাইডে গ্রানুলারিটি দেখুন।

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

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

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

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

রেফারেন্স গাইডে রায় এবং ঠিকানার অধীনে addressComplete দেখুন।

ঠিকানার মান

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

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

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

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

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

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

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

addressComponent প্রপার্টি হল address একটি উপ-উপাদান যা Maps JavaScript API-তে ঠিকানা যাচাইকরণ প্রক্রিয়াকৃত ঠিকানার উপাদানগুলি—অথবা উপাদানগুলির—একটি বিস্তারিত তালিকা প্রদান করে। API প্রতিটি উপাদান ক্ষেত্রকে তার নাম, ধরণ এবং নিশ্চিতকরণ স্তর দ্বারা চিহ্নিত করে।

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

geocode সম্পত্তি

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

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

metadata সম্পত্তি

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

ঠিকানা যাচাইকরণ API কভারেজ এবং Address metadata রেফারেন্স দেখুন।

uspsData সম্পত্তি

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

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