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

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

أسباب استخدام Time Zone API

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

  • أسماء المناطق الزمنية المترجَمة للمواقع الجغرافية على الخريطة من "منصة خرائط Google"
  • ويختلف التوقيت بين المنطقة الزمنية بالتوقيت العالمي المنسّق (UTC) وتوقيت التوقيت الصيفي.

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

الإجراءات التي يمكنك تنفيذها باستخدام Time Zone API

من خلال واجهة برمجة التطبيقات Time Zone API، يمكنك طلب معلومات المنطقة الزمنية على سطح الأرض، مع معادلة الوقت من التوقيت العالمي المنسَّق (UTC) والتوقيت الصيفي لكل يوم تلك المواقع.

طريقة عمل Time Zone API

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

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

الموارد

يلخص الجدول التالي الموارد المتاحة من خلال Time Zone API مع البيانات التي تعرضها.

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

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

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

كيفية استخدام Time Zone API

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

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

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

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

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