ঠিকানা যাচাইকরণ API একটি JSON অবজেক্ট হিসাবে একটি প্রতিক্রিয়া বডি প্রদান করে যাতে দুটি শীর্ষ-স্তরের বৈশিষ্ট্য রয়েছে:
-
result
,ValidationResult
টাইপের একটি বস্তু -
responseID
{
"result": {
// Validation verdict.
"verdict": {},
// Address details determined by the API.
"address": {},
// 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"
}
এই নথিটি result
বস্তুর উপর ফোকাস করে। responseID
সম্পর্কে তথ্যের জন্য, আপডেট করা ঠিকানাগুলি হ্যান্ডেল দেখুন।
verdict
সম্পত্তি
verdict
সম্পত্তি ঠিকানা যাচাইকরণের ফলাফলগুলিকে সংক্ষিপ্ত করে এবং ঠিকানা চেকিং লজিক তৈরি করার সময় মূল্যায়ন করা প্রথম সম্পত্তি হওয়া উচিত। আউটপুট ঠিকানার গুণমানের উপর নির্ভর করে সম্পত্তিটি বিভিন্ন ক্ষেত্র ফেরত দিতে পারে। উদাহরণ স্বরূপ, নিম্নলিখিতটি ভাল মানের একটি ঠিকানার verdict
সম্পত্তি দেখায়, যা এই বিশেষ অনুরোধের জন্য 4টি ক্ষেত্র প্রদান করে:
"verdict": {
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"addressComplete": true
}
নিম্নলিখিত বিভাগগুলি verdict
সম্পত্তির সমস্ত ক্ষেত্রকে সংক্ষিপ্ত করে৷
রেফারেন্স গাইডে রায় দেখুন। |
ঠিকানার গ্রানুলারিটি
ঠিকানা গ্রানুলারিটি একটি ঠিকানা বা জিওকোডের নির্দিষ্টতা নির্ধারণে ব্যবহৃত বিশদ স্তরকে বোঝায়। validationGranularity
ঠিকানার সুনির্দিষ্টতা গ্রানুলারিটি প্রতিক্রিয়া একটি ঠিকানা সরবরাহযোগ্য কিনা তার জন্য একটি মূল সংকেত।
verdict
সম্পত্তি এই গ্রানুলারিটি সংকেত প্রদান করে:
-
inputGranularity
— ঠিকানা যাচাইকরণ API এ পাঠানো ঠিকানা থেকে ক্যাপচার করা বিশদ স্তর বর্ণনা করে। অনুরোধে ঠিকানার বিশদ স্তরটি বৈধকরণ প্রতিক্রিয়াতে ঠিকানার বিশদ স্তরকে প্রভাবিত করে। উদাহরণস্বরূপ,PREMISE
নীচের স্তরের নীচে একটিinputGranularity
সহ একটি ঠিকানা সাধারণত একটিPREMISE
স্তরে একটিvalidationGranularity
ফলাফল দেয় না। -
validationGranularity
— কণিকা স্তর যা ঠিকানা যাচাইকরণ API ঠিকানাটিকে সম্পূর্ণরূপে যাচাই করতে পারে। বেশিরভাগ ক্ষেত্রে,PREMISE
বাSUB_PREMISE
এর একটি গ্রানুলারিটি স্তর একটি গুণমানের ঠিকানা নির্দেশ করে যা সম্ভবত বিতরণযোগ্য। -
geocodeGranularity
— ঠিকানার সাথে যুক্ত জিওকোডের বিস্তারিত স্তর বর্ণনা করে। উদাহরণস্বরূপ, Google রেকর্ডগুলি একটি অ্যাপার্টমেন্ট নম্বরের অস্তিত্ব নির্দেশ করতে পারে, কিন্তু একটি বড় অ্যাপার্টমেন্ট কমপ্লেক্সের মধ্যে সেই নির্দিষ্ট অ্যাপার্টমেন্টের জন্য একটি সুনির্দিষ্ট অবস্থান নয়৷ সেই ক্ষেত্রে,validationGranularity
হলSUB_PREMISE
কিন্তুgeocodeGranularity
is
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
সম্পত্তি
ঠিকানা যাচাইকরণ API দ্বারা প্রক্রিয়া করা প্রতিটি ঠিকানার জন্য এই সম্পত্তিটি জনবহুল নাও হতে পারে, তবে ঠিকানাটি আবাসিক, ব্যবসা বা একটি PO বক্সের প্রকারের কিনা তা নির্দেশ করে।
ঠিকানা যাচাইকরণ API কভারেজ এবং Address metadata রেফারেন্স দেখুন। |
uspsData
বৈশিষ্ট্য
এই সম্পত্তি মার্কিন যুক্তরাষ্ট্র ডাক ঠিকানা জন্য দরকারী তথ্য প্রদান করে. যাইহোক, পরিষেবা দ্বারা যাচাইকৃত প্রতিটি ঠিকানার জন্য এটি সম্পূর্ণরূপে জনবহুল হওয়ার নিশ্চয়তা নেই। সেই কারণে, ঠিকানা যাচাই করার একমাত্র উপায় হিসাবে আপনার এই সম্পত্তির উপর নির্ভর করা উচিত নয়, বরং verdict
এবং address
পরীক্ষা করে দেখুন।
হ্যান্ডেল ইউনাইটেড স্টেটস ঠিকানা এবং UspsData এর রেফারেন্স দেখুন। |