Method: validateAddress

किसी पते की पुष्टि करता है.

एचटीटीपी अनुरोध

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

यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य भाग में, नीचे दिए गए स्ट्रक्चर वाला डेटा होता है:

JSON के काेड में दिखाना 
{
  "address": {
    object (PostalAddress)
  },
  "previousResponseId": string,
  "enableUspsCass": boolean,
  "languageOptions": {
    object (LanguageOptions)
  },
  "sessionToken": string
}
फ़ील्ड
address

object (PostalAddress)

ज़रूरी है. पते की पुष्टि की जा रही है. बिना फ़ॉर्मैट वाले पते addressLines का इस्तेमाल करके सबमिट किए जाने चाहिए.

इस इनपुट में मौजूद फ़ील्ड की कुल लंबाई 280 वर्णों से ज़्यादा नहीं होनी चाहिए.

जिन देशों/इलाकों में यह सुविधा उपलब्ध है उनकी जानकारी यहां देखें.

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

Address Validation API, recipients और organization में दी गई वैल्यू को अनदेखा कर देता है. उन फ़ील्ड में मौजूद किसी भी वैल्यू को खारिज कर दिया जाएगा और उसे नहीं दिखाया जाएगा. कृपया उन्हें सेट न करें.
previousResponseId

string

पते की पुष्टि के लिए किए गए पहले अनुरोध में, यह फ़ील्ड खाली होना चाहिए. अगर किसी एक पते की पूरी तरह से पुष्टि करने के लिए ज़्यादा अनुरोध ज़रूरी हैं, तो हर फ़ॉलोअप अनुरोध में, पुष्टि के क्रम में मिले पहले जवाब से responseId को इस फ़ील्ड में भरना होगा. उदाहरण के लिए, अगर शुरुआती पुष्टि के बाद उपयोगकर्ता ने जो बदलाव किए हैं उनकी फिर से पुष्टि करनी है.
enableUspsCass

boolean

USPS CASS के साथ काम करने वाला मोड चालू करता है. इससे google.maps.addressvalidation.v1.ValidationResult के google.maps.addressvalidation.v1.ValidationResult.usps_data फ़ील्ड पर सिर्फ़ असर पड़ता है. ध्यान दें: प्योर्तो रिको के पतों के लिए, 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)

ज़रूरी नहीं. झलक: यह सुविधा, झलक (Pre-GA) के तौर पर उपलब्ध है. ऐसा हो सकता है कि Pre-GA प्रॉडक्ट और सुविधाएं सीमित तौर पर काम करें. साथ ही, Pre-GA प्रॉडक्ट और सुविधाओं में किए गए बदलाव, Pre-GA वाले अन्य वर्शन के साथ काम न करें. Pre-GA के तहत आने वाले प्रॉडक्ट और सुविधाओं पर, Google Maps Platform की सेवा की खास शर्तें लागू होती हैं. ज़्यादा जानकारी के लिए, लॉन्च के चरणों की जानकारी देखें.

इससे, Address Validation API को जवाब में ज़्यादा जानकारी शामिल करने में मदद मिलती है.
sessionToken

string

ज़रूरी नहीं. बिलिंग के लिए, ऑटोकंप्लीट सेशन की पहचान करने वाली स्ट्रिंग. यूआरएल और फ़ाइल नाम की सुरक्षित base64 स्ट्रिंग होनी चाहिए, जिसमें ज़्यादा से ज़्यादा 36 ASCII वर्ण हों. ऐसा न करने पर, INVALID_ARGUMENT गड़बड़ी का मैसेज दिखता है.

जब उपयोगकर्ता ऑटोमैटिक भरने की सुविधा के लिए कोई क्वेरी डालता है, तब सेशन शुरू होता है. यह तब खत्म होता है, जब वह कोई जगह चुनता है और जगह की जानकारी या पते की पुष्टि करने के लिए कॉल करता है. हर सेशन में, अपने-आप पूरी होने वाली कई क्वेरी हो सकती हैं. इसके बाद, जगह की जानकारी या पते की पुष्टि करने का एक अनुरोध किया जा सकता है. किसी सेशन में हर अनुरोध के लिए इस्तेमाल किए गए क्रेडेंशियल, एक ही Google Cloud Console प्रोजेक्ट से होने चाहिए. सेशन खत्म होने के बाद, टोकन अमान्य हो जाता है. इसलिए, आपके ऐप्लिकेशन को हर सेशन के लिए नया टोकन जनरेट करना होगा. अगर sessionToken पैरामीटर को शामिल नहीं किया जाता है या किसी सेशन टोकन का फिर से इस्तेमाल किया जाता है, तो सेशन के लिए उसी तरह शुल्क लिया जाता है जैसे कोई सेशन टोकन न दिया गया हो. हर अनुरोध के लिए अलग से बिलिंग की जाती है.

