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 वैल्यू को आने वाले समय में इस्तेमाल करने के लिए रिज़र्व रखा गया है. फ़िलहाल, इसे अनदेखा कर दिया गया है. पुष्टि किए गए पते का नतीजा, दिए गए पते के लिए पसंदीदा भाषा के हिसाब से अपने-आप भर जाएगा. भाषा की पहचान, सिस्टम ने की है.

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

string

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

boolean

USPS CASS के साथ काम करने वाले मोड को चालू करता है. इसका असर सिर्फ़ google.maps.addressvalidation.v1.ValidationResult के google.maps.addressvalidation.v1.ValidationResult.usps_data फ़ील्ड पर पड़ता है. ध्यान दें: अगर प्योर्तो रिको में पते के लिए यूएसपीएस सीएएसएस की सुविधा चालू है, तो address का google.type.PostalAddress.region_code "पीआर" के तौर पर दिया जाना चाहिए या 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_LAMBDA गड़बड़ी दिखाई जाती है.

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

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

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

पता इनपुट / बदलाव करने के बारे में सलाह: - अंतरराष्ट्रीय मानकों के मुताबिक पता विजेट का इस्तेमाल करें, जैसे कि 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") या सिर्फ़ एक संख्या होती है. यह "sector code" को दिखाता है (जमैका), "डिलीवरी एरिया इंडिकेटर" (मलावी) या "पोस्ट ऑफ़िस इंडिकेटर" (उदाहरण के लिए आइवरी कोस्ट).
administrativeArea

string

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

string

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

string

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

string

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

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

किसी पते की कम से कम जानकारी में addressLines में मौजूद सारी जानकारी शामिल होती है. अगर regionCode नहीं दिया गया है, तो पते की लाइनों से इलाके का अनुमान लगाया जाता है.

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

string

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

string

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

LanguageOptions

झलक: यह सुविधा झलक (प्री-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)

डिलीवर की ज़्यादा से ज़्यादा जानकारी देने के लिए, यूएसपीएस की ओर से उपलब्ध कराए गए फ़्लैग. सिर्फ़ 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 फ़ील्ड में अपने-आप जानकारी नहीं भरती है.

नतीजा

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

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 मेन स्ट्रीट, रेडवुड सिटी, CA, 94061" PREMISE की पहचान करता है, जबकि "Redwood City, CA, 94061" जैसा कुछ LOCALITY की पहचान करता है. हालांकि, अगर हमें "123 मेन स्ट्रीट" के लिए जियोकोड नहीं मिल पाता है रेडवुड सिटी में, वापस भेजा गया जियोकोड 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

object (PostalAddress)

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

object (AddressComponent)

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

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

string

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

string

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

string

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

AddressComponent

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

JSON के काेड में दिखाना 
{
  "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

इससे कॉम्पोनेंट के नाम की गलत स्पेलिंग में सुधार किया जाता है. एपीआई, स्पेलिंग के एक वैरिएंट से दूसरे में होने वाले बदलावों को हमेशा फ़्लैग नहीं करता. जैसे, "सेंटर" बदलते समय "सेंटर" में सेट करें. यह आम तौर पर इस्तेमाल होने वाली गलत स्पेलिंग को भी फ़्लैग नहीं करता है. जैसे, "Amphitheater Pkwy" को बदलना से लेकर "एम्फ़ीथिएटर 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) जगह की जानकारी का रेफ़रंस है, जिसमें दो फ़ॉर्मैट हैं: 14mx14m (डिग्री का 1/8000वां) या छोटे रेक्टैंगल के बारे में बताने वाला ग्लोबल कोड और कंपाउंड कोड, जो प्रीफ़िक्स को रेफ़रंस जगह से बदल देता है.

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

string

जगह का ग्लोबल (पूरा) कोड, जैसे कि "9FWM33GV+HQ", जो 1/8000 x 1/8000 डिग्री एरिया (~14 x 14 मीटर) को दिखाता है.
compoundCode

string

जगह का कंपाउंड कोड, जैसे कि "33GV+HQ, रामबर्ग, नॉर्वे", जिसमें ग्लोबल कोड का सफ़िक्स है और इसमें प्रीफ़िक्स को किसी पहचान इकाई के फ़ॉर्मैट किए गए नाम से बदलना है.

व्यूपोर्ट

अक्षांश-देशांतर व्यूपोर्ट, जिसे 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

पते के लिए यूएसपीएस का डेटा. इस बात की कोई गारंटी नहीं है कि 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)

यूएसपीएस का मानक पता.
deliveryPointCode

string

डिलीवरी की जगह का दो अंकों वाला कोड
deliveryPointCheckDigit

string

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

string

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

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

string

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

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

string

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

  • Y: यह पता, CMRA है
  • N: यह पता, CMRA नहीं है
dpvVacant

string

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

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

string

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

  • Y: पता ऐक्टिव नहीं है
  • N: पता चालू है
dpvNoStatReasonCode

integer

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

  • 1: आईडीए (इंटरनल लॉन्च पता) – ऐसे पते जिन्हें यूएसपीएस से सीधे तौर पर मेल नहीं मिलता, लेकिन उन्हें ऐसे ड्रॉप पते पर डिलीवर किया जाता है जिस पर उन्हें सेवाएं दी जाती हैं.
  • 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 – गुरुवार गैर-डिलीवरी का दिन है 0x01 – शनिवार गैर-डिलीवरी दिन है 0x0
dpvNoSecureLocation

string

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

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

string

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

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

string

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

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

string

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

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

string

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

प्रीफ़िक्स:

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

string

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

boolean

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

string

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

string

मुख्य पोस्ट ऑफ़िस की स्थिति.
abbreviatedCity

string

छोटा शहर.
fipsCountyCode

string

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

string

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

string

एन्हैंसमेंट लाइन ऑफ़ ट्रैवल (eLOT) नंबर.
elotFlag

string

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

boolean

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

string

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

string

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

string

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

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

boolean

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

string

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

यह गड़बड़ी मौजूद होने पर, हो सकता है कि यूएसपीएस डेटा फ़ील्ड में जानकारी न भरे.
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

पिन कोड, जैसे कि 10,009 से शुरू होता है.
zipCodeExtension

string

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