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

ঠিকানা যাচাইকরণ 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 সম্পত্তি দেখায়, যা এই বিশেষ অনুরোধের জন্য 4টি ক্ষেত্র প্রদান করে:

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

নিম্নলিখিত বিভাগগুলি verdict সম্পত্তির সমস্ত ক্ষেত্রকে সংক্ষিপ্ত করে।

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

ঠিকানার গ্রানুলারিটি

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

verdict সম্পত্তি এই গ্রানুলারিটি সংকেত প্রদান করে:

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

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

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

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

addressComponent প্রপার্টি হল address একটি সাবকম্পোনেন্ট যা ম্যাপ জাভাস্ক্রিপ্ট এপিআই-এ অ্যাড্রেস ভ্যালিডেশন প্রসেস করা ঠিকানার উপাদান-বা উপাদানগুলির একটি বিস্তারিত তালিকা প্রদান করে। API প্রতিটি উপাদান ক্ষেত্রকে তার নাম, ধরন এবং নিশ্চিতকরণ স্তর দ্বারা চিহ্নিত করে।

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

geocode সম্পত্তি

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

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

metadata সম্পত্তি

ম্যাপ জাভাস্ক্রিপ্ট এপিআই-এ ঠিকানা যাচাইকরণ দ্বারা প্রক্রিয়াকৃত প্রতিটি ঠিকানার জন্য এই সম্পত্তিটি জনবহুল নাও হতে পারে, তবে ঠিকানাটি আবাসিক, ব্যবসা বা PO বক্সের প্রকারের কিনা তা নির্দেশ করে।

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

uspsData বৈশিষ্ট্য

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

হ্যান্ডেল ইউনাইটেড স্টেটস অ্যাড্রেস এবং USPSData এর রেফারেন্স দেখুন।