Method: validateAddress

একটি ঠিকানা যাচাই করে।

HTTP অনুরোধ

POST https://addressvalidation.googleapis.com/v1:validateAddress

URL gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।

শরীরের অনুরোধ

অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:

JSON প্রতিনিধিত্ব 
{
  "address": {
    object (PostalAddress)
  },
  "previousResponseId": string,
  "enableUspsCass": boolean,
  "languageOptions": {
    object (LanguageOptions)
  },
  "sessionToken": string
}
ক্ষেত্র
address

object ( PostalAddress )

প্রয়োজন। ঠিকানা যাচাই করা হচ্ছে। বিন্যাসহীন ঠিকানা addressLines মাধ্যমে জমা দিতে হবে।

এই ইনপুটে ক্ষেত্রগুলির মোট দৈর্ঘ্য 280 অক্ষরের বেশি হওয়া উচিত নয়৷

সমর্থিত অঞ্চলগুলি এখানে পাওয়া যাবে।

ইনপুট ঠিকানায় languageCode মান ভবিষ্যতে ব্যবহারের জন্য সংরক্ষিত এবং আজ উপেক্ষা করা হয়। বৈধ ঠিকানার ফলাফল প্রদত্ত ঠিকানার জন্য পছন্দের ভাষার উপর ভিত্তি করে তৈরি করা হবে, যেমন সিস্টেম দ্বারা চিহ্নিত করা হয়েছে।

ঠিকানা যাচাইকরণ API recipients এবং organization মান উপেক্ষা করে। এই ক্ষেত্রের যেকোন মান বাতিল করা হবে এবং ফেরত দেওয়া হবে না। তাদের সেট করবেন না দয়া করে.

previousResponseId

string

প্রথম ঠিকানা যাচাইকরণের অনুরোধের জন্য এই ক্ষেত্রটি অবশ্যই খালি থাকতে হবে। যদি একটি একক ঠিকানাকে সম্পূর্ণরূপে বৈধ করার জন্য আরও অনুরোধের প্রয়োজন হয় (উদাহরণস্বরূপ যদি ব্যবহারকারীর প্রাথমিক বৈধতার পরে করা পরিবর্তনগুলিকে পুনরায় যাচাই করা প্রয়োজন), তাহলে প্রতিটি ফলোআপ অনুরোধকে অবশ্যই এই ক্ষেত্রটি বৈধকরণের ক্রমটিতে প্রথম প্রতিক্রিয়া থেকে responseId দিয়ে পূরণ করতে হবে।

enableUspsCass

boolean

USPS CASS সামঞ্জস্যপূর্ণ মোড সক্ষম করে৷ এটি শুধুমাত্র google.maps.addressvalidation.v1.ValidationResult.usps_data এর google.maps.addressvalidation.v1.ValidationResult ফিল্ডকে প্রভাবিত করে। দ্রষ্টব্য: পুয়ের্তো রিকোর ঠিকানাগুলির জন্য USPS CASS সক্ষমিত অনুরোধগুলির জন্য, address একটি google.type.PostalAddress.region_code অবশ্যই "PR" হিসাবে প্রদান করতে হবে, অথবা address একটি google.type.PostalAddress.administrative_area অবশ্যই "পুয়ের্তো রিকো" (কেস-সংবেদনশীল) বা "PR" হিসাবে প্রদান করতে হবে।

এটি একটি কম্পোনেন্টাইজড address ব্যবহার করার জন্য বাঞ্ছনীয়, অথবা বিকল্পভাবে কমপক্ষে দুটি google.type.PostalAddress.address_lines উল্লেখ করুন যেখানে প্রথম লাইনে রাস্তার নম্বর এবং নাম রয়েছে এবং দ্বিতীয় লাইনে শহর, রাজ্য এবং জিপ কোড রয়েছে৷

languageOptions

object ( LanguageOptions )

ঐচ্ছিক। পূর্বরূপ: এই বৈশিষ্ট্যটি পূর্বরূপ (প্রি-GA) এ রয়েছে। প্রাক-GA পণ্য এবং বৈশিষ্ট্যগুলির সীমিত সমর্থন থাকতে পারে এবং প্রাক-GA পণ্য এবং বৈশিষ্ট্যগুলির পরিবর্তনগুলি অন্যান্য প্রাক-GA সংস্করণগুলির সাথে সামঞ্জস্যপূর্ণ নাও হতে পারে। প্রাক-GA অফারগুলি Google মানচিত্র প্ল্যাটফর্ম পরিষেবার নির্দিষ্ট শর্তাবলী দ্বারা আচ্ছাদিত। আরও তথ্যের জন্য, লঞ্চ পর্যায়ের বিবরণ দেখুন।

প্রতিক্রিয়াতে অতিরিক্ত তথ্য অন্তর্ভুক্ত করতে ঠিকানা যাচাইকরণ API সক্ষম করে৷

sessionToken

string

ঐচ্ছিক। একটি স্ট্রিং যা বিলিং উদ্দেশ্যে একটি স্বয়ংসম্পূর্ণ সেশন সনাক্ত করে৷ সর্বাধিক 36টি ASCII অক্ষর সহ একটি URL এবং ফাইলের নাম নিরাপদ base64 স্ট্রিং হতে হবে৷ অন্যথায় একটি INVALID_ARGUMENT ত্রুটি ফেরত দেওয়া হবে৷

সেশন শুরু হয় যখন ব্যবহারকারী একটি স্বয়ংসম্পূর্ণ ক্যোয়ারী করে, এবং শেষ হয় যখন তারা একটি স্থান নির্বাচন করে এবং স্থানের বিবরণ বা ঠিকানা যাচাইকরণে কল করা হয়। প্রতিটি সেশনে একাধিক স্বয়ংসম্পূর্ণ প্রশ্ন থাকতে পারে, তার পরে একটি স্থানের বিবরণ বা ঠিকানা যাচাইকরণের অনুরোধ থাকতে পারে। একটি সেশনের মধ্যে প্রতিটি অনুরোধের জন্য ব্যবহৃত শংসাপত্রগুলি অবশ্যই একই Google Cloud Console প্রকল্পের অন্তর্গত। একবার একটি অধিবেশন শেষ হয়ে গেলে, টোকেনটি আর বৈধ থাকে না; আপনার অ্যাপকে অবশ্যই প্রতিটি সেশনের জন্য একটি নতুন টোকেন তৈরি করতে হবে। যদি sessionToken প্যারামিটারটি বাদ দেওয়া হয়, বা আপনি যদি একটি সেশন টোকেন পুনরায় ব্যবহার করেন, তাহলে সেশনটি চার্জ করা হবে যেন কোনো সেশন টোকেন প্রদান করা হয়নি (প্রতিটি অনুরোধ আলাদাভাবে বিল করা হয়)।

দ্রষ্টব্য: ঠিকানা যাচাইকরণ শুধুমাত্র স্বয়ংসম্পূর্ণ (নতুন) API সহ সেশনগুলিতে ব্যবহার করা যেতে পারে, স্বয়ংসম্পূর্ণ API নয়। আরও বিশদ বিবরণের জন্য https://developers.google.com/maps/documentation/places/web-service/session-pricing দেখুন৷

প্রতিক্রিয়া শরীর

একটি ঠিকানা বৈধতা অনুরোধের প্রতিক্রিয়া.

সফল হলে, প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে ডেটা থাকে:

JSON প্রতিনিধিত্ব 
{
  "result": {
    object (ValidationResult)
  },
  "responseId": string
}
ক্ষেত্র
result

object ( ValidationResult )

ঠিকানা যাচাইকরণের ফলাফল।

responseId

string

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

integer

PostalAddress স্কিমা সংশোধন। 0 ব্যতীত অন্য যেকোন মান API-কে একটি INVALID_ARGUMENT ত্রুটি ফিরিয়ে দেবে৷

regionCode

string

