![نظرة عامة على Timezone API](https://developers.google.cn/static/maps/images/landing/places-api_480.png?authuser=9&hl=ar)
واجهة برمجة تطبيقات المنطقة الزمنية هي خدمة تقبل طلب HTTP
إحداثيات خط العرض/خط الطول والتاريخ والوقت المطلوبين. يعرض الوقت
بيانات المنطقة الخاصة بالموقع الجغرافي، بما في ذلك معادلة التوقيت العالمي المنسَّق (UTC) والتوقيت الصيفي
الوقت.
أسباب استخدام Time Zone API
باستخدام واجهة برمجة التطبيقات Time Zone API، يمكنك تطوير التطبيقات التي توفّر رقم تعريف المنطقة الزمنية واسم التواريخ والأوقات في مواقع جغرافية محدّدة على الخريطة. على سبيل المثال، يمكنك عرض ما يلي: بيانات المنطقة الزمنية:
- أسماء المناطق الزمنية المترجَمة للمواقع الجغرافية على الخريطة من "منصة خرائط Google"
- ويختلف التوقيت بين المنطقة الزمنية بالتوقيت العالمي المنسّق (UTC) وتوقيت التوقيت الصيفي.
يمكن أن تكون بيانات المنطقة الزمنية مفيدة بشكل خاص عندما ترغب في الحصول على موقعك الإلكتروني أو تطبيقك بيانات مستنِدة إلى الوقت وذات صلة بالمستخدمين
الإجراءات التي يمكنك تنفيذها باستخدام Time Zone API
من خلال واجهة برمجة التطبيقات Time Zone API، يمكنك طلب معلومات المنطقة الزمنية على سطح الأرض، مع معادلة الوقت من التوقيت العالمي المنسَّق (UTC) والتوقيت الصيفي لكل يوم تلك المواقع.
طريقة عمل Time Zone API
تقبل واجهة برمجة تطبيقات المنطقة الزمنية طلب HTTPS لخط الطول/العرض والإحداثيات، والتاريخ والوقت المطلوبين كطابع زمني، واختياريًا، رمز اللغة. وهو يعرض البيانات بالتنسيق المحدد في الطلب. يوضح المثال التالي طلبًا نيفادا، الولايات المتحدة الأمريكية، مع الناتج المطلوب بتنسيق JSON.
https://maps.googleapis.com/maps/api/timezone/json ?location=39.6034810%2C-119.6822510 ×tamp=1331161200 &key=YOUR_API_KEY
الموارد
يلخص الجدول التالي الموارد المتاحة من خلال Time Zone API مع البيانات التي تعرضها.
موارد البيانات | تم إرجاع البيانات | تنسيق الإرجاع |
---|---|---|
المنطقة الزمنية
يجب تقديم طلبك بالإضافة إلى الموقع الجغرافي والطابع الزمني. عرض حقل مطلوب المَعلمات. |
|
|
كيفية استخدام Time Zone API
1 | البدء | ابدأ بـ إعداد مشروع Google Cloud وإكمال عملية الإعداد والتعليمات التالية. |
2 | تجربة طلب المنطقة الزمنية | بمجرد حصولك على مفتاح واجهة برمجة التطبيقات، يمكنك البدء في اختبار Time Zone API مباشرةً من المتصفح. الاطّلاع على أمثلة على المنطقة الزمنية في دليل طلبات المنطقة الزمنية وردودها للاطّلاع على التفاصيل. |
3 | فهم أساسيات الردود | تعرَّف على كيفية استخدام بيانات المنطقة الزمنية في تطبيقك أو موقعك الإلكتروني. الاطّلاع على ردود المنطقة الزمنية لمزيد من التفاصيل. |
5 | يمكنك دمج بيانات المنطقة الزمنية في تطبيقك. | يمكنك استخدام بيانات المنطقة الزمنية لتحسين التطبيقات والمواقع الإلكترونية للمستخدمين على مستوى لغات مختلفة مستندة إلى الوقت. |
مكتبات العملاء المتاحة
استدعِ واجهة برمجة التطبيقات هذه بلغة حسب اختيارك من خلال إحدى مكتبات العملاء التالية:
- Java برنامج لخدمات "خرائط Google"
- لغة Python برنامج لخدمات "خرائط Google"
- عميل Go لخدمات "خرائط Google"
- Node.js برنامج لخدمات "خرائط Google"
عميل Java، وعميل Python، وعميل Go، وعميل Node.js لخرائط Google والخدمات هي مكتبات عملاء مدعومة من خلال المنتدى، وتكون مفتوحة المصدر ضمن ترخيص Apache 2.0: قم بتنزيلها من GitHub، حيث يمكنك أيضًا العثور على تعليمات التثبيت ونموذج التعليمات البرمجية.
الخطوات التالية
- تعرَّف على كيفية إرسال طلبات المنطقة الزمنية: انتقِل إلى طلبات المنطقة الزمنية والردود عليها:
- اتّباع أفضل الممارسات: الانتقال إلى أفضل ممارسات خدمات الويب.