गाइड

कॉन्फ़िडेंस स्कोर पर भरोसा करने से पहले उसे सही तरह से पढ़ें

किसी जियोकोडिंग परिणाम पर 0.0 और 1.0 के बीच का कॉन्फ़िडेंस मान एक सरल पास या फ़ेल संकेत जैसा दिखता है, लेकिन उसे ऐसे मानने से यह छूट जाता है कि वह असल में क्या मापता है।

कॉन्फ़िडेंस क्या मापता है

कॉन्फ़िडेंस यह दर्शाता है कि दिए गए इनपुट टेक्स्ट के आधार पर मैच कितना निश्चित है कि यही परिणाम वह है जिसकी ओर इनपुट इशारा कर रहा था। किसी अस्पष्ट या अजीब तरह से फ़ॉर्मैट किए गए इनपुट पर ऊँचे कॉन्फ़िडेंस स्कोर का भी यही मतलब है कि सिस्टम को अपने सबसे अच्छे अनुमान पर भरोसा है, यह नहीं कि इनपुट निश्चित रूप से सही था या स्थान निश्चित रूप से वैसा ही मौजूद है जैसा बताया गया।

GET /v1/forward?q=Main Street, Springfield&limit=1
{
  "status": "ok",
  "query": "Main Street, Springfield",
  "results": [
    {"formatted": "Main Street, Springfield, IL", "lat": 39.7817, "lon": -89.6501, "type": "address", "precision": "street", "confidence": 0.62, "place_id": "sp901", "components": {}}
  ]
}

यहाँ 0.62 का कॉन्फ़िडेंस इस तथ्य को दर्शाता है कि कई कस्बों का नाम Springfield है, इसलिए किसी एक ख़ास Springfield से सही मैच में भी यह अंतर्निहित अनिश्चितता रहती है कि क्या यही वह Springfield है जो इनपुट का मतलब था।

कॉन्फ़िडेंस बनाम प्रिसिज़न

ये दो अलग फ़ील्ड हैं जो दो अलग चीज़ें मापते हैं। प्रिसिज़न बताता है कि मैच कितना विशिष्ट है: मकान, सड़क या कोई मोटा स्तर। कॉन्फ़िडेंस बताता है कि सिस्टम अपने बनाए मैच को लेकर कितना निश्चित है। "house" प्रिसिज़न वाले परिणाम का कॉन्फ़िडेंस स्कोर भी मध्यम हो सकता है, अगर इनपुट इस बारे में अस्पष्ट था कि किस सड़क का कौन-सा मकान, और "street" प्रिसिज़न वाले परिणाम का कॉन्फ़िडेंस स्कोर ऊँचा हो सकता है, अगर मैच मोटा होते हुए भी असंदिग्ध था।

सीमा तय करना

कॉन्फ़िडेंस की सीमा इस आधार पर चुनें कि ग़लत परिणाम से आपको कितना नुकसान होगा। 0.8 या उससे ऊपर की सीमा किसी स्वचालित और महत्वपूर्ण काम के लिए सही है, जैसे बिना किसी मानवीय समीक्षा के शिपिंग लेबल अपने आप भरना। कम सीमा ऐसे काम के लिए उचित है जिसमें बाद में कोई व्यक्ति परिणाम जाँचता हो, जैसे पुष्टि के लिए ग्राहक को दिखाया गया सुझाव।

countries पैरामीटर के साथ मिलाना

ऊपर के Springfield उदाहरण जैसे अस्पष्ट मैच अक्सर तब हल हो जाते हैं जब आपको पहले से पता हो कि पता किस देश में होना चाहिए और आप countries पैरामीटर से खोज को सीमित करते हैं। इससे दूसरे लुकअप की ज़रूरत के बजाय पहली ही कोशिश में ऊँचे कॉन्फ़िडेंस वाले मैच की संभावना बढ़ जाती है।

लागत वही रहती है

कॉन्फ़िडेंस को सही तरीके से पढ़ने से लुकअप की लागत नहीं बदलती, दोनों तरह से एक ही अनुरोध। यह बदलता है कि आप परिणाम पर सही मात्रा में भरोसे के साथ कार्रवाई करते हैं या नहीं।

कॉन्फ़िडेंस एक विशिष्ट, सीमित संकेत है, सही होने की कोई सामान्य गारंटी नहीं, और इसे इसी तरह पढ़ने से किसी कमज़ोर मैच पर जल्दबाज़ी में कार्रवाई करने से बचा जा सकता है। फ़ील्ड की पूरी परिभाषाएँ फ़ॉरवर्ड जियोकोडिंग दस्तावेज़ में हैं।