सीमा तक पहुँचने से पहले अपनी कुंजी के उपयोग पर नज़र रखें
काम के साथ-साथ अपने कोटा हेडर देखते रहने से पता चलता है कि कब सीमा करीब आ रही है, किसी अनुरोध के असल में अस्वीकार होने से काफ़ी पहले।
पतों की स्प्रेडशीट को एक ही बैच अनुरोध में जियोकोड करें
पतों से भरी स्प्रेडशीट के लिए लूप की ज़रूरत नहीं है। My Geocode का हर एंडपॉइंट क्वेरी पैरामीटर की जगह JSON ऐरे वाला POST अनुरोध स्वीकार करता है, और फ़ॉरवर्ड जियोकोडिंग एंडपॉइंट पतों का पूरा कॉलम एक साथ ले लेगा, और हर पंक्ति के लिए एक जियोकोड किया गया परिणाम उसी क्रम में लौटाएगा जिसमें आपने उन्हें भेजा था।
अनुरोध बनाना
अपनी स्प्रेडशीट से पते वाला कॉलम स्ट्रिंग के सादे ऐरे के रूप में एक्सपोर्ट करें, फिर उसे /v1/forward पर POST करें। ऐरे के हर आइटम को उसका अपना लुकअप माना जाता है और वह अपना परिणाम लौटाता है, उसी क्रम में जिसमें आपने उन्हें भेजा था।
POST /v1/forward
Content-Type: application/json
["221B Baker Street, London", "1600 Pennsylvania Avenue, Washington"]{
"status": "ok",
"results": [
{"formatted": "221B Baker Street, London, UK", "lat": 51.5237, "lon": -0.1585, "type": "address", "precision": "house", "confidence": 0.95, "place_id": "abc123", "components": {}},
{"formatted": "1600 Pennsylvania Avenue, Washington, DC", "lat": 38.8977, "lon": -77.0365, "type": "address", "precision": "house", "confidence": 0.97, "place_id": "def456", "components": {}}
]
}कई देशों वाली सूची में परिणामों को सीमित करना
अगर आपकी स्प्रेडशीट में कई देश हैं, तो स्ट्रिंग का सादा ऐरे अब भी काम करता है, लेकिन अलग-अलग देशों में एक जैसे सड़क नामों का गलत देश में रिज़ॉल्व हो जाना संभव है। जहाँ आपकी स्प्रेडशीट में देश का अलग कॉलम है, वहाँ देशों को एक ही कॉल में मिलाकर यह उम्मीद करने के बजाय कि सिर्फ़ पते का टेक्स्ट उन्हें अलग कर देगा, हर देश की पंक्तियों को उसके अपने बैच के रूप में भेजें और countries पैरामीटर को मेल खाने वाले ISO कोड पर सेट करें।
इसकी लागत क्या है
बल्क अनुरोध का बिल आइटम के हिसाब से बनता है, कॉल के हिसाब से नहीं। एक POST में दो पते आपके दैनिक कोटा से दो अनुरोध इस्तेमाल करते हैं, ठीक वैसे ही जैसे आपने दो अलग GET अनुरोध भेजे हों। 500 पंक्तियों वाली स्प्रेडशीट पर 500 अनुरोध लगते हैं, जो हर कुंजी के साथ, या बिना किसी कुंजी के भी, मिलने वाले 2,500 प्रतिदिन मुफ़्त अनुरोधों के भीतर आराम से आ जाते हैं।
पंक्तियों को वापस मिलाना
परिणाम उसी क्रम में वापस आते हैं जिसमें आपने ऐरे भेजा था, इसलिए अनुरोध भेजने से पहले हर पते के साथ मूल पंक्ति का इंडेक्स रखें। रिस्पॉन्स आने के बाद, परिणामों को टेक्स्ट की तुलना करके नहीं, बल्कि स्थिति के आधार पर अपनी स्प्रेडशीट की पंक्तियों से मिलाएँ, क्योंकि रिस्पॉन्स में फ़ॉर्मैट किया गया पता शायद ही कभी हूबहू वैसा होगा जैसा आपने टाइप किया था।
आंशिक विफलताओं को संभालना
जिस पंक्ति का परिणाम नहीं आया, जिसका कॉन्फ़िडेंस स्कोर कम है, या जिसकी सटीकता आपकी ज़रूरत से कम है, उसे अपने आप स्वीकार करने के बजाय चिह्नित किया जाना चाहिए। हर आइटम पर confidence फ़ील्ड जाँचें और आपकी अपनी सीमा से नीचे की हर चीज़ को मैनुअल रिव्यू सूची में भेजें।
एक खास स्थिति: खाली पंक्तियाँ
स्प्रेडशीट एक्सपोर्ट में अक्सर फ़ाइल के अंत के पास कुछ पूरी तरह खाली पंक्तियाँ रह जाती हैं, जो फ़ॉर्मैटिंग से या किसी ऐसे फ़िल्टर से बची होती हैं जिसमें कभी खाली सेल शामिल थे। ऐरे में खाली स्ट्रिंग भी एक आइटम के रूप में गिनी जाती है और आम तौर पर खाली या बहुत कम कॉन्फ़िडेंस वाला परिणाम लौटाती है, जिसे फिर आपकी डेटा टेबल तक पहुँचने से पहले फ़िल्टर करना पड़ता है, इसलिए खाली पंक्तियों को बैच में भेजने के बजाय एक्सपोर्ट के समय ही हटा दें।
एक गलती जिससे बचना चाहिए
एक ही पते को दो बार भेजना, एक बार सक्रिय ग्राहक सूची से और फिर किसी पुराने एक्सपोर्ट से जिसे कभी साफ़ नहीं किया गया, दोहराए गए काम पर आपके दैनिक कोटा का एक हिस्सा खर्च कर देने का आसान तरीका है। ऐरे बनाने से पहले पते वाले कॉलम से डुप्लिकेट हटाएँ, और हर बार कुछ पंक्तियाँ जुड़ने पर पूरी स्प्रेडशीट को दोबारा जियोकोड करने के बजाय सिर्फ़ उन्हीं पंक्तियों को दोबारा चलाएँ जो पिछले एक्सपोर्ट के बाद बदली हैं।
बड़ी फ़ाइलों को बाँटना
बहुत बड़ी फ़ाइलों को कुछ सौ से लेकर कुछ हज़ार पंक्तियों के हिस्सों में संभालना आसान होता है। हिस्सों में बाँटने से बैचों के बीच अपने कोटा हेडर जाँचना और अपने मुफ़्त कोटा या प्रीपेड क्रेडिट के पार जाने से पहले रुकना भी आसान हो जाता है।
अगर आपकी स्प्रेडशीट में कुछ से ज़्यादा पंक्तियाँ हैं, तो यह एक अनुरोध और सैकड़ों राउंड ट्रिप के बीच का अंतर है। अनुरोध और रिस्पॉन्स की पूरी संरचना फ़ॉरवर्ड जियोकोडिंग पेज पर प्रलेखित है।