ঐচ্ছিক। ঠিকানার দেশ/অঞ্চলের CLDR অঞ্চল কোড। বিস্তারিত জানার জন্য https://cldr.unicode.org/ এবং https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html দেখুন। উদাহরণ: সুইজারল্যান্ডের জন্য "CH"। অঞ্চল কোড প্রদান করা না হলে, এটি ঠিকানা থেকে অনুমান করা হবে. সেরা পারফরম্যান্সের জন্য, যদি আপনি এটি জানেন তবে অঞ্চল কোড অন্তর্ভুক্ত করার পরামর্শ দেওয়া হয়। অসামঞ্জস্যপূর্ণ বা পুনরাবৃত্তি অঞ্চলগুলি খারাপ কার্যক্ষমতার দিকে নিয়ে যেতে পারে, উদাহরণস্বরূপ, যদি addressLines ইতিমধ্যে অঞ্চলটি অন্তর্ভুক্ত করে তবে এই ক্ষেত্রে আবার অঞ্চল কোড প্রদান করবেন না৷ সমর্থিত অঞ্চলগুলি প্রায়শই জিজ্ঞাসিত প্রশ্নগুলিতে পাওয়া যেতে পারে।

languageCode

string

ইনপুট ঠিকানার ভাষা কোড ভবিষ্যতে ব্যবহারের জন্য সংরক্ষিত এবং আজ উপেক্ষা করা হয়। API ঠিকানাটি যেখানে অবস্থিত তার জন্য উপযুক্ত ভাষায় ঠিকানা প্রদান করে।

postalCode

string

ঐচ্ছিক। ঠিকানার পোস্টাল কোড। সমস্ত দেশে পোস্টাল কোড ব্যবহার করা হয় না বা উপস্থিত থাকার প্রয়োজন হয় না, তবে যেখানে সেগুলি ব্যবহার করা হয়, তারা ঠিকানার অন্যান্য অংশগুলির সাথে অতিরিক্ত বৈধতা ট্রিগার করতে পারে (উদাহরণস্বরূপ, মার্কিন যুক্তরাষ্ট্রে রাজ্য বা জিপ কোড বৈধতা)।

sortingCode

string

