الانتقال

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

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

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

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

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

خطوات عملية لهذا الانتقال تحديدًا:

  • اعزل كل موضع استدعاء يصل حاليًا إلى نقطة نهاية المنطقة الزمنية في Google، لأنها غالبًا ما تُستدعى من دالة أو دالتين مساعدتين فقط حتى في قاعدة كود أكبر
  • اختبر مقابل إحداثيات في مناطق ذات قواعد غير معتادة للمنطقة الزمنية، مثل الأماكن التي تطبق فوارق بنصف ساعة أو المناطق التي لا تطبق التوقيت الصيفي، لأن هذه الحالات الحدية هي حيث تميل التحويلات الساذجة إلى الفشل
  • حدّث المصادقة إلى مفتاح يُرسَل في X-API-Key، أو Authorization: Bearer، أو عبر مصادقة HTTP Basic، أو كمعامل في الاستعلام، أيها يتلاءم بشكل أكثر طبيعية مع كود الطلبات الحالي لديك

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