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 में मौजूद नहीं होते हैं. "Boulder, California, 80301, USA" जैसे इनपुट के लिए, ['street_number', 'route'] का उदाहरण हो सकता है. संभावित प्रकारों की सूची यहां देखी जा सकती है.
unconfirmed_component_types[]

string

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

string

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

AddressComponent

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

फ़ील्ड
component_name

ComponentName

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

string

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

ConfirmationLevel

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

bool

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

bool

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

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

जगह के आईडी के बारे में ज़्यादा जानकारी के लिए यहां देखें.
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 x 1/8000 डिग्री एरिया (~14 x 14 मीटर) को दिखाता है.
compound_code

string

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

ProvideValidationFeedbackRequest

पुष्टि करने के बारे में सुझाव/राय देने या शिकायत करने के लिए अनुरोध.

फ़ील्ड
conclusion

ValidationConclusion

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

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

string

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

ValidationConclusion

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

Enums
VALIDATION_CONCLUSION_UNSPECIFIED इस वैल्यू का इस्तेमाल नहीं किया गया है. अगर ProvideValidationFeedbackRequest.conclusion फ़ील्ड को VALIDATION_CONCLUSION_UNSPECIFIED पर सेट किया जाता है, तो INVALID_ARGUMENT गड़बड़ी मिलेगी.
VALIDATED_VERSION_USED Address Validation API से दिखाए गए पते के वर्शन का इस्तेमाल लेन-देन के लिए किया गया था.
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

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

string

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

string

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

string

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

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

string

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

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

string

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

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

string

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

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

int32

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

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

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

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

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

string

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

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

bool

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

string

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

यह गड़बड़ी मौजूद होने पर, हो सकता है कि यूएसपीएस डेटा फ़ील्ड में जानकारी न भरे.
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 फ़ील्ड पर पड़ता है. ध्यान दें: अगर प्योर्तो रिको में पतों के लिए यूएसपीएस सीएएसएस की सुविधा चालू है, तो address का google.type.PostalAddress.region_code "पीआर" के तौर पर दिया जाना चाहिए. इसके अलावा, address का google.type.PostalAddress.administrative_area "प्योर्तो रिको" (केस-इनसेंसिटिव) या "पीआर" के तौर पर दिया जाना चाहिए.

हमारा सुझाव है कि कॉम्पोनेंट वाला 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_LAMBDA गड़बड़ी दिखाई जाती है.

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

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