API ya Wasanidi

API ya REST ya bure na yenye nyaraka kamili kwa jiokodi ya mbele, jiokodi kinyume, utafutaji wa saa za eneo, mwinuko na nyakati za jua na mwezi — vituo vile vile vinavyoheshimu faragha ambavyo tovuti hii inatumia. Hakuna kadi ya benki; ufunguo hutolewa papo hapo na huonyeshwa mara moja tu.

1000 maombi/siku · 60 kwa dakika

Pata ufunguo wako bure

Jina

Barua pepe

Utajenga nini? (si lazima)

Andika msimbo unaoonyeshwa

Hausomeki? Pakia ukurasa upya upate msimbo mpya. Huthibitishwa kwenye seva yetu — hakuna huduma ya captcha ya nje, hakuna taarifa zako zinazotoka kwenye tovuti hii.

Tunatumia barua pepe yako kukujulisha tu kuhusu mabadiliko makubwa ya API au matumizi mabaya. Hakuna majarida, hakuna kuuza.

Vituo vya API

Kituo	Kinachofanya	Mfano
`GET /api/v1/geocode`	Anwani / mahali → viwianishi (matokeo 5 bora)	`?q=Eiffel+Tower`
`GET /api/v1/reverse-geocode`	Viwianishi → anwani	`?lat=48.858&lng=2.294`
`GET /api/v1/timezone`	Viwianishi → saa za eneo za IANA + tofauti ya UTC	`?lat=28.61&lng=77.21`
`GET /api/v1/elevation`	Viwianishi → mwinuko wa ardhi (Copernicus DEM)	`?lat=27.99&lng=86.93`
`GET /api/v1/sun-times`	Macheo, machweo, mapambazuko, jioni, urefu wa siku	`?lat=51.5&lng=-0.12&date=2026-07-19`
`GET /api/v1/moon`	Awamu ya mwezi, mwangaza, kuchomoza/kutua kwa mwezi	`?lat=51.5&lng=-0.12`

Uthibitishaji: tuma ufunguo kama kichwa cha X-Api-Key (inapendekezwa) au kigezo cha ?key=. Kila jibu hujumuisha X-RateLimit-Remaining-Today. Hitilafu ni JSON zenye msimbo wa error. Data ya jiokodi © wachangiaji wa OpenStreetMap (ODbL) — hifadhi matokeo badala ya kuuliza upya, na onyesha sifa kwenye programu za watumiaji.

Anza haraka

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

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

# 3. Nyakati za jua leo
curl -H "X-Api-Key: wiml_YOURKEY" "https://whatismylocation.ai/api/v1/sun-times?lat=27.1751&lng=78.0421"

Matumizi ya haki: kiwango cha bure kipo kwa ajili ya majaribio, mawakala, na programu ndogo. Unahitaji zaidi? Zungumza nasi.

Kwa mawakala wa AI

API hii ndiyo kituo rasmi cha mashine kwa zana za tovuti hii (pia kinatangazwa katika llms.txt na ai.json). Mawakala wanakaribishwa kwenye kiwango hicho hicho cha bure — tambulisha wakala wako kwenye sehemu ya madhumuni wakati wa kujisajili.

Zana yenye nguvu: jiokodi ya kundi

Una CSV ya anwani (au viwianishi)? zana ya jiokodi ya kundi huendesha hadi safu 500 kupitia API hii moja kwa moja kwenye kivinjari chako kwa ufunguo wako — kwa foleni ya takriban ombi 1 kwa sekunde, matokeo yanaweza kupakuliwa kama CSV au GeoJSON, na faili yako haifiki kamwe kwenye seva yetu. Kwa kazi zaidi ya safu elfu chache, tumia jiokoda ya kibiashara badala ya ya jamii ya bure.