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

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 पर सेट किया जाता है.

रेफ़रंस गाइड में, फ़ैसला और पता के तहत addressComplete देखें.

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

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

"verdict": {
    "inputGranularity": "PREMISE",
    "validationGranularity": "OTHER",
    "geocodeGranularity": "OTHER",
    "hasUnconfirmedComponents": true,
    "hasInferredComponents": true
}
रेफ़रंस गाइड में फ़ैसला देखें.

अगली संभावित कार्रवाई

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

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

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

रेफ़रंस गाइड में Address देखें.

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

रेफ़रंस गाइड में addressComponent देखें.

geocode प्रॉपर्टी

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

रेफ़रंस गाइड में Geocode देखें.

metadata प्रॉपर्टी

ऐसा हो सकता है कि Maps JavaScript API में Address Validation से प्रोसेस किए गए हर पते के लिए, यह प्रॉपर्टी अपने-आप न भरी जाए. हालांकि, इससे यह पता चलता है कि पता किस तरह का है: रिहायशी, कारोबार या पीओ बॉक्स.

Address Validation API की कवरेज और Address metadata के बारे में जानकारी देखें.

uspsData प्रॉपर्टी

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

अमेरिका के पतों को मैनेज करना और USPSData के लिए रेफ़रंस देखें.