Package google.type

इंडेक्स

LatLng

अक्षांश/देशांतर के पेयर को दिखाने वाला ऑब्जेक्ट. अक्षांश और देशांतर की डिग्री दिखाने के लिए, इसे दो डबल वैल्यू के तौर पर दिखाया जाता है. अगर इस बारे में अलग से जानकारी नहीं दी गई है, तो यह ऑब्जेक्ट WGS84 स्टैंडर्ड के मुताबिक होना चाहिए. वैल्यू, सामान्य सीमा के अंदर होनी चाहिए.

फ़ील्ड
latitude

double

डिग्री में अक्षांश. यह वैल्यू [-90.0, +90.0] की रेंज में होनी चाहिए.
longitude

double

डिग्री में देशांतर. यह वैल्यू, [-180.0, +180.0] की रेंज में होनी चाहिए.

PostalAddress

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

सामान्य इस्तेमाल में, उपयोगकर्ता के इनपुट के ज़रिए या मौजूदा डेटा को इंपोर्ट करके पता बनाया जाएगा. यह इस बात पर निर्भर करता है कि प्रोसेस किस तरह की है.

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

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

फ़ील्ड
revision

int32

PostalAddress के स्कीमा में किया गया बदलाव. 0 को छोड़कर कोई भी दूसरी वैल्यू होने पर, एपीआई INVALID_ARGUMENT गड़बड़ी दिखाएगा.
region_code

string

ज़रूरी नहीं. पते के देश/इलाके का CLDR कोड. ज़्यादा जानकारी के लिए, https://cldr.unicode.org/ और https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html देखें. उदाहरण: स्विट्ज़रलैंड के लिए "CH". अगर क्षेत्र का कोड नहीं दिया गया है, तो इसे पते से अनुमान लगाया जाएगा. बेहतर परफ़ॉर्मेंस के लिए, हमारा सुझाव है कि अगर आपको क्षेत्र का कोड पता है, तो उसे शामिल करें. अलग-अलग या दोहराए गए क्षेत्रों की वजह से परफ़ॉर्मेंस खराब हो सकती है. उदाहरण के लिए, अगर address_lines में पहले से ही क्षेत्र शामिल है, तो इस फ़ील्ड में क्षेत्र कोड दोबारा न डालें. इस सुविधा के साथ काम करने वाले देशों और इलाकों की जानकारी, अक्सर पूछे जाने वाले सवाल में दी गई है.
language_code

string

इनपुट पते में मौजूद भाषा कोड को आने वाले समय में इस्तेमाल करने के लिए रिज़र्व किया गया है. फ़िलहाल, इसका इस्तेमाल नहीं किया जा रहा है. एपीआई, पते की जगह के हिसाब से सही भाषा में पता दिखाता है.
postal_code

string

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

string

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

string

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

string

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

string

ज़रूरी नहीं. पते की उप-इलाका. उदाहरण के लिए, यह इलाके, बोरो, जिले हो सकते हैं.
address_lines[]

string

ज़रूरी है. पते की निचली लाइनों की जानकारी देने वाली, बिना स्ट्रक्चर वाली लाइनें.

address_lines में मौजूद वैल्यू में टाइप की जानकारी नहीं होती है. साथ ही, कभी-कभी एक फ़ील्ड में कई वैल्यू हो सकती हैं, जैसे कि "ऑस्टिन, टेक्सास". इसलिए, यह ज़रूरी है कि लाइन का क्रम साफ़ तौर पर दिखे. पते के देश/इलाके के हिसाब से, पते की लाइन का क्रम "एनवलप का क्रम" होना चाहिए.

किसी पते के स्ट्रक्चर्ड डेटा में कम से कम उतनी ही जानकारी होनी चाहिए जितनी address_lines में दी गई है. अगर region_code नहीं दिया गया है, तो इलाके का पता, पते की लाइनों से लगाया जाता है.

पूरी तरह से अनियमित पतों को मैनेज करने के लिए, हमारा सुझाव है कि आप सिर्फ़ address_lines वाला पता बनाएं और फिर उसे जियोकोड करें. ऐसा करने से, यह अनुमान लगाने की ज़रूरत नहीं पड़ती कि पते के किन हिस्सों में इलाके या प्रशासनिक क्षेत्र होने चाहिए.
recipients[]

string

कृपया इस फ़ील्ड को सेट करने से बचें. फ़िलहाल, Address Validation API इसका इस्तेमाल नहीं करता. फ़िलहाल, एपीआई इस फ़ील्ड को सेट करके किए गए अनुरोधों को अस्वीकार नहीं करेगा. हालांकि, इस जानकारी को खारिज कर दिया जाएगा और इसे रिस्पॉन्स में नहीं दिखाया जाएगा.
organization

string

कृपया इस फ़ील्ड को सेट करने से बचें. फ़िलहाल, Address Validation API इसका इस्तेमाल नहीं करता. हालांकि, अभी एपीआई इस फ़ील्ड सेट वाले अनुरोधों को अस्वीकार नहीं करेगा, लेकिन जानकारी को खारिज कर दिया जाएगा और जवाब में यह जानकारी नहीं दिखाई जाएगी.