الانتقال

الانتقال من HERE Geocoding and Search

تظهر HERE Geocoding and Search كثيرًا في برمجيات السيارات واللوجستيات، وهي قطاعات يكون فيها الحساب المؤسسي مع جهة اتصال مسماة وعقد دعم الطريقة المعتادة لممارسة الأعمال. والمصادقة عادةً مفتاح API أو رمز OAuth، وتعود الاستجابات كمصفوفة items يحمل كل عنصر فيها كائن position وكتلة address منظمة بحقول مثل label وcountryCode وhouseNumber.

تكون هذه البنية عادةً موثقة جيدًا داخليًا في الشركات التي تعتمد عليها، لأن HERE غالبًا ما تُختار تحديدًا لجودة تحليل العناوين في منطقة معينة أو لتكامل التوجيه في موضع آخر من المنظومة. والترحيل الذي يكسر شكل الاستجابة يكسر كل تلك الشيفرة اللاحقة دفعة واحدة، ولهذا يهم التوافق هنا أكثر من تكلفة تبديل الحساب نفسه.

يعيد المضيف البديل المتوافق مع HERE في My Geocode إنتاج مصفوفة items وحقولها المتداخلة position وaddress تمامًا كما تعيدها HERE، مع استبدال نص حقوق النشر والشروط والخصوصية فقط. راجع /compatibility/here/ للاطلاع على مرجع الحقول. وفي معظم الحالات، يكون التغيير المطلوب في شيفرة التطبيق هو اسم المضيف والمفتاح، ولا شيء في الشيفرة التي تقرأ items[0].position أو items[0].address.label.

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

من حيث المصادقة، يمكن إرسال المفتاح الذي تصدره My Geocode كترويسة X-API-Key أو ترويسة Authorization: Bearer أو مصادقة HTTP Basic أو معامل استعلام. وإذا كانت مكتبة عميل HERE الحالية لديك تصادق أصلًا بطريقة معينة، فإن توجيهها إلى المضيف الجديد بمفتاح جديد يكفي عادةً، لأن المكتبة نفسها لا تحتاج إلى تغيير.

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

إذا كان جزء من استخدامك لـ HERE هو الاقتراح التلقائي بدلًا من الترميز الجغرافي المباشر، فمن المفيد معاملته كخطوة ترحيل مستقلة، لأن نقاط النهاية من نوع الإكمال التلقائي لها شكل استجابة خاص بها ونمط طلب يعتمد على مدخلات جزئية، وهي تستحق اختبارًا منفصلًا بدلًا من دمجها في تحويل الترميز الجغرافي. ويظهر استهلاك الحصة في كل طلب، بما في ذلك المضيف البديل المتوافق، عبر ترويسات استجابة مثل X-Quota-Used وX-Credits-Remaining، الموثقة في /docs/rate-limits/.