ध्यान दें: पते की पुष्टि करने की सुविधा का इस्तेमाल, ऑटोकंप्लीट (नया) एपीआई वाले सेशन में ही किया जा सकता है, ऑटोकंप्लीट एपीआई का नहीं. ज़्यादा जानकारी के लिए, https://developers.google.com/maps/documentation/places/web-service/session-pricing पर जाएं.

जवाब का मुख्य भाग

पते की पुष्टि करने के अनुरोध का जवाब.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

JSON के काेड में दिखाना 
{
  "result": {
    object (ValidationResult)
  },
  "responseId": string
}
फ़ील्ड
result

object (ValidationResult)

पते की पुष्टि का नतीजा.
responseId

string

वह यूनीक आईडी जो इस रिस्पॉन्स की पहचान करता है. अगर पते की फिर से पुष्टि करनी है, तो नए अनुरोध में यह यूयूआईडी होना चाहिए.

PostalAddress

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

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

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

इस स्कीमा का इस्तेमाल करने के बारे में ज़्यादा जानकारी के लिए, कृपया यहां जाएं: 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 के अलावा किसी भी वैल्यू को डालने पर, एपीआई INVALID_ARGUMENT गड़बड़ी दिखाएगा.
regionCode

string

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

string

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

string

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

string

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

string

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

string

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

string

ज़रूरी नहीं. पते की उप-इलाका. उदाहरण के लिए, इसमें आस-पड़ोस, नगर, ज़िला हो सकते हैं.
addressLines[]

string

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

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

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

सिर्फ़ addressLines वाले पते बनाने के बाद, बिना स्ट्रक्चर वाले पतों को मैनेज करने के लिए जियोकोडिंग का इस्तेमाल करने का सुझाव दिया जाता है. यह अनुमान लगाने के बजाय कि पते के कौनसे हिस्से, इलाके या प्रशासनिक इलाके होने चाहिए.
recipients[]

string

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

string

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

LanguageOptions

झलक: यह सुविधा, झलक (Pre-GA) के तौर पर उपलब्ध है. ऐसा हो सकता है कि Pre-GA के तहत आने वाले प्रॉडक्ट और सुविधाओं के लिए, आपको सीमित सहायता ही मिले. साथ ही, Pre-GA के तहत आने वाले प्रॉडक्ट और सुविधाओं में किए गए बदलाव, Pre-GA के अन्य वर्शन के साथ काम न करें. Pre-GA ऑफ़र पर Google Maps Platform की सेवा की खास शर्तें लागू होती हैं. ज़्यादा जानकारी के लिए, लॉन्च के चरणों की जानकारी देखें.

जवाब में ज़्यादा जानकारी शामिल करने के लिए, पते की पुष्टि करने वाले एपीआई को चालू करता है.

JSON के काेड में दिखाना 
{
  "returnEnglishLatinAddress": boolean
}
फ़ील्ड
returnEnglishLatinAddress

boolean

झलक: अंग्रेज़ी में google.maps.addressvalidation.v1.Address दिखाएं. ज़्यादा जानकारी के लिए, google.maps.addressvalidation.v1.ValidationResult.english_latin_address पर जाएं.

ValidationResult

किसी पते की पुष्टि करने का नतीजा.

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)

डिलीवरी के लिए ज़रूरी अन्य जानकारी. इस बात की कोई गारंटी नहीं है कि पते की पुष्टि करने वाले एपीआई को भेजे गए हर पते के लिए, metadata पूरी तरह से पॉप्युलेट हो.
uspsData

object (UspsData)

USPS की ओर से डिलीवरी से जुड़े अतिरिक्त फ़्लैग. यह सुविधा सिर्फ़ US और PR इलाके में उपलब्ध है.
englishLatinAddress

object (Address)

झलक: यह सुविधा, झलक (Pre-GA) के तौर पर उपलब्ध है. ऐसा हो सकता है कि Pre-GA के तहत आने वाले प्रॉडक्ट और सुविधाओं के लिए, आपको सीमित सहायता ही मिले. साथ ही, Pre-GA के तहत आने वाले प्रॉडक्ट और सुविधाओं में किए गए बदलाव, Pre-GA के अन्य वर्शन के साथ काम न करें. Pre-GA ऑफ़र पर Google Maps Platform की सेवा की खास शर्तें लागू होती हैं. ज़्यादा जानकारी के लिए, लॉन्च के चरणों की जानकारी देखें.

