الأدلة

خزّن نتائج الترميز الجغرافي مؤقتًا دون إفساد حسابات حصتك

الترميز الجغرافي للعنوان نفسه مرتين في أسبوع واحد نمط شائع، والتخزين المؤقت هو الحل البديهي. أما ما يوقع الناس في الخطأ فهو نسيان أن الإصابة في ذاكرة التخزين المؤقت والإخفاق فيها يبدوان متطابقين لتطبيقك لكنهما مختلفان جدًا بالنسبة إلى حصتك.

ما الذي يمكن تخزينه مؤقتًا بأمان

نادرًا ما يتغير العنوان المرمّز جغرافيًا، لذا فإن التخزين المؤقت للنتيجة الكاملة لاستعلام أمامي أو عكسي، بمفتاح مبني على المُدخل الموحّد، آمن لفترة طويلة، أسابيع أو أشهر بحسب مدى تغيّر بيانات العناوين لديك. ونتيجة الاستعلام عن IP آمنة للتخزين المؤقت لفترات أقصر، لأن النطاقات يُعاد تخصيصها أحيانًا. ومعرّف المنطقة الزمنية في استعلام المنطقة الزمنية ثابت، لكن قيمة utc_offset تتغير مع التوقيت الصيفي، لذا خزّن المعرّف مؤقتًا وأعد حساب الفارق بدلًا من تخزين الاستجابة كاملة إلى أجل غير مسمى.

الخدمة من ذاكرة التخزين المؤقت لا تمس الحصة

الإصابة في ذاكرة التخزين المؤقت تعني أنك لم تستدعِ API على الإطلاق لذلك الطلب، فلا يتغير شيء في X-Quota-Used ولا في رصيدك. وهذا هو جوهر التخزين المؤقت، لكنه يعني أيضًا أن الإصابة في ذاكرة التخزين المؤقت لن تظهر في أي مكان من ترويسات الحصة، التي لا تعكس إلا الاستدعاءات التي وصلت إلى API فعلًا. لا تحاول مطابقة عدادات الطلبات الخاصة بك مع ترويسات الحصة ما لم تكن تتتبع أيضًا الإصابات في ذاكرة التخزين المؤقت بشكل منفصل.

مثال على مفتاح التخزين المؤقت

cache_key = "forward:" + normalize("221B Baker Street, London")

وحّد المُدخل بتحويله إلى أحرف صغيرة، وحذف المسافات البيضاء من طرفيه، ودمج المسافات المتكررة قبل حساب التجزئة، حتى لا تتسبب فروق التنسيق البسيطة في المُدخل في إخفاقات لا داعي لها في ذاكرة التخزين المؤقت.

تقدير الأحجام المتوقعة

إذا كان نصف العناوين الواردة إليك مكررًا ضمن نافذة التخزين المؤقت، فإن عدد طلباتك الفعلي المحتسب من الحصة المجانية ومن أي رصيد مسبق الدفع يساوي تقريبًا نصف حجم عناوينك الخام. ومن المفيد معرفة ذلك قبل أن تقرر ما إذا كنت بحاجة إلى الترقية بما يتجاوز 2,500 طلب مجاني يوميًا مضمّنة مع كل مفتاح، لأن العدد الحقيقي الذي يصل إلى API قد يكون أقل بكثير مما توحي به زياراتك الخام.

متى تتجاوز ذاكرة التخزين المؤقت

تجاوز ذاكرة التخزين المؤقت في كل حالة تكون فيها النتيجة القديمة خاطئة فعلًا، مثل إعادة التحقق من عنوان صحّحه العميل للتو. فالاستعلام الجديد الواحد يكلف طلبًا واحدًا في كل الأحوال، لذا فإن تجاوز ذاكرة التخزين المؤقت لتصحيح محدد ضمانة رخيصة ضد تقديم نتيجة مخزنة معروف أنها خاطئة.

التخزين المؤقت الجيد يتعلق في معظمه بمعرفة الحقول الثابتة والحقول المتغيرة، بدلًا من تخزين كل شيء أو لا شيء. راجع توثيق الترميز الجغرافي الأمامي لمعرفة الحقول التي تصلح مفاتيح جيدة للتخزين المؤقت.