توفّر واجهة برمجة التطبيقات Time Zone API بيانات عن المنطقة الزمنية للمواقع الجغرافية على سطح الأرض. يمكنك طلب معلومات المنطقة الزمنية لزوج محدّد من خطوط العرض وخطوط الطول والتاريخ. تعرض واجهة برمجة التطبيقات اسم تلك المنطقة الزمنية، وفرق التوقيت عن التوقيت العالمي المنسق، وفرق نظام التوقيت الصيفي.
نموذج الطلب والردّ
يمكنك الوصول إلى 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>
بدء الترميز باستخدام مكتبات العملاء
تسهّل مكتبات العملاء عملية التطوير باستخدام واجهات برمجة التطبيقات لخدمات الويب في "خرائط Google" من خلال توفير عمليات تنفيذ مباشرة ومضمّنة للمهام الشائعة، مثل المصادقة والتحكّم في الطلبات وإعادة المحاولة تلقائيًا. تتوفّر واجهة برمجة تطبيقات المنطقة الزمنية في عميل Java وعميل Python وعميل Go وعميل Node.js لخدمات "خرائط Google".
المصادقة والحصص والأسعار والسياسات
المصادقة
لاستخدام Time Zone API، عليك أولاً تفعيل واجهة برمجة التطبيقات والحصول على بيانات اعتماد المصادقة المناسبة. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة بدء استخدام "منصة خرائط Google".
الحصص والأسعار
للاطّلاع على تفاصيل حول الحصص والأسعار المحدّدة لواجهة Time Zone API، يُرجى مراجعة مقالة الاستخدام والفوترة.
السياسات
يجب أن يتوافق استخدام Time Zone API مع سياسات واجهة برمجة التطبيقات.
مزيد من المعلومات
في Time Zone API، يمكنك أيضًا ضبط مَعلمة لغة لعرض النتائج بلغات غير اللغة الإنجليزية التلقائية. يمكنك الاطّلاع على دليل مطوّري Time Zone API لمزيد من الأمثلة والتفاصيل الأخرى.
يساعد دليل المطوّرين الخاص بواجهة Time Zone API مطوّري المواقع الإلكترونية والأجهزة الجوّالة في تضمين بيانات الوقت على الخرائط التي توفّرها إحدى واجهات برمجة التطبيقات في "منصة خرائط Google". ويقدّم مقدّمة حول استخدام واجهة برمجة التطبيقات ومراجع حول المَعلمات المتاحة.