Package google.maps.addressvalidation.v1

इंडेक्स

AddressValidation

पतों की पुष्टि करने की सेवा.

ProvideValidationFeedback

rpc ProvideValidationFeedback(ProvideValidationFeedbackRequest) returns (ProvideValidationFeedbackResponse)

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

ValidateAddress

rpc ValidateAddress(ValidateAddressRequest) returns (ValidateAddressResponse)

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

पता

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

फ़ील्ड
formatted_address

string

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

postal_address

PostalAddress

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

address_components[]

AddressComponent

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

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

missing_component_types[]

string

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

unconfirmed_component_types[]

string

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

unresolved_tokens[]

string

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

AddressComponent

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

फ़ील्ड
component_name

ComponentName

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

component_type

string

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

confirmation_level

ConfirmationLevel

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

inferred

bool

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

spell_corrected

bool

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

replaced

bool

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

unexpected

bool

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

ConfirmationLevel

पुष्टि के लेवल के लिए अलग-अलग संभावित वैल्यू.

Enums
CONFIRMATION_LEVEL_UNSPECIFIED डिफ़ॉल्ट मान. इस वैल्यू का इस्तेमाल नहीं किया गया है.
CONFIRMED हम इस बात की पुष्टि कर पाए कि यह कॉम्पोनेंट मौजूद है और दिए गए पते के हिसाब से सही है.
UNCONFIRMED_BUT_PLAUSIBLE इस कॉम्पोनेंट की पुष्टि नहीं हो सकी, लेकिन ऐसा लगता है कि यह मौजूद है. उदाहरण के लिए, किसी सड़क पर नंबर की किसी मान्य रेंज में मौजूद सड़क का नंबर, जहां किसी खास घर के नंबर की जानकारी नहीं है.
UNCONFIRMED_AND_SUSPICIOUS इस कॉम्पोनेंट की पुष्टि नहीं हुई है और इसके गलत होने की संभावना है. उदाहरण के लिए, ऐसा आस-पड़ोस जो पते के बाकी हिस्से में नहीं है.

AddressMetadata

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

फ़ील्ड
business

bool

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

po_box

bool

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

residential

bool

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

ComponentName

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

फ़ील्ड
text

string

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

language_code

string

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

जियोकोड

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

फ़ील्ड
location

LatLng

इनपुट का जियोकोड किया गया स्थान.

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

plus_code

PlusCode

location से जुड़ा प्लस कोड.

bounds

Viewport

जियोकोड किए गए स्थान का दायरा.

feature_size_meters

float

जियोकोड किए गए स्थान का आकार, मीटर में. यह भी, जियोकोड की गई जगह की अनुमानित जानकारी की तरह ही सटीक जानकारी देता है. हालांकि, जगह के सिमैंटिक मतलब के बजाय, जगह की सटीक जानकारी का इस्तेमाल करना होता है.

place_id

string

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

जगह के आईडी के बारे में ज़्यादा जानकारी के लिए यहां देखें.

place_types[]

string

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

LanguageOptions

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

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

फ़ील्ड
return_english_latin_address

bool

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

PlusCode

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

फ़ील्ड
global_code

string

प्लेस का ग्लोबल (फ़ुल) कोड, जैसे कि "9FWM33GV+HQ", 1/8000 x 1/8,000 डिग्री क्षेत्र (~14 गुणा 14 मीटर) को दिखाता है.

compound_code

string

प्लेस का कंपाउंड कोड, जैसे कि "33GV+HQ, Ramberg, Norway" जिसमें ग्लोबल कोड का सफ़िक्स शामिल होता है. साथ ही, इसमें प्रीफ़िक्स की जगह रेफ़रंस इकाई के फ़ॉर्मैट किए गए नाम का इस्तेमाल किया जाता है.

ProvideValidationFeedbackRequest

पुष्टि करने के बारे में सुझाव, शिकायत या राय भेजने का अनुरोध.

फ़ील्ड
conclusion

ValidationConclusion

ज़रूरी है. पुष्टि करने की कोशिशों के क्रम का नतीजा.

अगर इस फ़ील्ड को VALIDATION_CONCLUSION_UNSPECIFIED पर सेट किया जाता है, तो INVALID_ARGUMENT गड़बड़ी दिखेगी.

response_id

string

ज़रूरी है. उस जवाब का आईडी जिसके लिए यह सुझाव, शिकायत या राय भेजी गई है. यह पता पुष्टि की कोशिशों के पहले जवाब से [response_id][google.maps.addressvalidation.v1.ValidateAddressRequest.response_id] होना चाहिए.

