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

ज़रूरी नहीं. आम तौर पर, इसका मतलब पते के शहर या कस्बे से होता है. उदाहरण: अमेरिका का शहर, इटली का कम्यून, यूनाइटेड किंगडम का पोस्ट टाउन. दुनिया के उन इलाकों में जहां स्थानीय जगहों की जानकारी ठीक से नहीं दी गई है या वे इस स्ट्रक्चर में सही से फ़िट नहीं होती हैं, वहां locality को खाली छोड़ें और 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 की सेवा की खास शर्तें लागू होती हैं. ज़्यादा जानकारी के लिए, लॉन्च के चरणों की जानकारी देखें.

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

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,
  "possibleNextAction": enum (PossibleNextAction),
  "hasSpellCorrectedComponents": 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 देखें.
possibleNextAction

enum (PossibleNextAction)

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

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

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 अन्य सभी जानकारी, जिन्हें एक साथ बकेट में रखा जाता है, क्योंकि उन्हें डिलीवर नहीं किया जा सकता.

PossibleNextAction

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

एपीआई के रिस्पॉन्स के आधार पर, आगे की संभावित कार्रवाइयां.

Enums
POSSIBLE_NEXT_ACTION_UNSPECIFIED डिफ़ॉल्ट मान. इस वैल्यू का इस्तेमाल नहीं किया जाता.
FIX एपीआई रिस्पॉन्स के एक या उससे ज़्यादा फ़ील्ड से पता चलता है कि प्रोसेस किए गए पते में कोई समस्या है. उदाहरण के लिए, verdict.validation_granularity OTHER है. अपने ग्राहक से पते में बदलाव करने के लिए कहने से, पते की क्वालिटी को बेहतर बनाने में मदद मिल सकती है.
CONFIRM_ADD_SUBPREMISES एपीआई के जवाब से पता चलता है कि प्रोसेस किए गए पते में सब-प्राइमिस मौजूद नहीं है. अपने ग्राहक से पते की समीक्षा करने और यूनिट नंबर जोड़ने के लिए कहने से, पते की क्वालिटी को बेहतर बनाने में मदद मिल सकती है. प्रोसेस किए गए पते में, दूसरी छोटी समस्याएं भी हो सकती हैं. ध्यान दें: यह वैल्यू सिर्फ़ अमेरिका के पतों के लिए दिख सकती है.
CONFIRM एपीआई रिस्पॉन्स के एक या उससे ज़्यादा फ़ील्ड से पता चलता है कि प्रोसेस किए गए पते में कुछ छोटी समस्याएं हो सकती हैं. उदाहरण के लिए, postalCode पते का कॉम्पोनेंट replaced था. अपने ग्राहक से पते की समीक्षा करने के लिए कहने से, पते की क्वालिटी को बेहतर बनाने में मदद मिल सकती है.
ACCEPT एपीआई रिस्पॉन्स में ऐसे सिग्नल शामिल नहीं हैं जिनसे यह पता चलता हो कि PossibleNextAction की किसी अन्य वैल्यू का इस्तेमाल किया जाना चाहिए. आपके पास अपने ग्राहक से फिर से पूछे बिना, पते को प्रोसेस करने के बाद दिए गए पते का इस्तेमाल करने का विकल्प है. हालांकि, इससे यह गारंटी नहीं मिलती कि पता मान्य है और उसमें अब भी सुधार किए जा सकते हैं. यह आपकी ज़िम्मेदारी है कि आप जोखिम का आकलन करके यह तय करें कि ग्राहक को सूचना देनी है या नहीं. साथ ही, अगर देनी है, तो कैसे देनी है.

पता

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

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

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

ध्यान दें: अगर आपको लगता है कि आपने पहले ही वह कॉम्पोनेंट उपलब्ध कराया है जो मौजूद नहीं है, तो आपको कॉम्पोनेंट टाइप मौजूद नहीं है वाला मैसेज दिख सकता है. उदाहरण के लिए, ऐसा तब हो सकता है, जब डाले गए पते में इमारत का नाम हो, लेकिन प्रॉपर्टी नंबर न हो. "渋谷区渋谷３丁目　Shibuya Stream" पते में, बिल्डिंग के नाम "Shibuya Stream" का कॉम्पोनेंट टाइप premise है. हालांकि, प्राइमिस नंबर मौजूद नहीं है, इसलिए missingComponentTypes में premise शामिल होगा.
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

इस इनपुट से जियोकोड की गई जगह का PlaceID.

प्लेस आईडी के बारे में ज़्यादा जानने के लिए, यहां जाएं.
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

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

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

string

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

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

string

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

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

string

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

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

string

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

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

integer

NoStat का टाइप बताता है. वजह का कोड, int के तौर पर दिखाता है.

  • 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

यह इंडिकेटर बताता है कि अनुरोध को CASS प्रोसेस किया गया है.

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.