PostalAddress

ডাক ঠিকানা, যেমন ডাক ডেলিভারি বা পেমেন্টের ঠিকানা। ডাক ঠিকানার মাধ্যমে, ডাক পরিষেবা কোনও প্রাঙ্গণ, পি.ও. বক্স বা একই ধরনের জায়গায় আইটেম ডেলিভার করতে পারে। রাস্তা, শহর বা পাহাড়ের মতো ভৌগোলিক লোকেশনের মডেল হিসেবে ডাক ঠিকানা ব্যবহার করা হয় না।

সাধারণত, প্রসেসের ধরনের উপর নির্ভর করে, ব্যবহারকারীর ইনপুট বা আগে থেকে থাকা ডেটা ইম্পোর্ট করার মাধ্যমে ঠিকানা তৈরি করা হয়।

ঠিকানা ইনপুট বা এডিট করা সংক্রান্ত পরামর্শ:

  • 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-তে সেট করতে হবে, যা লেটেস্ট রিভিশন।

সব নতুন রিভিশন অবশ্যই পুরনো রিভিশনের সাথে ব্যাকওয়ার্ড কম্প্যাটিবল হতে হবে।

regionCode

string

প্রয়োজনীয়। ঠিকানার দেশ/অঞ্চলের CLDR অঞ্চল কোড। এটি কখনই অনুমান করা হয় না এবং মানটি সঠিক কিনা তা নিশ্চিত করার দায়িত্ব ব্যবহারকারীর। বিস্তারিত জানতে https://cldr.unicode.org/ এবং https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html দেখুন। যেমন: সুইজারল্যান্ডের জন্য "CH"।

languageCode

string

ঐচ্ছিক। এই ঠিকানার কন্টেন্টের BCP-47 ভাষা কোড (যদি জানা থাকে)। এটি প্রায়শই ইনপুট ফর্মের UI ভাষা হয় অথবা ঠিকানা যে দেশ/অঞ্চলের, সেখানে ব্যবহৃত কোনও একটি ভাষা বা তার লিপ্যন্তরিত সমতুল্য ভাষার সাথে মিলবে বলে আশা করা হয়। এটি নির্দিষ্ট কিছু দেশে ফর্ম্যাটিংকে প্রভাবিত করতে পারে, তবে ডেটার নির্ভুলতার জন্য এটি গুরুত্বপূর্ণ নয় এবং কোনও যাচাইকরণ বা অন্যান্য ফর্ম্যাটিং-সম্পর্কিত অপারেশনকে কখনই প্রভাবিত করবে না।

এই ভ্যালু জানা না থাকলে, এটি বাদ দেওয়া উচিত (সম্ভবত ভুল ডিফল্ট উল্লেখ করার পরিবর্তে)।

যেমন: "zh-Hant", "ja", "ja-Latn", "en"।

postalCode

string

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

sortingCode

string

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

administrativeArea

string

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

locality

string

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

sublocality

string

ঐচ্ছিক। ঠিকানায় থাকা উপ-এলাকা। যেমন, এটি কোনও পাড়া, বরো বা জেলা হতে পারে।

addressLines[]

string

ঠিকানার নিচের লেভেল বর্ণনা করে এমন অসংগঠিত ঠিকানার লাইন।

addressLines-এ থাকা ভ্যালুতে টাইপ সংক্রান্ত তথ্য থাকে না এবং কখনও কখনও একটি ফিল্ডে একাধিক ভ্যালু থাকতে পারে (যেমন, "Austin, TX"), তাই লাইনের ক্রম স্পষ্ট হওয়া গুরুত্বপূর্ণ। ঠিকানার দেশ বা অঞ্চলের জন্য ঠিকানার লাইনগুলি "খামের ক্রম" অনুযায়ী হতে হবে। যেসব জায়গায় এটি আলাদা হতে পারে (যেমন, জাপান), সেখানে address_language ব্যবহার করে এটি স্পষ্টভাবে উল্লেখ করা হয় (যেমন, বড় থেকে ছোট ক্রমে সাজানোর জন্য "ja" এবং ছোট থেকে বড় ক্রমে সাজানোর জন্য "ja-Latn" বা "en")। এইভাবে, ভাষার উপর ভিত্তি করে কোনও ঠিকানার সবচেয়ে নির্দিষ্ট লাইন বেছে নেওয়া যেতে পারে।

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

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

recipients[]

string

ঐচ্ছিক। ঠিকানায় থাকা প্রাপকের নাম। কিছু পরিস্থিতিতে, এই ফিল্ডে একাধিক লাইনের তথ্য থাকতে পারে। যেমন, এতে "কেয়ার অফ" সংক্রান্ত তথ্য থাকতে পারে।

organization

string

ঐচ্ছিক। ঠিকানায় উল্লেখ করা সংস্থার নাম।