Saat dilimi API: koordinattan saat dilimi ve yerel saat
Bir enlem ve boylam gönderin; Geo API noktanın IANA saat dilimini (örneğin Europe/Istanbul), o anki UTC farkını, yaz saatinde olup olmadığını ve yerel saatini döndürür. Toplantı planlamak, teslimat saatlerini hesaplamak ve kullanıcıya kendi yerel saatini göstermek için.
Nasıl çalışır
/v1/timezone?lat=&lon= noktayı saat dilimi sınırlarına göre bulur. utc_offset ve utc_offset_seconds o anki farkı, dst yaz saatinin geçerli olup olmadığını, abbreviation kısaltmayı (EST gibi), local_time da isteğin yapıldığı andaki yerel saati verir.
Fark ve yaz saati IANA saat dilimi veritabanının kurallarından hesaplanır; uygulamanızda bir saat dilimi tablosu tutmanız gerekmez.
Sınır bölgeleri ve deniz
İki saat diliminin çakıştığı yerlerde ambiguous: true döner ve candidates alanı her adayı kendi farkı, yaz saati bilgisi ve yerel saatiyle listeler; biri rastgele seçilip gizlenmez. Açık denizdeki bir noktada match: "none" döner, tahmin yürütülmez.
Ne için kullanılır
Bir mağaza ya da kullanıcı konumunun yerel saatini göstermek, farklı ülkelerdeki ekipler için toplantı saati önermek, bildirimleri alıcının gece saatine denk getirmemek. Aynı koordinatla il, ilçe ve ülkeyi de bulabilirsiniz.
Örnek istek ve yanıt
New York'ta bir nokta, kış aylarında sorgulandı. utc_offset, dst ve abbreviation sorgulanan ana göre değişir: New York'ta kışın EST ve -05:00, yazın EDT, -04:00 ve dst: true döner. local_time da isteğin yapıldığı anı gösterir. Bu uç nokta API anahtarı ister.
İstek
curl -H "Authorization: Bearer $GEO_API_KEY" "https://api.forlab.io/geo/v1/timezone?lat=40.7128&lon=-74.0060"Yanıttan bir kesit
{
"data": {
"match": "found",
"timezone": "America/New_York",
"utc_offset": "-05:00",
"utc_offset_seconds": -18000,
"dst": false,
"abbreviation": "EST",
"local_time": "2026-11-21T14:09:31-05:00",
"ambiguous": false
},
"meta": { … }
}Aynı iş Apify Actor ile
Anahtar almadan ya da toplu iş için Geo Reference Actor'üne bir liste verin; her öğe bir sonuç satırı olur ve gönderdiğiniz değer satırda kalır. Örnek girdi:
{"operation": "timezone", "items": [{"lat": 40.7128, "lon": -74.006}]}Ne kadar tutar
- Apify Actor (timezone işlemi): 1.000 koordinat sorgusu için 0,30 $.
- Bu uç noktada anahtarsız ücretsiz kullanım yok; anahtar için api@forlab.io adresine yazın.
- Geo API sayfasındaki canlı haritada tıkladığınız noktanın saat dilimi de görünür.
Apify'da kullandıkça ödersiniz: yalnız yanıtlanan sorgular ücretlenir, isteğe dönüşemeyen öğeler ücretsizdir, her çalıştırmaya ayrıca 0,001 $ başlangıç ücreti eklenir. Apify'ın ücretsiz planındaki aylık 5 $ kredi yaklaşık 16.000 koordinat sorgusuna yeter. Doğrudan API anahtarı için api@forlab.io adresine yazın.
Sık sorulan sorular
Yaz saati uygulamasını hesaba katıyor mu?
Evet. utc_offset o anki farkı verir ve dst alanı yaz saatinin geçerli olup olmadığını söyler. Bütün yıl tek farkı olan bir dilim, Türkiye gibi, hiçbir zaman dst: true döndürmez.
Bir ülkenin bütün saat dilimlerini alabilir miyim?
Evet. /v1/countries/{cc} ülkenin saat dilimlerini listeler; örneğin Türkiye için yalnız Europe/Istanbul gelir.
Geçmiş ya da gelecek bir tarih için sorgulayabilir miyim?
Hayır. Yanıt isteğin yapıldığı andaki farkı ve yerel saati verir. Başka bir tarih için dönen IANA adını kendi tarih kütüphanenizle kullanın.
Nokta denizdeyse ne olur?
Yanıt match: "none" ve timezone: null olur; en yakın kıyının saat dilimi tahmin edilmez.