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

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 को भेजे गए पते से, कितनी जानकारी कैप्चर की गई है. अनुरोध में पते की जानकारी के लेवल से, पुष्टि के जवाब में पते की जानकारी का लेवल तय होता है. उदाहरण के लिए, अगर किसी पते में inputGranularity की वैल्यू PREMISE से कम है, तो आम तौर पर validationGranularity की वैल्यू PREMISE से कम नहीं होती.
• 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 में Address Validation की मदद से प्रोसेस किए गए हर पते के लिए, यह प्रॉपर्टी न भरी गई हो. हालांकि, इससे यह पता चलता है कि पता किस तरह का है. जैसे, रिहायशी, कारोबार या पीओ बॉक्स.

uspsData प्रॉपर्टी

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