Developer API

Isang libre at dokumentadong REST API para sa forward geocoding, reverse geocoding, paghahanap ng time zone, elevation at oras ng araw at buwan — ang mismong mga proxy na gumagalang sa privacy na pinapatakbo ng site na ito. Walang credit card; agad na ibinibigay ang key at isang beses lang ito ipinapakita.

1000 request/araw · 60 kada minuto

Kunin ang libreng key mo

Pangalan

Ano ang gagawin mo? (opsyonal)

I-type ang code na ipinapakita

Hindi mabasa? I-reload ang pahina para sa bagong code. Bine-verify sa server namin — walang third-party na captcha service, walang tungkol sa iyo ang umaalis sa site na ito.

Ginagamit lang namin ang email mo para ipaalam ang mga pagbabagong makakasira sa API o ang pang-aabuso. Walang newsletter, walang pagbebenta.

Mga endpoint

Endpoint	Ano ang ginagawa nito	Halimbawa
`GET /api/v1/geocode`	Address / lugar → coordinates (top 5 na tugma)	`?q=Eiffel+Tower`
`GET /api/v1/reverse-geocode`	Coordinates → address	`?lat=48.858&lng=2.294`
`GET /api/v1/timezone`	Coordinates → IANA na time zone + UTC offset	`?lat=28.61&lng=77.21`
`GET /api/v1/elevation`	Coordinates → elevation ng lupain (Copernicus DEM)	`?lat=27.99&lng=86.93`
`GET /api/v1/sun-times`	Pagsikat, paglubog ng araw, bukang-liwayway, takipsilim, haba ng araw	`?lat=51.5&lng=-0.12&date=2026-07-19`
`GET /api/v1/moon`	Moon phase, liwanag, pagsikat/paglubog ng buwan	`?lat=51.5&lng=-0.12`

Authentication: ipadala ang key bilang X-Api-Key header (mas mainam) o bilang ?key= parameter. Kasama sa bawat sagot ang X-RateLimit-Remaining-Today. JSON ang mga error, may error code. Geocoding data © mga kontribyutor ng OpenStreetMap (ODbL) — i-cache ang mga resulta sa halip na mag-query ulit, at ipakita ang atribusyon sa mga app para sa end user.

Mabilisang simula

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

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

# 3. Mga oras ng araw para sa ngayon
curl -H "X-Api-Key: wiml_YOURKEY" "https://whatismylocation.ai/api/v1/sun-times?lat=27.1751&lng=78.0421"

Patas na paggamit: para sa mga prototype, agent, at maliliit na app ang libreng tier. Kailangan ng higit pa? Kausapin kami.

Para sa mga AI agent

Ang API na ito ang opisyal na machine endpoint para sa mga tool sa site na ito (inaanunsyo rin sa llms.txt at ai.json). Malugod na tinatanggap ang mga agent sa parehong libreng tier — tukuyin ang iyong agent sa purpose field ng signup.

Malakas na tool: batch geocoding

May CSV ka ba ng mga address (o coordinates)? Pinapatakbo ng tool ng batch geocoding ang hanggang 500 row sa API na ito mismo sa browser mo gamit ang key mo — nakapila nang maayos sa ~1 request kada segundo, nada-download ang mga resulta bilang CSV o GeoJSON, at hindi kailanman dumadaan sa server namin ang file mo. Para sa mga trabahong lampas sa ilang libong row, gumamit ng komersyal na geocoder sa halip na libreng pang-komunidad.