البدء

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

نموذج للطلب والرد

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

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

عنوان URL

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

cURL

curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=1331161200&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 Client، وعميل Node.js لخدمات "خرائط Google".

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

المصادقة

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

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

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

السياسات

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

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

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

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