نظرة عامة على Time Zone API

واجهة برمجة تطبيقات المنطقة الزمنية هي خدمة تقبل طلب HTTP لإحداثيات خطوط العرض/الطول والتاريخ والوقت المطلوبين. تعرض بيانات المنطقة الزمنية للموقع، بما في ذلك التعويضات للتوقيت العالمي المنسق (UTC) والتوقيت الصيفي.

أسباب استخدام واجهة برمجة تطبيقات المنطقة الزمنية

باستخدام واجهة برمجة التطبيقات للمنطقة الزمنية، يمكنك تطوير التطبيقات التي توفّر معرّف المنطقة الزمنية واسمها للتواريخ والأوقات في مواقع جغرافية محدّدة على الخريطة. على سبيل المثال، يمكنك عرض بيانات المنطقة الزمنية التالية:

  • أسماء المناطق الزمنية المحلية لمواقع الخرائط من نظام خرائط Google الأساسي.
  • موازنة المنطقة الزمنية من التوقيت العالمي المنسق (UTC) وتوفير التوقيت الصيفي.

وقد تكون بيانات المنطقة الزمنية مفيدة بشكل خاص عندما تريد أن يعرض موقعك الإلكتروني أو تطبيقك بيانات تستند إلى الوقت ومرتبطة بالمستخدمين.

ما يمكنك فعله باستخدام واجهة برمجة تطبيقات المنطقة الزمنية

باستخدام واجهة برمجة التطبيقات للمنطقة الزمنية، يمكنك طلب المنطقة الزمنية للمواقع على سطح الأرض، مع معادلة التوقيت من التوقيت العالمي المنسق، بالتوقيت الصيفي لكل من هذه المواقع.

كيفية عمل واجهة برمجة تطبيقات المنطقة الزمنية

تقبل واجهة برمجة تطبيقات المنطقة الزمنية طلب HTTPS لإحداثيات خطوط الطول/العرض، والتاريخ والوقت المطلوبين كطابع زمني، واختياريًا رمز لغة. فهو يعرض البيانات بالتنسيق المحدد في الطلب. يوضّح المثال التالي طلبًا إلى نيفادا بالولايات المتحدة الأمريكية مع مخرج مطلوب في JSON.

 https://maps.googleapis.com/maps/api/timezone/json
    ?location=39.6034810%2C-119.6822510
    &timestamp=1331161200
    &key=YOUR_API_KEY

الموارد

يلخّص الجدول التالي الموارد المتاحة من خلال واجهة برمجة تطبيقات المنطقة الزمنية مع البيانات التي تعرضها.

موارد البيانات البيانات المعروضة تنسيق الإرجاع
المنطقة الزمنية

يجب تقديم طلبك بالإضافة إلى الموقع الجغرافي والطابع الزمني. راجِع المعلمات المطلوبة.

  • رقم تعريف المنطقة الزمنية.
  • اسم المنطقة الزمنية، مترجم اختياريًا
  • إزاحة من التوقيت العالمي المنسق بالثواني
  • إزاحة DST، بالثواني
  • راجع المنطقة الزمنية للاطلاع على أمثلة محددة للاستجابة.
  • JSON
  • XML

كيفية استخدام واجهة برمجة تطبيقات المنطقة الزمنية

1 الإعداد ابدأ من خلال إعداد مشروع Google Cloud وأكمِل تعليمات الإعداد التالية.
2 تجربة طلب منطقة زمنية بعد الحصول على مفتاح واجهة برمجة تطبيقات، يمكنك البدء في اختبار واجهة برمجة تطبيقات المنطقة الزمنية مباشرة من متصفّحك. راجِع أمثلة على المنطقة الزمنية في دليل طلبات المناطق الزمنية وردودها لمعرفة التفاصيل.
3 فهم أساسيات الاستجابة تعرَّف على كيفية استخدام بيانات المنطقة الزمنية في تطبيقك أو موقعك الإلكتروني. راجع الردود على المنطقة الزمنية للحصول على التفاصيل.
5 دمج بيانات المنطقة الزمنية في تطبيقك الخاص يمكنك استخدام بيانات المنطقة الزمنية لتحسين التطبيقات والمواقع الإلكترونية للمستخدمين في مواقع جغرافية مختلفة مستندة إلى الوقت.

مكتبات العملاء المتاحة

يمكنك استدعاء واجهة برمجة التطبيقات هذه باللغة التي تختارها من خلال إحدى مكتبات العملاء التالية:

عميلي جافا وعميل Python وGo Client وNode.js Client لخدمات خرائط Google هي مكتبات برامج يدعمها المنتدى ومفتوحة المصدر بموجب ترخيص Apache 2.0. يمكنك تنزيلها من GitHub، حيث يمكنك أيضًا العثور على تعليمات التثبيت ونموذج للرمز.

الخطوات التالية