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