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

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

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

المصادقة

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

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

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

السياسات

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

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

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

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