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 इसका इस्तेमाल नहीं करता. फ़िलहाल, एपीआई इस फ़ील्ड को सेट करके किए गए अनुरोधों को अस्वीकार नहीं करेगा. हालांकि, इस जानकारी को खारिज कर दिया जाएगा और रिस्पॉन्स में नहीं दिखाया जाएगा.