البدء

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

نموذج طلب واستجابة

يمكنك الوصول إلى Time Zone API من خلال واجهة HTTPS، مع إنشاء الطلبات كسلسلة عناوين URL، وذلك باستخدام إحداثيات خطوط الطول والعرض لتحديد location، وtimestamp لتحديد التاريخ، ومفتاح واجهة برمجة التطبيقات.

ينفّذ طلب البحث أدناه طلبًا بشأن المنطقة الزمنية لولاية نيفادا في الولايات المتحدة. تم ضبط الطابع الزمني على 8 آذار (مارس) 2012.

عنوان URL

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

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510×tamp=1733428634&key=YOUR_API_KEY'

يمكنك اختبار ذلك من خلال إدخال عنوان URL في متصفّح الويب (احرص على استبدال YOUR_API_KEY بمفتاح واجهة برمجة التطبيقات الفعلي). تتضمّن الاستجابة بيانات المنطقة الزمنية للموقع الجغرافي والتاريخ المحدّدَين (timestamp).

يمكنك الاطّلاع على دليل المطوّرين للحصول على مزيد من المعلومات حول إنشاء عناوين URL للطلبات والمَعلمات المتاحة و فهم الردّ.

في ما يلي نموذج استجابة بتنسيق JSON:

JSON

{
  "dstOffset": 0,
  "rawOffset": -28800,
  "status": "OK",
  "timeZoneId": "America/Los_Angeles",
  "timeZoneName": "Pacific Standard Time",
}

XML

<TimeZoneResponse>
 <status>OK</status>
 <raw_offset>-28800.0000000</raw_offset>
 <dst_offset>0.0000000</dst_offset>
 <time_zone_id>America/Los_Angeles</time_zone_id>
 <time_zone_name>Pacific Standard Time</time_zone_name>
</TimeZoneResponse>

بدء الترميز باستخدام مكتبات العملاء

تسهّل مكتبات البرامج إنشاء التطبيقات باستخدام واجهات برمجة التطبيقات الخاصة بخدمة الويب في &quot;خرائط Google&quot; من خلال توفير عمليات تنفيذ بسيطة ومدمجة للمهام الشائعة، مثل المصادقة والحدّ من عدد الطلبات وإعادة المحاولة تلقائيًا. تتوفّر Time Zone API في Java Client وPython Client وGo Client وNode.js Client لخدمات &quot;خرائط Google&quot;.

المصادقة والحصص والأسعار والسياسات

المصادقة

لاستخدام Time Zone API، يجب أولاً تفعيل واجهة برمجة التطبيقات والحصول على بيانات اعتماد المصادقة المناسبة. لمزيد من المعلومات، يُرجى الاطّلاع على بدء استخدام "منصة خرائط Google".

الحصص والأسعار

راجِع صفحة الاستخدام والفوترة للحصول على تفاصيل حول الحصص والأسعار المحدّدة لواجهة Time Zone API.

السياسات

يجب أن يكون استخدام Time Zone API متوافقًا مع سياسات واجهة برمجة التطبيقات.

مزيد من المعلومات

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

دليل مطوّري Time Zone API مخصّص لمطوّري المواقع الإلكترونية وتطبيقات الأجهزة الجوّالة الذين يريدون تضمين بيانات الوقت في الخرائط التي توفّرها إحدى واجهات برمجة التطبيقات في &quot;منصة خرائط Google&quot;. تقدّم هذه الصفحة مقدمة حول كيفية استخدام واجهة برمجة التطبيقات ومواد مرجعية حول المَعلمات المتاحة.