نقل أتمتة Zapier أو Make إلى مضيف ترميز جغرافي جديد
تحتاج عمليات الأتمتة دون شيفرة المبنية على خطوة ترميز جغرافي إلى نهج ترحيل مختلف عن الشيفرة المخصصة. إليك كيفية التعامل مع هذا التحويل.
الانتقال من Bing Maps REST Services
لخدمات Bing Maps REST Services شكل استجابة مميز: كائن في المستوى الأعلى يحتوي على مصفوفة resourceSets، تحتوي كل منها على resources، ويحمل كل مورد كائن point تتداخل فيه الإحداثيات داخل مصفوفة coordinates بدلًا من حقلين منفصلين لخط العرض وخط الطول. والمطورون الذين بنوا تكاملاتهم عليه، وغالبًا في شركات .NET حيث كانت Bing Maps الخيار الطبيعي، يحفظون هذه البنية عن ظهر قلب، وإعادة الكتابة حول بنية مختلفة هي بالضبط نوع العمل الهادئ والممل الذي يُبقي الترحيل خارج الجدول الزمني لشهور.
المفتاح الذي يُنشأ عبر Bing Maps Dev Center يُرسَل كمعامل استعلام، وهو نمط تشترك فيه معظم واجهات API للخرائط الموجهة للمستهلكين. وهذا الجزء من التكامل عادةً ما يكون أقل ما يقلق أي أحد؛ فتحليل الاستجابة هو موضع الارتباط الحقيقي.
تشغّل My Geocode مضيفًا بديلًا متوافقًا مع Bing Maps يعيد إنتاج بنية resourceSets هذه بالضبط، لذا تستمر شيفرة التحليل التي تقرأ resourceSets[0].resources[0].point.coordinates في العمل بعد التبديل. والمحتوى الوحيد في الاستجابة الذي لا يطابق شكل Bing الأصلي هو نص حقوق النشر والشروط والخصوصية، وهو خاص بنا بالضرورة. والتفاصيل الكاملة موجودة في /compatibility/bing-maps/.
بعض الأمور التي تستحق التحقق قبل التحويل:
- تأكد مما إذا كانت شيفرتك تقرأ حقول الثقة أو رمز المطابقة، لأنها تستحق مقارنة سريعة جنبًا إلى جنب
- تأكد من أسلوب المصادقة الذي تستخدمه مكتبة العميل لديك؛ إذ يمكن إرسال المفتاح كـ
X-API-KeyأوAuthorization: Bearerأو مصادقة HTTP Basic أو معامل استعلام، لذا ينبغي أن يستمر في العمل أي أسلوب تستخدمه مكتبتك أصلًا - قرر ما إذا كنت تريد تفعيل الحقول الإضافية الاختيارية (الارتفاع، وتهديدات IP، وتفاصيل الشبكة) عبر
mg_extras=1، لأنها تأتي إلى جانب الشكل القياسي بدلًا من أن تحل محله
الجانب التجاري بسيط بالمقارنة. فلا توجد خطوة لإعداد حساب فوترة: 2,500 طلب يوميًا مجانية دون أي مفتاح على الإطلاق، ويحصل كل مفتاح على 2,500 طلب مجاني يوميًا خاصة به تُحتسب لكل شبكة. وبعد هذه الحصة، يكون الخيار رصيدًا مسبق الدفع بسعر 0.0001 € للطلب أو مفتاح Unlimited مقابل 50 € شهريًا، ويكلف المضيف البديل المتوافق المبلغ نفسه الذي تكلفه كل نقطة نهاية أخرى على المنصة.
بالنسبة للفرق التي تشغّل الترميز الجغرافي كجزء من تطبيق .NET أو تطبيق مؤسسي أكبر، يكون الترحيل عادةً أصغر نطاقًا مما يبدو من الخارج، لأن غلاف resourceSets يُقرأ عادةً عبر عدد قليل من دوال الوصول المحصورة جيدًا بدلًا من أن يكون متناثرًا مباشرة في أنحاء قاعدة الشيفرة. والعثور على نقاط الوصول هذه أولًا، ثم توجيهها إلى المضيف الجديد في بيئة تجريبية، طريقة معقولة للتحقق من التبديل قبل المساس بحركة الإنتاج.
إذا كان تكاملك يستدعي أيضًا نقطة نهاية Bing للمنطقة الزمنية أو الارتفاع إلى جانب الترميز الجغرافي، فإن هذه تُعالَج بشكل منفصل، لأن عمليات البحث عن المنطقة الزمنية والارتفاع الخاصة بـ My Geocode تعمل بشكل مستقل عن المضيف البديل المتوافق للترميز الجغرافي، ويستحسن توصيلها وفق شروطها الخاصة بدلًا من إجبارها على المرور عبر مسار الشيفرة نفسه. والتفاصيل الكاملة للحصة، بما فيها X-Quota-Limit وترويسات الاستجابة المرتبطة بها التي يحملها كل طلب، موثقة في /docs/rate-limits/.