Method: validateAddress

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

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

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

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

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

अनुरोध के मुख्य हिस्से में, इस तरह का डेटा शामिल होता है:

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

object (PostalAddress)

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

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

इन देशों और इलाकों की जानकारी यहां देखी जा सकती है.

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

पते की पुष्टि करने वाला एपीआई, 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)

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

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

string

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

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

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

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

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

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

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

object (ValidationResult)

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

string

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

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 है, तो एपीआई 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

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

string

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

string

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

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

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

ऐसा पता बनाना जिसमें सिर्फ़ addressLines शामिल हो और फिर जियोकोडिंग पूरी तरह से अव्यवस्थित पतों को हैंडल करने का सुझाव दिया जाता है (यह अनुमान लगाने के बजाय कि पते के कौनसे हिस्से शहर या राज्य होने चाहिए).
recipients[]

string

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

string

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

LanguageOptions

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

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

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

boolean

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

ValidationResult

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

जेएसओएन के काेड में दिखाना 
{
  "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)

यूएसपीएस से मिले ज़्यादा डिलीवरी फ़्लैग. सिर्फ़ US और PR इलाके में उपलब्ध है.
englishLatinAddress

object (Address)

झलक: यह सुविधा, झलक (प्री-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 फ़ील्ड में जानकारी अपने-आप नहीं भरती.

नतीजा

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

जेएसओएन के काेड में दिखाना 
{
  "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)

जानकारी का वह लेवल जिसके लिए एपीआई, पते की पूरी validate कर सकता है. उदाहरण के लिए, 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 की पहचान होती है. हालांकि, अगर हम रेडवुड सिटी में "123 मेन स्ट्रीट" का जियोकोड खोजने में असमर्थ रहते हैं, तो पता ज़्यादा विस्तृत होने के बावजूद, हो सकता है कि जियोकोड किया गया जियोकोड, LOCALITY विवरण का स्तर हो.

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

पता

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

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

string

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

object (PostalAddress)

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

object (AddressComponent)

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

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

string

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

string

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

string

इनपुट में ऐसा कोई भी टोकन जो रिज़ॉल्व नहीं हो सका. यह एक ऐसा इनपुट हो सकता है जिसे पते के मान्य हिस्से के तौर पर पहचाना नहीं जा सका. उदाहरण के लिए, "123235253253 पैसेंजर "123235253253 मेन सेंट, सैन फ़्रांसिस्को, CA, 94105" जैसे इनपुट में, हल न हुए टोकन ["123235253253"] की तरह दिख सकते हैं, क्योंकि यह किसी मान्य सड़क नंबर जैसा नहीं दिखता.

AddressComponent

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

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

object (ComponentName)

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

string

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

enum (ConfirmationLevel)

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

boolean

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

boolean

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

boolean

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

boolean

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

ComponentName

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

जेएसओएन के काेड में दिखाना 
{
  "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 इस कॉम्पोनेंट की पुष्टि नहीं हुई थी और हो सकता है कि यह गलत हो. उदाहरण के लिए, कोई ऐसा आस-पड़ोस जो पते के बाकी हिस्से में फ़िट नहीं होता.

जियोकोड

इसमें उस जगह की जानकारी होती है जहां इनपुट जियोकोड किया गया था.

जेएसओएन के काेड में दिखाना 
{
  "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 मानक के मुताबिक होना चाहिए. वैल्यू, सामान्य रेंज के अंदर होनी चाहिए.

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

number

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

number

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

PlusCode

प्लस कोड (http://plus.codes) दो फ़ॉर्मैट वाली, जगह की जानकारी का रेफ़रंस होता है: एक ग्लोबल कोड जो 14mx14m (डिग्री का 1/8000वां) या छोटा रेक्टैंगल तय करता है. साथ ही, कंपाउंड कोड, प्रीफ़िक्स की जगह रेफ़रंस ले लेता है.

जेएसओएन के काेड में दिखाना 
{
  "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 } }

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

object (LatLng)

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

object (LatLng)

ज़रूरी है. व्यूपोर्ट का हाई पॉइंट.

AddressMetadata

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

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

boolean

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

boolean

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

boolean

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

UspsData

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

जेएसओएन के काेड में दिखाना 
{
  "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)

यूएसपीएस का स्टैंडर्ड पता.
deliveryPointCode

string

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

string

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

string

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

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

string

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

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

string

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

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

string

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

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

string

क्या यह कोई आंकड़ा नहीं है या सक्रिय पता है? कोई भी आंकड़े वे पते नहीं होते जिन पर लगातार कब्ज़ा नहीं रहता है या जिन पतों पर यूएसपीएस सेवा नहीं देता है. सिर्फ़ एक वर्ण दिखाता है.

  • Y: पता सक्रिय नहीं है
  • N: पता सक्रिय है
dpvNoStatReasonCode

integer

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

  • 1: IDA (इंटरनल ड्रॉप पता) – ऐसे पते जिन्हें USPS से सीधे मेल नहीं मिलता, लेकिन उन्हें सेवा देने वाले ड्रॉप पते पर डिलीवर कर दिया जाता है.
  • 2: CDS - ऐसे पते जो अब तक डिलीवर नहीं किए गए हैं. उदाहरण के लिए, एक नया सबडिविज़न, जहां बहुत से और मुख्य नंबर तय किए गए हैं, लेकिन अभी तक बुकिंग के लिए कोई स्ट्रक्चर मौजूद नहीं है.
  • 3: टकराव - वे पते जिनकी असल में DPV की पुष्टि नहीं होती है.
  • 4: CMZ (कॉलेज, मिलिट्री, और अन्य टाइप) - ZIP + 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

इससे पता चलता है कि पता, PBSA रिकॉर्ड से मैच हुआ था. सिर्फ़ एक वर्ण दिखाता है.

  • Y: पते का मिलान PBSA रिकॉर्ड से किया गया था.
  • N: पता, PBSA रिकॉर्ड से मैच नहीं हुआ था.
dpvDoorNotAccessible

string

फ़्लैग उन पतों को दिखाता है जहां USPS डाक डिलीवर करने के लिए दरवाज़ा नहीं खोल सकता. सिर्फ़ एक वर्ण दिखाता है.

  • Y: दरवाज़ा नहीं खोला जा सकता.
  • N: इससे पता नहीं चलता कि दरवाज़ा खुला नहीं है.
dpvEnhancedDeliveryCode

string

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

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

string

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

प्रीफ़िक्स:

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

string

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

boolean

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

string

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

string

मुख्य डाकघर राज्य.
abbreviatedCity

string

छोटे नाम में शहर.
fipsCountyCode

string

एफ़आईपीएस काउंटी का कोड.
county

string

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

string

यात्रा की बेहतर सुविधा (ईएलओटी) नंबर.
elotFlag

string

eLOT आरोही/घटते हुए फ़्लैग (A/D).
poBoxOnlyPostalCode

boolean

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

string

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

string

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

string

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

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

boolean

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

string

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

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

boolean

इस बात की जानकारी कि अनुरोध को सीएएसएस प्रोसेस किया जा चुका है.

UspsAddress

इसमें अमेरिका का पता दिखाया गया है.

जेएसओएन के काेड में दिखाना 
{
  "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.