इंडेक्स
AddressValidation
(इंटरफ़ेस)Address
(मैसेज)AddressComponent
(मैसेज)AddressComponent.ConfirmationLevel
(enum)AddressMetadata
(मैसेज)ComponentName
(मैसेज)Geocode
(मैसेज)LanguageOptions
(मैसेज)PlusCode
(मैसेज)ProvideValidationFeedbackRequest
(मैसेज)ProvideValidationFeedbackRequest.ValidationConclusion
(enum)ProvideValidationFeedbackResponse
(मैसेज)UspsAddress
(मैसेज)UspsData
(मैसेज)ValidateAddressRequest
(मैसेज)ValidateAddressResponse
(मैसेज)ValidationResult
(मैसेज)Verdict
(मैसेज)Verdict.Granularity
(enum)Verdict.PossibleNextAction
(enum)
AddressValidation
पतों की पुष्टि करने की सेवा.
ProvideValidationFeedback |
---|
पुष्टि करने के क्रम के नतीजे के बारे में सुझाव/राय दें. यह उसी पते की पुष्टि करने के लिए किए गए कॉल के क्रम के बाद किया जाने वाला आखिरी कॉल होना चाहिए. साथ ही, लेन-देन पूरा होने के बाद इसे कॉल किया जाना चाहिए. किसी पते की पूरी तरह से पुष्टि करने के लिए, |
ValidateAddress |
---|
किसी पते की पुष्टि करता है. |
पता
प्रोसेस किए गए पते की जानकारी. पोस्ट-प्रोसेसिंग में, पते के उन हिस्सों को ठीक करना शामिल है जिनमें स्पेलिंग की गड़बड़ी है. साथ ही, गलत हिस्सों को बदलना और छूटे हुए हिस्सों का अनुमान लगाना भी शामिल है.
फ़ील्ड | |
---|---|
formatted_address |
प्रोसेस किए गए पते को एक लाइन में फ़ॉर्मैट किया गया है. यह उस इलाके के पते को फ़ॉर्मैट करने के नियमों के मुताबिक है जहां पता मौजूद है. ध्यान दें: हो सकता है कि इस पते का फ़ॉर्मैट, |
postal_address |
प्रोसेस किए गए पते को डाक पते के तौर पर दिखाया जाता है. |
address_components[] |
बिना क्रम वाली सूची. फ़ॉर्मैट किए गए और सही किए गए पते के अलग-अलग कॉम्पोनेंट के साथ-साथ, पुष्टि की जानकारी. इससे, अलग-अलग कॉम्पोनेंट की पुष्टि की स्थिति की जानकारी मिलती है. पते के कॉम्पोनेंट किसी खास क्रम में नहीं होते. सूची में पते के कॉम्पोनेंट के क्रम के बारे में कोई अनुमान न लगाएं. |
missing_component_types[] |
ऐसे कॉम्पोनेंट जिनकी उम्मीद थी कि वे सही फ़ॉर्मैट में मेलिंग पते में मौजूद होंगे, लेकिन वे इनपुट में नहीं मिले और न ही उनका अनुमान लगाया जा सका. उदाहरण के लिए, "Boulder, Colorado, 80301, USA" जैसे इनपुट के लिए ध्यान दें: अगर आपको लगता है कि आपने पहले ही वह कॉम्पोनेंट उपलब्ध कराया है जो मौजूद नहीं है, तो आपको कॉम्पोनेंट टाइप मौजूद नहीं है वाला मैसेज दिख सकता है. उदाहरण के लिए, ऐसा तब हो सकता है, जब डाले गए पते में इमारत का नाम हो, लेकिन प्रॉपर्टी नंबर न हो. "渋谷区渋谷3丁目 Shibuya Stream" पते में, बिल्डिंग के नाम "Shibuya Stream" का कॉम्पोनेंट टाइप |
unconfirmed_component_types[] |
|
unresolved_tokens[] |
इनपुट में ऐसे टोकन जो हल नहीं किए जा सके. ऐसा हो सकता है कि यह कोई ऐसा इनपुट हो जिसे पते के मान्य हिस्से के तौर पर नहीं पहचाना गया हो. उदाहरण के लिए, "Parcel 0000123123 & 0000456456 Str # Guthrie Center IA 50115 US" जैसे इनपुट के लिए, हल नहीं किए गए टोकन |
AddressComponent
पते के किसी कॉम्पोनेंट को दिखाता है, जैसे कि सड़क, शहर या राज्य.
फ़ील्ड | |
---|---|
component_name |
इस कॉम्पोनेंट का नाम. |
component_type |
पते के कॉम्पोनेंट का टाइप. संभावित टाइप की सूची के लिए, दूसरी टेबल: Places सेवा से मिले अन्य टाइप देखें. |
confirmation_level |
इससे पता चलता है कि कॉम्पोनेंट सही है या नहीं. |
inferred |
इससे पता चलता है कि यह कॉम्पोनेंट इनपुट का हिस्सा नहीं था, लेकिन हमने इसे पते की जगह के लिए अनुमान लगाया है. साथ ही, हमारा मानना है कि इसे पूरे पते के लिए दिया जाना चाहिए. |
spell_corrected |
कॉम्पोनेंट के नाम में स्पेलिंग की गड़बड़ी को ठीक करने के बारे में बताता है. एपीआई हमेशा, स्पेलिंग के एक वैरिएंट से दूसरे वैरिएंट में हुए बदलावों को फ़्लैग नहीं करता. जैसे, "centre" को "center" में बदलने पर. यह हमेशा वर्तनी की सामान्य गलतियां भी फ़्लैग नहीं करता. जैसे, "Amphitheater Pkwy" को "Amphitheatre Pkwy" में बदलने पर. |
replaced |
इससे पता चलता है कि कॉम्पोनेंट के नाम को पूरी तरह से बदल दिया गया है. उदाहरण के लिए, गलत पिन कोड को पते के लिए सही पिन कोड से बदल दिया गया है. यह कोई कॉस्मेटिक बदलाव नहीं है. इनपुट कॉम्पोनेंट को बदलकर एक अलग कॉम्पोनेंट कर दिया गया है. |
unexpected |
इससे पता चलता है कि पते के जिस कॉम्पोनेंट का इस्तेमाल किया गया है वह दिए गए इलाके के डाक पते में मौजूद नहीं होना चाहिए. हमने इसे सिर्फ़ इसलिए बरकरार रखा है, क्योंकि यह इनपुट का हिस्सा था. |
ConfirmationLevel
पुष्टि के लेवल के लिए अलग-अलग वैल्यू.
Enums | |
---|---|
CONFIRMATION_LEVEL_UNSPECIFIED |
डिफ़ॉल्ट मान. इस वैल्यू का इस्तेमाल नहीं किया जाता. |
CONFIRMED |
हमने पुष्टि कर ली है कि यह कॉम्पोनेंट मौजूद है और यह पते के बाकी हिस्से के हिसाब से सही है. |
UNCONFIRMED_BUT_PLAUSIBLE |
इस कॉम्पोनेंट की पुष्टि नहीं की जा सकी, लेकिन हो सकता है कि यह मौजूद हो. उदाहरण के लिए, सड़क का ऐसा नंबर जो सड़क पर मौजूद घरों के नंबरों की मान्य सीमा में हो, लेकिन सड़क पर मौजूद किसी घर का नंबर न हो. |
UNCONFIRMED_AND_SUSPICIOUS |
इस कॉम्पोनेंट की पुष्टि नहीं की गई है और हो सकता है कि यह गलत हो. उदाहरण के लिए, कोई ऐसा इलाका जो पते के बाकी हिस्से से मेल नहीं खाता. |
AddressMetadata
प्रोसेस किए गए पते का मेटाडेटा. इस बात की कोई गारंटी नहीं है कि पते की पुष्टि करने वाले एपीआई को भेजे गए हर पते के लिए, metadata
पूरी तरह से पॉप्युलेट हो.
फ़ील्ड | |
---|---|
business |
इससे पता चलता है कि यह किसी कारोबार का पता है. अगर यह सेट नहीं है, तो इसका मतलब है कि वैल्यू अज्ञात है. |
po_box |
यह बताता है कि यह पीओ बॉक्स का पता है. अगर यह सेट नहीं है, तो इसका मतलब है कि वैल्यू अज्ञात है. |
residential |
यह बताता है कि यह घर का पता है. अगर यह सेट नहीं है, तो इसका मतलब है कि वैल्यू अज्ञात है. |
ComponentName
कॉम्पोनेंट के नाम के लिए एक रैपर.
फ़ील्ड | |
---|---|
text |
नाम का टेक्स्ट. उदाहरण के लिए, सड़क का नाम "5th Avenue" या सड़क का नंबर "1253". |
language_code |
BCP-47 भाषा कोड. अगर कॉम्पोनेंट का नाम किसी भाषा से जुड़ा नहीं है, तो यह एट्रिब्यूट मौजूद नहीं होगा. जैसे, सड़क का नंबर. |
जियोकोड
इसमें उस जगह की जानकारी होती है जिसे इनपुट के तौर पर इस्तेमाल करके, जगह की जानकारी हासिल की गई थी.
फ़ील्ड | |
---|---|
location |
इनपुट की जियोकोड की गई जगह. पते, अक्षांश/देशांतर निर्देशांक या प्लस कोड के बजाय, जगह के आईडी का इस्तेमाल करना बेहतर होता है. रूटिंग या ड्राइविंग दिशा-निर्देशों की गणना करते समय निर्देशांकों का उपयोग करने से, बिंदु उन निर्देशांकों के निकटतम सड़क पर स्नैप कर दिया जाएगा. ऐसा हो सकता है कि यह सड़क, मंज़िल तक तेज़ी से या सुरक्षित तरीके से न ले जाए. साथ ही, हो सकता है कि यह प्रॉपर्टी के ऐक्सेस पॉइंट के आस-पास न हो. इसके अलावा, जब किसी जगह को रिवर्स जियोकोड किया जाता है, तो इस बात की कोई गारंटी नहीं है कि मिला हुआ पता ओरिजनल पते से मेल खाएगा. |
plus_code |
|
bounds |
जियोकोड की गई जगह की सीमाएं. |
feature_size_meters |
जियोकोड की गई जगह का साइज़, मीटर में. यह भी जगह की सटीक जानकारी के बारे में बताता है. हालांकि, यह सेमेंटिक के बजाय, जगह के फ़िज़िकल साइज़ के बारे में बताता है. |
place_id |
इस इनपुट से जियोकोड की गई जगह का PlaceID. प्लेस आईडी के बारे में ज़्यादा जानने के लिए, यहां जाएं. |
place_types[] |
जगह का टाइप, जिसे इनपुट के ज़रिए जियोकोड किया गया है. उदाहरण के लिए, |
LanguageOptions
झलक: यह सुविधा, झलक (Pre-GA) के तौर पर उपलब्ध है. ऐसा हो सकता है कि Pre-GA के तहत आने वाले प्रॉडक्ट और सुविधाओं के लिए, आपको सीमित सहायता ही मिले. साथ ही, Pre-GA के तहत आने वाले प्रॉडक्ट और सुविधाओं में किए गए बदलाव, Pre-GA के अन्य वर्शन के साथ काम न करें. Pre-GA के तहत आने वाले प्रॉडक्ट और सुविधाओं पर, Google Maps Platform की सेवा की खास शर्तें लागू होती हैं. ज़्यादा जानकारी के लिए, लॉन्च के चरणों की जानकारी देखें.
इससे, Address Validation API को जवाब में ज़्यादा जानकारी शामिल करने में मदद मिलती है.
फ़ील्ड | |
---|---|
return_english_latin_address |
झलक: अंग्रेज़ी में |
PlusCode
प्लस कोड (http://plus.codes), जगह की जानकारी देने वाला एक रेफ़रंस है. इसका इस्तेमाल दो फ़ॉर्मैट में किया जाता है: ग्लोबल कोड, जो 14 मीटर x 14 मीटर (डिग्री का 1/8000वां हिस्सा) या उससे छोटे रेक्टैंगल की जानकारी देता है और कंपाउंड कोड, जो प्रीफ़िक्स को रेफ़रंस वाली जगह से बदल देता है.
फ़ील्ड | |
---|---|
global_code |
जगह का ग्लोबल (पूरा) कोड, जैसे कि "9FWM33GV+HQ". यह 1/8000 डिग्री से 1/8000 डिग्री (~14 से 14 मीटर) के इलाके को दिखाता है. |
compound_code |
जगह का कंपाउंड कोड, जैसे कि "33GV+HQ, Ramberg, Norway". इसमें ग्लोबल कोड का सफ़िक्स होता है और प्रीफ़िक्स को रेफ़रंस इकाई के फ़ॉर्मैट किए गए नाम से बदल दिया जाता है. |
ProvideValidationFeedbackRequest
पुष्टि करने के बारे में सुझाव/राय देने या शिकायत करने का अनुरोध.
फ़ील्ड | |
---|---|
conclusion |
ज़रूरी है. पुष्टि करने की कोशिशों के क्रम का नतीजा. अगर इस फ़ील्ड को |
response_id |
ज़रूरी है. उस जवाब का आईडी जिस पर यह सुझाव, राय या शिकायत दी गई है. यह पते की पुष्टि करने की कोशिशों की सीरीज़ में पहले जवाब का [response_id][google.maps.addressvalidation.v1.ValidateAddressRequest.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 |
पते की पहली लाइन. |
firm |
कंपनी का नाम. |
second_address_line |
पते की दूसरी लाइन. |
urbanization |
प्योर्तो रिको के शहर का नाम. |
city_state_zip_address_line |
शहर + राज्य + पिन कोड. |
city |
शहर का नाम. |
state |
राज्य का दो अक्षर वाला कोड. |
zip_code |
पिन कोड, जैसे कि 10009. |
zip_code_extension |
पिन कोड का चार अंकों वाला एक्सटेंशन, जैसे कि 5023. |
UspsData
पते के लिए USPS का डेटा. यह ज़रूरी नहीं है कि पते की पुष्टि करने वाले एपीआई को भेजे गए हर अमेरिकी या प्योर्तो रिको पते के लिए, uspsData
पूरी तरह से पॉप्युलेट हो. हमारा सुझाव है कि अगर आपने uspsData को जवाब के मुख्य हिस्से के तौर पर इस्तेमाल किया है, तो जवाब में बैकअप पते के फ़ील्ड इंटिग्रेट करें.
फ़ील्ड | |
---|---|
standardized_address |
USPS का स्टैंडर्ड पता. |
delivery_point_code |
डिलीवरी पॉइंट का दो अंकों वाला कोड |
delivery_point_check_digit |
डिलीवरी पॉइंट का चेक डिजिट. मशीन से स्कैन किए गए मेल के लिए, यह नंबर delivery_point_barcode के आखिर में जोड़ा जाता है. delivery_point_barcode, delivery_point_check_digit, पिन कोड, और ZIP+4 के सभी अंकों को जोड़ने पर, आपको 10 से भाग देने पर पूरी संख्या मिलनी चाहिए. |
dpv_confirmation |
डीपीवी की पुष्टि के लिए संभावित वैल्यू. एक वर्ण दिखाता है या कोई वैल्यू नहीं दिखाता.
|
dpv_footnote |
डिलीवरी पॉइंट की पुष्टि से जुड़े फ़ुटनोट. एक ही स्ट्रिंग में कई फ़ुटनोट जोड़े जा सकते हैं.
|
dpv_cmra |
इससे पता चलता है कि पता, सीएमआरए (कॉमर्शियल मेल रिसीविंग एजेंसी) है या नहीं. सीएमआरए, क्लाइंट के लिए मेल पाने वाला निजी कारोबार होता है. एक वर्ण दिखाता है.
|
dpv_vacant |
क्या यह जगह खाली है? एक वर्ण दिखाता है.
|
dpv_no_stat |
क्या यह कोई ऐसा पता है जिसका कोई स्टेटस नहीं है या यह कोई चालू पता है? ऐसे पते जिन पर लगातार कोई नहीं रहता या जिन पर यूएसपीएस सेवा नहीं देता उन्हें कोई स्टेटस नहीं दिया जाता. एक वर्ण दिखाता है.
|
dpv_no_stat_reason_code |
NoStat का टाइप बताता है. वजह का कोड, int के तौर पर दिखाता है.
|
dpv_drop |
फ़्लैग से पता चलता है कि मेल, किसी साइट पर मौजूद एक ही रिसीविंग पते पर डिलीवर किया गया है. एक वर्ण दिखाता है.
|
dpv_throwback |
इससे पता चलता है कि मेल, सड़क के पते पर डिलीवर नहीं किया जाता. एक वर्ण दिखाता है.
|
dpv_non_delivery_days |
इस फ़्लैग से पता चलता है कि मेल की डिलीवरी, हफ़्ते के हर दिन नहीं की जाती. एक वर्ण दिखाता है.
|
dpv_non_delivery_days_values |
इंटिज़र, जो उन दिनों की पहचान करता है जब डिलीवरी नहीं की जाती. बिट फ़्लैग का इस्तेमाल करके, इसकी जानकारी देखी जा सकती है: 0x40 – रविवार को डिलीवरी नहीं की जाती 0x20 – सोमवार को डिलीवरी नहीं की जाती 0x10 – मंगलवार को डिलीवरी नहीं की जाती 0x08 – बुधवार को डिलीवरी नहीं की जाती 0x04 – गुरुवार को डिलीवरी नहीं की जाती 0x02 – शुक्रवार को डिलीवरी नहीं की जाती 0x01 – शनिवार को डिलीवरी नहीं की जाती |
dpv_no_secure_location |
इस फ़्लैग से पता चलता है कि दरवाज़े को ऐक्सेस किया जा सकता है. हालांकि, सुरक्षा से जुड़ी समस्याओं की वजह से पैकेज नहीं छोड़ा जाएगा. एक वर्ण दिखाता है.
|
dpv_pbsa |
इससे पता चलता है कि पता, पीबीएसए रिकॉर्ड से मेल खाता है. एक वर्ण दिखाता है.
|
dpv_door_not_accessible |
इस फ़्लैग से उन पतों के बारे में पता चलता है जहां यूएसपीएस, मेल डिलीवर करने के लिए दरवाज़ा नहीं खटखटा सकता. एक वर्ण दिखाता है.
|
dpv_enhanced_delivery_code |
इससे पता चलता है कि पते के लिए एक से ज़्यादा डीपीवी रिटर्न कोड मान्य हैं. एक वर्ण दिखाता है.
|
carrier_route |
कैरियर का रास्ता कोड. चार वर्णों वाला कोड, जिसमें एक अक्षर का प्रीफ़िक्स और तीन अंकों वाला रूट डिज़ाइनेटर होता है. प्रीफ़िक्स:
|
carrier_route_indicator |
कैरियर के रास्ते की दर को क्रम से लगाने वाला इंडिकेटर. |
ews_no_match |
डिलीवरी का पता मैच हो सकता है, लेकिन ईडब्ल्यूएस फ़ाइल से पता चलता है कि जल्द ही एकदम मैच होने वाला पता उपलब्ध होगा. |
post_office_city |
मुख्य पोस्ट ऑफ़िस का शहर. |
post_office_state |
मुख्य पोस्ट ऑफ़िस का राज्य. |
abbreviated_city |
शहर का छोटा नाम. |
fips_county_code |
एफ़आईपीएस के हिसाब से, काउंटी का कोड. |
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 |
यह इंडिकेटर बताता है कि अनुरोध को CASS प्रोसेस किया गया है. |
ValidateAddressRequest
किसी पते की पुष्टि करने का अनुरोध.
फ़ील्ड | |
---|---|
address |
ज़रूरी है. पते की पुष्टि की जा रही है. बिना फ़ॉर्मैट किए गए पते, इस इनपुट में मौजूद फ़ील्ड की कुल लंबाई 280 वर्णों से ज़्यादा नहीं होनी चाहिए. जिन देशों/इलाकों में यह सुविधा उपलब्ध है उनकी जानकारी यहां देखें. इनपुट पते में मौजूद Address Validation API, |
previous_response_id |
पते की पुष्टि के लिए किए गए पहले अनुरोध में, यह फ़ील्ड खाली होना चाहिए. अगर किसी एक पते की पूरी तरह से पुष्टि करने के लिए ज़्यादा अनुरोध ज़रूरी हैं, तो पुष्टि करने के क्रम में मिले पहले जवाब से, हर फ़ॉलोअप अनुरोध में इस फ़ील्ड को |
enable_usps_cass |
USPS CASS के साथ काम करने वाला मोड चालू करता है. इससे हमारा सुझाव है कि आप कॉम्पोनेंट वाले |
language_options |
ज़रूरी नहीं. झलक: यह सुविधा, झलक (Pre-GA) के तौर पर उपलब्ध है. ऐसा हो सकता है कि Pre-GA के तहत आने वाले प्रॉडक्ट और सुविधाओं के लिए, आपको सीमित सहायता ही मिले. साथ ही, Pre-GA के तहत आने वाले प्रॉडक्ट और सुविधाओं में किए गए बदलाव, Pre-GA के अन्य वर्शन के साथ काम न करें. Pre-GA के तहत आने वाले प्रॉडक्ट और सुविधाओं पर, Google Maps Platform की सेवा की खास शर्तें लागू होती हैं. ज़्यादा जानकारी के लिए, लॉन्च के चरणों की जानकारी देखें. इससे, Address Validation API को जवाब में ज़्यादा जानकारी शामिल करने में मदद मिलती है. |
session_token |
ज़रूरी नहीं. बिलिंग के लिए, अपने-आप जानकारी भरने वाले सेशन की पहचान करने वाली स्ट्रिंग. यह यूआरएल और फ़ाइल के नाम की सुरक्षित base64 स्ट्रिंग होनी चाहिए. इसमें ज़्यादा से ज़्यादा 36 ASCII वर्ण होने चाहिए. ऐसा न करने पर, INVALID_ARGUMENT गड़बड़ी का मैसेज दिखता है. जब उपयोगकर्ता ऑटोमैटिक भरने की सुविधा के लिए कोई क्वेरी डालता है, तब सेशन शुरू होता है. यह तब खत्म होता है, जब वह कोई जगह चुनता है और जगह की जानकारी या पते की पुष्टि करने के लिए कॉल करता है. हर सेशन में, अपने-आप पूरा नाम लिखने की सुविधा से जुड़ी कई क्वेरी हो सकती हैं. इसके बाद, जगह की जानकारी या पते की पुष्टि करने का एक अनुरोध किया जा सकता है. किसी सेशन में हर अनुरोध के लिए इस्तेमाल किए गए क्रेडेंशियल, एक ही Google Cloud Console प्रोजेक्ट से होने चाहिए. सेशन खत्म होने के बाद, टोकन मान्य नहीं रहता. इसलिए, आपके ऐप्लिकेशन को हर सेशन के लिए नया टोकन जनरेट करना होगा. अगर ध्यान दें: पते की पुष्टि करने की सुविधा का इस्तेमाल, सिर्फ़ ऑटोकंप्लीट (नया) एपीआई वाले सेशन में किया जा सकता है, न कि ऑटोकंप्लीट एपीआई वाले सेशन में. ज़्यादा जानकारी के लिए, https://developers.google.com/maps/documentation/places/web-service/session-pricing देखें. |
ValidateAddressResponse
पते की पुष्टि करने के अनुरोध का जवाब.
फ़ील्ड | |
---|---|
result |
पते की पुष्टि का नतीजा. |
response_id |
वह यूनीक आईडी जो इस रिस्पॉन्स की पहचान करता है. अगर पते की फिर से पुष्टि करनी है, तो नए अनुरोध में यह यूयूआईडी होना चाहिए. |
ValidationResult
किसी पते की पुष्टि करने का नतीजा.
फ़ील्ड | |
---|---|
verdict |
पूरे नतीजे के लिए फ़्लैग |
address |
जियोकोड के बजाय, पते की जानकारी. |
geocode |
उस जगह की जानकारी जहां पते को जियोकोड किया गया है. |
metadata |
ईमेल डिलीवर करने से जुड़ी अन्य जानकारी. इस बात की कोई गारंटी नहीं है कि पते की पुष्टि करने वाले एपीआई को भेजे गए हर पते के लिए, |
usps_data |
USPS की ओर से डिलीवरी से जुड़े अतिरिक्त फ़्लैग. यह सुविधा सिर्फ़ |
english_latin_address |
झलक: यह सुविधा, झलक (Pre-GA) के तौर पर उपलब्ध है. ऐसा हो सकता है कि Pre-GA के तहत आने वाले प्रॉडक्ट और सुविधाओं के लिए, आपको सीमित सहायता ही मिले. साथ ही, Pre-GA के तहत आने वाले प्रॉडक्ट और सुविधाओं में किए गए बदलाव, Pre-GA के अन्य वर्शन के साथ काम न करें. Pre-GA के तहत आने वाले प्रॉडक्ट और सुविधाओं पर, Google Maps Platform की सेवा की खास शर्तें लागू होती हैं. ज़्यादा जानकारी के लिए, लॉन्च के चरणों की जानकारी देखें. पते का अंग्रेज़ी में अनुवाद. अनुवाद किए गए पतों को एपीआई इनपुट के तौर पर फिर से इस्तेमाल नहीं किया जा सकता. यह सेवा, उपयोगकर्ता को उसकी भाषा में सवालों के जवाब देती है, ताकि वह मूल रूप से दिए गए पते की पुष्टि कर सके या उसे अस्वीकार कर सके. अगर पते के किसी हिस्से का अंग्रेज़ी में अनुवाद नहीं किया गया है, तो यह सेवा उस हिस्से को किसी ऐसी दूसरी भाषा में दिखाती है जिसमें लैटिन स्क्रिप्ट का इस्तेमाल किया जाता है. वैकल्पिक भाषा चुनने का तरीका जानने के लिए, यहां जाएं. अगर पते के किसी हिस्से का अनुवाद नहीं किया गया है या उसे लैटिन स्क्रिप्ट का इस्तेमाल करने वाली किसी भाषा में ट्रांसलिटरेट नहीं किया गया है, तो यह सेवा उस हिस्से को पते से जुड़ी स्थानीय भाषा में दिखाती है.
ध्यान दें: |
नतीजा
पते की पुष्टि के नतीजे और जियोकोड के बारे में खास जानकारी.
फ़ील्ड | |
---|---|
input_granularity |
इनपुट पते की जानकारी कितनी सटीक है. यह इनपुट पते को पार्स करने का नतीजा है. इससे पुष्टि करने के लिए कोई सिग्नल नहीं मिलता. पुष्टि करने वाले सिग्नल के लिए, नीचे दिया गया उदाहरण के लिए, अगर इनपुट पते में किसी अपार्टमेंट का नंबर शामिल है, तो यहां |
validation_granularity |
प्रोसेस किए गए पते के लिए ज़्यादा जानकारी का लेवल, जिसकी एपीआई पूरी तरह से पुष्टि कर सकता है. उदाहरण के लिए, पते के हर कॉम्पोनेंट की पुष्टि का नतीजा |
geocode_granularity |
यह कभी-कभी ऊपर दिए गए |
address_complete |
प्रोसेस किए गए पते को तब पूरा माना जाता है, जब उसमें कोई ऐसा टोकन न हो जिसे हल न किया जा सका हो. साथ ही, उसमें कोई ऐसा कॉम्पोनेंट न हो जो अचानक से जुड़ा हो या जो मौजूद न हो. अगर यह सेट नहीं है, तो इसका मतलब है कि वैल्यू |
has_unconfirmed_components |
पते के कम से कम एक कॉम्पोनेंट की कैटगरी तय नहीं की जा सकती या उसकी पुष्टि नहीं की जा सकती. ज़्यादा जानकारी के लिए, |
has_inferred_components |
पते का कम से कम एक ऐसा कॉम्पोनेंट जोड़ा गया है जो इनपुट में नहीं था. ज़्यादा जानकारी के लिए |
has_replaced_components |
पते का कम से कम एक कॉम्पोनेंट बदला गया था. ज़्यादा जानकारी के लिए, |
possible_next_action |
झलक: यह सुविधा, झलक (Pre-GA) के तौर पर उपलब्ध है. ऐसा हो सकता है कि Pre-GA के तहत आने वाले प्रॉडक्ट और सुविधाओं के लिए, आपको सीमित सहायता ही मिले. साथ ही, Pre-GA के तहत आने वाले प्रॉडक्ट और सुविधाओं में किए गए बदलाव, Pre-GA के अन्य वर्शन के साथ काम न करें. Pre-GA के तहत आने वाले प्रॉडक्ट और सुविधाओं पर, Google Maps Platform की सेवा की खास शर्तें लागू होती हैं. ज़्यादा जानकारी के लिए, लॉन्च के चरणों की जानकारी देखें. एपीआई के जवाब की खास जानकारी देता है. इससे, आगे की संभावित कार्रवाई तय करने में मदद मिलती है. यह फ़ील्ड, एपीआई रिस्पॉन्स के अन्य फ़ील्ड से लिया जाता है. इसे पते के सही होने या डिलीवरी की गारंटी के तौर पर नहीं माना जाना चाहिए. ज़्यादा जानकारी के लिए, पुष्टि करने का लॉजिक बनाएं लेख पढ़ें. |
has_spell_corrected_components |
पते के कम से कम एक कॉम्पोनेंट की स्पेलिंग ठीक की गई थी. ज़्यादा जानकारी के लिए, |
जानकारी का स्तर
पते या जियोकोड में अलग-अलग तरह की जानकारी हो सकती है. पते के बारे में ज़्यादा जानकारी देने के लिए इस्तेमाल किए जाने पर, ये वैल्यू बताती हैं कि पता, मेलिंग डेस्टिनेशन की कितनी बारीक जानकारी देता है. उदाहरण के लिए, "123 Main Street, Redwood City, CA, 94061" जैसे पते से PREMISE
की पहचान होती है, जबकि "Redwood City, CA, 94061" जैसे पते से LOCALITY
की पहचान होती है. हालांकि, अगर हमें Redwood City में "123 Main Street" का जियोकोड नहीं मिलता है, तो हो सकता है कि दिया गया जियोकोड LOCALITY
लेवल का हो. भले ही, पता ज़्यादा जानकारी वाला हो.
Enums | |
---|---|
GRANULARITY_UNSPECIFIED |
डिफ़ॉल्ट मान. इस वैल्यू का इस्तेमाल नहीं किया जाता. |
SUB_PREMISE |
बिल्डिंग के लेवल से नीचे का नतीजा, जैसे कि अपार्टमेंट. |
PREMISE |
बिल्डिंग-लेवल का नतीजा. |
PREMISE_PROXIMITY |
ऐसा जियोकोड जो पते की बिल्डिंग-लेवल की जगह की अनुमानित जानकारी देता है. |
BLOCK |
पता या जियोकोड से किसी ब्लॉक का पता चलता है. इसका इस्तेमाल सिर्फ़ उन इलाकों में किया जाता है जहां ब्लॉक-लेवल पर पते दिए जाते हैं. जैसे, जापान. |
ROUTE |
जियोकोड या पता, सड़क, रास्ता या हाइवे जैसे रास्ते के बारे में ज़्यादा जानकारी देता है. |
OTHER |
अन्य सभी जानकारी, जिन्हें एक साथ बकेट में रखा जाता है, क्योंकि उन्हें डिलीवर नहीं किया जा सकता. |
PossibleNextAction
झलक: यह सुविधा, झलक (Pre-GA) के तौर पर उपलब्ध है. ऐसा हो सकता है कि Pre-GA के तहत आने वाले प्रॉडक्ट और सुविधाओं के लिए, आपको सीमित सहायता ही मिले. साथ ही, Pre-GA के तहत आने वाले प्रॉडक्ट और सुविधाओं में किए गए बदलाव, Pre-GA के अन्य वर्शन के साथ काम न करें. Pre-GA के तहत आने वाले प्रॉडक्ट और सुविधाओं पर, Google Maps Platform की सेवा की खास शर्तें लागू होती हैं. ज़्यादा जानकारी के लिए, लॉन्च के चरणों की जानकारी देखें.
एपीआई के रिस्पॉन्स के आधार पर, आगे की संभावित कार्रवाइयां.
Enums | |
---|---|
POSSIBLE_NEXT_ACTION_UNSPECIFIED |
डिफ़ॉल्ट मान. इस वैल्यू का इस्तेमाल नहीं किया जाता. |
FIX |
एपीआई रिस्पॉन्स के एक या उससे ज़्यादा फ़ील्ड से पता चलता है कि प्रोसेस किए गए पते में कोई समस्या है. उदाहरण के लिए, verdict.validation_granularity OTHER है. अपने ग्राहक से पते में बदलाव करने के लिए कहने से, पते की क्वालिटी को बेहतर बनाने में मदद मिल सकती है. |
CONFIRM_ADD_SUBPREMISES |
एपीआई के जवाब से पता चलता है कि प्रोसेस किए गए पते में सब-प्राइमिस मौजूद नहीं है. अपने ग्राहक से पते की समीक्षा करने और यूनिट नंबर जोड़ने के लिए कहने से, पते की क्वालिटी को बेहतर बनाने में मदद मिल सकती है. प्रोसेस किए गए पते में, दूसरी छोटी समस्याएं भी हो सकती हैं. ध्यान दें: यह वैल्यू सिर्फ़ अमेरिका के पतों के लिए दिख सकती है. |
CONFIRM |
एपीआई रिस्पॉन्स के एक या उससे ज़्यादा फ़ील्ड से पता चलता है कि प्रोसेस किए गए पते में कुछ छोटी समस्याएं हो सकती हैं. उदाहरण के लिए, postal_code पते का कॉम्पोनेंट replaced था. अपने ग्राहक से पते की समीक्षा करने के लिए कहने से, पते की क्वालिटी को बेहतर बनाने में मदद मिल सकती है. |
ACCEPT |
एपीआई रिस्पॉन्स में ऐसे सिग्नल शामिल नहीं हैं जिनसे यह पता चलता हो कि PossibleNextAction की किसी अन्य वैल्यू का इस्तेमाल किया जाना चाहिए. आपके पास अपने ग्राहक से फिर से पूछे बिना, पते को प्रोसेस करने के बाद दिए गए पते का इस्तेमाल करने का विकल्प है. हालांकि, इससे यह गारंटी नहीं मिलती कि पता मान्य है और उसमें अब भी सुधार किए जा सकते हैं. यह आपकी ज़िम्मेदारी है कि आप जोखिम का आकलन करके यह तय करें कि ग्राहक को सूचना देनी है या नहीं. साथ ही, अगर देनी है, तो कैसे देनी है. |