‏‫الخطوات الأولى

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

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

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

يُجري الطلب أدناه طلب منطقة زمنية لنيومكسيكو، الولايات المتحدة الأمريكية. تم ضبط الطابع الزمني على 8 آذار (مارس) 2012.

عنوان URL

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

cURL

curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=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>

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

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

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

المصادقة

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

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

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

السياسات

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

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

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

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