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 पैसेंजर "123235253253 मेन सेंट, सैन फ़्रांसिस्को, CA, 94105" जैसे इनपुट में, हल न हुए टोकन ["123235253253"] की तरह दिख सकते हैं, क्योंकि यह किसी मान्य सड़क नंबर जैसा नहीं दिखता.

AddressComponent

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

फ़ील्ड
component_name

ComponentName

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

string

पता कॉम्पोनेंट का टाइप. संभावित प्रकारों की सूची के लिए टेबल 2: Places सेवा से लौटाए गए अतिरिक्त प्रकार देखें.
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 Avenue" या सड़क के नंबर के लिए "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) दो फ़ॉर्मैट वाली, जगह की जानकारी का रेफ़रंस होता है: एक ग्लोबल कोड जो 14mx14m (डिग्री का 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

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

string

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

string

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

string

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

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

string

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

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

string

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

  • 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 रिकॉर्ड, 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

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

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

string

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

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

string

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

  • Y: मुख्य और किसी दूसरे नंबर के लिए, डीपीवी का पता दिया गया.
  • N: प्राइमरी और सेकंडरी नंबर की कोई भी जानकारी DPV से पुष्टि नहीं की जा सकी.
  • 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_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: Street RECORD: यह ऐसे Street रिकॉर्ड से मैच करता है जिसमें एक मान्य प्राइमरी नंबर रेंज होती है.
default_address

bool

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

string

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

यह गड़बड़ी होने पर, हो सकता है कि 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 की सेवा की खास शर्तें लागू होती हैं. ज़्यादा जानकारी के लिए, लॉन्च के चरण की जानकारी देखें.

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

string

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

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

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

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

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