ValidationConclusion

पते की पुष्टि करने के लिए, पते की पुष्टि करने के अनुरोधों के क्रम के संभावित आखिरी नतीजे.

Enums
VALIDATION_CONCLUSION_UNSPECIFIED इस वैल्यू का इस्तेमाल नहीं किया गया है. अगर ProvideValidationFeedbackRequest.conclusion फ़ील्ड को VALIDATION_CONCLUSION_UNSPECIFIED पर सेट किया गया है, तो INVALID_ARGUMENT गड़बड़ी दिखेगी.
VALIDATED_VERSION_USED लेन-देन के लिए, पते की पुष्टि करने वाले एपीआई से मिले पते के वर्शन का इस्तेमाल किया गया.
USER_VERSION_USED उपयोगकर्ता ने जो पते का इस्तेमाल किया था उसी का इस्तेमाल लेन-देन के लिए किया गया था
UNVALIDATED_VERSION_USED पते का वह वर्शन जो पिछली बार पुष्टि करने की कोशिश के बाद डाला गया था, लेकिन जिसकी दोबारा पुष्टि नहीं की गई थी, उसका इस्तेमाल लेन-देन के लिए किया गया था.
UNUSED लेन-देन रद्द कर दिया गया और पते का इस्तेमाल नहीं किया गया.

ProvideValidationFeedbackResponse

इस टाइप के लिए कोई फ़ील्ड नहीं है.

पुष्टि करने के सुझाव का जवाब.

अगर सुझाव, शिकायत या राय भेज दी गई है, तो जवाब नहीं दिया जाएगा.

UspsAddress

इसमें अमेरिका के पते को यूएसपीएस के तौर पर दिखाया गया है.

फ़ील्ड
first_address_line

string

पते की पहली लाइन.

firm

string

फ़र्म का नाम.

second_address_line

string

दूसरी पता पंक्ति.

urbanization

string

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

city_state_zip_address_line

string

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

city

string

शहर का नाम.

state

string

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

zip_code

string

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

zip_code_extension

string

चार अंकों वाला पिन कोड एक्सटेंशन, उदाहरण के लिए, 5023.

UspsData

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

फ़ील्ड
standardized_address

UspsAddress

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

delivery_point_code

string

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

delivery_point_check_digit

string

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

dpv_confirmation

string

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

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

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: डीपीवी की पुष्टि का पता और पीएमबी की जानकारी
  • R1: ऐसे पते पर DPV की पुष्टि की गई है जिसमें पीएमबी की जानकारी मौजूद नहीं है
  • R7: मोबाइल और इंटरनेट सेवा देने वाली कंपनी का रूट R777 या R779 रिकॉर्ड
  • IA: बताए गए पते की पहचान की गई
  • TA: पीछे लगने वाले ऐल्फ़ा को छोड़कर, मुख्य नंबर का मिलान हुआ
dpv_cmra

string

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

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

string

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

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

string

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

  • Y: पता सक्रिय नहीं है
  • N: पता चालू है
dpv_no_stat_reason_code

int32

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

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

string

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

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

string

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

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

string

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

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

int32

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

dpv_no_secure_location

string

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

  • Y: सुरक्षा से जुड़ी वजहों से पैकेज को नहीं छोड़ा जाएगा.
  • N: ऐसा कोई संकेत नहीं है कि सुरक्षा की वजहों से पैकेज को नहीं छोड़ा जाएगा.
dpv_pbsa

string

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

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

string

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

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

string

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

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

string

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

प्रीफ़िक्स:

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

string

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

ews_no_match

bool

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

post_office_city

string

मुख्य डाकघर शहर.

post_office_state

string

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

abbreviated_city

string

संक्षिप्त शहर.

fips_county_code

string

FIPS काउंटी कोड.

county

string

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

elot_number

string

यात्रा की बेहतर सुविधा (eLOT) नंबर.

elot_flag

string

eLOT आरोही/अवरोही फ़्लैग (A/D).

po_box_only_postal_code

bool

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

pmb_designator

string

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

pmb_number

string

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

address_record_type

string

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

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

bool

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

error_message

string

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

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

cass_processed

bool

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

ValidateAddressRequest

पते की पुष्टि करने के लिए अनुरोध.

फ़ील्ड
address

PostalAddress

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

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

इन देशों और इलाकों में मान्य है की जानकारी यहां दी गई है.

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

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

previous_response_id

string

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

enable_usps_cass

