نقل أتمتة Zapier أو Make إلى مضيف ترميز جغرافي جديد
تحتاج عمليات الأتمتة دون شيفرة المبنية على خطوة ترميز جغرافي إلى نهج ترحيل مختلف عن الشيفرة المخصصة. إليك كيفية التعامل مع هذا التحويل.
الانتقال من Google Maps Platform: ما الذي يتغير وما الذي يبقى
غالبًا ما تكون Google Maps Platform أول API للترميز الجغرافي يوصله الفريق على الإطلاق، ويرجع ذلك أساسًا إلى أنها الاسم الأكبر في الساحة. ونموذج المصادقة لديها مألوف لمعظم المطورين الآن: مفتاح API مرتبط بحساب فوترة داخل مشروع Google Cloud، يُرسَل كمعامل استعلام في كل طلب. وتعود استجابات الترميز الجغرافي لديها ككائن JSON يتضمن مصفوفة results وحقل status وسلسلة formatted_address وكائن geometry.location متداخلًا يحمل خط العرض وخط الطول.
الجزء الذي يقلق الفرق عادةً بشأن التبديل هو شيفرة التحليل المبنية حول هذا الشكل بالضبط. فمكونات العنوان وحدود نافذة العرض ومعرّفات الأماكن، كلها تقرؤها دوال متناثرة في أنحاء قاعدة الشيفرة، وإعادة كتابة هذه الدوال هي نوع المهام التي لا يريد أحد جدولتها. وهذه تحديدًا المشكلة التي بُني المضيف البديل المتوافق لتجنبها.
تشغّل My Geocode مضيفًا بديلًا متوافقًا مع Google Maps يعيد إنتاج تنسيق طلب واستجابة الترميز الجغرافي الخاص بـ Google حقلًا بحقل. والنص الوحيد في الاستجابة الذي يخصنا هو صياغة حقوق النشر والشروط والخصوصية؛ وكل ما عدا ذلك، بما فيه أسماء الحقول والتداخل، يطابق ما تتوقعه شيفرتك أصلًا. وعمليًا، يعني الترحيل تغيير اسم مضيف ومفتاح، لا المساس بأداة التحليل. والتفاصيل موجودة في /compatibility/google-maps/.
ما الذي يبقى كما هو:
- بنية JSON التي تحللها شيفرتك أصلًا
- أسلوب معامل الاستعلام لإرسال المفتاح، إذا كان هذا ما يستخدمه عميلك
- نمط الطلب العام (عنوان يدخل، وبيانات موقع منظمة تخرج)
ما الذي يتغير:
- المضيف الذي ترسل إليه الطلبات
- المفتاح نفسه، الذي نصدره نحن بدلًا من Google
- اشتراط حساب الفوترة، الذي يحل محله نموذج أبسط قائم على الرصيد أو الاشتراك
بما أن المفتاح يمكن إرساله كترويسة X-API-Key أو ترويسة Authorization: Bearer أو مصادقة HTTP Basic أو معامل استعلام، فإن مكتبة العميل التي تصادق أصلًا بطريقتها الخاصة تستمر عادةً في العمل دون تعديل. وهذه المرونة أهم مما قد يبدو، لأن كثيرًا من صعوبات الترحيل في الواقع تأتي من مكتبات تفترض طريقة واحدة محددة لتمرير بيانات الاعتماد.
من حيث التسعير، النموذج بسيط: 2,500 طلب يوميًا مجانية من أي عنوان دون الحاجة إلى مفتاح، ويحصل كل مفتاح أيضًا على 2,500 طلب مجاني يوميًا تُحتسب لكل شبكة. وبعد ذلك، يكون الخيار رصيدًا مسبق الدفع بسعر 0.0001 € للطلب، أو باقة Unlimited مقابل 50 € شهريًا، وكل نقطة نهاية بما فيها كل مضيف بديل متوافق تكلف المبلغ نفسه. ولا توجد فئات منفصلة يجب التفاوض عليها بحسب المنتج الذي تستدعيه.
الحقول الإضافية الاختيارية، ارتفاع سطح الأرض وإشارات تهديدات IP وتفاصيل الشبكة، متاحة على أي مضيف بديل متوافق بإضافة mg_extras=1 أو ترويسة X-MG-Extras، دون الإخلال بالشكل الذي تعتمد عليه بقية شيفرتك. وهذا يمنحك طريقًا إلى بيانات أغنى لاحقًا دون ترحيل ثانٍ.
إذا كان تكاملك يشمل أيضًا الترميز الجغرافي العكسي أو الإكمال التلقائي أو البحث عن الرموز البريدية، فإن تبديل المضيف والمفتاح نفسه ينطبق، وإن كان شكل الطلب والاستجابة الدقيق لنقاط النهاية هذه يستحق المراجعة مقابل شيفرتك الحالية قبل التحويل، لأن أعراف تنسيق العناوين تختلف من دولة إلى أخرى. واختبار شريحة من حركة الإنتاج على المضيف الجديد قبل التبديل الكامل طريقة معقولة للتأكد من أن الشكل يتوافق مع ما تتوقعه. راجع /docs/compatibility/ للاطلاع على المرجع الكامل للحقول عبر جميع المضيفات البديلة المتوافقة.