ما أطلقناه هذا الشهر: الترميز الجغرافي وIP والمنطقة الزمنية والمزيد
ملخص للعمل الأخير في الواجهة: مضيفات توافق جديدة، واستعلامات أسرع للمنطقة الزمنية والارتفاع، وميزات جديدة في لوحة التحكم، ورؤية أوضح للحصة.
نقطة نهاية مخصصة للاستعلام عن الرمز البريدي
ليس كل سؤال عن الموقع سؤالًا عن الترميز الجغرافي فعلًا. ففي بعض الأحيان، كل ما يحتاجه التطبيق هو الرمز البريدي لمنطقة معينة، أو المنطقة التي يغطيها رمز بريدي معين، دون تحليل العنوان الأوسع الذي يوفره الترميز الجغرافي الأمامي أو العكسي. وُجدت /v1/postcode خصيصًا لهذا السؤال الأضيق، بوصفها نقطة نهاية مخصصة قائمة بذاتها وليست نتيجة جانبية لاستعلام أعم.
لإبقائها منفصلة عن /v1/forward و/v1/reverse أهمية لعدة أسباب عملية. فهذا يعني أن شكل الطلب يمكن بناؤه خصيصًا حول معاملات الرمز البريدي بدلًا من تكييفه من بنية عنوان أوسع. ويعني أن الاستجابة يمكن أن تركز على ما تحتاجه بالضبط عملية تكامل تقتصر على الرمز البريدي، دون حقول عنوان إضافية يجب تصفيتها. ويعني أن التوثيق، المتاح كاملًا في /docs/postal-code-lookup/، يمكنه شرح سلوك الرمز البريدي بشروطه الخاصة بدلًا من أن يكون قسمًا فرعيًا في دليل أطول عن الترميز الجغرافي.
تتبع المصادقة القواعد نفسها المتبعة في كل نقطة نهاية أخرى: ترويسة X-API-Key، أو ترويسة Authorization: Bearer، أو مصادقة HTTP Basic مع استخدام المفتاح اسمًا للمستخدم، أو معامل في الاستعلام، وكلها مقبولة بالطريقة نفسها. والتسعير هو نفسه أيضًا، إذ يستهلك من الحصة اليومية المجانية نفسها، سواء من الشبكة المرسلة أو من المفتاح، ثم بالسعر نفسه 0.0001 € للطلب من الرصيد مسبق الدفع أو ضمن تغطية باقة Unlimited بعد ذلك.
تعمل الطلبات المجمعة هنا تمامًا كما تعمل في أي مكان آخر على المنصة: كل رمز بريدي أو عنوان يُرسل في استدعاء واحد يُحتسب طلبًا واحدًا، وليس الاستدعاء بأكمله. ويمكن لفريق يتحقق من الرموز البريدية عبر قائمة عملاء كبيرة أن يرسل تلك القائمة دفعة واحدة وأن يتوقع الاحتساب نفسه لكل عنصر المطبق على أي عملية مجمعة أخرى في My Geocode.
كما أن وجود نقطة نهاية مخصصة يجعل عمل التوافق الخاص بالرموز البريدية عبر مضيفات التوافق السبعة عشر لدينا أكثر دقة، لأن المزودين الذين يقدمون استعلامًا بريديًا مخصصًا خاصًا بهم يمكن مطابقتهم بدقة بدلًا من تقريبهم عبر شكل ترميز جغرافي أعم.
إذا كان تطبيقك يحتاج فقط إلى معلومات الرمز البريدي وكان يرسل سابقًا طلبات ترميز جغرافي أعم لمجرد استخراج ذلك الحقل الواحد، فالأجدر أن تنتقل مباشرة إلى /v1/postcode. وهي موثقة بالكامل في /docs/postal-code-lookup/، إلى جانب بقية مرجع نقاط النهاية لدينا في /docs/.