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

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

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

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

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

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

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

باستخدام واجهة برمجة التطبيقات 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 والبيانات التي يعرضها.

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

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

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

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

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

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

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

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

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