الانتقال

الانتقال من Geocodio

بنت Geocodio سمعة قوية تحديدًا حول دقة العناوين في الولايات المتحدة وكندا، إلى جانب سير عمل لرفع ملفات CSV المجمّعة يتيح لأي شخص ترميز جدول بيانات من العناوين جغرافيًا دون كتابة أي شيفرة تكامل على الإطلاق. يُرسَل مفتاح API لديها كمعامل استعلام (api_key)، وتعود استجابات العنوان الواحد بمصفوفة results تحتوي على address_components وحقل accuracy يصف درجة الثقة في المطابقة.

يستحق سير عمل CSV المجمّع أن يُعامل كبند ترحيل مستقل، منفصل عن أي استدعاءات API برمجية يجريها تطبيقك. ففريق التسويق أو محلل العمليات الذي يرفع جدول بيانات عبر نموذج ويب مرة كل شهر لا يتأثر بالتغييرات في شيفرة الخادم الخلفي لديك، وهذا السير يحتاج إلى خطته الخاصة، سواء كان ذلك يعني كتابة مهمة دفعية برمجية على API الجديد أو التعامل معه يدويًا خلال فترة انتقالية.

بالنسبة للجانب البرمجي، يعيد المضيف البديل المتوافق مع Geocodio في My Geocode إنتاج مصفوفة results وبنية address_components التي تعيدها Geocodio، ويكون نص حقوق النشر والشروط والخصوصية هو المحتوى الوحيد الذي يتغير. والتفاصيل المرجعية موجودة في /compatibility/geocodio/. وينبغي أن تستمر الشيفرة التي تقرأ results[0].address_components.city في العمل بمجرد تحديث المضيف والمفتاح.

بعض النقاط التي تستحق التخطيط لها تحديدًا بسبب التركيز الإقليمي لـ Geocodio:

  • إذا كان تكاملك يعتمد على أي حقول إضافية خاصة بالولايات المتحدة، مثل معلومات الدوائر الانتخابية للكونغرس، فتحقق مما إذا كان هذا العنصر من البيانات جزءًا من نطاق الترحيل أم أنه يحتاج إلى بحث منفصل من الآن فصاعدًا
  • تأكد مما إذا كانت أي مهام مجمّعة تعمل وفق حد معدل مضبوط تحديدًا على الحدود الموثقة لدى Geocodio، لأن توقيت إعادة المحاولة المبني حول أرقام مزود واحد لا يناسب بالضرورة أرقام مزود آخر
  • اختبر دفعة من العناوين التاريخية الحقيقية من بياناتك على المضيف الجديد قبل افتراض التكافؤ التام، خصوصًا في الحالات الاستثنائية مثل صناديق البريد أو عناوين الطرق الريفية

تدعم المصادقة ترويسة X-API-Key أو ترويسة Authorization: Bearer أو مصادقة HTTP Basic أو معامل استعلام، لذا فإن أي أسلوب يستخدمه عميل Geocodio الحالي لديك لمعامل api_key له مقابل هنا.

من حيث التكلفة، لا توجد فئة تسعير منفصلة للمعالجة المجمّعة يجب التفكير فيها: فكل نقطة نهاية، بما فيها هذا المضيف البديل المتوافق، بالسعر نفسه، مع 2,500 طلب مجاني يوميًا لا تتطلب أي مفتاح على الإطلاق، و2,500 طلب مجاني آخر لكل مفتاح يوميًا يُحتسب لكل شبكة، وبعد ذلك رصيد مسبق الدفع بسعر 0.0001 € للطلب أو مفتاح Unlimited مقابل 50 € شهريًا. فالمهمة المجمّعة الكبيرة لمرة واحدة والتدفق المستمر من استدعاءات API يكلفان المبلغ نفسه لكل طلب في الحالتين، مما يجعل تقدير تكلفة الترحيل المجمّع عملية ضرب بسيطة بدلًا من البحث في جدول فئات.