सीमा तक पहुँचने से पहले अपनी कुंजी के उपयोग पर नज़र रखें
काम के साथ-साथ अपने कोटा हेडर देखते रहने से पता चलता है कि कब सीमा करीब आ रही है, किसी अनुरोध के असल में अस्वीकार होने से काफ़ी पहले।
ग्राहक सूची के पिन कोड बैच में रिज़ॉल्व करें
पिन कोड कॉलम वाला लेकिन निर्देशांकों के बिना ग्राहक एक्सपोर्ट, शिपिंग ज़ोन, क्षेत्रीय रिपोर्टिंग या स्टोर असाइनमेंट से जुड़े किसी भी काम का एक आम शुरुआती बिंदु है। पूरे कॉलम को एक साथ रिज़ॉल्व करना लूप लिखने से तेज़ है।
बैच भेजना
code और country ऑब्जेक्ट का एक array /v1/postcode पर POST करें। हर आइटम स्वतंत्र रूप से रिज़ॉल्व होता है और उसी क्रम में लौटता है।
POST /v1/postcode
Content-Type: application/json
[{"code": "10115", "country": "DE"}, {"code": "75001", "country": "FR"}]{
"status": "ok",
"results": [
{"postcode": "10115", "country_code": "DE", "results": [{"lat": 52.5300, "lon": 13.3800, "components": {"city": "Berlin", "region": "Berlin"}}]},
{"postcode": "75001", "country_code": "FR", "results": [{"lat": 48.8630, "lon": 2.3360, "components": {"city": "Paris", "region": "Ile-de-France"}}]}
]
}परिणामों को ग्राहक रिकॉर्ड से वापस मिलाना
अनुरोध भेजने से पहले हर code और country जोड़ी के साथ मूल पंक्ति इंडेक्स या ग्राहक ID रखें, और परिणामों को उसी स्थिति के आधार पर ग्राहक रिकॉर्ड से वापस मिलाएँ, वही तरीका जो बल्क फ़ॉरवर्ड या रिवर्स जियोकोडिंग के लिए काम करता है।
भेजने से पहले डुप्लिकेट हटाना
किसी भी वास्तविक आकार की ग्राहक सूची में पंक्तियों की तुलना में अलग-अलग पिन कोड कहीं कम होते हैं, क्योंकि किसी भी शहर या मोहल्ले में कई ग्राहकों का एक ही कोड होता है। पहले code और country जोड़ियों की एक यूनिक सूची बनाएँ, उस छोटी सूची को एक बैच में रिज़ॉल्व करें, और फिर परिणामों को हर उस ग्राहक पंक्ति पर वापस मैप करें जिसका वही कोड है, बजाय इसके कि हर ग्राहक के लिए एक array एंट्री भेजें और एक ही code और country जोड़ी के लिए बार-बार भुगतान करें।
रिज़ॉल्व न होने वाले कोड को संभालना
किसी खास आइटम के लिए खाली results array का आमतौर पर मतलब है कि वह code और country जोड़ी मौजूद नहीं है, जो टाइपिंग गलतियों या पुराने पिन कोड वाले पुराने एक्सपोर्ट में आम है। उन पंक्तियों को अपनी रिपोर्ट से चुपचाप हटाने के बजाय मैन्युअल समीक्षा के लिए चिह्नित करें।
एक खास मामला: फ़ॉर्मेटिंग के अंतर
बिना स्पेस के "SW1A1AA" के रूप में सेव किया गया कोड और स्पेस के साथ "SW1A 1AA" के रूप में सेव किया गया कोड एक ही तरह रिज़ॉल्व हो भी सकते हैं और नहीं भी, यह इस पर निर्भर करता है कि आपका अपना एक्सपोर्ट कोड को कितनी एकरूपता से फ़ॉर्मेट करता है, इसलिए बैच array बनाने से पहले अपने एक्सपोर्ट में स्पेसिंग और केस को सामान्य करने से उन पंक्तियों की संख्या घटती है जो कोड के वास्तव में गलत होने के बजाय केवल फ़ॉर्मेटिंग के कारण रिज़ॉल्व नहीं होतीं।
इसकी लागत क्या है
बैच का बिल प्रति आइटम एक अनुरोध के हिसाब से बनता है, इसलिए 2,000 पंक्तियों वाली ग्राहक सूची की लागत 2,000 अनुरोध है, चाहे उसे एक बल्क कॉल के रूप में भेजा जाए या 2,000 अलग-अलग कॉल के रूप में। फिर भी इसे एक कॉल के रूप में भेजना कम ओवरहेड और जाँचने के लिए कोटा हेडर के एक ही सेट के कारण उचित है, भले ही आपके कोटा में अनुरोधों की गिनती दोनों तरह बराबर हो। ऊपर बताए अनुसार पहले डुप्लिकेट हटाना ही वास्तव में अनुरोधों की संख्या घटाता है, बल्क और अलग-अलग कॉल के बीच का चुनाव नहीं।
बैच के बीच में अपने कोटा पर नज़र रखना
इतनी बड़ी सूची के लिए जो 2,500 प्रतिदिन मुफ़्त अनुरोधों से आगे निकल जाए, पूरी सूची एक बार में चलाने का फ़ैसला करने से पहले X-Quota-Free-Remaining जाँचें, या अगर आप एक बार के काम के लिए प्रीपेड क्रेडिट पर जाने की योजना नहीं बना रहे हैं तो इसे कुछ दिनों में बाँट दें।
पूरी ग्राहक सूची के पिन कोड एक ही कॉल में रिज़ॉल्व करने से जो पहले एक धीमा बैकग्राउंड जॉब होता था, वह एक सीधा अनुरोध बन जाता है। पिन कोड लुकअप दस्तावेज़ में फ़ील्ड की पूरी सूची है।