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

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

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

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

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

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

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

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

آلية عمل Time Zone API

تقبل واجهة برمجة التطبيقات 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) بالثواني
  • الفارق الزمني للتوقيت الصيفي بالثواني
  • اطّلِع على "المنطقة الزمنية" للحصول على أمثلة محدّدة على الردود.
  • JSON
  • XML

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

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

مكتبات البرامج المتاحة

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

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

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