अंग्रेज़ी में अनुवाद किया गया पता.

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

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

google.maps.addressvalidation.v1.LanguageOptions.return_english_latin_address फ़्लैग का इस्तेमाल करके, इस आउटपुट को चालू करें.

ध्यान दें: englishLatinAddress में मौजूद google.maps.addressvalidation.v1.Address.unconfirmed_component_types फ़ील्ड और englishLatinAddress.address_components में मौजूद google.maps.addressvalidation.v1.AddressComponent.confirmation_level फ़ील्ड में कोई वैल्यू नहीं है.

नतीजा

पते की पुष्टि के नतीजे और जियोकोड के बारे में खास जानकारी.

JSON के काेड में दिखाना 
{
  "inputGranularity": enum (Granularity),
  "validationGranularity": enum (Granularity),
  "geocodeGranularity": enum (Granularity),
  "addressComplete": boolean,
  "hasUnconfirmedComponents": boolean,
  "hasInferredComponents": boolean,
  "hasReplacedComponents": 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 देखें.

जानकारी का स्तर

पते या जियोकोड में अलग-अलग तरह की जानकारी हो सकती है. पते के बारे में ज़्यादा जानकारी देने के लिए इस्तेमाल किए जाने पर, ये वैल्यू बताती हैं कि पता, मेलिंग डेस्टिनेशन की कितनी बारीक जानकारी देता है. उदाहरण के लिए, "123 Main Street, Redwood City, CA, 94061" जैसे पते से PREMISE की पहचान होती है, जबकि "Redwood City, CA, 94061" जैसे पते से LOCALITY की पहचान होती है. हालांकि, अगर हमें Redwood City में "123 Main Street" का जियोकोड नहीं मिलता है, तो हो सकता है कि दिया गया जियोकोड LOCALITY लेवल का हो. भले ही, पता ज़्यादा जानकारी वाला हो.

Enums
GRANULARITY_UNSPECIFIED डिफ़ॉल्ट मान. इस वैल्यू का इस्तेमाल नहीं किया जाता.
SUB_PREMISE बिल्डिंग के लेवल से नीचे का नतीजा, जैसे कि अपार्टमेंट.
PREMISE बिल्डिंग-लेवल का नतीजा.
PREMISE_PROXIMITY ऐसा जियोकोड जो पते की बिल्डिंग-लेवल की जगह की अनुमानित जानकारी देता है.
BLOCK पता या जियोकोड से किसी ब्लॉक का पता चलता है. इसका इस्तेमाल सिर्फ़ उन इलाकों में किया जाता है जहां ब्लॉक-लेवल पर पते दिए जाते हैं. जैसे, जापान.
ROUTE जियोकोड या पता, सड़क, रास्ता या हाइवे जैसे रास्ते के बारे में ज़्यादा जानकारी देता है.
OTHER ज़्यादा जानकारी वाली अन्य सभी वैल्यू, जिन्हें एक साथ बकेट में रखा जाता है, क्योंकि उन्हें डिलीवर नहीं किया जा सकता.

पता

प्रोसेस किए गए पते की जानकारी. पोस्ट-प्रोसेसिंग में, पते के उन हिस्सों को ठीक करना शामिल है जिनमें स्पेलिंग की गड़बड़ी है. साथ ही, गलत हिस्सों को बदलना और छूटे हुए हिस्सों का अनुमान लगाना भी शामिल है.

JSON के काेड में दिखाना 
{
  "formattedAddress": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "addressComponents": [
    {
      object (AddressComponent)
    }
  ],
  "missingComponentTypes": [
    string
  ],
  "unconfirmedComponentTypes": [
    string
  ],
  "unresolvedTokens": [
    string
  ]
}
फ़ील्ड
formattedAddress

string

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

ध्यान दें: हो सकता है कि इस पते का फ़ॉर्मैट, postalAddress फ़ील्ड में मौजूद पते के फ़ॉर्मैट से मेल न खाए. उदाहरण के लिए, postalAddress हमेशा देश को दो अक्षरों regionCode से दिखाता है, जैसे कि "US" या "NZ". इसके उलट, इस फ़ील्ड में देश के नाम का लंबा फ़ॉर्म इस्तेमाल किया जाता है, जैसे कि "अमेरिका" या "न्यूज़ीलैंड".
postalAddress

object (PostalAddress)

प्रोसेस किए गए पते को डाक पते के तौर पर दिखाया जाता है.
addressComponents[]

object (AddressComponent)

बिना क्रम वाली सूची. फ़ॉर्मैट किए गए और सही किए गए पते के अलग-अलग कॉम्पोनेंट और पुष्टि की जानकारी. इससे, अलग-अलग कॉम्पोनेंट की पुष्टि की स्थिति की जानकारी मिलती है.

पते के कॉम्पोनेंट किसी खास क्रम में नहीं होते. सूची में पते के कॉम्पोनेंट के क्रम के बारे में कोई अनुमान न लगाएं.
missingComponentTypes[]

string

ऐसे कॉम्पोनेंट जिनकी उम्मीद थी कि वे सही फ़ॉर्मैट में मेलिंग पते में मौजूद होंगे, लेकिन वे इनपुट में नहीं मिले और न ही उनका अनुमान लगाया जा सका. इस तरह के कॉम्पोनेंट formattedAddress, postalAddress या addressComponents में मौजूद नहीं होते हैं. उदाहरण के लिए, "Boulder, Colorado, 80301, USA" जैसे इनपुट के लिए ['street_number', 'route']. अलग-अलग टाइप की सूची यहां देखी जा सकती है.
unconfirmedComponentTypes[]

string

ऐसे कॉम्पोनेंट टाइप जो addressComponents में मौजूद हैं, लेकिन उनके सही होने की पुष्टि नहीं की जा सकी. यह फ़ील्ड आपकी सुविधा के लिए उपलब्ध कराया गया है: इसका कॉन्टेंट, addressComponents में मौजूद सभी कॉम्पोनेंट के टाइप ढूंढने के लिए, confirmationLevel को CONFIRMED पर सेट करने या inferred फ़्लैग को true पर सेट करने के बराबर है. अलग-अलग टाइप की सूची यहां देखी जा सकती है.
unresolvedTokens[]

string

इनपुट में ऐसे टोकन जो हल नहीं किए जा सके. यह कोई ऐसा इनपुट हो सकता है जिसकी पहचान पते के मान्य हिस्से के तौर पर नहीं की गई थी. उदाहरण के लिए, "Parcel 0000123123 & 0000456456 Str # Guthrie Center IA 50115 US" जैसे इनपुट के लिए, हल नहीं किए गए टोकन ["Parcel", "0000123123", "&", "0000456456"] जैसे दिख सकते हैं.

AddressComponent

यह पते के किसी कॉम्पोनेंट को दिखाता है, जैसे कि सड़क, शहर या राज्य.

JSON के काेड में दिखाना 
{
  "componentName": {
    object (ComponentName)
  },
  "componentType": string,
  "confirmationLevel": enum (ConfirmationLevel),
  "inferred": boolean,
  "spellCorrected": boolean,
  "replaced": boolean,
  "unexpected": boolean
}
फ़ील्ड
componentName

object (ComponentName)

इस कॉम्पोनेंट का नाम.
componentType

string

पते के कॉम्पोनेंट का टाइप. संभावित टाइप की सूची के लिए, दूसरी टेबल: Places सेवा से मिले अन्य टाइप देखें.
confirmationLevel

enum (ConfirmationLevel)

इससे पता चलता है कि कॉम्पोनेंट सही है या नहीं.
inferred

boolean

इससे पता चलता है कि यह कॉम्पोनेंट इनपुट का हिस्सा नहीं था, लेकिन हमने इसे पते की जगह के लिए अनुमान लगाया है. साथ ही, हमारा मानना है कि इसे पूरे पते के लिए दिया जाना चाहिए.
spellCorrected

boolean

इससे कॉम्पोनेंट के नाम में गलत स्पेलिंग को ठीक किया जाता है. एपीआई हमेशा, स्पेलिंग के एक वैरिएंट से दूसरे वैरिएंट में किए गए बदलावों को फ़्लैग नहीं करता. जैसे, "centre" को "center" में बदलने पर. यह हमेशा वर्तनी की सामान्य गलतियां भी फ़्लैग नहीं करता. जैसे, "Amphitheater Pkwy" को "Amphitheatre Pkwy" में बदलने पर.
replaced

boolean

इससे पता चलता है कि कॉम्पोनेंट का नाम पूरी तरह से किसी दूसरे पिन कोड से बदला गया है. उदाहरण के लिए, पते के लिए सही पिन कोड को गलत पिन कोड से बदला गया है. यह कोई कॉस्मेटिक बदलाव नहीं है, इनपुट कॉम्पोनेंट को किसी दूसरे कॉम्पोनेंट में बदल दिया गया है.
unexpected

boolean

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

ComponentName

कॉम्पोनेंट के नाम के लिए एक रैपर.

JSON के काेड में दिखाना 
{
  "text": string,
  "languageCode": string
}
फ़ील्ड
text

string

नाम का टेक्स्ट. उदाहरण के लिए, सड़क के नाम के लिए "5th Avenue" या सड़क के नंबर के लिए "1253".
languageCode

string

BCP-47 भाषा कोड. अगर कॉम्पोनेंट का नाम किसी भाषा से जुड़ा नहीं है, तो यह एट्रिब्यूट मौजूद नहीं होगा. जैसे, सड़क का नंबर.

ConfirmationLevel

पुष्टि के लेवल के लिए अलग-अलग वैल्यू.

Enums
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

उस जगह का प्लेसआईडी जहां यह इनपुट जियोकोड करता है.

जगह की जानकारी वाले आईडी के बारे में ज़्यादा जानने के लिए, यहां जाएं.
placeTypes[]

string

जगह का वह(के) टाइप, जहां इनपुट जियोकोड किया गया. उदाहरण के लिए, ['locality', 'political']. अलग-अलग टाइप की पूरी सूची यहां देखी जा सकती है.

LatLng

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

JSON के काेड में दिखाना 
{
  "latitude": number,
  "longitude": number
}
फ़ील्ड
latitude

number

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

number

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

PlusCode

प्लस कोड (http://plus.codes), जगह की जानकारी देने वाला एक रेफ़रंस है. इसका इस्तेमाल दो फ़ॉर्मैट में किया जाता है: ग्लोबल कोड, जो 14 मीटर x 14 मीटर (डिग्री का 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, दोनों में जानकारी भरी जानी चाहिए. साथ ही, दिखाया गया बॉक्स खाली नहीं होना चाहिए (जैसा कि ऊपर दी गई परिभाषाओं में बताया गया है). खाली व्यूपोर्ट से गड़बड़ी होगी.

उदाहरण के लिए, यह व्यूपोर्ट पूरी तरह से न्यूयॉर्क सिटी को कवर करता है:

{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }

JSON के काेड में दिखाना 
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
फ़ील्ड
low

object (LatLng)

ज़रूरी है. व्यूपोर्ट का निचला पॉइंट.
high

object (LatLng)

ज़रूरी है. व्यूपोर्ट का सबसे ऊपरी पॉइंट.

AddressMetadata

पते का मेटाडेटा. इस बात की कोई गारंटी नहीं है कि पते की पुष्टि करने वाले एपीआई पर भेजे गए हर पते के लिए, metadata में जानकारी अपने-आप भर जाएगी.

JSON के काेड में दिखाना 
{
  "business": boolean,
  "poBox": boolean,
  "residential": boolean
}
फ़ील्ड
business

boolean

इससे पता चलता है कि यह किसी कारोबार का पता है. अगर यह सेट नहीं है, तो इसका मतलब है कि वैल्यू अज्ञात है.
poBox

boolean

इससे पता चलता है कि यह पीओ बॉक्स का पता है. अगर यह सेट नहीं है, तो इसका मतलब है कि वैल्यू अज्ञात है.
residential

boolean

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

UspsData

पते के लिए USPS का डेटा. यह गारंटी नहीं है कि पते की पुष्टि करने वाले एपीआई को भेजे गए हर अमेरिकी या प्योर्तो रिको पते के लिए, 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

डिलीवरी पॉइंट का दो अंकों वाला कोड
deliveryPointCheckDigit

string

डिलीवरी पॉइंट का चेक डिजिट. मशीन से स्कैन किए गए मेल के लिए, यह नंबर delivery_point_barcode के आखिर में जोड़ा जाता है. delivery_point_barcode, deliveryPointCheckDigit, पिन कोड, और ZIP+4 के सभी अंकों को जोड़ने पर, आपको 10 से भाग देने पर पूरी संख्या मिलनी चाहिए.
dpvConfirmation

string

DPV की पुष्टि के लिए संभावित वैल्यू. एक वर्ण दिखाता है या कोई वैल्यू नहीं दिखाता.

  • N: मुख्य नंबर और किसी भी सेकंडरी नंबर की जानकारी की पुष्टि DPV से नहीं की जा सकी.
  • D: सिर्फ़ प्राइमरी नंबर के लिए, पते की डीपीवी की पुष्टि की गई थी. साथ ही, सेकंडरी नंबर की जानकारी मौजूद नहीं थी.
  • S: सिर्फ़ प्राइमरी नंबर के लिए, पते की डीपीवी की पुष्टि की गई थी. सेकंडरी नंबर की जानकारी मौजूद थी, लेकिन उसकी पुष्टि नहीं की गई थी.
  • Y: प्राइमरी और सेकंडरी नंबर के लिए, पते की डीपीवी की पुष्टि की गई थी.
  • खाली: अगर जवाब में dpvConfirmation वैल्यू नहीं है, तो इसका मतलब है कि डीपीवी की पुष्टि के लिए पता सबमिट नहीं किया गया था.
dpvFootnote

string

डिलीवरी पॉइंट की पुष्टि से जुड़े फ़ुटनोट. एक ही स्ट्रिंग में कई फ़ुटनोट जोड़े जा सकते हैं.

  • AA: इनपुट पते का ZIP+4 फ़ाइल से मिलान किया गया है
  • A1: इनपुट पते का मिलान ZIP+4 फ़ाइल से नहीं हुआ है
  • BB: डीपीवी (सभी कॉम्पोनेंट) से मैच किया गया
  • CC: सेकंडरी नंबर मैच नहीं हुआ और यह ज़रूरी नहीं है
  • C1: सेकंडरी नंबर मेल नहीं खाता, लेकिन यह ज़रूरी है
  • N1: हाई-राईज़ बिल्डिंग के पते में सेकंडरी नंबर मौजूद नहीं है
  • M1: मुख्य फ़ोन नंबर मौजूद नहीं है
  • M3: मुख्य नंबर अमान्य है
  • P1: इनपुट पते का PO, RR या HC बॉक्स नंबर मौजूद नहीं है
  • P3: इनपुट पते का पीओ, आरआर या एचसी बॉक्स नंबर अमान्य है
  • F1: इनपुट पता, सेना के पते से मेल खाता है
  • G1: डाला गया पता, डिलीवरी के लिए दिए गए सामान्य पते से मेल खाता है
  • U1: दर्ज किए गए पते का मिलान अद्वितीय पिन कोड से हुआ है
  • PB: इनपुट पते का मिलान PBSA रिकॉर्ड से किया गया
  • RR: डीपीवी की पुष्टि वाला पता, जिसमें PMB की जानकारी शामिल हो
  • R1: डीपीवी की पुष्टि किए गए पते में पीएमबी की जानकारी मौजूद नहीं है
  • R7: मोबाइल और इंटरनेट सेवा देने वाली कंपनी का रूट R777 या R779 का रिकॉर्ड
  • IA: सूचित पते की पहचान की गई
  • TA: प्राइमरी नंबर, आखिर में मौजूद अक्षर हटाकर मैच किया गया
dpvCmra

string

यह बताता है कि पता, सीएमआरए (कमर्शियल मेल रिसीविंग एजेंसी) है या नहीं. यह ग्राहकों को डाक पाने वाला निजी कारोबार है. एक वर्ण दिखाता है.

  • Y: यह पता सीएमआरए है
  • N: यह पता सीएमआरए नहीं है
dpvVacant

string

क्या यह जगह खाली है? एक वर्ण दिखाता है.

  • Y: पता खाली है
  • N: पता खाली नहीं है
dpvNoStat

string

क्या यह कोई ऐसा पता है जिसका स्टेटस 'कोई जानकारी नहीं' है या यह कोई चालू पता है? ऐसे पते जिन पर लगातार कोई नहीं रहता या जिन पर यूएसपीएस सेवा नहीं देता उन्हें कोई स्टेटस नहीं दिया जाता. एक वर्ण दिखाता है.

  • Y: पता चालू नहीं है
  • N: पता चालू है
dpvNoStatReasonCode

integer

NoStat टाइप को दिखाता है. पूर्णांक के तौर पर वजह का कोड दिखाता है.

  • 1: आईडीए (इंटरनल ड्रॉप पता) – ऐसे पते जिन पर सीधे यूएसपीएस से मेल नहीं मिलता, बल्कि उन्हें किसी ऐसे ड्रॉप पते पर डिलीवर किया जाता है जो उनकी सेवा करता है.
  • 2: सीडीएस - ऐसे पते जिन्हें अभी तक डिलीवर नहीं किया जा सका है. उदाहरण के लिए, कोई नया सबडिविज़न जहां लॉट और प्राइमरी नंबर तय किए गए हैं, लेकिन अभी तक कोई स्ट्रक्चर मौजूद नहीं है.
  • 3: कॉलिशन - ऐसे पते जिनकी डीपीवी की पुष्टि नहीं होती.
  • 4: सीएमज़ (कॉलेज, मिलिट्री, और अन्य तरह के) - पिन कोड + चार अंकों के रिकॉर्ड, USPS ने डेटा में शामिल किए हैं.
  • 5: सामान्य - इससे पता चलता है कि जिन पतों पर डिलीवरी नहीं हो रही है और जिन पतों को डिलीवरी के लिए नहीं चुना गया है.
  • 6: सेकंडरी जानकारी देना ज़रूरी है - पते के लिए सेकंडरी जानकारी देना ज़रूरी है.
dpvDrop

string

फ़्लैग से पता चलता है कि मेल, किसी साइट पर मौजूद एक ही रिसीविंग पते पर डिलीवर किया गया है. एक वर्ण दिखाता है.

  • Y: मेल को किसी साइट पर मौजूद एक ही डिलीवरी बॉक्स में डिलीवर किया जाता है.
  • N: मेल को किसी साइट पर मौजूद एक ही पते पर डिलीवर नहीं किया जाता.
dpvThrowback

string

इससे पता चलता है कि मेल, सड़क के पते पर डिलीवर नहीं किया जाता. एक वर्ण दिखाता है.

  • Y: डाक को मोहल्ले के पते पर नहीं भेजा जाता है.
  • N: डाक को मोहल्ले के पते पर डिलीवर किया जाता है.
dpvNonDeliveryDays

string

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

  • Y: मेल की डिलीवरी, हफ़्ते के हर दिन नहीं की जाती.
  • N: इस बात का कोई संकेत नहीं है कि ईमेल की डिलीवरी, हफ़्ते के हर दिन नहीं की जाती.
dpvNonDeliveryDaysValues

integer

नॉन-डिलीवरी दिनों की पहचान करने वाला पूर्णांक. बिट फ़्लैग का इस्तेमाल करके, इसकी जानकारी देखी जा सकती है: 0x40 – रविवार को डिलीवरी नहीं की जाती 0x20 – सोमवार को डिलीवरी नहीं की जाती 0x10 – मंगलवार को डिलीवरी नहीं की जाती 0x08 – बुधवार को डिलीवरी नहीं की जाती 0x04 – गुरुवार को डिलीवरी नहीं की जाती 0x02 – शुक्रवार को डिलीवरी नहीं की जाती 0x01 – शनिवार को डिलीवरी नहीं की जाती
dpvNoSecureLocation

string

इस फ़्लैग से पता चलता है कि दरवाज़े को ऐक्सेस किया जा सकता है. हालांकि, सुरक्षा से जुड़ी समस्याओं की वजह से पैकेज नहीं छोड़ा जाएगा. एक वर्ण दिखाता है.

  • Y: सुरक्षा से जुड़ी समस्याओं की वजह से, पैकेज नहीं छोड़ा जाएगा.
  • N: सुरक्षा से जुड़ी समस्याओं की वजह से, पैकेज नहीं छोड़ा जाएगा.
dpvPbsa

string

इससे पता चलता है कि पता, पीबीएसए रिकॉर्ड से मेल खाता है. एक वर्ण दिखाता है.

  • Y: पते की जानकारी, पीबीएसए रिकॉर्ड से मेल खाती है.
  • N: आपका पता, पीबीएसए रिकॉर्ड से मेल नहीं खाता.
dpvDoorNotAccessible

string

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

  • Y: दरवाज़े को ऐक्सेस नहीं किया जा सकता.
  • N: दरवाज़े के ऐक्सेस नहीं होने का कोई संकेत नहीं है.
dpvEnhancedDeliveryCode

string

इससे पता चलता है कि पते के लिए एक से ज़्यादा डीपीवी रिटर्न कोड मान्य हैं. एक वर्ण लौटाता है.

  • Y: प्राइमरी और सेकंडरी नंबर के लिए, पते की डीपीवी की पुष्टि की गई थी.
  • N: प्राइमरी और सेकंडरी नंबर की जानकारी की डीपीवी की पुष्टि नहीं हो सकी.
  • S: सिर्फ़ प्राइमरी नंबर के लिए डीपीवी की पुष्टि की गई थी. सेकंडरी नंबर की जानकारी मौजूद थी, लेकिन उसकी पुष्टि नहीं की गई थी. इसके अलावा, डीपीवी मैच करने और सेकंडरी जानकारी की ज़रूरत पड़ने पर, प्राइमरी नंबर के आखिर में मौजूद एक अक्षर को हटा दिया गया था.
  • D: सिर्फ़ मुख्य नंबर के लिए पते के डीपीवी की पुष्टि हो गई थी और सेकंडरी नंबर की जानकारी मौजूद नहीं थी.
  • R: पते की पुष्टि हो गई है, लेकिन उसे फ़ैंटम रूट R777 और R779 को असाइन किया गया है. साथ ही, USPS डिलीवरी की सुविधा नहीं दी गई है.
carrierRoute

string

कैरियर का रास्ता कोड. चार वर्णों का कोड, जिसमें एक अक्षर का प्रीफ़िक्स और तीन अंकों वाला रास्ता तय करने वाला टूल शामिल होता है.

प्रीफ़िक्स:

  • C: कैरियर का रास्ता (या शहर का रास्ता)
  • R: ग्रामीण रास्ता
  • H: हाइवे अनुबंध मार्ग
  • B: डाकघर का पिन कोड सेक्शन
  • G: सामान्य डिलीवरी यूनिट
carrierRouteIndicator

string

कैरियर के रास्ते की दर को क्रम से लगाने का इंंडिकेटर.
ewsNoMatch

boolean

डिलीवरी का पता मैच हो सकता है, लेकिन ईडब्ल्यूएस फ़ाइल से पता चलता है कि जल्द ही एकदम मैच होने वाला पता उपलब्ध होगा.
postOfficeCity

string

मुख्य पोस्ट ऑफ़िस का शहर.
postOfficeState

string

मुख्य पोस्ट ऑफ़िस का राज्य.
abbreviatedCity

string

शहर का छोटा नाम.
fipsCountyCode

string

एफ़आईपीएस के हिसाब से, काउंटी का कोड.
county

string

काउंटी का नाम.
elotNumber

string

बेहतर यात्रा की लाइन (eLOT) नंबर.
elotFlag

string

eLOT के लिए, बढ़ते/घटते क्रम में लगाने के लिए फ़्लैग (A/D).
poBoxOnlyPostalCode

boolean

सिर्फ़ पीओ बॉक्स का पिन कोड.
pmbDesignator

string

पीएमबी (निजी मेल बॉक्स) यूनिट का डिज़ाइनर.
pmbNumber

string

पीएमबी (प्राइवेट मेल बॉक्स) नंबर;
addressRecordType

string

इनपुट पते से मेल खाने वाले पते के रिकॉर्ड का टाइप.

  • F: FIRM. यह फ़र्म रिकॉर्ड से मैच होता है. यह पते के लिए सबसे बेहतर मैच होता है.
  • G: सामान्य डिलीवरी. यह सामान्य डिलीवरी रिकॉर्ड से मेल खाता है.
  • H: बिल्डिंग / अपार्टमेंट. यह किसी इमारत या अपार्टमेंट के रिकॉर्ड से मैच करता है.
  • P: डाकघर का बॉक्स. यह पोस्ट ऑफ़िस बॉक्स से मिलता-जुलता है.
  • R: ग्रामीण सड़क या राजमार्ग का अनुबंध: यह ग्रामीण सड़क या राजमार्ग के अनुबंध के रिकॉर्ड से मेल खाता है. इन दोनों में बॉक्स नंबर की रेंज हो सकती है.
  • S: STREET RECORD: यह सड़क के उस रिकॉर्ड से मैच होता है जिसमें मान्य प्राइमरी नंबर की रेंज होती है.
defaultAddress

boolean

यह इंडिकेटर बताता है कि डिफ़ॉल्ट पता मिल गया है, लेकिन ज़्यादा सटीक पते मौजूद हैं.
errorMessage

string

USPS का डेटा पाने में हुई गड़बड़ी का मैसेज. जब USPS, आर्टिफ़िशियल तरीके से बनाए गए पतों का पता लगाता है, तो इस फ़ील्ड में जानकारी अपने-आप भर जाती है.

यह गड़बड़ी होने पर, हो सकता है कि USPS के डेटा फ़ील्ड अपने-आप न भरें.
cassProcessed

boolean

इस बात की जानकारी देने वाला इंडिकेटर कि अनुरोध सीएएसएस को प्रोसेस कर दिया गया है.

UspsAddress

अमेरिका के पते का यूएसपीएस वर्शन.

JSON के काेड में दिखाना 
{
  "firstAddressLine": string,
  "firm": string,
  "secondAddressLine": string,
  "urbanization": string,
  "cityStateZipAddressLine": string,
  "city": string,
  "state": string,
  "zipCode": string,
  "zipCodeExtension": string
}
फ़ील्ड
firstAddressLine

string

पहली पता पंक्ति.
firm

string

फ़र्म का नाम.
secondAddressLine

string

पते की दूसरी लाइन.
urbanization

string

प्योर्तो रिको के शहर का नाम.
cityStateZipAddressLine

string

शहर + राज्य + पिन कोड.
city

string

शहर का नाम.
state

string

दो अक्षर वाले राज्य का कोड.
zipCode

string

पिन कोड, जैसे कि 10009.
zipCodeExtension

string

पिन कोड का चार अंकों वाला एक्सटेंशन, जैसे कि 5023.