الانتقال

الانتقال من تكامل المنطقة الزمنية في Bing Maps

يُوصَل إلى وظيفة المنطقة الزمنية في Bing عادةً إما عبر Locations API مع علامة المنطقة الزمنية، أو عبر استدعاء مخصص للمنطقة الزمنية، بحسب الطريقة التي بُني بها التكامل في الأصل. وفي كلتا الحالتين، تعيش عادةً داخل حساب Bing Maps Dev Center نفسه الذي يضم الترميز الجغرافي، مما يعني أن تحويل الحساب بالكامل سيمس الاثنين معًا في العادة حتى عندما يكون جزء المنطقة الزمنية وحده هو المعني فعلًا.

بيانات المنطقة الزمنية استجابة صغيرة ومحددة جيدًا: معرّف، وفارق توقيت عن UTC، وعادةً ملاحظة حول تطبيق التوقيت الصيفي للإحداثية والتاريخ المحددين. وهذا الإيجاز ميزة حقيقية عند تخطيط الترحيل، لأن بنية الاستجابة التي يجب التحقق منها مقابل حالات اختبار حقيقية قليلة نسبيًا قبل اعتبار الانتقال مكتملًا.

يعمل الاستعلام عن المنطقة الزمنية في My Geocode كنقطة نهاية مستقلة تعمل بالكامل، موثقة في /docs/timezone-lookup/، ومنفصلة تمامًا عن المضيفين المتوافقين للترميز الجغرافي. وهو يُرجع معلومات المنطقة الزمنية لإحداثية ما مباشرة، مما يعني أن هذا الترحيل لا يتطلب اتخاذ أي قرار بشأن بقية تكامل Bing Maps أولًا. ويمكن للفرق نقل استدعاءات المنطقة الزمنية الآن وأخذ مزيد من الوقت لتقييم ما إذا كانت سترحّل الترميز الجغرافي أيضًا.

خطوات تستحق الاتباع في هذا الترحيل تحديدًا:

  1. حدد كل دالة تستدعي حاليًا وظيفة المنطقة الزمنية في Bing، مع مراعاة أنها قد تكون مضمّنة داخل استدعاء أوسع إلى Locations API بدلًا من نقطة نهاية منفصلة في الكود الحالي
  2. استخرج هذا المنطق إلى دالة خاصة به ذات اسم واضح إن لم يكن منفصلًا بالفعل، مما يجعل تبديل المزود الفعلي تغييرًا واحدًا ومحصورًا
  3. اختبر نقطة النهاية الجديدة مقابل إحداثيات معروفة بسلوك غير معتاد للمنطقة الزمنية (مناطق بفوارق توقيت ليست بساعات كاملة، وأماكن بلا توقيت صيفي) قبل اعتبار الترحيل مُتحققًا منه

تستخدم المصادقة مفتاحًا يُرسَل في X-API-Key، أو Authorization: Bearer، أو عبر مصادقة HTTP Basic، أو كمعامل في الاستعلام، أيها يتوافق أكثر مع الطريقة التي يرسل بها بقية تطبيقك بيانات الاعتماد إلى الخدمات الأخرى بالفعل.

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