Package google.maps.addressvalidation.v1

इंडेक्स

पते की पुष्टि

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

providerवैलिडेशनफ़ीडबैक

rpc ProvideValidationFeedback(ProvideValidationFeedbackRequest) returns (ProvideValidationFeedbackResponse)

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

rpc ValidateAddress(ValidateAddressRequest) returns (ValidateAddressResponse)

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

पता

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

फ़ील्ड
formatted_address

string

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

PostalAddress

प्रोसेस होने के बाद वाला पता, डाक पते के तौर पर दिखाया जाता है.
address_components[]

AddressComponent

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

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

string

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

string

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

string

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

पता कॉम्पोनेंट

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

फ़ील्ड
component_name

ComponentName

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

string

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

ConfirmationLevel

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

bool

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

bool

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

bool

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

bool

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

पुष्टि का लेवल

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

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

पते का मेटाडेटा

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

फ़ील्ड
business

bool

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

bool

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

bool

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

कॉम्पोनेंट का नाम

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

फ़ील्ड
text

string

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

string

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

जियोकोड

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

फ़ील्ड
location

LatLng

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

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

PlusCode

location से जुड़ा Plus Code.
bounds

Viewport

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

float

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

string

उस जगह का स्थान आईडी जहां यह इनपुट दिया गया है.

जगह के आईडी के बारे में ज़्यादा जानकारी यहां देखें.
place_types[]

string

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

भाषा विकल्प

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

प्लसकोड

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

फ़ील्ड
global_code

string

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

string

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

providerवैलिडेशनफ़ीडबैकअनुरोध

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

फ़ील्ड
conclusion

ValidationConclusion

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

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

string

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

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

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

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

Give Verificationफ़ीडबैकResponse

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

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

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

USpsपता

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

फ़ील्ड
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

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

यूएसबी डेटा

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

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

string

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

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

string

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

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

string

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

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

string

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

  • Y: पता चालू नहीं है
  • N: पता चालू है
carrier_route

string

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

प्रीफ़िक्स:

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

string

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

bool

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

string

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

string

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

string

छोटा शहर.
fips_county_code

string

FIPS काउंटी कोड.
county

string

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

string

बेहतर यात्रा लाइन (eLOT) नंबर.
elot_flag

string

eLOT A से Z के क्रम में/बढ़ते क्रम में फ़्लैग (A/D).
po_box_only_postal_code

bool

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

string

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

string

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

string

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

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

bool

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

string

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

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

bool

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

ValidateAddressRequest

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

फ़ील्ड
address

PostalAddress

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

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

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

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

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

string

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

bool

USPS CASS के साथ काम करने वाले मोड को चालू करता है. इससे सिर्फ़ google.maps.addressvalidation.v1.ValidationResult के google.maps.addressvalidation.v1.ValidationResult.usps_data फ़ील्ड पर असर पड़ता है. ध्यान दें: प्योर्तो रिको में पतों के लिए USPS CASS की सुविधा वाले अनुरोधों के लिए, address का google.type.PostalAddress.region_code "PR" के तौर पर दिया जाना चाहिए या address का google.type.PostalAddress.administrative_area "प्योर्तो रिको" (केस-इनसेंसिटिव) या "PR" के तौर पर दिया जाना चाहिए.

हमारा सुझाव है कि कॉम्पोनेंट फ़ॉर्मैट वाले address का इस्तेमाल करें. इसके अलावा, कम से कम दो google.type.PostalAddress.address_lines बताएं, जिनकी पहली लाइन में सड़क का नंबर और नाम हो. साथ ही, दूसरी लाइन में शहर, राज्य, और पिन कोड की जानकारी हो.
language_options

LanguageOptions

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

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

ConfirmAddressResponse

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

फ़ील्ड
result

ValidationResult

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

string

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

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

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

फ़ील्ड
verdict

Verdict

सभी नतीजे दिखाने वाले फ़्लैग
address

Address

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

Geocode

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

AddressMetadata

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

UspsData

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

Address

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

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

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

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

नतीजा

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

फ़ील्ड
input_granularity

Granularity

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

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

Granularity

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

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

Granularity

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

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

bool

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

bool

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

bool

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

bool

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

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

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

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