واجهة API للاستعلام عن المنطقة الزمنية

أرسل إحداثية واحصل على اسم المنطقة الزمنية في IANA وفرق التوقيت الحالي عن UTC وهل التوقيت الصيفي سارٍ والوقت المحلي. وأرسل طابعًا زمنيًا أيضًا لتحصل على فرق التوقيت الذي كان ساريًا، أو الذي سيسري، في تلك اللحظة، وهو ما تحتاج إليه للجدولة وللسجلات التاريخية.

GEThttps://api.mygeocode.com/v1/timezone?lat=...&lon=...

جرّبها في العرض التجريبي المرجع الكامل

مثال

الطلب

$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/timezone?lat=35.6762&lon=139.6503"

# At a specific moment (Unix seconds)
$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/timezone?lat=40.7128&lon=-74.0060&timestamp=1773817200"

احفظ اسم timezone لا فرق التوقيت. تتغير فروق التوقيت مرتين في السنة في أماكن كثيرة، وأحيانًا بشكل دائم عندما تغيّر حكومة ما القواعد. يبقى اسم IANA صالحًا، وتُحدَّث القواعد هنا خلال يوم من كل إصدار من IANA.

الاستجابة

{
  "status": "ok",
  "lat": 35.6762,
  "lon": 139.6503,
  "timezone": "Asia/Tokyo",
  "abbreviation": "JST",
  "utc_offset": "+09:00",
  "utc_offset_seconds": 32400,
  "dst": false,
  "timestamp": 1756335245,
  "local_time": "2026-08-28T08:34:05+09:00",
  "country_code": "JP"
}

ما تحصل عليه

الحقل	المعنى
`timezone`	اسم IANA مثل `Europe/Berlin`. وفي المياه الدولية، منطقة بحرية مثل `Etc/GMT-3`.
`abbreviation`	الاختصار الساري عند الطابع الزمني: `CET` و`CEST` و`JST`. ليس فريدًا على مستوى العالم، للعرض فقط.
`utc_offset`, `utc_offset_seconds`	فرق التوقيت عند الطابع الزمني، نصًا ورقمًا.
`dst`	هل التوقيت الصيفي سارٍ عند الطابع الزمني.
`timestamp`, `local_time`	اللحظة التي تصفها الإجابة، بثواني Unix وكسلسلة RFC 3339 بالتوقيت المحلي.
`country_code`	الدولة التي تقع فيها النقطة، إن وُجدت.

أين تُستخدم

الجدولة عبر المواقع

أرسل تذكيرًا في الساعة 9 صباحًا بالتوقيت المحلي لكل متجر. استعلم عن المنطقة الزمنية مرة واحدة لكل متجر وحوّل الوقت بمكتبة المناطق الزمنية في لغتك البرمجية.

تصحيح الطوابع الزمنية في السجلات

يمكن تصحيح بيانات الأجهزة التي تسجّل الوقت المحلي دون فرق توقيت لاحقًا، بالاستعلام عن فرق التوقيت عند ذلك الطابع الزمني والموقع.

عرض الوقت المحلي للمستخدمين

اعرض «الساعة هناك 8:34 صباحًا» بجانب موقع على الخريطة أو بطاقة جهة اتصال.

السعر والحدود

استدعاء واحد، طلب واحد. لكل مفتاح 2,500 طلب مجاني يوميًا، وبعد ذلك يُخصم 0.0001 € لكل طلب من الرصيد المسبق الدفع، أو لا شيء على مفتاح Unlimited (50 € شهريًا). الأسعار. يتوفر تنسيقا Google Time Zone API وBing Time Zone كمضيفات بديلة متوافقة.