सूची
AddressValidation
(इंटरफ़ेस)Address
(मैसेज)AddressComponent
(मैसेज)AddressComponent.ConfirmationLevel
(enum)AddressMetadata
(मैसेज)ComponentName
(मैसेज)Geocode
(मैसेज)PlusCode
(मैसेज)ProvideValidationFeedbackRequest
(मैसेज)ProvideValidationFeedbackRequest.ValidationConclusion
(enum)ProvideValidationFeedbackResponse
(मैसेज)UspsAddress
(मैसेज)UspsData
(मैसेज)ValidateAddressRequest
(मैसेज)ValidateAddressResponse
(मैसेज)ValidationResult
(मैसेज)Verdict
(मैसेज)Verdict.Granularity
(enum)
पते की पुष्टि करना
पतों की पुष्टि करने की सेवा.
पुष्टि करने का सुझाव दें |
---|
पुष्टि की कोशिशों के क्रम के नतीजे के बारे में सुझाव. यह उसी पते पर पुष्टि कॉल होने के बाद किया गया आखिरी कॉल होना चाहिए. साथ ही, लेन-देन पूरा होने के बाद यह कॉल किया जाना चाहिए. इसे |
पते की पुष्टि करें |
---|
पते की पुष्टि करता है. |
पता
इनपुट से पार्स किए गए पते की जानकारी.
फ़ील्ड | |
---|---|
formatted_address |
सही पता, पते को फ़ॉर्मैट किए जाने वाले क्षेत्र के पते की फ़ॉर्मैटिंग के नियमों का पालन करके, एक लाइन वाले पते के रूप में फ़ॉर्मैट किया जाता है. |
postal_address |
पुष्टि किया गया पता, डाक पते के तौर पर दिखाया गया है. |
address_components[] |
बिना क्रम वाली सूची. फ़ॉर्मैट और सही किए गए पते के अलग-अलग पते के कॉम्पोनेंट, साथ ही पुष्टि करने की जानकारी. इससे हर कॉम्पोनेंट की पुष्टि के स्टेटस की जानकारी मिलती है. पता कॉम्पोनेंट किसी खास तरीके से ऑर्डर नहीं किए जाते हैं. सूची में पता कॉम्पोनेंट के क्रम के बारे में कोई अनुमान न लगाएं. |
missing_component_types[] |
इस तरह के कॉम्पोनेंट, सही तरीके से फ़ॉर्मैट किए गए डाक पते में मौजूद होने चाहिए थे, लेकिन इनपुट में नहीं मिले. इसलिए, उनका अनुमान नहीं लगाया जा सका. इस तरह के कॉम्पोनेंट |
unconfirmed_component_types[] |
ऐसे कॉम्पोनेंट जो |
unresolved_tokens[] |
इनपुट में मौजूद किसी भी टोकन को ठीक नहीं किया जा सका. यह एक ऐसा इनपुट हो सकता है, जिसे किसी पते के मान्य हिस्से के रूप में पहचाना नहीं गया हो (उदाहरण के लिए, "123235253253 मेन सेंट, सैन फ़्रांसिस्को, सीए, 94105" जैसे इनपुट में, हल नहीं किए गए टोकन |
पते वाला कॉम्पोनेंट
पते के कॉम्पोनेंट को दिखाता है, जैसे कि सड़क, शहर या राज्य.
फ़ील्ड | |
---|---|
component_name |
इस कॉम्पोनेंट का नाम. |
component_type |
पते के कॉम्पोनेंट का टाइप. संभावित टेबल की सूची के लिए, टेबल 2: जगहों की सेवा से दिए गए दूसरे टाइप देखें. |
confirmation_level |
इस बात की पुष्टि होती है कि कॉम्पोनेंट सही है या नहीं. |
inferred |
इससे पता चलता है कि कॉम्पोनेंट, इनपुट का हिस्सा नहीं था. हालांकि, हमने पते की जगह का पता लगाया है और इसे पूरा पता दिया है. |
spell_corrected |
इससे पता चलता है कि कॉम्पोनेंट के नाम की स्पेलिंग को ठीक करने का तरीका बहुत कम था. उदाहरण के लिए, ऐसे दो वर्णों को बदलना जो गलत क्रम में लगे. इससे कॉस्मेटिक बदलाव का पता चलता है. |
replaced |
इससे पता चलता है कि कॉम्पोनेंट के नाम को पूरी तरह से अलग पते से बदल दिया गया था. उदाहरण के लिए, गलत पिन कोड को पते के लिए सही पिन कोड से बदला गया. यह कॉस्मेटिक बदलाव नहीं है, इनपुट कॉम्पोनेंट को किसी और कॉम्पोनेंट में बदल दिया गया है. |
unexpected |
पते के उस कॉम्पोनेंट की जानकारी देता है जो किसी इलाके के डाक पते में मौजूद नहीं है. हमने इसे सिर्फ़ इसलिए रखा है, क्योंकि यह इनपुट का हिस्सा था. |
पुष्टि का लेवल
पुष्टि करने के लेवल के लिए अलग-अलग वैल्यू.
Enums | |
---|---|
CONFIRMATION_LEVEL_UNSPECIFIED |
डिफ़ॉल्ट मान. इस वैल्यू का इस्तेमाल नहीं किया गया है. |
CONFIRMED |
हम इस बात की पुष्टि कर पाए कि यह कॉम्पोनेंट मौजूद है और बाकी पते के हिसाब से यह ठीक है. |
UNCONFIRMED_BUT_PLAUSIBLE |
इस कॉम्पोनेंट की पुष्टि नहीं की जा सकी. हालांकि, ऐसा लगता है कि यह कॉम्पोनेंट मौजूद है. उदाहरण के लिए, अगर किसी सड़क पर कोई खास नंबर मालूम नहीं है, तो उस सड़क पर मौजूद मान्य नंबर के मोहल्ले में मौजूद सड़क का नंबर. |
UNCONFIRMED_AND_SUSPICIOUS |
इस कॉम्पोनेंट की पुष्टि नहीं हुई और यह गलत हो सकता है. उदाहरण के लिए, ऐसा आस-पड़ोस जो बाकी पते से मेल नहीं खाता. |
पते का मेटाडेटा
पते का मेटाडेटा. इस बात की कोई गारंटी नहीं है कि metadata
पते की पुष्टि करने वाले एपीआई को भेजे गए हर पते के लिए जानकारी अपने-आप भर जाएगी.
फ़ील्ड | |
---|---|
business |
इससे पता चलता है कि यह कारोबार का पता है. अगर इस नीति को सेट नहीं किया जाता है, तो इससे पता चलता है कि वैल्यू के बारे में कोई जानकारी नहीं है. |
po_box |
इससे पता चलता है कि पीओ बॉक्स का पता क्या है. अगर इस नीति को सेट नहीं किया जाता है, तो इससे पता चलता है कि वैल्यू के बारे में कोई जानकारी नहीं है. |
residential |
इससे पता चलता है कि यह आपके घर का पता है. अगर इस नीति को सेट नहीं किया जाता है, तो इससे पता चलता है कि वैल्यू के बारे में कोई जानकारी नहीं है. |
कॉम्पोनेंट का नाम
कॉम्पोनेंट के नाम के लिए रैपर.
फ़ील्ड | |
---|---|
text |
नाम का टेक्स्ट. उदाहरण के लिए, सड़क के नाम के लिए "5th Avenue" या स्ट्रीट नंबर के लिए "1253". |
language_code |
BCP-47 भाषा कोड. अगर कॉम्पोनेंट का नाम किसी भाषा, जैसे कि स्ट्रीट नंबर से नहीं जुड़ा है, तो वह मौजूद नहीं होगा. |
ट्रांसकोड
इसमें, इनपुट की गई जगह की जानकारी शामिल होती है.
फ़ील्ड | |
---|---|
location |
इनपुट की जगह. पतों, अक्षांश/देशांतर निर्देशांकों या प्लस कोड का उपयोग करने के बजाय स्थान आईडी का इस्तेमाल करना बेहतर होता है. ड्राइविंग दिशा-निर्देशों को रूट या कैलकुलेट करते समय निर्देशांकों का इस्तेमाल करने पर हमेशा उस पॉइंट को उन निर्देशांकों के पास वाली सड़क पर स्नैप किया जाता है. हो सकता है कि यह वह सड़क न हो जो फटाफट या सुरक्षित तरीके से मंज़िल तक पहुंचेगी और शायद प्रॉपर्टी के ऐक्सेस पॉइंट के पास न हो. इसके अलावा, जब किसी जगह के पते की जानकारी को बदला जाता है, तो इस बात की कोई गारंटी नहीं होती कि लौटाया गया पता, मूल पते से मैच करेगा या नहीं. |
plus_code |
|
bounds |
भौगोलिक जगह की सीमा. |
feature_size_meters |
मीटर में, भौगोलिक जगह का आकार. यह, भौगोलिक जगह के जगह की खुरदरी माप का एक और पैमाना है, लेकिन मतलब के हिसाब से नहीं. |
place_id |
उस जगह का प्लेस आईडी जहां यह इनपुट जियोकोड करता है. जगह के आईडी के बारे में ज़्यादा जानने के लिए, यहां जाएं. |
place_types[] |
उस जगह का (के) टाइप, जहां इनपुट वाला (जियोकोड) किया गया था. उदाहरण के लिए, |
प्लस कोड
Plus Code (http://plus.codes) एक जगह का रेफ़रंस होता है, जिसमें दो फ़ॉर्मैट होते हैं: 14mx14m (किसी डिग्री का 1/8000वां) या छोटे रेक्टैंगल के बारे में बताने वाला ग्लोबल कोड और कंपाउंड कोड, प्रीफ़िक्स को रेफ़रंस की जगह से बदल देता है.
फ़ील्ड | |
---|---|
global_code |
जगह का ग्लोबल (पूरा) कोड, जैसे कि "9FWM33GV+HQ", 1/8000 x 1/8000 डिग्री के क्षेत्र को दिखाता है (~14 x 14 मीटर). |
compound_code |
जगह का कंपाउंड कोड, जैसे कि "33GV+HQ, रैमबर्ग, नॉर्वे". इसमें ग्लोबल कोड का सफ़िक्स होता है. साथ ही, प्रीफ़िक्स को, रेफ़रंस वाली इकाई के फ़ॉर्मैट किए गए नाम से बदला जाता है. |
इस तरह का सुझाव दें
पुष्टि का अनुरोध भेजने के लिए अनुरोध.
फ़ील्ड | |
---|---|
conclusion |
ज़रूरी है. पुष्टि की कोशिशों के क्रम का नतीजा. अगर इस फ़ील्ड को |
response_id |
ज़रूरी है. उस सुझाव का आईडी जिसके लिए यह सुझाव दिया गया है. यह पते की पुष्टि करने की कोशिशों की सीरीज़ में, पहली प्रतिक्रिया से [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 |
पते की पहली लाइन. |
firm |
फ़र्म का नाम. |
second_address_line |
पते की दूसरी लाइन. |
urbanization |
प्योर्तो रिकन शहर का नाम. |
city_state_zip_address_line |
शहर + राज्य + पिन कोड. |
city |
शहर का नाम. |
state |
2 अक्षरों का राज्य कोड. |
zip_code |
पिन कोड, जैसे कि 10009. |
zip_code_extension |
चार अंकों वाला पिन कोड एक्सटेंशन, जैसे कि 5023. |
Upsडेटा
पते के लिए USPS डेटा. इस बात की कोई गारंटी नहीं है कि uspsData
पते की पुष्टि करने वाले एपीआई में भेजे गए हर अमेरिका या पीआर पते को अपने-आप भर दिया जाएगा. हमारा सुझाव है कि रिस्पॉन्स में बैक अप पते के फ़ील्ड को इंटिग्रेट करें. अगर रिस्पॉन्स के प्राथमिक हिस्से के तौर पर USPSData का इस्तेमाल किया जाता है, तो ऐसा किया जाएगा.
फ़ील्ड | |
---|---|
standardized_address |
USPS का मानक बनाया गया पता. |
delivery_point_code |
2 अंकों वाला डिलीवरी पॉइंट कोड |
delivery_point_check_digit |
डिलीवरी पॉइंट की जांच करने का अंक. यह नंबर, मशीन से स्कैन किए गए मेल के लिए, delivery_point_barcode के आखिर में जोड़ा जाता है. delivery_point_barcode, delivery_point_check_अंक, पिन कोड, और ZIP+4 के सभी अंकों को एक साथ जोड़ने पर संख्या 10 से विभाजित होनी चाहिए. |
dpv_confirmation |
DPV पुष्टि के लिए संभावित मान. एक वर्ण दिखाता है.
|
dpv_footnote |
डिलीवरी पॉइंट की पुष्टि करने वाले फ़ुटनोट. कई फ़ुटनोट एक ही स्ट्रिंग में एक साथ फंस सकते हैं.
|
dpv_cmra |
यह बताता है कि पता सीएमएआरए (व्यावसायिक मेल पाने वाली एजेंसी) है या नहीं--यह एक निजी कारोबार है, जो क्लाइंट के लिए ईमेल पाता है. एक वर्ण दिखाता है.
|
dpv_vacant |
क्या यह जगह खाली है? एक वर्ण दिखाता है.
|
dpv_no_stat |
क्या यह कोई स्थायी पता या सक्रिय पता नहीं है? कोई भी स्टैट पता ऐसे नहीं होते जो लगातार अधिकार में न हों या वे पते जिन पर यूएसपीएस सेवा नहीं देता. एक वर्ण दिखाता है.
|
carrier_route |
कैरियर का रास्ता कोड. चार वर्णों वाला कोड. इसमें एक अक्षर का प्रीफ़िक्स और तीन अंकों वाला एक रूट डिज़ाइनर होता है. प्रीफ़िक्स:
|
carrier_route_indicator |
कैरियर रास्ते की दर के हिसाब से क्रम में लगाने वाला संकेत. |
ews_no_match |
वितरण पता मेल खाने योग्य है, लेकिन EMEA फ़ाइल बताती है कि जल्द ही एक सटीक मिलान उपलब्ध होगा. |
post_office_city |
पोस्ट ऑफ़िस का मुख्य शहर. |
post_office_state |
मुख्य डाकघर की स्थिति. |
abbreviated_city |
संक्षिप्त शहर. |
fips_county_code |
FIPS काउंटी कोड. |
county |
काउंटी का नाम. |
elot_number |
बेहतर लाइन ऑफ़ ट्रैवल (eLOT) नंबर. |
elot_flag |
eLOT आरोही/बढ़ता झंडा (A/D). |
lacs_link_return_code |
LACSLink वापसी कोड. |
lacs_link_indicator |
LACSLink इंडिकेटर |
po_box_only_postal_code |
पीओ बॉक्स सिर्फ़ पिन कोड पर. |
suitelink_footnote |
किसी सड़क से मिलान करने से लेकर फ़ुटनोट जोड़ने तक का रिकॉर्ड. अगर कारोबारी नाम मेल खाता है, तो दूसरी संख्या दिखती है.
|
pmb_designator |
पीएमबी (प्राइवेट मेल बॉक्स) यूनिट डिज़ाइनर. |
pmb_number |
पीएमबी (प्राइवेट मेल बॉक्स) नंबर; |
address_record_type |
इनपुट पते से मेल खाने वाले पता रिकॉर्ड का प्रकार.
|
default_address |
इससे पता चलता है कि डिफ़ॉल्ट पता मिला, लेकिन इसमें ज़्यादा खास पते मौजूद हैं. |
error_message |
USPS डेटा वापस पाने के लिए गड़बड़ी का मैसेज. यह तब दर्ज होता है, जब आर्टिफ़िशियल तरीके से बनाए गए पतों का पता लगाने की वजह से, USPS प्रोसेसिंग रोक दी जाती है. यह गड़बड़ी मौजूद होने पर हो सकता है कि USPS डेटा फ़ील्ड पॉप्युलेट न हों. |
cass_processed |
इससे पता चलता है कि अनुरोध को प्रोसेस कर दिया गया है. |
पते की पुष्टि करें
पते की पुष्टि करने का अनुरोध.
फ़ील्ड | |
---|---|
address |
ज़रूरी है. पते की पुष्टि की जा रही है. बिना फ़ॉर्मैट वाले पते इस इनपुट में फ़ील्ड की कुल लंबाई 280 वर्णों से ज़्यादा नहीं होनी चाहिए. इन इलाकों में, अक्सर पूछे जाने वाले सवाल सेक्शन देखे जा सकते हैं. इनपुट पते में दिया गया पता पुष्टि एपीआई, |
previous_response_id |
पहले पते की पुष्टि के अनुरोध के लिए, यह फ़ील्ड खाली होना चाहिए. अगर एक पते की पूरी तरह से पुष्टि करने के लिए और अनुरोध करने की ज़रूरत पड़ती है (उदाहरण के लिए, अगर पुष्टि की शुरुआती पुष्टि के लिए उपयोगकर्ता जो बदलाव करता है उनकी फिर से पुष्टि करना हो), तो फ़ॉलोअप के हर अनुरोध को इस फ़ील्ड में |
enable_usps_cass |
USPS CASS के साथ काम करने वाले मोड को चालू करता है. इसका असर सिर्फ़ यह सुझाव दिया जाता है कि कॉम्पोनेंट के तौर पर |
VerifiedAddressResponse
पते की पुष्टि करने के अनुरोध का जवाब.
फ़ील्ड | |
---|---|
result |
पते की पुष्टि करने का नतीजा. |
response_id |
UUID जो इस रिस्पॉन्स की पहचान करता है. अगर पते की फिर से पुष्टि करने की ज़रूरत है, तो यह UUID के साथ नए अनुरोध का ज़रूर होना ज़रूरी है. |
पुष्टि का नतीजा
किसी पते की पुष्टि करने का नतीजा.
फ़ील्ड | |
---|---|
verdict |
अपराध की जांच के फ़ैसले की कुल संख्या |
address |
वेब पते के बजाय पते के बारे में जानकारी. |
geocode |
उस जगह और जगह के बारे में जानकारी जहां पता दिया गया था. |
metadata |
डिलीवरी से जुड़ी अन्य जानकारी. इस बात की कोई गारंटी नहीं है कि |
usps_data |
डिलीवरी के लिए, फ़्लैग करने के ज़्यादा से ज़्यादा फ़्लैग. सिर्फ़ |
नतीजा
पते की पुष्टि करने के नतीजे और वेब पेज की जानकारी से जुड़ी खास जानकारी.
फ़ील्ड | |
---|---|
input_granularity |
input पते की जानकारी का लेवल. यह इनपुट पते को पार्स करने की वजह से है और पुष्टि करने के लिए कोई सिग्नल नहीं देता. पुष्टि सिग्नल के लिए नीचे उदाहरण के लिए, अगर इनपुट पते में कोई खास अपार्टमेंट नंबर शामिल है, तो |
validation_granularity |
जानकारी का लेवल, जिस लेवल पर एपीआई पते की पुष्टि कर सकता है. उदाहरण के लिए, हर पते के कॉम्पोनेंट की पुष्टि का नतीजा |
geocode_granularity |
यह कभी-कभी ऊपर दिए गए |
address_complete |
अगर पते का कोई समाधान नहीं होता है, तो कोई पता नहीं होने या पते के कॉम्पोनेंट मौजूद नहीं होने पर यह पता पूरा माना जाता है. ज़्यादा जानकारी के लिए, |
has_unconfirmed_components |
पते के कम से कम एक कॉम्पोनेंट को कैटगरी में नहीं रखा जा सकता और न ही उसकी पुष्टि की जा सकती है. जानकारी के लिए, |
has_inferred_components |
इनपुट में कम से कम एक पता कॉम्पोनेंट जोड़ा गया (जोड़ा गया) जो जानकारी में नहीं था. ज़्यादा जानकारी के लिए |
has_replaced_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 |
अन्य सभी विवरण, जिन्हें बकेट में एक साथ बकेट किया जाता है, क्योंकि वे डिलीवर नहीं किए जा सकते. |