bool

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 डालें, जहां पहली लाइन में सड़क का नंबर और नाम हो और दूसरी लाइन में शहर, राज्य, और पिन कोड शामिल हों.

language_options

LanguageOptions

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

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

ValidateAddressResponse

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

फ़ील्ड
result

ValidationResult

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

response_id

string

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

ValidationResult

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

फ़ील्ड
verdict

Verdict

नतीजे के सभी फ़्लैग

address

Address

जियोकोड के विपरीत पते के बारे में जानकारी.

geocode

Geocode

उस जगह और जगह की जानकारी जहां पते को जियोकोड किया गया.

metadata

AddressMetadata

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

usps_data

UspsData

डिलीवर करने की ज़्यादा जानकारी के लिए USPS की ओर से दिए गए फ़्लैग. सिर्फ़ US और PR क्षेत्र में उपलब्ध है.

english_latin_address

Address

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

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

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

ध्यान दें: english_latin_address के google.maps.addressvalidation.v1.Address.unconfirmed_component_types फ़ील्ड और english_latin_address.address_components के google.maps.addressvalidation.v1.AddressComponent.confirmation_level फ़ील्ड में जानकारी अपने-आप नहीं भरी गई है.

नतीजा

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

फ़ील्ड
input_granularity

Granularity

इनपुट पते की जानकारी का स्तर. यह इनपुट पते को पार्स करने का नतीजा है और इससे पुष्टि करने के लिए कोई सिग्नल नहीं मिलता. पुष्टि करने के सिग्नल के लिए, नीचे validation_granularity देखें.

उदाहरण के लिए, अगर इनपुट पते में कोई खास अपार्टमेंट नंबर शामिल है, तो यहां input_granularity होगा SUB_PREMISE. अगर हम डेटाबेस में दिए गए अपार्टमेंट नंबर को मैच नहीं कर पाते या अपार्टमेंट नंबर गलत है, तो validation_granularity की वैल्यू PREMISE या इससे कम होगी.

validation_granularity

Granularity

जानकारी का वह लेवल जिसके लिए एपीआई, पते की पूरी validate कर सकता है. उदाहरण के लिए, PREMISE का validation_granularity बताता है कि PREMISE के लेवल पर पते के सभी कॉम्पोनेंट की पुष्टि की जा सकती है. इसके अलावा, अनुमानित वैल्यू की पुष्टि की जा सकती है.

हर पते के लिए कॉम्पोनेंट की पुष्टि का नतीजा, google.maps.addressvalidation.v1.Address.address_components में मिल सकता है.

geocode_granularity

Granularity

geocode की जानकारी के लेवल की जानकारी. इसे इस तरह समझा जा सकता है कि जियोकोड की गई जगह कितनी खराब या बारीक है.

यह कभी-कभी ऊपर दिए गए validation_granularity से अलग हो सकता है. उदाहरण के लिए, हो सकता है कि हमारे डेटाबेस में कोई अपार्टमेंट नंबर मौजूद हो, लेकिन हमारे पास किसी बड़े अपार्टमेंट कॉम्प्लेक्स में अपार्टमेंट की सटीक जगह न हो. इस मामले में, validation_granularity का मान SUB_PREMISE होगा, लेकिन geocode_granularity का मान PREMISE होगा.

address_complete

bool

अगर कोई ऐसा टोकन नहीं है जिसे सुलझाया नहीं गया है, तो पते को 'पूरा माना गया' माना जाता है. साथ ही, अगर पते के कॉम्पोनेंट अनचाहे या मौजूद नहीं हैं, तो उन्हें पूरा माना जाता है. ज़्यादा जानकारी के लिए missing_component_types, unresolved_tokens या unexpected फ़ील्ड देखें.

has_unconfirmed_components

bool

पते के कम से कम एक कॉम्पोनेंट की कैटगरी तय नहीं की जा सकती या उसकी पुष्टि नहीं की जा सकती. ज़्यादा जानकारी के लिए, google.maps.addressvalidation.v1.Address.address_components देखें.

has_inferred_components

bool

पते का कम से कम एक कॉम्पोनेंट जोड़ा गया (जोड़ा गया), जो इनपुट में नहीं था. ज़्यादा जानकारी के लिए google.maps.addressvalidation.v1.Address.address_components देखें.

has_replaced_components

bool

पते का कम से कम एक कॉम्पोनेंट बदला गया है. ज़्यादा जानकारी के लिए, google.maps.addressvalidation.v1.Address.address_components देखें.

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

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

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