- HTTP অনুরোধ
- শরীরের অনুরোধ
- প্রতিক্রিয়া শরীর
- ডাক ঠিকানা
- ভাষার বিকল্প
- যাচাইকরণের ফলাফল
- রায়
- গ্রানুলারিটি
- ঠিকানা
- ঠিকানা উপাদান
- উপাদানের নাম
- নিশ্চিতকরণ স্তর
- জিওকোড
- LatLng
- প্লাসকোড
- ভিউপোর্ট
- ঠিকানা মেটাডেটা
- ইউএসপিএস ডেটা
- ইউএসপিএস ঠিকানা
একটি ঠিকানা যাচাই করে।
HTTP অনুরোধ
POST https://addressvalidation.googleapis.com/v1:validateAddress
URL gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।
শরীরের অনুরোধ
অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:
JSON প্রতিনিধিত্ব |
---|
{ "address": { object ( |
ক্ষেত্র | |
---|---|
address | প্রয়োজন। ঠিকানা যাচাই করা হচ্ছে। বিন্যাসহীন ঠিকানা এই ইনপুটে ক্ষেত্রগুলির মোট দৈর্ঘ্য 280 অক্ষরের বেশি হওয়া উচিত নয়৷ সমর্থিত অঞ্চলগুলি এখানে পাওয়া যাবে। ইনপুট ঠিকানায় ঠিকানা যাচাইকরণ API |
previousResponseId | প্রথম ঠিকানা যাচাইকরণের অনুরোধের জন্য এই ক্ষেত্রটি অবশ্যই খালি থাকতে হবে। যদি একটি একক ঠিকানাকে সম্পূর্ণরূপে বৈধ করার জন্য আরও অনুরোধের প্রয়োজন হয় (উদাহরণস্বরূপ যদি ব্যবহারকারীর প্রাথমিক যাচাইকরণের পরে যে পরিবর্তনগুলি করা হয় তা পুনরায় যাচাই করা প্রয়োজন), তাহলে প্রতিটি ফলোআপ অনুরোধকে অবশ্যই প্রথম প্রতিক্রিয়া থেকে |
enableUspsCass | USPS CASS সামঞ্জস্যপূর্ণ মোড সক্ষম করে৷ এটি শুধুমাত্র এটি একটি কম্পোনেন্টাইজড |
languageOptions | ঐচ্ছিক। পূর্বরূপ: এই বৈশিষ্ট্যটি পূর্বরূপ (প্রি-GA) এ রয়েছে। প্রাক-GA পণ্য এবং বৈশিষ্ট্যগুলির সীমিত সমর্থন থাকতে পারে এবং প্রাক-GA পণ্য এবং বৈশিষ্ট্যগুলির পরিবর্তনগুলি অন্যান্য প্রাক-GA সংস্করণগুলির সাথে সামঞ্জস্যপূর্ণ নাও হতে পারে। প্রাক-GA অফারগুলি Google মানচিত্র প্ল্যাটফর্ম পরিষেবার নির্দিষ্ট শর্তাবলী দ্বারা আচ্ছাদিত। আরও তথ্যের জন্য, লঞ্চ পর্যায়ের বিবরণ দেখুন। প্রতিক্রিয়াতে অতিরিক্ত তথ্য অন্তর্ভুক্ত করতে ঠিকানা যাচাইকরণ API সক্ষম করে৷ |
sessionToken | ঐচ্ছিক। একটি স্ট্রিং যা বিলিং উদ্দেশ্যে একটি স্বয়ংসম্পূর্ণ সেশন সনাক্ত করে৷ সর্বাধিক 36টি ASCII অক্ষর সহ একটি URL এবং ফাইলের নাম নিরাপদ base64 স্ট্রিং হতে হবে৷ অন্যথায় একটি INVALID_ARGUMENT ত্রুটি ফেরত দেওয়া হবে৷ সেশন শুরু হয় যখন ব্যবহারকারী একটি স্বয়ংসম্পূর্ণ ক্যোয়ারী করে, এবং শেষ হয় যখন তারা একটি স্থান নির্বাচন করে এবং স্থানের বিবরণ বা ঠিকানা যাচাইকরণে কল করা হয়। প্রতিটি সেশনে একাধিক স্বয়ংসম্পূর্ণ প্রশ্ন থাকতে পারে, তার পরে একটি স্থানের বিবরণ বা ঠিকানা যাচাইকরণের অনুরোধ থাকতে পারে। একটি সেশনের মধ্যে প্রতিটি অনুরোধের জন্য ব্যবহৃত শংসাপত্রগুলি অবশ্যই একই Google Cloud Console প্রকল্পের অন্তর্গত। একবার একটি অধিবেশন শেষ হয়ে গেলে, টোকেনটি আর বৈধ থাকে না; আপনার অ্যাপকে অবশ্যই প্রতিটি সেশনের জন্য একটি নতুন টোকেন তৈরি করতে হবে। যদি দ্রষ্টব্য: ঠিকানা যাচাইকরণ শুধুমাত্র স্বয়ংসম্পূর্ণ (নতুন) API সহ সেশনগুলিতে ব্যবহার করা যেতে পারে, স্বয়ংসম্পূর্ণ API নয়। আরও বিশদ বিবরণের জন্য https://developers.google.com/maps/documentation/places/web-service/session-pricing দেখুন৷ |
প্রতিক্রিয়া শরীর
একটি ঠিকানা বৈধতা অনুরোধের প্রতিক্রিয়া.
সফল হলে, প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে ডেটা থাকে:
JSON প্রতিনিধিত্ব |
---|
{
"result": {
object ( |
ক্ষেত্র | |
---|---|
result | ঠিকানা যাচাইকরণের ফলাফল। |
responseId | UUID যা এই প্রতিক্রিয়া সনাক্ত করে। ঠিকানাটি পুনরায় যাচাই করার প্রয়োজন হলে, এই UUID অবশ্যই নতুন অনুরোধের সাথে থাকবে। |
ডাক ঠিকানা
একটি ডাক ঠিকানা প্রতিনিধিত্ব করে, যেমন ডাক বিতরণ বা অর্থপ্রদানের ঠিকানার জন্য। একটি ডাক ঠিকানা দেওয়া হলে, একটি ডাক পরিষেবা একটি প্রিমাইজ, PO বক্স বা অনুরূপ আইটেমগুলি সরবরাহ করতে পারে। এটি ভৌগলিক অবস্থান (রাস্তা, শহর, পাহাড়) মডেল করার উদ্দেশ্যে নয়।
সাধারণ ব্যবহারে একটি ঠিকানা ব্যবহারকারীর ইনপুট বা বিদ্যমান ডেটা আমদানির মাধ্যমে তৈরি করা হবে, প্রক্রিয়ার ধরনের উপর নির্ভর করে।
ঠিকানা ইনপুট / সম্পাদনা সংক্রান্ত পরামর্শ: - একটি আন্তর্জাতিকীকরণ-প্রস্তুত ঠিকানা উইজেট ব্যবহার করুন যেমন https://github.com/google/libaddressinput ) - ব্যবহারকারীদের UI উপাদানগুলি ইনপুট বা ক্ষেত্রগুলির সম্পাদনার জন্য উপস্থাপন করা উচিত নয় যেখানে সেই ক্ষেত্রটি রয়েছে ব্যবহৃত
এই স্কিমাটি কীভাবে ব্যবহার করবেন সে সম্পর্কে আরও নির্দেশনার জন্য, অনুগ্রহ করে দেখুন: https://support.google.com/business/answer/6397478
JSON প্রতিনিধিত্ব |
---|
{ "revision": integer, "regionCode": string, "languageCode": string, "postalCode": string, "sortingCode": string, "administrativeArea": string, "locality": string, "sublocality": string, "addressLines": [ string ], "recipients": [ string ], "organization": string } |
ক্ষেত্র | |
---|---|
revision | |
regionCode | ঐচ্ছিক। ঠিকানার দেশ/অঞ্চলের CLDR অঞ্চল কোড। বিস্তারিত জানার জন্য https://cldr.unicode.org/ এবং https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html দেখুন। উদাহরণ: সুইজারল্যান্ডের জন্য "CH"। অঞ্চল কোড প্রদান করা না হলে, এটি ঠিকানা থেকে অনুমান করা হবে. সেরা পারফরম্যান্সের জন্য, যদি আপনি এটি জানেন তবে অঞ্চল কোড অন্তর্ভুক্ত করার পরামর্শ দেওয়া হয়। অসামঞ্জস্যপূর্ণ বা পুনরাবৃত্তি অঞ্চলগুলি খারাপ কার্যক্ষমতার দিকে নিয়ে যেতে পারে, উদাহরণস্বরূপ, যদি |
languageCode | ইনপুট ঠিকানার ভাষা কোড ভবিষ্যতে ব্যবহারের জন্য সংরক্ষিত এবং আজ উপেক্ষা করা হয়। API ঠিকানাটি যেখানে অবস্থিত তার জন্য উপযুক্ত ভাষায় ঠিকানা প্রদান করে। |
postalCode | ঐচ্ছিক। ঠিকানার পোস্টাল কোড। সমস্ত দেশে পোস্টাল কোড ব্যবহার করা হয় না বা উপস্থিত থাকার প্রয়োজন হয় না, তবে যেখানে সেগুলি ব্যবহার করা হয়, তারা ঠিকানার অন্যান্য অংশগুলির সাথে অতিরিক্ত বৈধতা ট্রিগার করতে পারে (যেমন মার্কিন যুক্তরাষ্ট্রে রাজ্য/জিপ বৈধতা)। |
sortingCode | ঐচ্ছিক। অতিরিক্ত, দেশ-নির্দিষ্ট, সাজানোর কোড। এটি বেশিরভাগ অঞ্চলে ব্যবহৃত হয় না। যেখানে এটি ব্যবহার করা হয়, মানটি হয় "CEDEX" এর মতো একটি স্ট্রিং, ঐচ্ছিকভাবে একটি সংখ্যা (যেমন "CEDEX 7") অনুসরণ করে, অথবা শুধুমাত্র একটি সংখ্যা, যা "সেক্টর কোড" (জ্যামাইকা), "ডেলিভারি এলাকা সূচক" প্রতিনিধিত্ব করে। (মালাউই) বা "ডাকঘর সূচক" (যেমন কোট ডি আইভরি)। |
administrativeArea | ঐচ্ছিক। সর্বোচ্চ প্রশাসনিক উপবিভাগ যা একটি দেশ বা অঞ্চলের ডাক ঠিকানার জন্য ব্যবহৃত হয়। উদাহরণস্বরূপ, এটি একটি রাজ্য, একটি প্রদেশ, একটি ওব্লাস্ট বা একটি প্রিফেকচার হতে পারে। বিশেষ করে, স্পেনের জন্য এটি প্রদেশ এবং স্বায়ত্তশাসিত সম্প্রদায় নয় (যেমন "বার্সেলোনা" এবং "কাতালোনিয়া" নয়)। অনেক দেশ ডাক ঠিকানায় প্রশাসনিক এলাকা ব্যবহার করে না। যেমন সুইজারল্যান্ডে এটি জনবসতিহীন ছেড়ে দেওয়া উচিত। |
locality | ঐচ্ছিক। সাধারণত ঠিকানার শহর/শহরের অংশকে বোঝায়। উদাহরণ: ইউএস সিটি, আইটি কমিউন, ইউকে পোস্ট টাউন। বিশ্বের এমন অঞ্চলে যেখানে লোকালয়টি ভালভাবে সংজ্ঞায়িত করা হয় না বা এই কাঠামোর সাথে ভালভাবে ফিট করে না, লোকালয়টি খালি রাখুন এবং অ্যাড্রেসলাইনগুলি ব্যবহার করুন। |
sublocality | ঐচ্ছিক। ঠিকানার উপ-অবস্থান। উদাহরণস্বরূপ, এটি পাড়া, বরো, জেলা হতে পারে। |
addressLines[] | প্রয়োজন। একটি ঠিকানার নিম্ন স্তরের বর্ণনা করে অসংগঠিত ঠিকানা লাইন। |
recipients[] | এই ক্ষেত্র সেট করা এড়িয়ে চলুন দয়া করে. ঠিকানা যাচাইকরণ API বর্তমানে এটি ব্যবহার করে না। যদিও এই সময়ে API এই ফিল্ড সেটের সাথে অনুরোধগুলি প্রত্যাখ্যান করবে না, তথ্যটি বাতিল করা হবে এবং প্রতিক্রিয়াতে ফেরত দেওয়া হবে না। |
organization | এই ক্ষেত্র সেট করা এড়িয়ে চলুন দয়া করে. ঠিকানা যাচাইকরণ API বর্তমানে এটি ব্যবহার করে না। যদিও এই সময়ে API এই ফিল্ড সেটের সাথে অনুরোধগুলি প্রত্যাখ্যান করবে না, তথ্যটি বাতিল করা হবে এবং প্রতিক্রিয়াতে ফেরত দেওয়া হবে না। |
ভাষার বিকল্প
পূর্বরূপ: এই বৈশিষ্ট্যটি পূর্বরূপ (প্রি-GA) এ রয়েছে। প্রাক-GA পণ্য এবং বৈশিষ্ট্যগুলির সীমিত সমর্থন থাকতে পারে এবং প্রাক-GA পণ্য এবং বৈশিষ্ট্যগুলির পরিবর্তনগুলি অন্যান্য প্রাক-GA সংস্করণগুলির সাথে সামঞ্জস্যপূর্ণ নাও হতে পারে। প্রাক-GA অফারগুলি Google মানচিত্র প্ল্যাটফর্ম পরিষেবার নির্দিষ্ট শর্তাবলী দ্বারা আচ্ছাদিত। আরও তথ্যের জন্য, লঞ্চ পর্যায়ের বিবরণ দেখুন।
প্রতিক্রিয়াতে অতিরিক্ত তথ্য অন্তর্ভুক্ত করতে ঠিকানা যাচাইকরণ API সক্ষম করে৷
JSON প্রতিনিধিত্ব |
---|
{ "returnEnglishLatinAddress": boolean } |
ক্ষেত্র | |
---|---|
returnEnglishLatinAddress | পূর্বরূপ: ইংরেজিতে একটি |
যাচাইকরণের ফলাফল
ঠিকানা যাচাই করার ফলাফল।
JSON প্রতিনিধিত্ব |
---|
{ "verdict": { object ( |
ক্ষেত্র | |
---|---|
verdict | সামগ্রিক রায়ের পতাকা |
address | জিওকোডের বিপরীতে ঠিকানা সম্পর্কে তথ্য। |
geocode | ঠিকানা জিওকোড করা অবস্থান এবং স্থান সম্পর্কে তথ্য। |
metadata | বিতরণযোগ্যতার সাথে সম্পর্কিত অন্যান্য তথ্য। ঠিকানা যাচাইকরণ API এ পাঠানো প্রতিটি ঠিকানার জন্য |
uspsData | USPS দ্বারা প্রদত্ত অতিরিক্ত বিতরণযোগ্য পতাকা। শুধুমাত্র অঞ্চল |
englishLatinAddress | পূর্বরূপ: এই বৈশিষ্ট্যটি পূর্বরূপ (প্রি-GA) এ রয়েছে। প্রাক-GA পণ্য এবং বৈশিষ্ট্যগুলির সীমিত সমর্থন থাকতে পারে এবং প্রাক-GA পণ্য এবং বৈশিষ্ট্যগুলির পরিবর্তনগুলি অন্যান্য প্রাক-GA সংস্করণগুলির সাথে সামঞ্জস্যপূর্ণ নাও হতে পারে। প্রাক-GA অফারগুলি Google মানচিত্র প্ল্যাটফর্ম পরিষেবার নির্দিষ্ট শর্তাবলী দ্বারা আচ্ছাদিত। আরও তথ্যের জন্য, লঞ্চ পর্যায়ের বিবরণ দেখুন। ঠিকানাটি ইংরেজিতে অনুবাদ করা হয়েছে। অনুবাদিত ঠিকানাগুলি API ইনপুট হিসাবে পুনরায় ব্যবহারযোগ্য নয়৷ পরিষেবাটি তাদের প্রদান করে যাতে ব্যবহারকারী তাদের স্থানীয় ভাষা ব্যবহার করে আসল-প্রদত্ত ঠিকানার বৈধতা নিশ্চিত বা অস্বীকার করতে পারে। ঠিকানার অংশের ইংরেজি অনুবাদ না থাকলে, পরিষেবাটি সেই অংশটিকে একটি বিকল্প ভাষায় ফেরত দেয় যা একটি ল্যাটিন স্ক্রিপ্ট ব্যবহার করে। কিভাবে বিকল্প ভাষা নির্বাচন করা হয় তার ব্যাখ্যার জন্য এখানে দেখুন। যদি ঠিকানার অংশে ল্যাটিন স্ক্রিপ্ট ব্যবহার করে এমন কোনো ভাষায় কোনো অনুবাদ বা প্রতিবর্ণীকরণ না থাকে, তাহলে পরিষেবাটি ঠিকানার সাথে যুক্ত স্থানীয় ভাষায় সেই অংশটি ফিরিয়ে দেয়। দ্রষ্টব্য: |
রায়
ঠিকানা যাচাইকরণ ফলাফল এবং জিওকোডের উচ্চ স্তরের ওভারভিউ।
JSON প্রতিনিধিত্ব |
---|
{ "inputGranularity": enum ( |
ক্ষেত্র | |
---|---|
inputGranularity | ইনপুট ঠিকানার গ্রানুলারিটি। এটি ইনপুট ঠিকানা পার্স করার ফলাফল এবং কোন বৈধতা সংকেত দেয় না। বৈধতা সংকেতের জন্য, নীচের উদাহরণস্বরূপ, যদি ইনপুট ঠিকানায় একটি নির্দিষ্ট অ্যাপার্টমেন্ট নম্বর থাকে, তাহলে এখানে |
validationGranularity | কণিকা স্তর যা API ঠিকানাটিকে সম্পূর্ণরূপে যাচাই করতে পারে৷ উদাহরণস্বরূপ, প্রতি ঠিকানা উপাদান যাচাইকরণের ফলাফল |
geocodeGranularity | এটি মাঝে মাঝে উপরের |
addressComplete | কোনো অমীমাংসিত টোকেন না থাকলে, কোনো অপ্রত্যাশিত বা অনুপস্থিত ঠিকানা উপাদান না থাকলে ঠিকানাটি সম্পূর্ণ বলে বিবেচিত হয়। যদি সেট না থাকে, তাহলে নির্দেশ করে যে মানটি |
hasUnconfirmedComponents | অন্তত একটি ঠিকানা উপাদান শ্রেণীবদ্ধ বা যাচাই করা যাবে না, বিস্তারিত জানার জন্য |
hasInferredComponents | অন্তত একটি ঠিকানা উপাদান অনুমান করা হয়েছে (যোগ করা হয়েছে) যা ইনপুটে ছিল না, বিস্তারিত জানার জন্য |
hasReplacedComponents | অন্তত একটি ঠিকানা উপাদান প্রতিস্থাপিত হয়েছে, বিস্তারিত জানার জন্য |
গ্রানুলারিটি
একটি ঠিকানা বা একটি জিওকোড থাকতে পারে এমন বিভিন্ন গ্রানুলারিটি। যখন একটি ঠিকানার জন্য গ্রানুলারিটি নির্দেশ করতে ব্যবহৃত হয়, তখন এই মানগুলি নির্দেশ করে যে ঠিকানাটি একটি মেইলিং গন্তব্যকে কতটা সূক্ষ্ম কণিকা চিহ্নিত করে। উদাহরণ স্বরূপ, একটি ঠিকানা যেমন "123 Main Street, Redwood City, CA, 94061" একটি PREMISE
সনাক্ত করে যখন "Redwood City, CA, 94061" এর মতো কিছু একটি LOCALITY
সনাক্ত করে৷ যাইহোক, যদি আমরা রেডউড সিটিতে "123 মেইন স্ট্রিট"-এর জন্য একটি জিওকোড খুঁজে না পাই, তবে ঠিকানাটি আরও দানাদার হওয়া সত্ত্বেও যে জিওকোড ফেরত দেওয়া হয়েছে তা LOCALITY
গ্র্যানুলারিটির হতে পারে৷
Enums | |
---|---|
GRANULARITY_UNSPECIFIED | ডিফল্ট মান। এই মান অব্যবহৃত. |
SUB_PREMISE | নিম্ন-বিল্ডিং স্তরের ফলাফল, যেমন একটি অ্যাপার্টমেন্ট। |
PREMISE | বিল্ডিং-স্তরের ফলাফল। |
PREMISE_PROXIMITY | একটি জিওকোড যা ঠিকানাটির বিল্ডিং-স্তরের অবস্থান আনুমানিক করে। |
BLOCK | ঠিকানা বা জিওকোড একটি ব্লক নির্দেশ করে। শুধুমাত্র সেই অঞ্চলে ব্যবহৃত হয় যেখানে ব্লক-লেভেল অ্যাড্রেসিং আছে, যেমন জাপান। |
ROUTE | জিওকোড বা ঠিকানাটি রুটের জন্য দানাদার, যেমন রাস্তা, রাস্তা বা হাইওয়ে। |
OTHER | অন্যান্য সমস্ত গ্রানুলারিটি, যেগুলিকে একসাথে বাকেট করা হয় যেহেতু সেগুলি বিতরণযোগ্য নয়৷ |
ঠিকানা
পোস্ট-প্রসেসড ঠিকানার বিশদ বিবরণ। পোস্ট-প্রসেসিং এর মধ্যে রয়েছে ঠিকানার ভুল বানান অংশ সংশোধন করা, ভুল অংশ প্রতিস্থাপন করা এবং অনুপস্থিত অংশ অনুমান করা।
JSON প্রতিনিধিত্ব |
---|
{ "formattedAddress": string, "postalAddress": { object ( |
ক্ষেত্র | |
---|---|
formattedAddress | পোস্ট-প্রসেসড অ্যাড্রেস, যেখানে ঠিকানাটি অবস্থিত সেই অঞ্চলের অ্যাড্রেস ফরম্যাটিং নিয়ম অনুসরণ করে একটি একক-লাইন ঠিকানা হিসাবে ফর্ম্যাট করা হয়। |
postalAddress | পোস্ট-প্রসেসড ঠিকানা একটি ডাক ঠিকানা হিসাবে প্রতিনিধিত্ব করে। |
addressComponents[] | অবিন্যস্ত তালিকা. বৈধতা তথ্য সহ ফর্ম্যাট করা এবং সংশোধন করা ঠিকানার পৃথক ঠিকানা উপাদান। এটি পৃথক উপাদানের বৈধতা অবস্থার তথ্য প্রদান করে। ঠিকানা উপাদান একটি নির্দিষ্ট উপায়ে আদেশ করা হয় না. তালিকার ঠিকানা উপাদানগুলির ক্রমানুসারে কোনো অনুমান করবেন না। |
missingComponentTypes[] | সঠিকভাবে ফরম্যাট করা মেইলিং ঠিকানায় উপস্থিত থাকার প্রত্যাশিত উপাদানগুলির প্রকারগুলি কিন্তু ইনপুটে পাওয়া যায়নি এবং অনুমান করা যায়নি৷ এই ধরনের উপাদানগুলি |
unconfirmedComponentTypes[] | |
unresolvedTokens[] | ইনপুটে কোনো টোকেন আছে যা সমাধান করা যায়নি। এটি এমন একটি ইনপুট হতে পারে যা একটি ঠিকানার একটি বৈধ অংশ হিসাবে স্বীকৃত হয়নি (উদাহরণস্বরূপ একটি ইনপুটে যেমন "123235253253 Main St, San Francisco, CA, 94105", অমীমাংসিত টোকেনগুলি |
ঠিকানা উপাদান
একটি ঠিকানা উপাদান প্রতিনিধিত্ব করে, যেমন একটি রাস্তা, শহর বা রাজ্য।
JSON প্রতিনিধিত্ব |
---|
{ "componentName": { object ( |
ক্ষেত্র | |
---|---|
componentName | এই উপাদান জন্য নাম. |
componentType | ঠিকানা উপাদানের ধরন। সারণি 2 দেখুন: সম্ভাব্য প্রকারের তালিকার জন্য স্থান পরিষেবা দ্বারা প্রত্যাবর্তিত অতিরিক্ত প্রকারগুলি । |
confirmationLevel | আমাদের নিশ্চিততার স্তর নির্দেশ করে যে উপাদানটি সঠিক। |
inferred | ইঙ্গিত করে যে উপাদানটি ইনপুটের অংশ ছিল না, কিন্তু আমরা ঠিকানার অবস্থানের জন্য এটি অনুমান করেছি এবং বিশ্বাস করি এটি একটি সম্পূর্ণ ঠিকানার জন্য প্রদান করা উচিত। |
spellCorrected | উপাদান নামের একটি ভুল বানান সংশোধন নির্দেশ করে। API সর্বদা একটি বানান বৈকল্পিক থেকে অন্য বানান পরিবর্তন করে না, যেমন যখন "কেন্দ্র" থেকে "কেন্দ্র" পরিবর্তন করে। এটি সর্বদা সাধারণ ভুল বানানগুলিকেও ফ্ল্যাগ করে না, যেমন যখন "Amphitheater Pkwy" থেকে "Amphitheatre Pkwy" পরিবর্তন করে। |
replaced | ইঙ্গিত করে যে উপাদানটির নাম সম্পূর্ণ ভিন্ন একটি দিয়ে প্রতিস্থাপিত হয়েছে, উদাহরণস্বরূপ ঠিকানার জন্য সঠিক একটি দিয়ে একটি ভুল পোস্টাল কোড প্রতিস্থাপিত হচ্ছে৷ এটি একটি প্রসাধনী পরিবর্তন নয়, ইনপুট উপাদান একটি ভিন্ন একটি পরিবর্তন করা হয়েছে. |
unexpected | একটি ঠিকানা উপাদান নির্দেশ করে যা প্রদত্ত অঞ্চলের জন্য একটি ডাক ঠিকানায় উপস্থিত থাকার আশা করা হয় না৷ আমরা এটিকে ধরে রেখেছি কারণ এটি ইনপুটের অংশ ছিল। |
উপাদানের নাম
কম্পোনেন্টের নামের জন্য একটি মোড়ক।
JSON প্রতিনিধিত্ব |
---|
{ "text": string, "languageCode": string } |
ক্ষেত্র | |
---|---|
text | নামের পাঠ্য। উদাহরণস্বরূপ, রাস্তার নামের জন্য "5ম অ্যাভিনিউ" বা রাস্তার নম্বরের জন্য "1253"। |
languageCode | BCP-47 ভাষার কোড। এটি উপস্থিত থাকবে না যদি উপাদানের নামটি একটি ভাষার সাথে যুক্ত না হয়, যেমন রাস্তার নম্বর। |
নিশ্চিতকরণ স্তর
নিশ্চিতকরণ স্তরের জন্য বিভিন্ন সম্ভাব্য মান।
Enums | |
---|---|
CONFIRMATION_LEVEL_UNSPECIFIED | ডিফল্ট মান। এই মান অব্যবহৃত. |
CONFIRMED | আমরা যাচাই করতে সক্ষম হয়েছি যে এই উপাদানটি বিদ্যমান এবং বাকি ঠিকানার প্রেক্ষাপটে অর্থপূর্ণ। |
UNCONFIRMED_BUT_PLAUSIBLE | এই উপাদানটি নিশ্চিত করা যায়নি, তবে এটির অস্তিত্ব আছে বলে বিশ্বাসযোগ্য। উদাহরণস্বরূপ, একটি রাস্তার নম্বর যেখানে নির্দিষ্ট বাড়ির নম্বর জানা নেই এমন একটি রাস্তায় সংখ্যার একটি পরিচিত বৈধ পরিসরের মধ্যে। |
UNCONFIRMED_AND_SUSPICIOUS | এই উপাদানটি নিশ্চিত করা হয়নি এবং সম্ভবত ভুল হতে পারে। উদাহরণস্বরূপ, একটি আশেপাশের এলাকা যা বাকি ঠিকানার সাথে খাপ খায় না। |
জিওকোড
যেখানে ইনপুটটি জিওকোড করা হয়েছিল সে সম্পর্কে তথ্য রয়েছে৷
JSON প্রতিনিধিত্ব |
---|
{ "location": { object ( |
ক্ষেত্র | |
---|---|
location | ইনপুটের জিওকোডেড অবস্থান। ঠিকানা, অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্ক বা প্লাস কোড ব্যবহার করার চেয়ে স্থান আইডি ব্যবহার করা পছন্দনীয়। ড্রাইভিং দিকনির্দেশ রাউটিং বা গণনা করার সময় স্থানাঙ্ক ব্যবহার করার ফলে সর্বদা পয়েন্টটি সেই স্থানাঙ্কগুলির নিকটবর্তী রাস্তায় স্ন্যাপ করা হবে। এটি এমন একটি রাস্তা নাও হতে পারে যা দ্রুত বা নিরাপদে গন্তব্যে নিয়ে যাবে এবং সম্পত্তির অ্যাক্সেস পয়েন্টের কাছাকাছি নাও হতে পারে। উপরন্তু, যখন একটি অবস্থান বিপরীত জিওকোড করা হয়, তখন কোন গ্যারান্টি নেই যে ফেরত ঠিকানাটি আসলটির সাথে মিলবে। |
plusCode | |
bounds | জিওকোড করা স্থানের সীমানা। |
featureSizeMeters | জিওকোড করা জায়গার মাপ, মিটারে। এটি জিওকোডেড অবস্থানের স্থূলতার আরেকটি পরিমাপ, কিন্তু শব্দার্থগত অর্থের পরিবর্তে প্রকৃত আকারে। |
placeId | এই ইনপুট জিওকোড করা জায়গার PlaceID। প্লেস আইডি সম্পর্কে আরও তথ্যের জন্য এখানে দেখুন। |
placeTypes[] | ইনপুট জিওকোড করা স্থানের প্রকার(গুলি)৷ উদাহরণস্বরূপ, |
LatLng
একটি বস্তু যা একটি অক্ষাংশ/দ্রাঘিমাংশ জোড়া প্রতিনিধিত্ব করে। এটি ডিগ্রী অক্ষাংশ এবং ডিগ্রী দ্রাঘিমাংশের প্রতিনিধিত্ব করার জন্য এক জোড়া দ্বিগুণ হিসাবে প্রকাশ করা হয়। অন্যথায় নির্দিষ্ট করা না থাকলে, এই বস্তুটিকে অবশ্যই WGS84 মান মেনে চলতে হবে। মানগুলি অবশ্যই স্বাভাবিক সীমার মধ্যে থাকতে হবে৷
JSON প্রতিনিধিত্ব |
---|
{ "latitude": number, "longitude": number } |
ক্ষেত্র | |
---|---|
latitude | ডিগ্রী অক্ষাংশ. এটি অবশ্যই [-90.0, +90.0] এর মধ্যে হতে হবে। |
longitude | ডিগ্রী দ্রাঘিমাংশ. এটি অবশ্যই [-180.0, +180.0] পরিসরে হতে হবে। |
প্লাসকোড
প্লাস কোড ( http://plus.codes ) হল দুটি ফর্ম্যাট সহ একটি অবস্থানের রেফারেন্স: গ্লোবাল কোড একটি 14mx14m (ডিগ্রীর 1/8000তম) বা ছোট আয়তক্ষেত্র সংজ্ঞায়িত করে এবং যৌগিক কোড, একটি রেফারেন্স অবস্থানের সাথে উপসর্গ প্রতিস্থাপন করে।
JSON প্রতিনিধিত্ব |
---|
{ "globalCode": string, "compoundCode": string } |
ক্ষেত্র | |
---|---|
globalCode | স্থানের গ্লোবাল (সম্পূর্ণ) কোড, যেমন "9FWM33GV+HQ", একটি 1/8000 বাই 1/8000 ডিগ্রী এলাকা (~14 বাই 14 মিটার) প্রতিনিধিত্ব করে। |
compoundCode | স্থানের যৌগিক কোড, যেমন "33GV+HQ, Ramberg, Norway", যেখানে গ্লোবাল কোডের প্রত্যয় রয়েছে এবং একটি রেফারেন্স সত্তার ফর্ম্যাট করা নামের সাথে প্রিফিক্স প্রতিস্থাপন করা হয়েছে। |
ভিউপোর্ট
একটি অক্ষাংশ-দ্রাঘিমাংশ ভিউপোর্ট, দুটি তির্যক বিপরীত low
এবং high
বিন্দু হিসাবে উপস্থাপিত। একটি ভিউপোর্টকে একটি বন্ধ অঞ্চল হিসাবে বিবেচনা করা হয়, অর্থাৎ এটি এর সীমানা অন্তর্ভুক্ত করে। অক্ষাংশের সীমাগুলি অবশ্যই -90 থেকে 90 ডিগ্রী সহ, এবং দ্রাঘিমাংশের সীমাগুলি অবশ্যই -180 থেকে 180 ডিগ্রী সহ এর মধ্যে হতে হবে৷ বিভিন্ন ক্ষেত্রে অন্তর্ভুক্ত:
low
=high
হলে, ভিউপোর্টটি সেই একক বিন্দু নিয়ে গঠিত।low.longitude
>high.longitude
হলে, দ্রাঘিমাংশের সীমাটি উল্টানো হয় (ভিউপোর্টটি 180 ডিগ্রি দ্রাঘিমাংশের রেখা অতিক্রম করে)।low.longitude
= -180 ডিগ্রি এবংhigh.longitude
= 180 ডিগ্রি হলে, ভিউপোর্টে সমস্ত দ্রাঘিমাংশ অন্তর্ভুক্ত থাকে।low.longitude
= 180 ডিগ্রি এবংhigh.longitude
= -180 ডিগ্রি হলে, দ্রাঘিমাংশের পরিসর খালি।low.latitude
>high.latitude
হলে, অক্ষাংশ পরিসর খালি থাকে।
low
এবং high
উভয়ই জনবসতিপূর্ণ হতে হবে এবং উপস্থাপিত বাক্সটি খালি হতে পারে না (উপরের সংজ্ঞা দ্বারা নির্দিষ্ট করা হয়েছে)। একটি খালি ভিউপোর্ট একটি ত্রুটির কারণ হবে.
উদাহরণস্বরূপ, এই ভিউপোর্টটি সম্পূর্ণরূপে নিউ ইয়র্ক সিটিকে ঘিরে রেখেছে:
{ "নিম্ন": { "অক্ষাংশ": 40.477398, "দ্রাঘিমাংশ": -74.259087 }, "উচ্চ": { "অক্ষাংশ": 40.91618, "দ্রাঘিমাংশ": -73.70018 } }
JSON প্রতিনিধিত্ব |
---|
{ "low": { object ( |
ক্ষেত্র | |
---|---|
low | প্রয়োজন। ভিউপোর্টের নিম্ন পয়েন্ট। |
high | প্রয়োজন। ভিউপোর্টের উচ্চ বিন্দু। |
ঠিকানা মেটাডেটা
ঠিকানার জন্য মেটাডেটা। ঠিকানা যাচাইকরণ API এ পাঠানো প্রতিটি ঠিকানার জন্য metadata
সম্পূর্ণরূপে জনবহুল হওয়ার নিশ্চয়তা নেই।
JSON প্রতিনিধিত্ব |
---|
{ "business": boolean, "poBox": boolean, "residential": boolean } |
ক্ষেত্র | |
---|---|
business | নির্দেশ করে যে এটি একটি ব্যবসার ঠিকানা। যদি সেট না থাকে, তাহলে নির্দেশ করে যে মানটি অজানা। |
poBox | একটি PO বক্সের ঠিকানা নির্দেশ করে। যদি সেট না থাকে, তাহলে নির্দেশ করে যে মানটি অজানা। |
residential | নির্দেশ করে যে এটি একটি বাসস্থানের ঠিকানা। যদি সেট না থাকে, তাহলে নির্দেশ করে যে মানটি অজানা। |
ইউএসপিএস ডেটা
ঠিকানার জন্য USPS ডেটা। ঠিকানা যাচাইকরণ API এ পাঠানো প্রতিটি US বা PR ঠিকানার জন্য uspsData
সম্পূর্ণরূপে জনবহুল হওয়ার নিশ্চয়তা নেই। আপনি যদি প্রতিক্রিয়ার প্রাথমিক অংশ হিসাবে uspsData ব্যবহার করেন তবে প্রতিক্রিয়াতে ব্যাকআপ ঠিকানা ক্ষেত্রগুলিকে সংহত করার পরামর্শ দেওয়া হয়।
JSON প্রতিনিধিত্ব |
---|
{
"standardizedAddress": {
object ( |
ক্ষেত্র | |
---|---|
standardizedAddress | USPS প্রমিত ঠিকানা। |
deliveryPointCode | 2 সংখ্যার ডেলিভারি পয়েন্ট কোড |
deliveryPointCheckDigit | ডেলিভারি পয়েন্ট চেক ডিজিট। এই নম্বরটি যান্ত্রিকভাবে স্ক্যান করা মেলের জন্য বিতরণ_পয়েন্ট_বারকোডের শেষে যোগ করা হয়। Delivery_point_barcode, deliveryPointCheckDigit, পোস্টাল কোড, এবং ZIP+4 এর সমস্ত সংখ্যা একসাথে যোগ করলে 10 দ্বারা বিভাজ্য সংখ্যা পাওয়া উচিত। |
dpvConfirmation | DPV নিশ্চিতকরণের সম্ভাব্য মান। একটি একক অক্ষর প্রদান করে বা কোনো মান প্রদান করে না।
|
dpvFootnote | ডেলিভারি পয়েন্ট বৈধতা থেকে পাদটীকা. একাধিক পাদটীকা একই স্ট্রিং এ একসাথে স্ট্রং করা যেতে পারে।
|
dpvCmra | ঠিকানাটি একটি CMRA (বাণিজ্যিক মেল রিসিভিং এজেন্সি)- - ক্লায়েন্টদের জন্য একটি ব্যক্তিগত ব্যবসায়িক মেল গ্রহণ করে কিনা তা নির্দেশ করে৷ একটি একক অক্ষর প্রদান করে।
|
dpvVacant | এই জায়গা কি খালি? একটি একক অক্ষর প্রদান করে।
|
dpvNoStat | এটি কি কোন স্ট্যাট ঠিকানা না একটি সক্রিয় ঠিকানা? কোন স্ট্যাট ঠিকানা এমন নয় যা ক্রমাগত দখল করা হয় না বা এমন ঠিকানা যা USPS পরিষেবা দেয় না। একটি একক অক্ষর প্রদান করে।
|
dpvNoStatReasonCode | NoStat প্রকার নির্দেশ করে। int হিসাবে একটি কারণ কোড প্রদান করে।
|
dpvDrop | পতাকা নির্দেশ করে যে একটি সাইটে একটি একক গ্রহণযোগ্য মেল বিতরণ করা হয়েছে। একটি একক অক্ষর প্রদান করে।
|
dpvThrowback | ইঙ্গিত করে যে মেল রাস্তার ঠিকানায় বিতরণ করা হয় না। একটি একক অক্ষর প্রদান করে।
|
dpvNonDeliveryDays | পতাকা নির্দেশ করে মেইল ডেলিভারি সপ্তাহের প্রতিদিন সঞ্চালিত হয় না। একটি একক অক্ষর প্রদান করে।
|
dpvNonDeliveryDaysValues | পূর্ণসংখ্যা নন-ডেলিভারি দিন সনাক্ত করে। বিট ফ্ল্যাগ ব্যবহার করে জিজ্ঞাসাবাদ করা যেতে পারে: 0x40 - রবিবার একটি নন-ডেলিভারির দিন 0x20 - সোমবার একটি নন-ডেলিভারির দিন 0x10 - মঙ্গলবার একটি নন-ডেলিভারির দিন 0x08 - বুধবার একটি নন-ডেলিভারির দিন 0x04 - বৃহস্পতিবার একটি নন-ডেলিভারি দিন -ডেলিভারির দিন 0x02 - শুক্রবার একটি নন-ডেলিভারির দিন 0x01 - শনিবার একটি নন-ডেলিভারির দিন |
dpvNoSecureLocation | পতাকা নির্দেশ করে দরজা অ্যাক্সেসযোগ্য, কিন্তু নিরাপত্তা উদ্বেগের কারণে প্যাকেজটি ছেড়ে দেওয়া হবে না। একটি একক অক্ষর প্রদান করে।
|
dpvPbsa | ইঙ্গিত করে ঠিকানাটি PBSA রেকর্ডের সাথে মিলে গেছে। একটি একক অক্ষর প্রদান করে।
|
dpvDoorNotAccessible | পতাকা সেই ঠিকানাগুলি নির্দেশ করে যেখানে ইউএসপিএস মেল বিতরণের জন্য দরজায় টোকা দিতে পারে না। একটি একক অক্ষর প্রদান করে।
|
dpvEnhancedDeliveryCode | নির্দেশ করে যে ঠিকানার জন্য একাধিক DPV রিটার্ন কোড বৈধ। একটি একক অক্ষর প্রদান করে।
|
carrierRoute | ক্যারিয়ার রুট কোড। একটি চার অক্ষরের কোড যা একটি এক অক্ষর উপসর্গ এবং একটি তিন অঙ্কের রুট ডিজাইনার নিয়ে গঠিত। উপসর্গ:
|
carrierRouteIndicator | ক্যারিয়ার রুট রেট সাজানোর সূচক। |
ewsNoMatch | ডেলিভারির ঠিকানা মিলছে, কিন্তু EWS ফাইলটি নির্দেশ করে যে শীঘ্রই একটি সঠিক মিল পাওয়া যাবে। |
postOfficeCity | প্রধান পোস্ট অফিস শহর। |
postOfficeState | প্রধান পোস্ট অফিস রাষ্ট্র. |
abbreviatedCity | সংক্ষিপ্ত শহর। |
fipsCountyCode | FIPS কাউন্টি কোড। |
county | কাউন্টির নাম। |
elotNumber | ভ্রমণের বর্ধিত লাইন (eLOT) নম্বর। |
elotFlag | eLOT অ্যাসেন্ডিং/ডিসেন্ডিং ফ্ল্যাগ (A/D)। |
lacsLinkReturnCode | LACSLink রিটার্ন কোড। |
lacsLinkIndicator | LACSLink সূচক। |
poBoxOnlyPostalCode | PO বক্স শুধুমাত্র পোস্টাল কোড. |
suitelinkFootnote | পাদটীকাগুলি একটি রাস্তার বা হাইরাইজ রেকর্ডের সাথে স্যুট তথ্যের সাথে মিলে যায়৷ ব্যবসার নামের মিল পাওয়া গেলে, সেকেন্ডারি নম্বর ফেরত দেওয়া হয়।
|
pmbDesignator | PMB (প্রাইভেট মেইল বক্স) ইউনিট মনোনীত। |
pmbNumber | PMB (ব্যক্তিগত মেইল বক্স) নম্বর; |
addressRecordType | ঠিকানা রেকর্ডের প্রকার যা ইনপুট ঠিকানার সাথে মেলে।
|
defaultAddress | নির্দেশক যে একটি ডিফল্ট ঠিকানা পাওয়া গেছে, কিন্তু আরো নির্দিষ্ট ঠিকানা বিদ্যমান। |
errorMessage | USPS ডেটা পুনরুদ্ধারের জন্য ত্রুটি বার্তা। কৃত্রিমভাবে তৈরি ঠিকানা সনাক্তকরণের কারণে যখন USPS প্রক্রিয়াকরণ স্থগিত করা হয় তখন এটি জনবহুল হয়। এই ত্রুটি উপস্থিত থাকলে USPS ডেটা ক্ষেত্রগুলি জনবহুল নাও হতে পারে। |
cassProcessed | নির্দেশক যে অনুরোধটি CASS প্রক্রিয়া করা হয়েছে। |
ইউএসপিএস ঠিকানা
একটি মার্কিন ঠিকানার USPS প্রতিনিধিত্ব.
JSON প্রতিনিধিত্ব |
---|
{ "firstAddressLine": string, "firm": string, "secondAddressLine": string, "urbanization": string, "cityStateZipAddressLine": string, "city": string, "state": string, "zipCode": string, "zipCodeExtension": string } |
ক্ষেত্র | |
---|---|
firstAddressLine | প্রথম ঠিকানা লাইন। |
firm | দৃঢ় নাম। |
secondAddressLine | দ্বিতীয় ঠিকানা লাইন। |
urbanization | পুয়ের্তো রিকান নগরায়নের নাম। |
cityStateZipAddressLine | শহর + রাজ্য + পোস্টাল কোড। |
city | শহরের নাম। |
state | 2 অক্ষরের রাষ্ট্রীয় কোড। |
zipCode | পোস্টাল কোড যেমন 10009। |
zipCodeExtension | 4-সংখ্যার পোস্টাল কোড এক্সটেনশন যেমন 5023। |