पते की पुष्टि से जुड़े बुनियादी जवाब को समझना

Address Validation API के रिस्पॉन्स में, ये टॉप-लेवल प्रॉपर्टी शामिल होती हैं:

{
  // Address details determined by the API.
  "address": {},
  // Validation verdict.
  "verdict": {},
  // The geocode generated for the input address.
  "geocode": {},
  // Information indicating if the address is a business, residence, etc.
  "metadata": {},
  // Information about the address from the US Postal Service
  // ("US" and "PR" addresses only).
  "uspsData": {},
  // A unique identifier generated for every request to the API.
  "responseId": "ID"
}

verdict प्रॉपर्टी

verdict प्रॉपर्टी, पते की पुष्टि करने के नतीजों के बारे में खास जानकारी देती है. पते की जांच करने का लॉजिक बनाते समय, इस प्रॉपर्टी का आकलन सबसे पहले किया जाना चाहिए. यह प्रॉपर्टी, आउटपुट पते की क्वालिटी के आधार पर कई तरह के फ़ील्ड दिखा सकती है. उदाहरण के लिए, यहां अच्छी क्वालिटी वाले पते की verdict प्रॉपर्टी दिखाई गई है. इससे इस खास अनुरोध के लिए, ये फ़ील्ड मिलते हैं:

"verdict": {
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "possibleNextAction": "ACCEPT",
  "addressComplete": true,
  "hasUnconfirmedComponents": false,
  "hasInferredComponents": true,
  "hasReplacedComponents": false
}

यहां दिए गए सेक्शन में, verdict प्रॉपर्टी के सभी फ़ील्ड की खास जानकारी दी गई है.

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

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

verdict प्रॉपर्टी, ये ग्रेन्यूलैरिटी सिग्नल दिखाती है:

• inputGranularity — इससे, Maps JavaScript API में Address Validation को भेजे गए पते से मिली जानकारी के लेवल के बारे में पता चलता है. अनुरोध में पते की जानकारी के लेवल से, पुष्टि के जवाब में पते की जानकारी के लेवल पर असर पड़ता है. उदाहरण के लिए, अगर किसी पते में PREMISE लेवल से नीचे inputGranularity लेवल है, तो आम तौर पर उसे PREMISE लेवल में validationGranularity नहीं किया जाता.
• validationGranularity — यह वह ग्रेन्यूलैरिटी लेवल है जिस पर Maps JavaScript API में मौजूद Address Validation, पते की पूरी तरह से पुष्टि कर सकती है. ज़्यादातर मामलों में, PREMISE या SUB_PREMISE के ग्रैन्युलैरिटी लेवल से पता चलता है कि पता सही है और इस पर डिलीवरी की जा सकती है.
• geocodeGranularity — इससे पते से जुड़े जियोकोड की जानकारी के लेवल के बारे में पता चलता है. उदाहरण के लिए, Google के रिकॉर्ड में अपार्टमेंट नंबर की जानकारी हो सकती है. हालांकि, बड़े अपार्टमेंट कॉम्प्लेक्स में उस अपार्टमेंट की सटीक जगह की जानकारी नहीं होती. इस मामले में, validationGranularity की वैल्यू SUB_PREMISE है, लेकिन geocodeGranularity की वैल्यू PREMISE है.

पते की पूरी जानकारी

फ़ैसले में addressComplete प्रॉपर्टी को, अच्छी क्वालिटी वाले पते के सिग्नल के तौर पर दिखाया जाता है. इसका मतलब है कि इसमें कोई भी कॉम्पोनेंट मौजूद है, जिसका समाधान नहीं किया गया है या जो उम्मीद के मुताबिक नहीं है:

"verdict": {
    "inputGranularity": "PREMISE",
    "validationGranularity": "PREMISE",
    "geocodeGranularity": "PREMISE",
    "addressComplete": true
}

अगर पते में कोई कॉम्पोनेंट मौजूद नहीं है, हल नहीं किया गया है या अनचाहा है, तो फ़ील्ड को false पर सेट किया जाता है.

पते की क्वालिटी

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

"verdict": {
    "inputGranularity": "PREMISE",
    "validationGranularity": "OTHER",
    "geocodeGranularity": "OTHER",
    "hasUnconfirmedComponents": true,
    "hasInferredComponents": true
}

अगली कार्रवाई

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

address और addressComponent प्रॉपर्टी

address प्रॉपर्टी, अनुरोध में दिए गए प्रोसेस किए गए पते के लिए फ़ॉर्मैटिंग उपलब्ध कराती है. साथ ही, पते के कॉम्पोनेंट-लेवल की खास जानकारी भी देती है. इसमें पते के गलत स्पेलिंग वाले हिस्से, बदले गए गलत हिस्से, और अनुमानित तौर पर जोड़े गए हिस्से शामिल हैं.

addressComponent प्रॉपर्टी, address का सबकॉम्पोनेंट है. यह पते के उन एलिमेंट या कॉम्पोनेंट की पूरी सूची दिखाता है जिन्हें Maps JavaScript API में मौजूद Address Validation ने प्रोसेस किया है. एपीआई, हर कॉम्पोनेंट फ़ील्ड की पहचान उसके नाम, टाइप, और पुष्टि के लेवल से करता है.

geocode प्रॉपर्टी

geocode प्रॉपर्टी, इनपुट किए गए पते से जुड़ी जियोकोड की गई जगह की जानकारी देती है. इस प्रॉपर्टी से, जगह की जानकारी मिलती है. जैसे, इसका प्लेस आईडी.

metadata प्रॉपर्टी

Maps JavaScript API में पता पुष्टि करने की सुविधा से प्रोसेस किए गए हर पते के लिए, यह प्रॉपर्टी नहीं भरी जा सकती. हालांकि, इससे यह पता चलता है कि पता, घर, कारोबार या पीओ बॉक्स का है.

uspsData प्रॉपर्टी

यह प्रॉपर्टी, अमेरिका के डाक पतों के लिए काम की जानकारी देती है. हालांकि, इस बात की गारंटी नहीं है कि सेवा से पुष्टि किए गए हर पते के लिए, यह फ़ील्ड पूरी तरह से भरा गया हो. इसलिए, आपको सिर्फ़ इस प्रॉपर्टी पर भरोसा नहीं करना चाहिए. इसके बजाय, verdict और address की भी जांच करनी चाहिए.