Geliştirici API
İleri coğrafi kodlama, ters coğrafi kodlama, saat dilimi sorgusu, rakım ve güneş ile ay saatleri için ücretsiz, belgelenmiş bir REST API — bu sitenin üzerinde çalıştığı, gizliliğe saygılı aynı proxy'ler. Kredi kartı yok; anahtar anında verilir ve yalnızca bir kez gösterilir.
1000 istek/gün · 60 dakikada
| Uç nokta | Ne yapar | Örnek |
|---|---|---|
GET /api/v1/geocode | Adres / yer → koordinatlar (en iyi 5 eşleşme) | ?q=Eiffel+Tower |
GET /api/v1/reverse-geocode | Koordinatlar → adres | ?lat=48.858&lng=2.294 |
GET /api/v1/timezone | Koordinatlar → IANA saat dilimi + UTC farkı | ?lat=28.61&lng=77.21 |
GET /api/v1/elevation | Koordinatlar → arazi yüksekliği (Copernicus DEM) | ?lat=27.99&lng=86.93 |
GET /api/v1/sun-times | Gün doğumu, gün batımı, şafak, alacakaranlık, gün uzunluğu | ?lat=51.5&lng=-0.12&date=2026-07-19 |
GET /api/v1/moon | Ay evresi, aydınlanma oranı, ay doğumu/batımı | ?lat=51.5&lng=-0.12 |
Kimlik doğrulama: anahtarı X-Api-Key başlığı (tercih edilen) ya da ?key= parametresi olarak gönderin. Her yanıt X-RateLimit-Remaining-Today bilgisini içerir. Hatalar, error kodu taşıyan JSON biçimindedir. Coğrafi kodlama verileri © OpenStreetMap katkıda bulunanlar (ODbL) — yeniden sorgulamak yerine sonuçları önbelleğe alın ve son kullanıcı uygulamalarında kaynak gösterin.
# 1. Bir adresi coğrafi kodla
curl -H "X-Api-Key: wiml_YOURKEY" "https://whatismylocation.ai/api/v1/geocode?q=Taj+Mahal"
# 2. Ters coğrafi kodlama
curl -H "X-Api-Key: wiml_YOURKEY" "https://whatismylocation.ai/api/v1/reverse-geocode?lat=27.1751&lng=78.0421"
# 3. Bugünün güneş saatleri
curl -H "X-Api-Key: wiml_YOURKEY" "https://whatismylocation.ai/api/v1/sun-times?lat=27.1751&lng=78.0421"
Adil kullanım: ücretsiz katman prototipler, ajanlar ve küçük uygulamalar içindir. Daha fazlası mı gerekiyor? Bize yazın.
Bu API, bu sitedeki araçlar için onaylanmış makine uç noktasıdır (llms.txt ve ai.json dosyalarında da duyurulur). Ajanlar aynı ücretsiz katmanda kabul edilir — kayıt formundaki amaç alanında ajanınızı tanıtın.
Adres (ya da koordinat) içeren bir CSV dosyanız mı var? toplu coğrafi kodlama aracı, anahtarınızla doğrudan tarayıcınızda 500 satıra kadar veriyi bu API üzerinden işler — saniyede ~1 istekle nazikçe sıraya alınır, sonuçlar CSV veya GeoJSON olarak indirilebilir ve dosyanız hiçbir zaman sunucumuza ulaşmaz. Birkaç bin satırı aşan işler için ücretsiz bir topluluk hizmeti yerine ticari bir coğrafi kodlayıcı kullanın.