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

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 से कम है, तो आम तौर पर उसे validationGranularity से PREMISE लेवल पर नहीं ले जाया जाता.inputGranularity
  • 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 API की कवरेज और Address metadata के बारे में जानकारी देखें.

uspsData प्रॉपर्टी

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

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