ঐচ্ছিক। অতিরিক্ত, দেশ-নির্দিষ্ট, সাজানোর কোড। এটি বেশিরভাগ অঞ্চলে ব্যবহৃত হয় না। যেখানে এটি ব্যবহার করা হয়, মানটি হয় "CEDEX" এর মতো একটি স্ট্রিং, ঐচ্ছিকভাবে একটি সংখ্যা (উদাহরণস্বরূপ, "CEDEX 7"), অথবা শুধুমাত্র একটি সংখ্যা, যা "সেক্টর কোড" (জ্যামাইকা), "ডেলিভারি এলাকা নির্দেশক" (মালাউই) বা "পোস্ট অফিস নির্দেশক" (কোট ডি'আইভরি) প্রতিনিধিত্ব করে।

administrativeArea

string

ঐচ্ছিক। সর্বোচ্চ প্রশাসনিক উপবিভাগ যা একটি দেশ বা অঞ্চলের ডাক ঠিকানার জন্য ব্যবহৃত হয়। উদাহরণস্বরূপ, এটি একটি রাজ্য, একটি প্রদেশ, একটি ওব্লাস্ট বা একটি প্রিফেকচার হতে পারে। স্পেনের জন্য, এটি প্রদেশ এবং স্বায়ত্তশাসিত সম্প্রদায় নয় (উদাহরণস্বরূপ, "বার্সেলোনা" এবং "কাতালোনিয়া" নয়)। অনেক দেশ ডাক ঠিকানায় প্রশাসনিক এলাকা ব্যবহার করে না। উদাহরণস্বরূপ, সুইজারল্যান্ডে, এটি জনবসতিহীন ছেড়ে দেওয়া উচিত।

locality

string

ঐচ্ছিক। সাধারণত ঠিকানার শহর বা শহরের অংশকে বোঝায়। উদাহরণ: ইউএস সিটি, আইটি কমিউন, ইউকে পোস্ট টাউন। বিশ্বের এমন অঞ্চলে যেখানে লোকালয়টি ভালভাবে সংজ্ঞায়িত করা হয় না বা এই কাঠামোর সাথে ভালভাবে ফিট করে না, locality খালি রাখুন এবং addressLines ব্যবহার করুন৷

sublocality

string

ঐচ্ছিক। ঠিকানার উপ-অবস্থান। উদাহরণস্বরূপ, এটি একটি পাড়া, বরো বা জেলা হতে পারে।

addressLines[]

string

প্রয়োজন। একটি ঠিকানার নিম্ন স্তরের বর্ণনা করে অসংগঠিত ঠিকানা লাইন।

কারণ অ্যাড্রেসলাইনের মানগুলিতে টাইপ তথ্য নেই এবং কখনও কখনও একটি একক ক্ষেত্রে একাধিক মান থাকতে পারে (যেমন "অস্টিন, TX"), এটি গুরুত্বপূর্ণ যে লাইনের ক্রমটি পরিষ্কার। ঠিকানার লাইনের ক্রম ঠিকানার দেশ/অঞ্চলের জন্য "খামের আদেশ" হওয়া উচিত।

একটি ঠিকানার ন্যূনতম অনুমোদিত কাঠামোগত উপস্থাপনা addressLines রাখা সমস্ত তথ্য নিয়ে গঠিত। যদি একটি regionCode প্রদান করা না হয়, অঞ্চলটি ঠিকানা লাইন থেকে অনুমান করা হয়।

শুধুমাত্র addressLines সম্বলিত একটি ঠিকানা তৈরি করা, এবং তারপর জিওকোডিং হল সম্পূর্ণরূপে অসংগঠিত ঠিকানাগুলি পরিচালনা করার প্রস্তাবিত উপায় (অ্যাড্রেসের কোন অংশগুলি স্থানীয় বা প্রশাসনিক এলাকা হওয়া উচিত তা অনুমান করার বিপরীতে)।

recipients[]

string

এই ক্ষেত্র সেট করা এড়িয়ে চলুন দয়া করে. ঠিকানা যাচাইকরণ API বর্তমানে এটি ব্যবহার করে না। যদিও এই সময়ে API এই ফিল্ড সেটের সাথে অনুরোধগুলি প্রত্যাখ্যান করবে না, তথ্যটি বাতিল করা হবে এবং প্রতিক্রিয়াতে ফেরত দেওয়া হবে না।

organization

string

এই ক্ষেত্র সেট করা এড়িয়ে চলুন দয়া করে. ঠিকানা যাচাইকরণ API বর্তমানে এটি ব্যবহার করে না। যদিও এই সময়ে API এই ফিল্ড সেটের সাথে অনুরোধগুলি প্রত্যাখ্যান করবে না, তথ্যটি বাতিল করা হবে এবং প্রতিক্রিয়াতে ফেরত দেওয়া হবে না।

ভাষার বিকল্প

পূর্বরূপ: এই বৈশিষ্ট্যটি পূর্বরূপ (প্রি-GA) এ রয়েছে। প্রাক-GA পণ্য এবং বৈশিষ্ট্যগুলির সীমিত সমর্থন থাকতে পারে এবং প্রাক-GA পণ্য এবং বৈশিষ্ট্যগুলির পরিবর্তনগুলি অন্যান্য প্রাক-GA সংস্করণগুলির সাথে সামঞ্জস্যপূর্ণ নাও হতে পারে। প্রাক-GA অফারগুলি Google মানচিত্র প্ল্যাটফর্ম পরিষেবার নির্দিষ্ট শর্তাবলী দ্বারা আচ্ছাদিত। আরও তথ্যের জন্য, লঞ্চ পর্যায়ের বিবরণ দেখুন।

প্রতিক্রিয়াতে অতিরিক্ত তথ্য অন্তর্ভুক্ত করতে ঠিকানা যাচাইকরণ API সক্ষম করে৷

JSON প্রতিনিধিত্ব 
{
  "returnEnglishLatinAddress": boolean
}
ক্ষেত্র
returnEnglishLatinAddress

boolean

পূর্বরূপ: ইংরেজিতে একটি google.maps.addressvalidation.v1.Address ফেরত দিন। বিস্তারিত জানার জন্য google.maps.addressvalidation.v1.ValidationResult.english_latin_address দেখুন।

যাচাইকরণের ফলাফল

ঠিকানা যাচাই করার ফলাফল।

JSON প্রতিনিধিত্ব 
{
  "verdict": {
    object (Verdict)
  },
  "address": {
    object (Address)
  },
  "geocode": {
    object (Geocode)
  },
  "metadata": {
    object (AddressMetadata)
  },
  "uspsData": {
    object (UspsData)
  },
  "englishLatinAddress": {
    object (Address)
  }
}
ক্ষেত্র
verdict

object ( Verdict )

সামগ্রিক রায়ের পতাকা

address

object ( Address )

জিওকোডের বিপরীতে ঠিকানা সম্পর্কে তথ্য।

geocode

object ( Geocode )

ঠিকানা জিওকোড করা অবস্থান এবং স্থান সম্পর্কে তথ্য।

metadata

object ( AddressMetadata )

বিতরণযোগ্যতার সাথে সম্পর্কিত অন্যান্য তথ্য। ঠিকানা যাচাইকরণ API এ পাঠানো প্রতিটি ঠিকানার জন্য metadata সম্পূর্ণরূপে জনবহুল হওয়ার নিশ্চয়তা নেই।

uspsData

object ( UspsData )

USPS দ্বারা প্রদত্ত অতিরিক্ত বিতরণযোগ্য পতাকা। শুধুমাত্র অঞ্চল US এবং PR প্রদান করা হয়.

englishLatinAddress

object ( Address )

পূর্বরূপ: এই বৈশিষ্ট্যটি পূর্বরূপ (প্রি-GA) এ রয়েছে। প্রাক-GA পণ্য এবং বৈশিষ্ট্যগুলির সীমিত সমর্থন থাকতে পারে এবং প্রাক-GA পণ্য এবং বৈশিষ্ট্যগুলির পরিবর্তনগুলি অন্যান্য প্রাক-GA সংস্করণগুলির সাথে সামঞ্জস্যপূর্ণ নাও হতে পারে। প্রাক-GA অফারগুলি Google মানচিত্র প্ল্যাটফর্ম পরিষেবার নির্দিষ্ট শর্তাবলী দ্বারা আচ্ছাদিত। আরও তথ্যের জন্য, লঞ্চ পর্যায়ের বিবরণ দেখুন।

ঠিকানাটি ইংরেজিতে অনুবাদ করা হয়েছে।

অনুবাদিত ঠিকানাগুলি API ইনপুট হিসাবে পুনরায় ব্যবহারযোগ্য নয়৷ পরিষেবাটি তাদের প্রদান করে যাতে ব্যবহারকারী তাদের স্থানীয় ভাষা ব্যবহার করে আসল-প্রদত্ত ঠিকানার বৈধতা নিশ্চিত বা অস্বীকার করতে পারে।

ঠিকানার অংশের ইংরেজি অনুবাদ না থাকলে, পরিষেবাটি সেই অংশটিকে একটি বিকল্প ভাষায় ফেরত দেয় যা একটি ল্যাটিন স্ক্রিপ্ট ব্যবহার করে। কিভাবে বিকল্প ভাষা নির্বাচন করা হয় তার ব্যাখ্যার জন্য এখানে দেখুন। যদি ঠিকানার অংশে ল্যাটিন স্ক্রিপ্ট ব্যবহার করে এমন কোনো ভাষায় কোনো অনুবাদ বা প্রতিবর্ণীকরণ না থাকে, তাহলে পরিষেবাটি ঠিকানার সাথে যুক্ত স্থানীয় ভাষায় সেই অংশটি ফিরিয়ে দেয়।

google.maps.addressvalidation.v1.LanguageOptions.return_english_latin_address পতাকা ব্যবহার করে এই আউটপুটটি সক্ষম করুন৷

দ্রষ্টব্য: englishLatinAddress এ google.maps.addressvalidation.v1.Address.unconfirmed_component_types ক্ষেত্র এবং ইংরেজিতে google.maps.addressvalidation.v1.AddressComponent.confirmation_level ক্ষেত্রগুলি englishLatinAddress.address_components নয়।

রায়

ঠিকানা যাচাইকরণ ফলাফল এবং জিওকোডের উচ্চ স্তরের ওভারভিউ।

JSON প্রতিনিধিত্ব 
{
  "inputGranularity": enum (Granularity),
  "validationGranularity": enum (Granularity),
  "geocodeGranularity": enum (Granularity),
  "addressComplete": boolean,
  "hasUnconfirmedComponents": boolean,
  "hasInferredComponents": boolean,
  "hasReplacedComponents": boolean,
  "possibleNextAction": enum (PossibleNextAction),
  "hasSpellCorrectedComponents": boolean
}
ক্ষেত্র
inputGranularity

enum ( Granularity )

ইনপুট ঠিকানার গ্রানুলারিটি। এটি ইনপুট ঠিকানা পার্স করার ফলাফল এবং কোন বৈধতা সংকেত দেয় না। বৈধতা সংকেতের জন্য, নীচের validationGranularity পড়ুন।

উদাহরণস্বরূপ, যদি ইনপুট ঠিকানায় একটি নির্দিষ্ট অ্যাপার্টমেন্ট নম্বর থাকে, তাহলে এখানে inputGranularity হবে SUB_PREMISE । যদি ঠিকানা যাচাইকরণ পরিষেবাটি ডাটাবেসের অ্যাপার্টমেন্ট নম্বরের সাথে মেলে না বা অ্যাপার্টমেন্ট নম্বরটি অবৈধ হয়, তাহলে validationGranularity সম্ভবত PREMISE বা আরও মোটা হবে৷

validationGranularity

enum ( Granularity )

এপিআই সম্পূর্ণরূপে যাচাই করতে পারে এমন পোস্ট-প্রসেসড ঠিকানার জন্য গ্রানুলারিটির স্তর। উদাহরণস্বরূপ, PREMISE এর একটি validationGranularity নির্দেশ করে যে PREMISE এর স্তরে সমস্ত ঠিকানা উপাদান বা আরও বেশি মোটা যাচাই করা যেতে পারে।

প্রতি ঠিকানা উপাদান যাচাইকরণের ফলাফল google.maps.addressvalidation.v1.Address.address_components এ পাওয়া যাবে।

geocodeGranularity

enum ( Granularity )

geocode গ্রানুলারিটি সম্পর্কে তথ্য। এটি জিওকোডেড অবস্থানটি কতটা মোটা বা সূক্ষ্ম তার শব্দার্থিক অর্থ হিসাবে বোঝা যেতে পারে।

এটি মাঝে মাঝে উপরের validationGranularity গ্রানুলারিটি থেকে ভিন্ন হতে পারে। উদাহরণস্বরূপ, আমাদের ডাটাবেস একটি অ্যাপার্টমেন্ট নম্বরের অস্তিত্ব রেকর্ড করতে পারে কিন্তু একটি বড় অ্যাপার্টমেন্ট কমপ্লেক্সের মধ্যে অ্যাপার্টমেন্টের জন্য একটি সুনির্দিষ্ট অবস্থান নেই। সেক্ষেত্রে, validationGranularity হবে SUB_PREMISE কিন্তু geocodeGranularity হবে PREMISE ।

addressComplete

boolean

কোনো অমীমাংসিত টোকেন না থাকলে, কোনো অপ্রত্যাশিত বা অনুপস্থিত ঠিকানা উপাদান না থাকলে পোস্ট-প্রসেসড ঠিকানাটি সম্পূর্ণ বলে বিবেচিত হয়। যদি সেট না থাকে, তাহলে নির্দেশ করে যে মানটি false । আরও বিশদ বিবরণের জন্য missingComponentTypes , unresolvedTokens বা unexpected ক্ষেত্রগুলি দেখুন৷

hasUnconfirmedComponents

boolean

অন্তত একটি ঠিকানা উপাদান শ্রেণীবদ্ধ বা যাচাই করা যাবে না, বিস্তারিত জানার জন্য google.maps.addressvalidation.v1.Address.address_components দেখুন।

hasInferredComponents

boolean

অন্তত একটি ঠিকানা উপাদান অনুমান করা হয়েছে (যোগ করা হয়েছে) যা ইনপুটে ছিল না, বিস্তারিত জানার জন্য google.maps.addressvalidation.v1.Address.address_components দেখুন।

hasReplacedComponents

boolean

অন্তত একটি ঠিকানা উপাদান প্রতিস্থাপিত হয়েছে, বিস্তারিত জানার জন্য google.maps.addressvalidation.v1.Address.address_components দেখুন।

possibleNextAction

enum ( PossibleNextAction )

পূর্বরূপ: এই বৈশিষ্ট্যটি পূর্বরূপ (প্রি-GA) এ রয়েছে। প্রাক-GA পণ্য এবং বৈশিষ্ট্যগুলির সীমিত সমর্থন থাকতে পারে এবং প্রাক-GA পণ্য এবং বৈশিষ্ট্যগুলির পরিবর্তনগুলি অন্যান্য প্রাক-GA সংস্করণগুলির সাথে সামঞ্জস্যপূর্ণ নাও হতে পারে। প্রাক-GA অফারগুলি Google মানচিত্র প্ল্যাটফর্ম পরিষেবার নির্দিষ্ট শর্তাবলী দ্বারা আচ্ছাদিত। আরও তথ্যের জন্য, লঞ্চ পর্যায়ের বিবরণ দেখুন।

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

hasSpellCorrectedComponents

boolean

অন্তত একটি ঠিকানা উপাদান বানান সংশোধন করা হয়েছে, বিস্তারিত জানার জন্য google.maps.addressvalidation.v1.Address.address_components দেখুন৷

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

একটি ঠিকানা বা একটি জিওকোড থাকতে পারে এমন বিভিন্ন গ্রানুলারিটি। যখন একটি ঠিকানার জন্য গ্রানুলারিটি নির্দেশ করতে ব্যবহৃত হয়, তখন এই মানগুলি নির্দেশ করে যে ঠিকানাটি একটি মেইলিং গন্তব্যকে কতটা সূক্ষ্ম কণিকা চিহ্নিত করে। উদাহরণ স্বরূপ, একটি ঠিকানা যেমন "123 Main Street, Redwood City, CA, 94061" একটি PREMISE সনাক্ত করে যখন "Redwood City, CA, 94061" এর মতো কিছু একটি LOCALITY সনাক্ত করে৷ যাইহোক, যদি আমরা রেডউড সিটিতে "123 মেইন স্ট্রিট"-এর জন্য একটি জিওকোড খুঁজে না পাই, তবে ঠিকানাটি আরও দানাদার হওয়া সত্ত্বেও যে জিওকোড ফেরত দেওয়া হয়েছে তা LOCALITY গ্র্যানুলারিটির হতে পারে৷

এনামস
GRANULARITY_UNSPECIFIED ডিফল্ট মান। এই মান অব্যবহৃত.
SUB_PREMISE নিম্ন-বিল্ডিং স্তরের ফলাফল, যেমন একটি অ্যাপার্টমেন্ট।
PREMISE বিল্ডিং-স্তরের ফলাফল।
PREMISE_PROXIMITY একটি জিওকোড যা ঠিকানাটির বিল্ডিং-স্তরের অবস্থান আনুমানিক করে।
BLOCK ঠিকানা বা জিওকোড একটি ব্লক নির্দেশ করে। শুধুমাত্র সেই অঞ্চলে ব্যবহৃত হয় যেখানে ব্লক-লেভেল অ্যাড্রেসিং আছে, যেমন জাপান।
ROUTE জিওকোড বা ঠিকানাটি রুটের জন্য দানাদার, যেমন রাস্তা, রাস্তা বা হাইওয়ে।
OTHER অন্যান্য সমস্ত গ্রানুলারিটি, যেগুলিকে একসাথে বাকেট করা হয় যেহেতু সেগুলি বিতরণযোগ্য নয়৷

সম্ভাব্য পরবর্তী অ্যাকশন

পূর্বরূপ: এই বৈশিষ্ট্যটি পূর্বরূপ (প্রি-GA) এ রয়েছে। প্রাক-GA পণ্য এবং বৈশিষ্ট্যগুলির সীমিত সমর্থন থাকতে পারে এবং প্রাক-GA পণ্য এবং বৈশিষ্ট্যগুলির পরিবর্তনগুলি অন্যান্য প্রাক-GA সংস্করণগুলির সাথে সামঞ্জস্যপূর্ণ নাও হতে পারে। প্রাক-GA অফারগুলি Google মানচিত্র প্ল্যাটফর্ম পরিষেবার নির্দিষ্ট শর্তাবলী দ্বারা আচ্ছাদিত। আরও তথ্যের জন্য, লঞ্চ পর্যায়ের বিবরণ দেখুন।

API প্রতিক্রিয়ার উপর ভিত্তি করে সম্ভাব্য পরবর্তী পদক্ষেপগুলি নেওয়া যেতে পারে।

এনামস
POSSIBLE_NEXT_ACTION_UNSPECIFIED ডিফল্ট মান। এই মান অব্যবহৃত.
FIX API প্রতিক্রিয়ার এক বা একাধিক ক্ষেত্র পোস্ট-প্রসেসড ঠিকানার সাথে একটি সম্ভাব্য সমস্যা নির্দেশ করে, উদাহরণস্বরূপ verdict.validation_granularity হল OTHER । আপনার গ্রাহককে ঠিকানা সম্পাদনা করতে অনুরোধ করা ঠিকানার গুণমান উন্নত করতে সাহায্য করতে পারে৷
CONFIRM_ADD_SUBPREMISES এপিআই প্রতিক্রিয়া নির্দেশ করে যে পোস্ট-প্রসেসড ঠিকানা একটি সাবপ্রিমিসেস অনুপস্থিত হতে পারে। আপনার গ্রাহককে ঠিকানা পর্যালোচনা করার জন্য অনুরোধ করা এবং একটি ইউনিট নম্বর যোগ করার বিষয়ে বিবেচনা করা ঠিকানার গুণমান উন্নত করতে সাহায্য করতে পারে। পোস্ট-প্রসেসড ঠিকানায় অন্যান্য ছোটখাটো সমস্যাও থাকতে পারে। দ্রষ্টব্য: এই enum মান শুধুমাত্র মার্কিন ঠিকানাগুলির জন্য ফেরত দেওয়া যেতে পারে।
CONFIRM API প্রতিক্রিয়ার এক বা একাধিক ক্ষেত্র পোস্ট-প্রসেসড ঠিকানার সাথে সম্ভাব্য ছোটখাটো সমস্যাগুলি নির্দেশ করে, উদাহরণস্বরূপ postalCode ঠিকানা উপাদান replaced হয়েছে। আপনার গ্রাহককে ঠিকানা পর্যালোচনা করার জন্য অনুরোধ করা ঠিকানার গুণমান উন্নত করতে সাহায্য করতে পারে।
ACCEPT এপিআই প্রতিক্রিয়াতে এমন সংকেত নেই যা অন্যান্য সম্ভাব্য নেক্সটঅ্যাকশন মানগুলির একটিকে নিশ্চিত করে। আপনি আপনার গ্রাহককে আরও প্রম্পট না করে পোস্ট-প্রসেসড ঠিকানা ব্যবহার করার কথা বিবেচনা করতে পারেন, যদিও এটি ঠিকানাটির বৈধতা নিশ্চিত করে না এবং ঠিকানাটিতে এখনও সংশোধন থাকতে পারে। আপনার নিজের ঝুঁকি মূল্যায়নের উপর নির্ভর করে আপনার গ্রাহককে কীভাবে প্রম্পট করতে হবে তা নির্ধারণ করা আপনার দায়িত্ব।

ঠিকানা

পোস্ট-প্রসেসড ঠিকানার বিশদ বিবরণ। পোস্ট-প্রসেসিং এর মধ্যে রয়েছে ঠিকানার ভুল বানান অংশ সংশোধন করা, ভুল অংশ প্রতিস্থাপন করা এবং অনুপস্থিত অংশ অনুমান করা।

JSON প্রতিনিধিত্ব 
{
  "formattedAddress": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "addressComponents": [
    {
      object (AddressComponent)
    }
  ],
  "missingComponentTypes": [
    string
  ],
  "unconfirmedComponentTypes": [
    string
  ],
  "unresolvedTokens": [
    string
  ]
}
ক্ষেত্র
formattedAddress

string

পোস্ট-প্রসেসড অ্যাড্রেস, যেখানে ঠিকানাটি অবস্থিত সেই অঞ্চলের অ্যাড্রেস ফরম্যাটিং নিয়ম অনুসরণ করে একটি একক-লাইন ঠিকানা হিসাবে ফর্ম্যাট করা হয়।

দ্রষ্টব্য: এই ঠিকানার বিন্যাস postalAddress ক্ষেত্রের ঠিকানার বিন্যাসের সাথে নাও মিলতে পারে। উদাহরণস্বরূপ, postalAddress সর্বদা একটি 2 অক্ষরের regionCode হিসাবে দেশকে উপস্থাপন করে, যেমন "US" বা "NZ"। বিপরীতে, এই ক্ষেত্রটি দেশের নামের একটি দীর্ঘ রূপ ব্যবহার করে, যেমন "USA" বা "New Zealand"।

postalAddress

object ( PostalAddress )

পোস্ট-প্রসেসড ঠিকানা একটি ডাক ঠিকানা হিসাবে প্রতিনিধিত্ব করে।

addressComponents[]

object ( AddressComponent )

অবিন্যস্ত তালিকা। বৈধতা তথ্য সহ ফর্ম্যাট করা এবং সংশোধন করা ঠিকানার পৃথক ঠিকানা উপাদান। এটি পৃথক উপাদানের বৈধতা অবস্থার তথ্য প্রদান করে।

ঠিকানা উপাদান একটি নির্দিষ্ট উপায়ে আদেশ করা হয় না. তালিকার ঠিকানা উপাদানগুলির ক্রমানুসারে কোনো অনুমান করবেন না।

missingComponentTypes[]

string

সঠিকভাবে ফরম্যাট করা মেইলিং ঠিকানায় উপস্থিত থাকার প্রত্যাশিত উপাদানগুলির প্রকারগুলি কিন্তু ইনপুটে পাওয়া যায়নি এবং অনুমান করা যায়নি৷ "Boulder, Colorado, 80301, USA" এর মতো একটি ইনপুটের জন্য একটি উদাহরণ হতে পারে ['street_number', 'route'] । সম্ভাব্য প্রকারের তালিকা এখানে পাওয়া যাবে।

দ্রষ্টব্য: আপনি একটি অনুপস্থিত উপাদান প্রকার দেখতে পারেন যখন আপনি মনে করেন যে আপনি ইতিমধ্যে অনুপস্থিত উপাদান সরবরাহ করেছেন। উদাহরণস্বরূপ, এটি ঘটতে পারে যখন ইনপুট ঠিকানায় বিল্ডিংয়ের নাম থাকে, কিন্তু প্রিমিস নম্বর থাকে না। "渋谷区渋谷３丁目 Shibuya Stream" ঠিকানায়, "Shibuya Stream" বিল্ডিং নামটিতে কম্পোনেন্ট টাইপ premise আছে, কিন্তু প্রিমিস নম্বরটি নেই, তাই missingComponentTypes premise থাকবে।

unconfirmedComponentTypes[]

string

addressComponents উপস্থিত উপাদানগুলির প্রকারগুলি কিন্তু সঠিক বলে নিশ্চিত করা যায়নি। এই ক্ষেত্রটি সুবিধার জন্য প্রদান করা হয়েছে: এর বিষয়বস্তু addressComponents মাধ্যমে পুনরাবৃত্তি করার সমতুল্য যে সমস্ত উপাদানগুলির প্রকারগুলি খুঁজে বের করতে যেখানে confirmationLevel স্তরটি CONFIRMED হয়নি বা inferred পতাকাটি true সেট করা হয়নি৷ সম্ভাব্য প্রকারের তালিকা এখানে পাওয়া যাবে।

unresolvedTokens[]

string

ইনপুটে কোনো টোকেন আছে যা সমাধান করা যায়নি। এটি একটি ইনপুট হতে পারে যা একটি ঠিকানার একটি বৈধ অংশ হিসাবে স্বীকৃত হয়নি৷ উদাহরণস্বরূপ, "পার্সেল 0000123123 এবং 0000456456 Str # Guthrie Center IA 50115 US" এর মতো একটি ইনপুটের জন্য, অমীমাংসিত টোকেনগুলি দেখতে ["Parcel", "0000123123", "&", "0000456456"] এর মতো হতে পারে৷

ঠিকানা উপাদান

একটি ঠিকানা উপাদান প্রতিনিধিত্ব করে, যেমন একটি রাস্তা, শহর বা রাজ্য।

JSON প্রতিনিধিত্ব 
{
  "componentName": {
    object (ComponentName)
  },
  "componentType": string,
  "confirmationLevel": enum (ConfirmationLevel),
  "inferred": boolean,
  "spellCorrected": boolean,
  "replaced": boolean,
  "unexpected": boolean
}
ক্ষেত্র
componentName

object ( ComponentName )

এই উপাদান জন্য নাম.

componentType

string

ঠিকানা উপাদানের ধরন। সারণি 2 দেখুন: সম্ভাব্য প্রকারের তালিকার জন্য স্থান পরিষেবা দ্বারা প্রত্যাবর্তিত অতিরিক্ত প্রকারগুলি ।

confirmationLevel

enum ( ConfirmationLevel )

আমাদের নিশ্চিততার স্তর নির্দেশ করে যে উপাদানটি সঠিক।

inferred

boolean

ইঙ্গিত করে যে উপাদানটি ইনপুটের অংশ ছিল না, কিন্তু আমরা ঠিকানার অবস্থানের জন্য এটি অনুমান করেছি এবং বিশ্বাস করি এটি একটি সম্পূর্ণ ঠিকানার জন্য প্রদান করা উচিত।

spellCorrected

boolean

উপাদান নামের একটি ভুল বানান সংশোধন নির্দেশ করে। API সর্বদা একটি বানান বৈকল্পিক থেকে অন্য বানান পরিবর্তন করে না, যেমন যখন "কেন্দ্র" থেকে "কেন্দ্র" পরিবর্তন করে। এটি সর্বদা সাধারণ ভুল বানানগুলিকেও ফ্ল্যাগ করে না, যেমন যখন "Amphitheater Pkwy" থেকে "Amphitheatre Pkwy" পরিবর্তন করে।

replaced

boolean

ইঙ্গিত করে যে উপাদানটির নাম সম্পূর্ণ ভিন্ন একটি দিয়ে প্রতিস্থাপিত হয়েছে, উদাহরণস্বরূপ ঠিকানার জন্য সঠিক একটি দিয়ে একটি ভুল পোস্টাল কোড প্রতিস্থাপিত হচ্ছে৷ এটি একটি প্রসাধনী পরিবর্তন নয়, ইনপুট উপাদান একটি ভিন্ন একটি পরিবর্তন করা হয়েছে.

unexpected

boolean

একটি ঠিকানা উপাদান নির্দেশ করে যা প্রদত্ত অঞ্চলের জন্য একটি ডাক ঠিকানায় উপস্থিত থাকার আশা করা হয় না৷ আমরা এটিকে ধরে রেখেছি কারণ এটি ইনপুটের অংশ ছিল।

উপাদানের নাম

কম্পোনেন্টের নামের জন্য একটি মোড়ক।

JSON প্রতিনিধিত্ব 
{
  "text": string,
  "languageCode": string
}
ক্ষেত্র
text

string

নামের পাঠ্য। উদাহরণস্বরূপ, রাস্তার নামের জন্য "5ম অ্যাভিনিউ" বা রাস্তার নম্বরের জন্য "1253"।

languageCode

string

BCP-47 ভাষার কোড। এটি উপস্থিত থাকবে না যদি উপাদানের নামটি একটি ভাষার সাথে যুক্ত না হয়, যেমন রাস্তার নম্বর।

নিশ্চিতকরণ স্তর

নিশ্চিতকরণ স্তরের জন্য বিভিন্ন সম্ভাব্য মান।

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

জিওকোড

যেখানে ইনপুটটি জিওকোড করা হয়েছিল সে সম্পর্কে তথ্য রয়েছে৷

JSON প্রতিনিধিত্ব 
{
  "location": {
    object (LatLng)
  },
  "plusCode": {
    object (PlusCode)
  },
  "bounds": {
    object (Viewport)
  },
  "featureSizeMeters": number,
  "placeId": string,
  "placeTypes": [
    string
  ]
}
ক্ষেত্র
location

object ( LatLng )

ইনপুটের জিওকোডেড অবস্থান।

ঠিকানা, অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্ক বা প্লাস কোড ব্যবহার করার চেয়ে স্থান আইডি ব্যবহার করা পছন্দনীয়। ড্রাইভিং দিকনির্দেশ রাউটিং বা গণনা করার সময় স্থানাঙ্ক ব্যবহার করার ফলে সর্বদা পয়েন্টটি সেই স্থানাঙ্কগুলির নিকটবর্তী রাস্তায় স্ন্যাপ করা হবে। এটি এমন একটি রাস্তা নাও হতে পারে যা দ্রুত বা নিরাপদে গন্তব্যে নিয়ে যাবে এবং সম্পত্তির অ্যাক্সেস পয়েন্টের কাছাকাছি নাও হতে পারে। উপরন্তু, যখন একটি অবস্থান বিপরীত জিওকোড করা হয়, তখন কোন গ্যারান্টি নেই যে ফেরত ঠিকানাটি আসলটির সাথে মিলবে।

plusCode

object ( PlusCode )

location সাথে সংশ্লিষ্ট প্লাস কোড।

bounds

object ( Viewport )

জিওকোড করা স্থানের সীমানা।

featureSizeMeters

number

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

placeId

string

এই ইনপুট জিওকোড করা জায়গার PlaceID।

প্লেস আইডি সম্পর্কে আরও তথ্যের জন্য এখানে দেখুন।

placeTypes[]

string

ইনপুট জিওকোড করা স্থানের প্রকার(গুলি)৷ উদাহরণস্বরূপ, ['locality', 'political'] । প্রকারের সম্পূর্ণ তালিকা এখানে পাওয়া যাবে।

LatLng

একটি বস্তু যা একটি অক্ষাংশ/দ্রাঘিমাংশ জোড়া প্রতিনিধিত্ব করে। এটি ডিগ্রী অক্ষাংশ এবং ডিগ্রী দ্রাঘিমাংশের প্রতিনিধিত্ব করার জন্য এক জোড়া দ্বিগুণ হিসাবে প্রকাশ করা হয়। অন্যথায় নির্দিষ্ট করা না থাকলে, এই বস্তুটিকে অবশ্যই WGS84 মান মেনে চলতে হবে। মানগুলি অবশ্যই স্বাভাবিক সীমার মধ্যে থাকতে হবে৷

JSON প্রতিনিধিত্ব 
{
  "latitude": number,
  "longitude": number
}
ক্ষেত্র
latitude

number

ডিগ্রী অক্ষাংশ. এটি অবশ্যই [-90.0, +90.0] এর মধ্যে হতে হবে।

longitude

number

ডিগ্রী দ্রাঘিমাংশ. এটি অবশ্যই [-180.0, +180.0] পরিসরে হতে হবে।

প্লাসকোড

প্লাস কোড ( http://plus.codes ) হল দুটি ফর্ম্যাট সহ একটি অবস্থানের রেফারেন্স: গ্লোবাল কোড একটি 14mx14m (ডিগ্রীর 1/8000তম) বা ছোট আয়তক্ষেত্র সংজ্ঞায়িত করে এবং যৌগিক কোড, একটি রেফারেন্স অবস্থানের সাথে উপসর্গ প্রতিস্থাপন করে।

JSON প্রতিনিধিত্ব 
{
  "globalCode": string,
  "compoundCode": string
}
ক্ষেত্র
globalCode

string

স্থানের গ্লোবাল (সম্পূর্ণ) কোড, যেমন "9FWM33GV+HQ", একটি 1/8000 বাই 1/8000 ডিগ্রী এলাকা (~14 বাই 14 মিটার) প্রতিনিধিত্ব করে।

compoundCode

string

স্থানের যৌগিক কোড, যেমন "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 (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
ক্ষেত্র
low

object ( LatLng )

প্রয়োজন। ভিউপোর্টের নিম্ন পয়েন্ট।

high

object ( LatLng )

প্রয়োজন। ভিউপোর্টের উচ্চ বিন্দু।

ঠিকানা মেটাডেটা

পোস্ট-প্রসেসড ঠিকানার মেটাডেটা। ঠিকানা যাচাইকরণ API এ পাঠানো প্রতিটি ঠিকানার জন্য metadata সম্পূর্ণরূপে জনবহুল হওয়ার নিশ্চয়তা নেই।

JSON প্রতিনিধিত্ব 
{
  "business": boolean,
  "poBox": boolean,
  "residential": boolean
}
ক্ষেত্র
business

boolean

নির্দেশ করে যে এটি একটি ব্যবসার ঠিকানা। যদি সেট না থাকে, তাহলে নির্দেশ করে যে মানটি অজানা।

poBox

boolean

একটি PO বক্সের ঠিকানা নির্দেশ করে। যদি সেট না থাকে, তাহলে নির্দেশ করে যে মানটি অজানা।

residential

boolean

নির্দেশ করে যে এটি একটি বাসস্থানের ঠিকানা। যদি সেট না থাকে, তাহলে নির্দেশ করে যে মানটি অজানা।

ইউএসপিএস ডেটা

ঠিকানার জন্য USPS ডেটা। ঠিকানা যাচাইকরণ API এ পাঠানো প্রতিটি US বা PR ঠিকানার জন্য uspsData সম্পূর্ণরূপে জনবহুল হওয়ার নিশ্চয়তা নেই। আপনি যদি প্রতিক্রিয়ার প্রাথমিক অংশ হিসাবে uspsData ব্যবহার করেন তবে প্রতিক্রিয়াতে ব্যাকআপ ঠিকানা ক্ষেত্রগুলিকে সংহত করার পরামর্শ দেওয়া হয়।

JSON প্রতিনিধিত্ব 
{
  "standardizedAddress": {
    object (UspsAddress)
  },
  "deliveryPointCode": string,
  "deliveryPointCheckDigit": string,
  "dpvConfirmation": string,
  "dpvFootnote": string,
  "dpvCmra": string,
  "dpvVacant": string,
  "dpvNoStat": string,
  "dpvNoStatReasonCode": integer,
  "dpvDrop": string,
  "dpvThrowback": string,
  "dpvNonDeliveryDays": string,
  "dpvNonDeliveryDaysValues": integer,
  "dpvNoSecureLocation": string,
  "dpvPbsa": string,
  "dpvDoorNotAccessible": string,
  "dpvEnhancedDeliveryCode": string,
  "carrierRoute": string,
  "carrierRouteIndicator": string,
  "ewsNoMatch": boolean,
  "postOfficeCity": string,
  "postOfficeState": string,
  "abbreviatedCity": string,
  "fipsCountyCode": string,
  "county": string,
  "elotNumber": string,
  "elotFlag": string,
  "lacsLinkReturnCode": string,
  "lacsLinkIndicator": string,
  "poBoxOnlyPostalCode": boolean,
  "suitelinkFootnote": string,
  "pmbDesignator": string,
  "pmbNumber": string,
  "addressRecordType": string,
  "defaultAddress": boolean,
  "errorMessage": string,
  "cassProcessed": boolean
}
ক্ষেত্র
standardizedAddress

object ( UspsAddress )

USPS প্রমিত ঠিকানা।

deliveryPointCode

string

2 সংখ্যার ডেলিভারি পয়েন্ট কোড

deliveryPointCheckDigit

string

ডেলিভারি পয়েন্ট চেক ডিজিট। এই নম্বরটি যান্ত্রিকভাবে স্ক্যান করা মেলের জন্য বিতরণ_পয়েন্ট_বারকোডের শেষে যোগ করা হয়। Delivery_point_barcode, deliveryPointCheckDigit, পোস্টাল কোড, এবং ZIP+4 এর সমস্ত সংখ্যা একসাথে যোগ করলে 10 দ্বারা বিভাজ্য সংখ্যা পাওয়া উচিত।

dpvConfirmation

string

DPV নিশ্চিতকরণের সম্ভাব্য মান। একটি একক অক্ষর প্রদান করে বা কোনো মান প্রদান করে না।

  • N : প্রাথমিক এবং কোনো সেকেন্ডারি নম্বর তথ্য DPV নিশ্চিত করতে ব্যর্থ হয়েছে।
  • D : ঠিকানা শুধুমাত্র প্রাথমিক নম্বরের জন্য DPV নিশ্চিত করা হয়েছে, এবং দ্বিতীয় নম্বরের তথ্য অনুপস্থিত ছিল।
  • S : ঠিকানা শুধুমাত্র প্রাথমিক নম্বরের জন্য DPV নিশ্চিত করা হয়েছে, এবং সেকেন্ডারি নম্বর তথ্য উপস্থিত ছিল কিন্তু নিশ্চিত করা হয়নি।
  • Y : প্রাথমিক এবং যেকোনো মাধ্যমিক নম্বরের জন্য ঠিকানা DPV নিশ্চিত করা হয়েছে।
  • খালি: যদি প্রতিক্রিয়াতে একটি dpvConfirmation মান না থাকে, তাহলে ঠিকানাটি DPV নিশ্চিতকরণের জন্য জমা দেওয়া হয়নি।
dpvFootnote

string

ডেলিভারি পয়েন্ট বৈধতা থেকে পাদটীকা. একাধিক পাদটীকা একই স্ট্রিং এ একসাথে স্ট্রং করা যেতে পারে।

  • AA : ইনপুট ঠিকানা ZIP+4 ফাইলের সাথে মিলেছে
  • A1 : ইনপুট ঠিকানা ZIP+4 ফাইলের সাথে মেলেনি
  • BB : DPV এর সাথে মিলে গেছে (সমস্ত উপাদান)
  • CC : মাধ্যমিক নম্বর মিলছে না এবং প্রয়োজন নেই
  • C1 : সেকেন্ডারি নম্বর মেলেনি কিন্তু প্রয়োজনীয়
  • N1 : উচ্চ-বৃদ্ধির ঠিকানা সেকেন্ডারি নম্বর অনুপস্থিত
  • M1 : প্রাথমিক নম্বর অনুপস্থিত
  • M3 : প্রাথমিক সংখ্যা অবৈধ
  • P1 : ইনপুট ঠিকানা PO, RR বা HC বক্স নম্বর অনুপস্থিত
  • P3 : ইনপুট ঠিকানা PO, RR, বা HC বক্স নম্বর অবৈধ৷
  • F1 : একটি সামরিক ঠিকানার সাথে মিলিত ইনপুট ঠিকানা
  • G1 : ইনপুট ঠিকানা একটি সাধারণ বিতরণ ঠিকানার সাথে মিলেছে
  • U1 : ইনপুট ঠিকানা একটি অনন্য জিপ কোডের সাথে মিলেছে
  • PB : ইনপুট ঠিকানা PBSA রেকর্ডের সাথে মিলেছে
  • RR : PMB তথ্য সহ DPV নিশ্চিত ঠিকানা
  • R1 : PMB তথ্য ছাড়া DPV নিশ্চিত ঠিকানা
  • R7 : ক্যারিয়ার রুট R777 বা R779 রেকর্ড
  • IA : অবহিত ঠিকানা চিহ্নিত করা হয়েছে
  • TA : একটি ট্রেলিং আলফা বাদ দিয়ে প্রাথমিক সংখ্যা মিলেছে৷
dpvCmra

string

ঠিকানাটি একটি CMRA (বাণিজ্যিক মেল রিসিভিং এজেন্সি)- - ক্লায়েন্টদের জন্য একটি ব্যক্তিগত ব্যবসায়িক মেল গ্রহণ করে কিনা তা নির্দেশ করে৷ একটি একক অক্ষর প্রদান করে।

  • Y : ঠিকানাটি একটি CMRA
  • N : ঠিকানাটি CMRA নয়
dpvVacant

string

এই জায়গা কি খালি? একটি একক অক্ষর প্রদান করে।

  • Y : ঠিকানা খালি
  • N : ঠিকানা খালি নেই
dpvNoStat

string

এটি কি কোন স্ট্যাট ঠিকানা না একটি সক্রিয় ঠিকানা? কোন স্ট্যাট ঠিকানা এমন নয় যা ক্রমাগত দখল করা হয় না বা এমন ঠিকানা যা USPS পরিষেবা দেয় না। একটি একক অক্ষর প্রদান করে।

  • Y : ঠিকানাটি সক্রিয় নয়
  • N : ঠিকানাটি সক্রিয়
dpvNoStatReasonCode

integer

NoStat প্রকার নির্দেশ করে। int হিসাবে একটি কারণ কোড প্রদান করে।

  • 1 : IDA (অভ্যন্তরীণ ড্রপ ঠিকানা) – যে ঠিকানাগুলি সরাসরি USPS থেকে মেইল ​​​​পায় না কিন্তু একটি ড্রপ ঠিকানায় বিতরণ করা হয় যা তাদের পরিষেবা দেয়।
  • 2 : CDS - ঠিকানা যেগুলি এখনও বিতরণযোগ্য হয়ে ওঠেনি। উদাহরণস্বরূপ, একটি নতুন উপবিভাগ যেখানে লট এবং প্রাথমিক সংখ্যা নির্ধারণ করা হয়েছে, কিন্তু দখলের জন্য এখনও কোনো কাঠামো বিদ্যমান নেই।
  • 3 : সংঘর্ষ - ঠিকানা যা আসলে DPV নিশ্চিত করে না।
  • 4 : CMZ (কলেজ, সামরিক এবং অন্যান্য প্রকার) - ZIP + 4 রেকর্ড ইউএসপিএস ডেটাতে অন্তর্ভুক্ত করেছে।
  • 5 : নিয়মিত - ঠিকানাগুলি ডেলিভারি পাচ্ছে না এবং ঠিকানাগুলি সম্ভাব্য ডেলিভারি হিসাবে গণনা করা হয় না।
  • 6 : সেকেন্ডারি প্রয়োজনীয় - ঠিকানার জন্য সেকেন্ডারি তথ্য প্রয়োজন।
dpvDrop

string

পতাকা নির্দেশ করে যে একটি সাইটে একটি একক গ্রহণযোগ্য মেল বিতরণ করা হয়েছে। একটি একক অক্ষর প্রদান করে।

  • Y : মেলটি একটি সাইটে গ্রহনযোগ্য একটি একক স্থানে বিতরণ করা হয়।
  • N : মেইলটি একটি সাইটে গ্রহনযোগ্য একক ডেলিভারি করা হয় না।
dpvThrowback

string

ইঙ্গিত করে যে মেল রাস্তার ঠিকানায় বিতরণ করা হয় না। একটি একক অক্ষর প্রদান করে।

  • Y : রাস্তার ঠিকানায় মেলটি বিতরণ করা হয় না।
  • N : মেইলটি রাস্তার ঠিকানায় পৌঁছে দেওয়া হয়।
dpvNonDeliveryDays

string

পতাকা নির্দেশ করে মেইল ​​ডেলিভারি সপ্তাহের প্রতিদিন সঞ্চালিত হয় না। একটি একক অক্ষর প্রদান করে।

  • Y : মেইল ​​ডেলিভারি সপ্তাহের প্রতিদিন সঞ্চালিত হয় না।
  • N : কোন ইঙ্গিত নেই যে মেইল ​​ডেলিভারি সপ্তাহের প্রতিদিন সঞ্চালিত হয় না।
dpvNonDeliveryDaysValues

integer

পূর্ণসংখ্যা নন-ডেলিভারি দিন সনাক্ত করে। বিট ফ্ল্যাগ ব্যবহার করে জিজ্ঞাসাবাদ করা যেতে পারে: 0x40 - রবিবার একটি নন-ডেলিভারির দিন 0x20 - সোমবার একটি নন-ডেলিভারির দিন 0x10 - মঙ্গলবার একটি নন-ডেলিভারির দিন 0x08 - বুধবার একটি নন-ডেলিভারির দিন 0x04 - বৃহস্পতিবার একটি নন-ডেলিভারি দিন 0x02 - শুক্রবার একটি নন-ডেলিভারি দিন 0x02 - শুক্রবার একটি নন-ডেলিভারি দিন দিন

dpvNoSecureLocation

string

পতাকা নির্দেশ করে দরজা অ্যাক্সেসযোগ্য, কিন্তু নিরাপত্তা উদ্বেগের কারণে প্যাকেজটি ছেড়ে দেওয়া হবে না। একটি একক অক্ষর প্রদান করে।

  • Y : নিরাপত্তা সংক্রান্ত উদ্বেগের কারণে প্যাকেজটি ছেড়ে দেওয়া হবে না।
  • N : নিরাপত্তা সংক্রান্ত উদ্বেগের কারণে প্যাকেজটি ছেড়ে দেওয়া হবে না এমন কোনো ইঙ্গিত নেই।
dpvPbsa

string

ইঙ্গিত করে ঠিকানাটি PBSA রেকর্ডের সাথে মিলে গেছে। একটি একক অক্ষর প্রদান করে।

  • Y : ঠিকানাটি PBSA রেকর্ডের সাথে মিলে গেছে।
  • N : ঠিকানাটি PBSA রেকর্ডের সাথে মেলেনি।
dpvDoorNotAccessible

string

পতাকা সেই ঠিকানাগুলি নির্দেশ করে যেখানে ইউএসপিএস মেল বিতরণের জন্য দরজায় টোকা দিতে পারে না। একটি একক অক্ষর প্রদান করে।

  • Y : দরজা অ্যাক্সেসযোগ্য নয়।
  • N : কোন ইঙ্গিত দরজা অ্যাক্সেসযোগ্য নয়.
dpvEnhancedDeliveryCode

string

নির্দেশ করে যে ঠিকানার জন্য একাধিক DPV রিটার্ন কোড বৈধ। একটি একক অক্ষর প্রদান করে।

  • Y : প্রাথমিক এবং যেকোনো মাধ্যমিক নম্বরের জন্য ঠিকানা DPV নিশ্চিত করা হয়েছে।
  • N : প্রাথমিক এবং কোনো সেকেন্ডারি নম্বর তথ্য DPV নিশ্চিত করতে ব্যর্থ হয়েছে।
  • S : ঠিকানা শুধুমাত্র প্রাথমিক সংখ্যার জন্য DPV নিশ্চিত করা হয়েছিল, এবং মাধ্যমিক নম্বরের তথ্য উপস্থিত ছিল কিন্তু নিশ্চিত করা হয়নি, বা একটি প্রাথমিক নম্বরের একটি একক ট্রেইলিং আলফা একটি DPV ম্যাচ এবং সেকেন্ডারি তথ্যের প্রয়োজনীয়তা তৈরি করতে বাদ দেওয়া হয়েছিল৷
  • D : ঠিকানা শুধুমাত্র প্রাথমিক নম্বরের জন্য DPV নিশ্চিত করা হয়েছে, এবং দ্বিতীয় নম্বরের তথ্য অনুপস্থিত।
  • R : ঠিকানা নিশ্চিত করা হয়েছে কিন্তু ফ্যান্টম রুট R777 এবং R779-এ বরাদ্দ করা হয়েছে এবং USPS ডেলিভারি দেওয়া হয়নি।
carrierRoute

string

ক্যারিয়ার রুট কোড। একটি চার অক্ষরের কোড যা একটি এক অক্ষর উপসর্গ এবং একটি তিন অঙ্কের রুট ডিজাইনার নিয়ে গঠিত।

উপসর্গ:

  • C : ক্যারিয়ার রুট (বা শহরের রুট)
  • R : গ্রামীণ পথ
  • H : হাইওয়ে চুক্তি রুট
  • B : পোস্ট অফিস বক্স বিভাগ
  • G : সাধারণ বিতরণ ইউনিট
carrierRouteIndicator

string

ক্যারিয়ার রুট রেট সাজানোর সূচক।

ewsNoMatch

boolean

ডেলিভারির ঠিকানা মিলছে, কিন্তু EWS ফাইলটি নির্দেশ করে যে শীঘ্রই একটি সঠিক মিল পাওয়া যাবে।

postOfficeCity

string

প্রধান পোস্ট অফিস শহর।

postOfficeState

string

প্রধান পোস্ট অফিস রাষ্ট্র.

abbreviatedCity

string

সংক্ষিপ্ত শহর।

fipsCountyCode

string

FIPS কাউন্টি কোড।

county

string

কাউন্টির নাম।

elotNumber

string

ভ্রমণের বর্ধিত লাইন (eLOT) নম্বর।

elotFlag

string

eLOT অ্যাসেন্ডিং/ডিসেন্ডিং ফ্ল্যাগ (A/D)।

poBoxOnlyPostalCode

boolean

PO বক্স শুধুমাত্র পোস্টাল কোড.

pmbDesignator

string

PMB (প্রাইভেট মেইল ​​বক্স) ইউনিট মনোনীত।

pmbNumber

string

PMB (ব্যক্তিগত মেইল ​​বক্স) নম্বর;

addressRecordType

string

ঠিকানা রেকর্ডের প্রকার যা ইনপুট ঠিকানার সাথে মেলে।

  • F : FIRM. এটি একটি দৃঢ় রেকর্ডের সাথে একটি মিল, যা একটি ঠিকানার জন্য উপলব্ধ সেরা স্তরের মিল।
  • G : সাধারণ ডেলিভারি। এটি একটি সাধারণ ডেলিভারির রেকর্ডের সাথে মিল।
  • H : বিল্ডিং / অ্যাপার্টমেন্ট। এটি একটি বিল্ডিং বা অ্যাপার্টমেন্ট রেকর্ডের সাথে মিল।
  • P : পোস্ট অফিস বক্স। এটি একটি পোস্ট অফিস বক্সের সাথে মিল।
  • R : গ্রামীণ রুট বা হাইওয়ে চুক্তি: এটি হয় একটি গ্রামীণ রুট বা হাইওয়ে চুক্তির রেকর্ডের সাথে মিল, উভয়েরই বক্স নম্বর রেঞ্জ যুক্ত থাকতে পারে।
  • S : রাস্তার রেকর্ড: এটি একটি বৈধ প্রাথমিক সংখ্যা পরিসর ধারণকারী একটি রাস্তার রেকর্ডের সাথে মিল।
defaultAddress

boolean

সূচক যে একটি ডিফল্ট ঠিকানা পাওয়া গেছে, তবে আরও নির্দিষ্ট ঠিকানা বিদ্যমান।

errorMessage

string

ইউএসপিএস ডেটা পুনরুদ্ধারের জন্য ত্রুটি বার্তা। কৃত্রিমভাবে তৈরি ঠিকানাগুলি সনাক্তকরণের কারণে ইউএসপিএস প্রসেসিং স্থগিত করা হলে এটি পপুলেট হয়।

এই ত্রুটি উপস্থিত থাকলে ইউএসপিএস ডেটা ক্ষেত্রগুলি পপুলেশন নাও হতে পারে।

cassProcessed

boolean

সূচক যে অনুরোধটি ক্যাস প্রক্রিয়াজাত করা হয়েছে।

ইউএসপিএসএড্রেস

ইউএসপিএস একটি মার্কিন ঠিকানার প্রতিনিধিত্ব।

JSON প্রতিনিধিত্ব 
{
  "firstAddressLine": string,
  "firm": string,
  "secondAddressLine": string,
  "urbanization": string,
  "cityStateZipAddressLine": string,
  "city": string,
  "state": string,
  "zipCode": string,
  "zipCodeExtension": string
}
ক্ষেত্র
firstAddressLine

string

প্রথম ঠিকানা লাইন।

firm

string

দৃ firm ় নাম।

secondAddressLine

string

দ্বিতীয় ঠিকানা লাইন।

urbanization

string

পুয়ের্তো রিকান নগরায়ণের নাম।

cityStateZipAddressLine

string

শহর + রাজ্য + ডাক কোড।

city

string

শহরের নাম।

state

string

2 লেটার স্টেট কোড।

zipCode

string

ডাক কোড ইজি 10009।

zipCodeExtension

string

4-অঙ্কের ডাক কোড এক্সটেনশন ইজি 5023।