सीमा तक पहुँचने से पहले अपनी कुंजी के उपयोग पर नज़र रखें
काम के साथ-साथ अपने कोटा हेडर देखते रहने से पता चलता है कि कब सीमा करीब आ रही है, किसी अनुरोध के असल में अस्वीकार होने से काफ़ी पहले।
अधूरे पते का पिन कोड पता करें
जो ग्राहक पिन कोड का फ़ील्ड खाली छोड़ देता है, ज़रूरी नहीं कि उसने आपको खराब डेटा दिया हो। फ़ॉरवर्ड जियोकोडिंग आम तौर पर बाकी पते से वह कमी भर सकती है।
अधूरा पता भेजना
आपके पास जो भी टेक्स्ट है, कम से कम सड़क और शहर, उसे /v1/forward पर भेजें। परिणाम के components ऑब्जेक्ट में सबसे अच्छे मिलान का पिन कोड शामिल होता है, भले ही इनपुट में उसका ज़िक्र न हो।
GET /v1/forward?q=1600 Pennsylvania Avenue, Washington&limit=1{
"status": "ok",
"query": "1600 Pennsylvania Avenue, Washington",
"results": [
{
"formatted": "1600 Pennsylvania Avenue NW, Washington, DC 20500",
"lat": 38.8977,
"lon": -77.0365,
"type": "address",
"precision": "house",
"confidence": 0.97,
"place_id": "def456",
"components": {"postcode": "20500", "city": "Washington", "region": "DC", "country": "US"}
}
]
}कम जानकारी वाला एक उदाहरण, और यह क्यों मायने रखता है
हर पता इतना पूरा नहीं होता। सिर्फ़ शहर और क्षेत्र वाली क्वेरी, जैसे "Springfield, Illinois", फिर भी परिणाम लौटा सकती है, लेकिन components में पिन कोड किसी एक इमारत के बजाय पूरे शहर को कवर करेगा, और precision फ़ील्ड में "house" से मोटा कोई स्तर होगा। यह फ़र्क तब मायने रखता है जब आप लौटाए गए पिन कोड को सिर्फ़ क्षेत्रीय अनुमान के लिए उपयोग करने के बजाय शिपिंग लेबल पर छापने की योजना बना रहे हों, क्योंकि शहर-स्तर का पिन कोड वह गारंटी नहीं देता जो मकान-स्तर का देता है।
परिणाम पर भरोसा करना
लौटाए गए पिन कोड को भरोसेमंद मानने से पहले precision और confidence फ़ील्ड जाँचें। उच्च confidence स्कोर के साथ "house" precision का मतलब है कि मिलान इतना विशिष्ट था कि पिन कोड के मान पर सीधे भरोसा किया जा सके। मोटी precision, जैसे सड़क या शहर स्तर का मिलान, का मतलब है कि पिन कोड बड़े इलाके को कवर करता है और हो सकता है वह ग्राहक के इरादे वाले सटीक पते से मेल न खाए।
इस लुकअप की लागत
यह एक ही लुकअप है, एक पते के लिए आपके दैनिक कोटा से एक अनुरोध। बिना पिन कोड के आने वाले हर चेकआउट या साइन अप फ़ॉर्म सबमिशन के लिए ऐसा करना सामान्य उपयोग है और यह शायद ही कभी उन प्रतिदिन 2,500 मुफ़्त अनुरोधों के करीब पहुँचेगा जो कुंजी के साथ, या बिना कुंजी के किसी एक IP पते से, हर दिन शामिल हैं।
जब कोई अच्छा मिलान न हो
खाली results ऐरे, या कम confidence स्कोर वाला परिणाम, का मतलब है कि पता हल करने के लिए बहुत अस्पष्ट था। ऐसे में अनुमान लगाने के बजाय ग्राहक से सीधे पिन कोड पूछें, क्योंकि शिपिंग लेबल पर गलत पिन कोड खाली पिन कोड से ज़्यादा परेशानी पैदा करता है।
एक असामान्य मामला जिसकी योजना बनानी चाहिए
कुछ देश पिन कोड का उपयोग बिल्कुल नहीं करते, या इतने असंगत ढंग से करते हैं कि किसी परिणाम के components ऑब्जेक्ट में यह फ़ील्ड होता ही नहीं। छूटे हुए postcode फ़ील्ड को अपने आप में गलती न मानें: पहले components ऑब्जेक्ट में देश जाँचें, और पंक्ति को समीक्षा के लिए तभी चिह्नित करें जब वह देश ऐसा हो जहाँ आम तौर पर पिन कोड की उम्मीद की जाती है।
एक संबंधित जाँच
एक बार आपके पास संभावित पिन कोड हो, तो उस कोड और components ऑब्जेक्ट के देश के साथ /v1/postcode पर सीधी कॉल उसे स्वतंत्र रूप से दोबारा जाँचने का तेज़ तरीका है, जो खास तौर पर तब उपयोगी है जब मूल फ़ॉरवर्ड जियोकोडिंग का confidence स्पष्ट रूप से ऊँचा या स्पष्ट रूप से नीचा होने के बजाय सीमा पर था।
इस तरह छूटा हुआ पिन कोड भरने से एक फ़ॉर्म फ़ील्ड और ग्राहक के साथ एक अतिरिक्त आदान-प्रदान बचता है। फ़ील्ड की पूरी परिभाषाएँ पिन कोड लुकअप दस्तावेज़ और फ़ॉरवर्ड जियोकोडिंग दस्तावेज़ में हैं।