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

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

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

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

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

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

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

string

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

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

string

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

प्रीफ़िक्स:

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

string

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

bool

डिलीवरी का पता मैच हो सकता है, लेकिन ईडब्ल्यूएस फ़ाइल से पता चलता है कि जल्द ही एकदम मैच होने वाला पता उपलब्ध होगा.
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: STREET RECORD: यह सड़क के उस रिकॉर्ड से मैच होता है जिसमें मान्य प्राइमरी नंबर की रेंज होती है.
default_address

bool

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

string

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

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

bool

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

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

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