نظرة عامة على Time Zone API

واجهة برمجة تطبيقات المنطقة الزمنية هي خدمة تقبل طلب HTTP لإحداثيات خطوط العرض/الطول وتاريخ ووقت محدّدَين. وتعرض بيانات المنطقة الزمنية للموقع الجغرافي، بما في ذلك معادلات التوقيت العالمي المنسّق (UTC) ونظام التوقيت الصيفي.

أهمية استخدام Time Zone API

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

  • أسماء المناطق الزمنية المترجَمة للمواقع الجغرافية على الخريطة من "منصة خرائط Google"
  • فروق التوقيت عن المنطقة الزمنية للتوقيت العالمي المنسَّق (UTC) ونظام التوقيت الصيفي

تكون بيانات المنطقة الزمنية مفيدة بشكل خاص عندما تريد أن يعرض موقعك الإلكتروني أو تطبيقك بيانات مستندة إلى الوقت ذات صلة بالأشخاص الذين يستخدمون تطبيقك.

الإجراءات التي تتيح Time Zone API تنفيذها

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

طريقة عمل Time Zone API

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

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

الموارد

يلخّص الجدول التالي الموارد المتاحة من خلال واجهة برمجة تطبيقات المنطقة الزمنية والبيانات التي تعرضها:

مصادر البيانات البيانات التي تم عرضها تنسيق الإرجاع
المنطقة الزمنية

يتم إرسال طلبك مع الموقع الجغرافي والطابع الزمني. يُرجى الاطّلاع على المَعلمات المطلوبة.

  • رقم تعريف المنطقة الزمنية
  • اسم المنطقة الزمنية، ويمكن ترجمته.
  • الفَرق بين التوقيت على الجهاز والتوقيت العالمي المنسَّق (UTC) بالثواني
  • الفَرق بين التوقيت على الجهاز وتوقيت غرينتش في التوقيت الصيفي بالثواني
  • يُرجى الاطّلاع على المنطقة الزمنية للحصول على أمثلة محدّدة على الردود.
  • JSON
  • XML

كيفية استخدام Time Zone API

1 إعداد الميزة ابدأ بإعداد مشروعك على Google Cloud وأكمِل تعليمات الإعداد التالية.
2 جرِّب طلبًا يتعلّق بالمنطقة الزمنية بعد الحصول على مفتاح واجهة برمجة التطبيقات، يمكنك بدء اختبار Time Zone API مباشرةً من متصفّحك. يمكنك الاطّلاع على أمثلة على المنطقة الزمنية في دليل طلبات المنطقة الزمنية والردود عليها لمزيد من التفاصيل.
3 التعرّف على أساسيات الردود تعرَّف على كيفية استخدام بيانات المنطقة الزمنية في تطبيقك أو موقعك الإلكتروني. لمزيد من التفاصيل، يُرجى الاطّلاع على ردود المنطقة الزمنية.
5 يمكنك دمج بيانات المنطقة الزمنية في تطبيقك. يمكنك استخدام بيانات المنطقة الزمنية لتحسين التطبيقات والمواقع الإلكترونية في مختلف المناطق المحلية المستندة إلى الوقت.

مكتبات العملاء المتاحة

يمكنك طلب بيانات واجهة برمجة التطبيقات هذه باللغة التي تختارها من خلال إحدى مكتبات البرامج التالية:

إنّ عملاء Java وPython وGo وNode.js لخدمات "خرائط Google" هم مكتبات عملاء يدعمها المنتدى، وهي مفتوحة المصدر بموجب ترخيص Apache 2.0. يمكنك تنزيلها من GitHub، حيث يمكنك أيضًا العثور على تعليمات التثبيت والرمز النموذجي.

الخطوات التالية