Package google.maps.addressvalidation.v1

संग्रह की मदद से व्यवस्थित रहें अपनी प्राथमिकताओं के आधार पर, कॉन्टेंट को सेव करें और कैटगरी में बांटें.

सूची

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

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

पुष्टि करने का सुझाव दें

rpc ProvideValidationFeedback(ProvideValidationFeedbackRequest) returns (ProvideValidationFeedbackResponse)

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

unconfirmed_component_types[]

string

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

unresolved_tokens[]

string

इनपुट में मौजूद किसी भी टोकन को ठीक नहीं किया जा सका. यह एक ऐसा इनपुट हो सकता है, जिसे किसी पते के मान्य हिस्से के रूप में पहचाना नहीं गया हो (उदाहरण के लिए, "123235253253 मेन सेंट, सैन फ़्रांसिस्को, सीए, 94105" जैसे इनपुट में, हल नहीं किए गए टोकन ["123235253253"] जैसे दिखाई दे सकते हैं, क्योंकि यह एक मान्य सड़क संख्या नहीं लग रही है).

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

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

फ़ील्ड
component_name

ComponentName

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

component_type

string

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

confirmation_level

ConfirmationLevel

इस बात की पुष्टि होती है कि कॉम्पोनेंट सही है या नहीं.

inferred

bool

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

spell_corrected

bool

इससे पता चलता है कि कॉम्पोनेंट के नाम की स्पेलिंग को ठीक करने का तरीका बहुत कम था. उदाहरण के लिए, ऐसे दो वर्णों को बदलना जो गलत क्रम में लगे. इससे कॉस्मेटिक बदलाव का पता चलता है.

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 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']. टाइप की पूरी सूची यहां देखी जा सकती है.

प्लस कोड

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

फ़ील्ड
global_code

string

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

compound_code

string

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

इस तरह का सुझाव दें

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

फ़ील्ड
conclusion

ValidationConclusion

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

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

response_id

string

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

पुष्टि की प्रक्रिया पूरी होने की तारीख

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

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

विज्ञापन के ज़रिए फ़ीडबैक का जवाब दें

पुष्टि करने के लिए मिले सुझाव.

अगर फ़ीडबैक भेज दिया जाता है, तो जवाब खाली होता है.

यूएसपीएस पता

अमेरिका के पते के हिसाब से USPS.

फ़ील्ड
first_address_line

string

पते की पहली लाइन.

firm

string

फ़र्म का नाम.

second_address_line

string

पते की दूसरी लाइन.

urbanization

string

प्योर्तो रिकन शहर का नाम.

city_state_zip_address_line

string

शहर + राज्य + पिन कोड.

city

string

शहर का नाम.

state

string

2 अक्षरों का राज्य कोड.

zip_code

string

पिन कोड, जैसे कि 10009.

zip_code_extension

string

चार अंकों वाला पिन कोड एक्सटेंशन, जैसे कि 5023.

Upsडेटा

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

फ़ील्ड
standardized_address

UspsAddress

USPS का मानक बनाया गया पता.

delivery_point_code

string

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

delivery_point_check_digit

string

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

dpv_confirmation

string

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

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

string

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

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

string

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

  • Y: पता एक CMRA है
  • N: यह पता सीएमए नहीं है
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

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

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/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 डेटा वापस पाने के लिए गड़बड़ी का मैसेज. यह तब दर्ज होता है, जब आर्टिफ़िशियल तरीके से बनाए गए पतों का पता लगाने की वजह से, USPS प्रोसेसिंग रोक दी जाती है.

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

cass_processed

bool

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

पते की पुष्टि करें

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

फ़ील्ड
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 तय किए जा सकते हैं. पहली लाइन में स्ट्रीट नंबर और नाम होता है. वहीं, दूसरी लाइन में शहर, राज्य, और पिन कोड होता है.

VerifiedAddressResponse

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

फ़ील्ड
result

ValidationResult

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

response_id

string

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

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

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

फ़ील्ड
verdict

Verdict

अपराध की जांच के फ़ैसले की कुल संख्या

address

Address

वेब पते के बजाय पते के बारे में जानकारी.

geocode

Geocode

उस जगह और जगह के बारे में जानकारी जहां पता दिया गया था.

metadata

AddressMetadata

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

usps_data

UspsData

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

नतीजा

पते की पुष्टि करने के नतीजे और वेब पेज की जानकारी से जुड़ी खास जानकारी.

फ़ील्ड
input_granularity

Granularity

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