ما أطلقناه هذا الشهر: الترميز الجغرافي وIP والمنطقة الزمنية والمزيد
ملخص للعمل الأخير في الواجهة: مضيفات توافق جديدة، واستعلامات أسرع للمنطقة الزمنية والارتفاع، وميزات جديدة في لوحة التحكم، ورؤية أوضح للحصة.
التوافق البديل المباشر مع Bing Maps REST Services متاح الآن
بُنيت كثير من تكاملات الخرائط قبل سنوات على Bing Maps REST Services وظلت تعمل منذ ذلك الحين دون أن يمسها أحد، لأنه لم يكن هناك قط سبب مقنع لإعادة كتابتها. نعتقد أن هناك سببًا الآن: مضيف متوافق يستقبل الطلبات نفسها ويعيد بنية الاستجابة نفسها، بهيكل أسعار وحصص واضح منذ الاستدعاء الأول.
يطابق مضيفنا المتوافق مع Bing Maps REST Services معلمات الطلب في الخدمة الأصلية ومتن الاستجابة مطابقة تامة، باستثناء نصوص حقوق النشر والشروط والخصوصية، التي تعكس My Geocode بدلًا من المزود الأصلي. يمكن توجيه الشيفرة الحالية التي تبني الطلبات بصيغة Bing، أو تحلل الاستجابات بصيغة Bing، أو تفعل الأمرين، إلى مضيفنا دون أي إعادة كتابة.
يتطلب الوصول إلى ذلك تغيير أمرين: اسم المضيف الذي تُرسل إليه طلباتك، والمفتاح الذي تصادق به. ويمكن إرسال هذا المفتاح بالطريقة التي يتوقعها تكاملك أصلًا، في ترويسة X-API-Key، أو في ترويسة Authorization: Bearer، أو عبر مصادقة HTTP Basic مع المفتاح بوصفه اسم المستخدم، أو في معلمة استعلام عادية. وتعمل الطرق الأربع بالشكل نفسه على كل مضيفات My Geocode، بما فيها هذا المضيف.
الأسعار التي تقوم عليها طبقة التوافق هي نفسها في أي مكان آخر على المنصة. يحصل كل عنوان على 2,500 طلب مجاني يوميًا دون الحاجة إلى مفتاح على الإطلاق، تُحسب لكل شبكة حتى لا يمكن تقسيم اتصال مشترك على مفاتيح كثيرة لمضاعفة الفئة المجانية. ويضيف كل مفتاح 2,500 طلب مجاني يوميًا خاصة به فوق ذلك. وبعد تجاوز هذه الحصص، يُخصم الاستخدام من الرصيد المسبق الدفع بسعر 0.0001 € للطلب، أو يُغطّى بباقة Unlimited بسعر 50 € شهريًا، ويبقى هذا السعر ثابتًا بغض النظر عن المضيف أو نقطة النهاية التي ذهب إليها الطلب.
لا تختفي رؤية الحصة لمجرد أن بنية الاستجابة تطابق مزودًا آخر. فكل استدعاء لا يزال يعيد X-Quota-Limit وX-Quota-Used وX-Quota-Free-Remaining وX-Quota-Network-Used وX-Credits-Remaining وبقية مجموعة ترويساتنا القياسية، لتعرف دائمًا بدقة وضع مفتاح معين أو شبكة معينة، وهو أمر لا تقدمه الخدمة الأصلية بهذا الشكل.
للفرق التي تريد أكثر من الاستجابة المتوافقة الصارمة، يضيف mg_extras=1 في الطلب، أو ترويسة X-MG-Extras، حقولًا اختيارية فوق البنية القياسية دون الإخلال بها. اترك هذا الخيار غير مفعّل تمامًا، وستكون الاستجابة مطابقة في بنيتها لما كانت ستعيده الواجهة الأصلية بحيث لا يمكن التمييز بينهما.
تتوفر أدلة الانتقال التي تشرح نقل تكامل قائم، نقطة نهاية تلو الأخرى، في /docs/compatibility/، والمضيف نفسه موثق في /compatibility/bing-maps/. ولا تكلّف تجربته شيئًا سوى بضع دقائق فراغ ومفتاح.