PostalAddress

यह किसी डाक पते को दिखाता है. जैसे, डाक डिलीवरी या पेमेंट के पते के लिए. डाक पते को ध्यान में रखते हुए, डाक सेवा, पीओ बॉक्स या ऐसी ही किसी जगह पर सामान डिलीवर कर सकती है. यह भौगोलिक स्थानों (सड़कों, शहरों, पहाड़ों) को मॉडल करने के लिए लक्षित नहीं है.

प्रोसेस के टाइप के आधार पर, सामान्य इस्तेमाल में पता उपयोगकर्ता के इनपुट या मौजूदा डेटा को इंपोर्ट करके बनाया जाएगा.

पता डालने / बदलाव करने के लिए सलाह: - https://github.com/google/libaddressinput जैसे अंतरराष्ट्रीय बनाने के लिए तैयार पते वाले विजेट का इस्तेमाल करें - उपयोगकर्ताओं को उन देशों के बाहर फ़ील्ड डालने या उनमें बदलाव करने के लिए यूज़र इंटरफ़ेस (यूआई) एलिमेंट नहीं दिए जाने चाहिए जहां उस फ़ील्ड का इस्तेमाल किया गया है.

इस स्कीमा को इस्तेमाल करने के बारे में ज़्यादा जानकारी के लिए, कृपया यह देखें: https://support.google.com/business/answer/6397478

जेएसओएन के काेड में दिखाना
{
  "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/regional_information.html पर जाएं. उदाहरण: स्विट्ज़रलैंड के लिए "CH".

languageCode

string

ज़रूरी नहीं. इस पते की सामग्री का BCP-47 भाषा कोड (अगर पता हो). आम तौर पर, यह इनपुट फ़ॉर्म की यूज़र इंटरफ़ेस (यूआई) भाषा होती है. आम तौर पर, यह पते के देश/इलाके या चुनी गई भाषाओं में से किसी एक भाषा से मेल खाती है. इससे कुछ देशों में फ़ॉर्मैटिंग पर असर पड़ सकता है. हालांकि, डेटा के सही होने के लिए यह अहम नहीं है. इससे, पुष्टि करने या फ़ॉर्मैट न करने से जुड़ी दूसरी कार्रवाइयों पर कभी असर नहीं पड़ेगा.

अगर यह जानकारी नहीं है, तो इसे हटा देना चाहिए. हो सकता है कि यह डिफ़ॉल्ट तौर पर गलत हो.

जैसे: "zh-Hant", "ja", "ja-Latn", "en".

postalCode

string

ज़रूरी नहीं. पते का पिन कोड. सभी देशों में पिन कोड का इस्तेमाल नहीं किया जाता या उनका मौजूद होना ज़रूरी नहीं होता. हालांकि, वे जहां पते का इस्तेमाल करते हैं वहां पते के दूसरे हिस्सों के साथ अन्य पुष्टि भी ट्रिगर कर सकते हैं (उदाहरण के लिए, संयुक्त राज्य अमेरिका में राज्य/ज़िप पुष्टि).

sortingCode

string

ज़रूरी नहीं. अन्य, देश के हिसाब से, क्रम से लगाने का कोड. ज़्यादातर इलाकों में इसका इस्तेमाल नहीं किया जाता. जहां इसका इस्तेमाल किया जाता है वहां वैल्यू या तो "CEDEX" जैसी स्ट्रिंग होती है और उसके बाद कोई संख्या (जैसे "CEDEX 7") होती है या सिर्फ़ एक संख्या होती है, जो "सेक्टर कोड" (जमैका), "डिलीवरी एरिया इंडिकेटर" (मलावी) या "पोस्ट ऑफ़िस इंडिकेटर" (जैसे, कोट डी आइवर) को दिखाती है.

administrativeArea

string

ज़रूरी नहीं. देश या डाक के पते के लिए इस्तेमाल किया जाने वाला सबसे बड़ा एडमिन ग्रुप. उदाहरण के लिए, यह किसी राज्य, प्रांत, ओब्लास्ट या प्रांत का हो सकता है. खास तौर पर, स्पेन के लिए यह प्रांत है, न कि स्वायत्त प्रांत. जैसे, "बार्सलोना", न कि "कैटालोनिया". कई देश डाक पतों में राज्य का इस्तेमाल नहीं करते हैं. उदा. स्विट्ज़रलैंड में इसे खाली नहीं छोड़ा जाना चाहिए.

locality

string

ज़रूरी नहीं. आम तौर पर, पते में शहर/कस्बा का हिस्सा दिखाया जाता है. उदाहरण: अमेरिका का शहर, आईटी कम्यून, यूके का पोस्ट टाउन. दुनिया के उन इलाकों के लिए जहां इलाके अच्छी तरह से तय नहीं किए गए हैं या वहां इस इलाके में फ़िट नहीं बैठते. इलाके को खाली छोड़ें और पते की लाइनों का इस्तेमाल करें.

sublocality

string

ज़रूरी नहीं. पते का उप-क्षेत्र. उदाहरण के लिए, यह आस-पड़ोस, नगर, ज़िले हो सकता है.

addressLines[]

string

किसी पते के निचले लेवल की जानकारी देने वाली अव्यवस्थित पता पंक्तियां.

पते की पंक्तियों में दी गई वैल्यू में टाइप की जानकारी शामिल नहीं होती है. कभी-कभी एक फ़ील्ड में एक से ज़्यादा वैल्यू हो सकती हैं (जैसे, "ऑस्टिन, TX"), इसलिए यह ज़रूरी है कि लाइन का ऑर्डर साफ़ हो. पते के लिए जिस देश या इलाके का नाम डाला जाना है उसके लिए पते की लाइनों का ऑर्डर "एन्वेलप ऑर्डर" होना चाहिए. जिन जगहों पर यह अलग-अलग हो सकती है (उदाहरण के लिए, Japan) वहां ad_language का इस्तेमाल करके, लोगों को साफ़ तौर पर बताया जाता है. उदाहरण के लिए, छोटी-बड़ी सूचियों के लिए "ja" और छोटे-बड़े से "ja-Latn" या "en". इस तरह, भाषा के आधार पर, पते की सबसे खास लाइन चुनी जा सकती है.

किसी पते को स्ट्रक्चर किए जाने के लिए, कम से कम एक क्षेत्र का एक कोड की ज़रूरत होती है, जिसमें बाकी सभी जानकारी AddressLines में मौजूद हो. पते को कोड में बदलने के तरीके के बिना, इस पते को करीब-करीब फ़ॉर्मैट करना मुमकिन है, लेकिन पते के किसी भी कॉम्पोनेंट के बारे में तब तक कोई मतलब नहीं निकाला जा सकता, जब तक कि उसका कुछ हद तक हल न हो जाए.

कोई ऐसा पता बनाना जिसमें किसी क्षेत्र कोड और AddressLines का इस्तेमाल किया जाता है. इसके बाद, पूरी तरह से व्यवस्थित न किए गए पतों को हैंडल करने का सुझाव दिया जाता है. पते के किन हिस्सों में इलाके या प्रशासनिक इलाके होने चाहिए, यह अनुमान नहीं लगाया जा सकता.

recipients[]

string

ज़रूरी नहीं. ईमेल पाने वाला व्यक्ति. कुछ खास परिस्थितियों में, इस फ़ील्ड में एक से ज़्यादा लाइन की जानकारी हो सकती है. उदाहरण के लिए, इसमें "केयर ऑफ़" जानकारी हो सकती है.

organization

string

ज़रूरी नहीं. पते पर मौजूद संगठन का नाम.