API Pembangun

REST API percuma yang berdokumentasi untuk geocoding hadapan, geocoding songsang, carian zon masa, ketinggian serta waktu matahari dan bulan — proksi menghormati privasi yang sama seperti yang digunakan laman ini. Tiada kad kredit; kunci dikeluarkan serta-merta dan dipaparkan sekali sahaja.

1000 permintaan/hari · 60 seminit

Dapatkan kunci percuma anda

Nama

E-mel

Apa yang anda akan bina? (pilihan)

Taip kod yang dipaparkan

Tidak dapat dibaca? Muat semula halaman untuk kod baharu. Disahkan pada pelayan kami — tiada perkhidmatan captcha pihak ketiga, tiada maklumat tentang anda keluar dari laman ini.

Kami menggunakan e-mel anda hanya untuk menghubungi anda tentang perubahan API yang memutuskan keserasian atau penyalahgunaan. Tiada surat berita, tiada penjualan semula.

Titik akhir

Titik akhir	Apa yang dilakukannya	Contoh
`GET /api/v1/geocode`	Alamat / tempat → koordinat (5 padanan teratas)	`?q=Eiffel+Tower`
`GET /api/v1/reverse-geocode`	Koordinat → alamat	`?lat=48.858&lng=2.294`
`GET /api/v1/timezone`	Koordinat → zon masa IANA + ofset UTC	`?lat=28.61&lng=77.21`
`GET /api/v1/elevation`	Koordinat → ketinggian rupa bumi (Copernicus DEM)	`?lat=27.99&lng=86.93`
`GET /api/v1/sun-times`	Matahari terbit, terbenam, fajar, senja, panjang siang	`?lat=51.5&lng=-0.12&date=2026-07-19`
`GET /api/v1/moon`	Fasa bulan, pencahayaan, bulan terbit/terbenam	`?lat=51.5&lng=-0.12`

Pengesahan: hantar kunci sebagai pengepala X-Api-Key (disyorkan) atau parameter ?key=. Setiap respons menyertakan X-RateLimit-Remaining-Today. Ralat ialah JSON dengan kod error. Data geocoding © penyumbang OpenStreetMap (ODbL) — simpan hasil dalam cache dan bukannya menanya semula, serta paparkan atribusi dalam apl pengguna akhir.

Permulaan pantas

# 1. Geokod satu alamat
curl -H "X-Api-Key: wiml_YOURKEY" "https://whatismylocation.ai/api/v1/geocode?q=Taj+Mahal"

# 2. Geokod songsang
curl -H "X-Api-Key: wiml_YOURKEY" "https://whatismylocation.ai/api/v1/reverse-geocode?lat=27.1751&lng=78.0421"

# 3. Waktu matahari untuk hari ini
curl -H "X-Api-Key: wiml_YOURKEY" "https://whatismylocation.ai/api/v1/sun-times?lat=27.1751&lng=78.0421"

Penggunaan saksama: peringkat percuma ini wujud untuk prototaip, ejen dan apl kecil. Perlukan lebih? Hubungi kami.

Untuk ejen AI

API ini ialah titik akhir mesin yang dibenarkan untuk alat di laman ini (turut diiklankan dalam llms.txt dan ai.json). Ejen dialu-alukan pada peringkat percuma yang sama — kenal pasti ejen anda dalam medan tujuan semasa pendaftaran.

Alat kuasa: geocoding kelompok

Ada fail CSV berisi alamat (atau koordinat)? alat geocoding kelompok menjalankan sehingga 500 baris melalui API ini terus dalam pelayar anda dengan kunci anda — dibariskan dengan sopan pada ~1 permintaan/saat, hasil boleh dimuat turun sebagai CSV atau GeoJSON, dan fail anda tidak pernah menyentuh pelayan kami. Untuk tugasan melebihi beberapa ribu baris, gunakan geocoder komersial dan bukannya geocoder komuniti yang percuma.