ما أطلقناه هذا الشهر: الترميز الجغرافي وIP والمنطقة الزمنية والمزيد
ملخص للعمل الأخير في الواجهة: مضيفات توافق جديدة، واستعلامات أسرع للمنطقة الزمنية والارتفاع، وميزات جديدة في لوحة التحكم، ورؤية أوضح للحصة.
ترويسات الحصة في كل استجابة: اعرف حدك قبل أن تستدعي
تتركك معظم واجهات API تخمّن موقفك من الاستخدام حتى يتعطل شيء ما. أما My Geocode فتتبع نهجًا مختلفًا: كل استجابة، على كل نقطة نهاية وكل مضيف توافق، تحمل مجموعة كاملة من ترويسات الحصة تخبرك بموقفك بالضبط.
تعطي X-Quota-Limit وX-Quota-Used الصورة الأساسية للمفتاح أو الشبكة التي تجري الاستدعاء. وتُظهر X-Quota-Free-Remaining مقدار ما تبقى من الحصة اليومية المجانية، وتعكس X-Quota-Network-Used مقدار ما استُهلك بالفعل من تلك الحصة المجانية المشتركة لكل شبكة من قبل أي عنوان أو مفتاح على الاتصال نفسه. وتُظهر X-Credits-Remaining رصيد الرصيد مسبق الدفع لكل من تجاوز الفئة المجانية وليس على باقة Unlimited. وتتتبع X-Key-IPs-Used وX-Key-IPs-Limit عدد العناوين المختلفة التي استُخدم منها مفتاح معين، وتخبرك X-Quota-Reset متى تُعاد العدادات اليومية إلى الصفر.
سبب أهمية ذلك بسيط: السكربت الذي يرى حصته يستطيع التصرف بذكاء حيالها. يمكنه أن يبطئ قبل أن يُحظر، أو ينبه مطورًا عندما يقترب الرصيد من النفاد، أو يتحول من مفتاح مجاني إلى مفتاح مدفوع تلقائيًا بدلًا من أن يفشل أولًا ثم يتفاعل بعد ذلك. ولا يتطلب أي من ذلك استدعاء نقطة نهاية منفصلة للاستخدام أو تفقد لوحة التحكم يدويًا. فالمعلومات تأتي مع الإجابة التي طلبتها أصلًا.
ينطبق هذا سواء كنت تستخدم نقاط النهاية الأصلية لدينا أو أحد مضيفات التوافق السبعة عشر. فالطلب المصاغ كاستدعاء إلى Google Maps Platform أو Bing Maps REST Services أو ipstack يعود مع ترويسات الحصة الخاصة بنا مرفقة به، إضافة إلى جسم الاستجابة المطابق لصيغة ذلك المزود. وتبديل المزودين لا يعني خسارة هذه الرؤية، بل يعني اكتسابها في أماكن لم تكن متوفرة فيها أصلًا.
يحصل كل مفتاح على حصة يومية مجانية. وبعدها تُخصم الطلبات من الرصيد مسبق الدفع أو تغطيها باقة Unlimited. وكل استجابة تخبرك بموقفك في ترويساتها، وهذا أمر صغير في أي استدعاء منفرد، ومفيد فعلًا على مدار يوم مزدحم بالزيارات.
للفرق التي تبني أي شيء أكبر من سكربت لمرة واحدة، نقترح تسجيل هذه الترويسات إلى جانب سجلات الطلبات الخاصة بكم من البداية. فملاحظة اتجاه هادئ في X-Quota-Free-Remaining ينخفض أسرع من المتوقع على رسم بياني أقل تكلفة بكثير من ملاحظته في تذكرة دعم. التفاصيل الكاملة لكل ترويسة وما يؤدي إليها موثقة في /docs/rate-limits/، إلى جانب إرشادات المصادقة العامة في /docs/authentication/.