نقل أتمتة Zapier أو Make إلى مضيف ترميز جغرافي جديد
تحتاج عمليات الأتمتة دون شيفرة المبنية على خطوة ترميز جغرافي إلى نهج ترحيل مختلف عن الشيفرة المخصصة. إليك كيفية التعامل مع هذا التحويل.
الانتقال من OpenCage
اكتسبت OpenCage جمهورها بجعل الترميز الجغرافي سهل المنال: معامل مفتاح واحد، واستجابة JSON بمصفوفة results، وكائن components يفصّل العنوان إلى حقول مثل road وcity وcountry. وهي تمزج البيانات من عدة مصادر مفتوحة بدلًا من تشغيل مجموعة بيانات مملوكة خاصة بها، وهذا جزء من سبب ميل المطورين الذين يقدّرون الشفافية بشأن مصدر بيانات مواقعهم إليها.
الانتقال بعيدًا عن مزود اختير جزئيًا لبساطته يطرح سؤالًا مشروعًا: هل يحافظ الخيار الجديد على البساطة نفسها؟ الإجابة الصادقة تعتمد على ما تقارن به. فإنشاء حساب عام مع نموذج فوترة تجربة مختلفة عن وضع مفتاح في ترويسة، ومن المفيد التحقق من أيهما تستبدل فعلًا.
يعيد المضيف المتوافق مع OpenCage من My Geocode إنتاج مصفوفة results وتفصيل components اللذين تُرجعهما OpenCage، ويبقى نص حقوق النشر والشروط والخصوصية الجزء الوحيد الذي يتغير. ويوجد المرجع على مستوى الحقول في /compatibility/opencage/. وبالنسبة لمعظم التكاملات، يعني هذا تحديث مضيف الطلب وقيمة المفتاح، بينما يستمر الكود الذي يقرأ results[0].components.city أو results[0].formatted في العمل كما كُتب.
تقبل المصادقة لدينا ترويسة X-API-Key، أو ترويسة Authorization: Bearer، أو مصادقة HTTP Basic، أو معاملًا في الاستعلام، لذا فإن العميل الذي يرسل مفتاح OpenCage بالفعل كمعامل في سلسلة الاستعلام سيستمر عمومًا في العمل بقيمة مفتاح جديدة دون تغيير أي شيء آخر في منطق الطلب.
الفئة المجانية جزء مهم من هذه المقارنة لكل من اختار OpenCage لسهولة الوصول إليها في المشاريع الصغيرة والمشاريع الجانبية. تقدّم My Geocode 2,500 طلب مجاني يوميًا من أي عنوان دون الحاجة إلى أي مفتاح على الإطلاق، ويحصل كل مفتاح أيضًا على 2,500 طلب مجاني يوميًا يُحتسب لكل شبكة، ويُتقاسم بين الاستخدام دون مفتاح والاستخدام بمفتاح من الشبكة نفسها. وبعد ذلك يكون التسعير رصيدًا مسبق الدفع بسعر 0.0001 € لكل طلب أو مفتاح Unlimited بسعر 50 € شهريًا، مع تسعير كل نقطة نهاية بالسعر نفسه، بما في ذلك كل مضيف متوافق.
أمر واحد يستحق الاختبار مباشرة بدلًا من الافتراض: التعليقات التوضيحية (annotations). إذا كان تكامل OpenCage لديك يقرأ حقول تعليقات توضيحية إضافية مثل معلومات المنطقة الزمنية أو العملة المضمّنة في استجابة الترميز الجغرافي، فقارن الحقول الموثقة للمضيف المتوافق بما يتوقعه كود التحليل لديك، لأن بعض هذه التفاصيل قد يلزم أن يأتي من نقطة نهاية مخصصة بدلًا من ذلك، مثل الاستعلام عن المنطقة الزمنية لدى My Geocode، بدلًا من أن يكون مضمّنًا في استجابة الترميز الجغرافي نفسها.
بالنسبة لمشروع بدأ صغيرًا ثم نما، فإن البساطة التي جعلت OpenCage خيارًا أول سهلًا ليست شيئًا يجب أن تتخلى عنه بتغيير المزود. فمفتاح يعمل بأي أسلوب يرسله به عميلك بالفعل، وحصة يومية مجانية دون الحاجة إلى إنشاء حساب لبدء الاختبار، وسعر واحد لكل نقاط النهاية، كل ذلك يُبقي تجربة الانضمام قريبة مما اعتاده كثير من مستخدمي OpenCage.