Package google.maps.addressvalidation.v1

इंडेक्स

AddressValidation

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

ProvideValidationFeedback

rpc ProvideValidationFeedback(ProvideValidationFeedbackRequest) returns (ProvideValidationFeedbackResponse)

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

rpc ValidateAddress(ValidateAddressRequest) returns (ValidateAddressResponse)

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

पता

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

फ़ील्ड
formatted_address

string

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

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

PostalAddress

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

AddressComponent

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

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

string

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

string

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

string

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

AddressComponent

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

फ़ील्ड
component_name

ComponentName

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

string

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

ConfirmationLevel

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

bool

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

bool

कॉम्पोनेंट के नाम में स्पेलिंग की गड़बड़ी को ठीक करने के बारे में बताता है. एपीआई हमेशा, स्पेलिंग के एक वैरिएंट से दूसरे वैरिएंट में किए गए बदलावों को फ़्लैग नहीं करता. जैसे, "centre" को "center" में बदलने पर. यह हमेशा वर्तनी की सामान्य गलतियां भी फ़्लैग नहीं करता. जैसे, "Amphitheater Pkwy" को "Amphitheatre 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 Avenue" या सड़क का नंबर "1253".
language_code

string

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

जियोकोड

इसमें उस जगह की जानकारी होती है जिसे इनपुट के तौर पर इस्तेमाल करके, जगह की जानकारी हासिल की गई थी.

फ़ील्ड
location

LatLng

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

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

PlusCode

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

Viewport

जियोकोड किए गए स्थान की सीमाएं.
feature_size_meters

float

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

string

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

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

string

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

LanguageOptions

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

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

फ़ील्ड
return_english_latin_address

bool

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

PlusCode

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

फ़ील्ड
global_code

string

जगह का ग्लोबल (पूरा) कोड, जैसे कि "9FWM33GV+HQ". यह कोड, 1/8000 डिग्री से 1/8000 डिग्री के क्षेत्र (~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

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

फ़ील्ड
standardized_address

UspsAddress

USPS का स्टैंडर्ड पता.
delivery_point_code

string

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

string

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

string

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

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

string

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

  • AA: इनपुट पता, पिन कोड के साथ चार अंकों वाली फ़ाइल से मेल खाता है
  • A1: डाला गया पता, पिन कोड के साथ चार अंकों वाली फ़ाइल से मेल नहीं खाता
  • BB: डीपीवी (सभी कॉम्पोनेंट) से मैच किया गया
  • CC: सेकंडरी नंबर मैच नहीं हुआ और यह ज़रूरी नहीं है
  • C1: सेकंडरी नंबर मेल नहीं खाता, लेकिन यह ज़रूरी है
  • N1: हाइट-राइज़ पते में सेकंडरी नंबर मौजूद नहीं है
  • M1: मुख्य नंबर मौजूद नहीं है
  • M3: मुख्य नंबर अमान्य है
  • P1: इनपुट पते का PO, RR या HC बॉक्स नंबर मौजूद नहीं है
  • P3: पते का PO, RR या HC बॉक्स नंबर अमान्य है
  • F1: डाला गया पता, मिलिट्री पते से मेल खाता है
  • G1: दर्ज किए गए पते का मिलान एक सामान्य वितरण पते से हुआ
  • U1: दर्ज किए गए पते का मिलान अद्वितीय पिन कोड से हुआ है
  • PB: इनपुट पता, पीबीएसए रिकॉर्ड से मेल खाता है
  • RR: पीएमपी की जानकारी के साथ DPV की पुष्टि की गई पता
  • R1: DPV की पुष्टि वाला पता, लेकिन PMB की जानकारी नहीं मिली
  • 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 का टाइप बताता है. वजह का कोड, int के तौर पर दिखाता है.

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

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

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

string

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

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

string

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

  • Y: प्राइमरी और सेकंडरी नंबर के लिए, पते की डीपीवी की पुष्टि की गई थी.
  • N: प्राइमरी और सेकंडरी नंबर की जानकारी की डीपीवी की पुष्टि नहीं हो सकी.
  • S: सिर्फ़ मुख्य नंबर के लिए पते की DPV की पुष्टि की गई. दूसरी जानकारी मौजूद थी, लेकिन उसकी पुष्टि नहीं हुई थी. यह भी हो सकता है कि DPV मिलान और दूसरी ज़रूरी जानकारी देने के लिए, मुख्य नंबर के आखिर में एक ऐल्फ़ा नंबर हो गया हो.
  • D: सिर्फ़ मुख्य नंबर के लिए पते के डीपीवी की पुष्टि हो गई थी और सेकंडरी नंबर की जानकारी मौजूद नहीं थी.
  • 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

एफ़आईपीएस के हिसाब से, काउंटी का कोड.
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: FIRM. यह फ़र्म रिकॉर्ड से मैच होता है. यह पते के लिए सबसे बेहतर मैच होता है.
  • G: सामान्य डिलीवरी. यह सामान्य डिलीवरी रिकॉर्ड से मिलता-जुलता है.
  • H: बिल्डिंग / अपार्टमेंट. यह किसी इमारत या अपार्टमेंट के रिकॉर्ड से मैच करता है.
  • P: डाकघर का बॉक्स. यह पोस्ट ऑफ़िस बॉक्स से मेल खाता है.
  • R: ग्रामीण सड़क या राजमार्ग का अनुबंध: यह ग्रामीण सड़क या राजमार्ग के अनुबंध के रिकॉर्ड से मेल खाता है. इन दोनों में बॉक्स नंबर की रेंज हो सकती है.
  • S: सड़क का रिकॉर्ड: यह सड़क के उस रिकॉर्ड से मिलता-जुलता है जिसमें एक मान्य मुख्य संख्या की रेंज होती है.
default_address

bool

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

string

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

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

bool

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

ValidateAddressRequest

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

फ़ील्ड
address

PostalAddress

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

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

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

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

Address Validation API, 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

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

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

string

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

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

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

ValidateAddressResponse

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

फ़ील्ड
result

ValidationResult

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

string

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

ValidationResult

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

फ़ील्ड
verdict

Verdict

पूरे नतीजे के लिए फ़्लैग
address

Address

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

Geocode

उस जगह की जानकारी जिसे पते के तौर पर जियोकोड किया गया है.
metadata

AddressMetadata

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

UspsData

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

Address

झलक: यह सुविधा, झलक (Pre-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

एपीआई, पते की पूरी पुष्टि तब कर सकता है, जब पते की जानकारी ज़्यादा सटीक हो. उदाहरण के लिए, 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

अगर पते में कोई ऐसा टोकन नहीं है जिसे हल नहीं किया जा सका है, कोई ऐसा कॉम्पोनेंट नहीं है जो अचानक से जुड़ा है या कोई कॉम्पोनेंट मौजूद नहीं है, तो पते को पूरा माना जाता है. अगर यह सेट नहीं है, तो इसका मतलब है कि वैल्यू false है. ज़्यादा जानकारी के लिए, 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 Main Street, Redwood City, CA, 94061" जैसे पते से PREMISE की पहचान होती है, जबकि "Redwood City, CA, 94061" जैसे पते से LOCALITY की पहचान होती है. हालांकि, अगर हमें Redwood City में "123 Main Street" का जियोकोड नहीं मिलता है, तो हो सकता है कि दिया गया जियोकोड LOCALITY लेवल का हो. भले ही, पता ज़्यादा जानकारी वाला हो.

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