API pro vývojáře
Bezplatné zdokumentované REST API pro geokódování, zpětné geokódování, vyhledání časového pásma, nadmořskou výšku a časy Slunce a Měsíce — tytéž proxy respektující soukromí, na kterých běží celý tento web. Bez platební karty; klíč vydáme okamžitě a zobrazíme jen jednou.
1000 požadavků/den · 60 za minutu
| Koncový bod | Co dělá | Příklad |
|---|---|---|
GET /api/v1/geocode | Adresa / místo → souřadnice (5 nejlepších shod) | ?q=Eiffel+Tower |
GET /api/v1/reverse-geocode | Souřadnice → adresa | ?lat=48.858&lng=2.294 |
GET /api/v1/timezone | Souřadnice → časové pásmo IANA + posun vůči UTC | ?lat=28.61&lng=77.21 |
GET /api/v1/elevation | Souřadnice → nadmořská výška terénu (Copernicus DEM) | ?lat=27.99&lng=86.93 |
GET /api/v1/sun-times | Východ a západ slunce, úsvit, soumrak, délka dne | ?lat=51.5&lng=-0.12&date=2026-07-19 |
GET /api/v1/moon | Fáze Měsíce, osvětlení, východ/západ Měsíce | ?lat=51.5&lng=-0.12 |
Ověření: klíč posílejte v hlavičce X-Api-Key (doporučeno) nebo jako parametr ?key=. Každá odpověď obsahuje X-RateLimit-Remaining-Today. Chyby jsou ve formátu JSON s kódem error. Geokódovací data © přispěvatelé OpenStreetMap (ODbL) — výsledky si raději ukládejte do mezipaměti, než abyste se dotazovali opakovaně, a v aplikacích pro koncové uživatele uvádějte zdroj.
# 1. Geokódování adresy
curl -H "X-Api-Key: wiml_YOURKEY" "https://whatismylocation.ai/api/v1/geocode?q=Taj+Mahal"
# 2. Zpětné geokódování
curl -H "X-Api-Key: wiml_YOURKEY" "https://whatismylocation.ai/api/v1/reverse-geocode?lat=27.1751&lng=78.0421"
# 3. Sluneční časy pro dnešek
curl -H "X-Api-Key: wiml_YOURKEY" "https://whatismylocation.ai/api/v1/sun-times?lat=27.1751&lng=78.0421"
Férové užití: bezplatná úroveň je určena pro prototypy, agenty a malé aplikace. Potřebujete víc? Napište nám.
Toto API je oficiální strojové rozhraní pro nástroje na tomto webu (uvedené také v llms.txt a ai.json). Agenti jsou vítáni na stejné bezplatné úrovni — svého agenta uveďte v registraci v poli s účelem.
Máte CSV s adresami (nebo souřadnicemi)? Nástroj pro hromadné geokódování zpracuje až 500 řádků přes toto API přímo ve vašem prohlížeči s vaším klíčem — ohleduplně ve frontě rychlostí ~1 požadavek za sekundu, výsledky ke stažení jako CSV nebo GeoJSON a váš soubor nikdy nedorazí na náš server. U úloh nad několik tisíc řádků použijte raději komerční geokodér než bezplatný komunitní.