الانتقال

الانتقال من Geoapify

تجمع Geoapify الترميز الجغرافي مع واجهات API للتوجيه والأماكن وتنسيق الخرائط تحت معامل apiKey واحد، وهو ما يناسب الفرق التي تريد حسابًا واحدًا يدير عدة ميزات مواقع في آن واحد. وتتبع استجابات الترميز الجغرافي لديها بنية شبيهة بـ GeoJSON تتضمن مصفوفة features، يحمل كل عنصر فيها properties لحقول العنوان وgeometry للإحداثيات.

بما أن Geoapify تغطي أكثر من الترميز الجغرافي، فإن الانتقال منها نادرًا ما يكون كل شيء أو لا شيء. ومن المفيد أن تكون متعمدًا بشأن النطاق: هل ستنقل كل ميزات المواقع دفعة واحدة، أم استدعاءات الترميز الجغرافي فقط مع إبقاء التوجيه أو تنسيق الخرائط على Geoapify في الوقت الحالي. كلا الخيارين معقول، لكنهما يؤديان إلى مقادير مختلفة من العمل، والخلط بينهما في منتصف المشروع يسبب عادةً ارتباكًا حول أي مفتاح يصادق أي طلب.

My Geocode هي API للترميز الجغرافي والبحث عن IP والمنطقة الزمنية والارتفاع والرموز البريدية، لذا فهي بديل مباشر لجزء الترميز الجغرافي تحديدًا من تكامل Geoapify. ويعيد المضيف البديل المتوافق مع Geoapify إنتاج مصفوفة features وحقولها المتداخلة properties وgeometry، ولا يغيّر سوى نص حقوق النشر والشروط والخصوصية في الاستجابة. وتفاصيل الحقول موجودة في /compatibility/geoapify/.

بالنسبة لاستدعاءات الترميز الجغرافي، يعني الانتقال ما يلي:

  • توجيه الطلب إلى المضيف الجديد بدلًا من مضيف Geoapify
  • إرسال مفتاح My Geocode بدلًا من apiKey الخاص بـ Geoapify، بأي من الأساليب الأربعة المدعومة التي يستخدمها عميلك أصلًا (X-API-Key أو Authorization: Bearer أو مصادقة HTTP Basic أو معامل استعلام)
  • ترك الشيفرة التي تقرأ features[0].properties وfeatures[0].geometry.coordinates دون أي تغيير

إذا كانت عمليات التوجيه أو البحث عن الأماكن ستبقى على Geoapify في الوقت الحالي، فلا شيء يتغير في ذلك؛ إذ يعمل المضيف البديل المتوافق للترميز الجغرافي بشكل مستقل ولا يتطلب انتقال بقية منظومتك في الوقت نفسه.

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

الإضافات الاختيارية، ارتفاع سطح الأرض وتفاصيل تهديدات IP ومعلومات الشبكة، متاحة على المضيف البديل المتوافق للترميز الجغرافي بإضافة mg_extras=1 أو ترويسة X-MG-Extras، ومن المفيد معرفة ذلك إذا كان جزء من سبب استخدامك لمزود مجمّع هو الحصول على أكثر من نوع واحد من البيانات من استدعاء واحد.

ترحيل جزء واحد من حساب متعدد الميزات طريقة عادية وتدريجية لتقليل الاعتماد على أي مورّد منفرد، ولا يتطلب قرارًا حاسمًا بشأن بقية المنظومة منذ اليوم الأول.