API dla programistów

Darmowe, udokumentowane API REST do geokodowania, geokodowania odwrotnego, odczytu strefy czasowej, wysokości n.p.m. oraz godzin słońca i księżyca — te same serwery pośredniczące, które szanują prywatność i na których działa ta strona. Bez karty kredytowej; klucz otrzymujesz od razu i widzisz go tylko raz.

1000 zapytań/dzień · 60 na minutę

Odbierz darmowy klucz

Imię i nazwisko

E-mail

Co zamierzasz zbudować? (opcjonalnie)

Przepisz wyświetlony kod

Nieczytelny? Odśwież stronę, aby otrzymać nowy kod. Weryfikujemy go na naszym serwerze — bez zewnętrznej usługi captcha, żadne Twoje dane nie opuszczają tej strony.

Twojego adresu e-mail używamy wyłącznie po to, by poinformować Cię o przełomowych zmianach w API lub o nadużyciach. Żadnych newsletterów, żadnej odsprzedaży.

Punkty końcowe

Punkt końcowy	Co robi	Przykład
`GET /api/v1/geocode`	Adres / miejsce → współrzędne (5 najlepszych dopasowań)	`?q=Eiffel+Tower`
`GET /api/v1/reverse-geocode`	Współrzędne → adres	`?lat=48.858&lng=2.294`
`GET /api/v1/timezone`	Współrzędne → strefa czasowa IANA + przesunięcie UTC	`?lat=28.61&lng=77.21`
`GET /api/v1/elevation`	Współrzędne → wysokość terenu (Copernicus DEM)	`?lat=27.99&lng=86.93`
`GET /api/v1/sun-times`	Wschód i zachód słońca, świt, zmierzch, długość dnia	`?lat=51.5&lng=-0.12&date=2026-07-19`
`GET /api/v1/moon`	Faza księżyca, oświetlenie, wschód/zachód księżyca	`?lat=51.5&lng=-0.12`

Uwierzytelnianie: wyślij klucz w nagłówku X-Api-Key (zalecane) lub jako parametr ?key=. Każda odpowiedź zawiera X-RateLimit-Remaining-Today. Błędy to JSON z kodem error. Dane geokodowania © współtwórcy OpenStreetMap (ODbL) — buforuj wyniki, zamiast ponawiać zapytania, i pokazuj atrybucję w aplikacjach dla użytkowników.

Szybki start

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

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

# 3. Godziny słońca na dziś
curl -H "X-Api-Key: wiml_YOURKEY" "https://whatismylocation.ai/api/v1/sun-times?lat=27.1751&lng=78.0421"

Uczciwe korzystanie: darmowy plan jest przeznaczony dla prototypów, agentów i małych aplikacji. Potrzebujesz więcej? Napisz do nas.

Dla agentów AI

To API jest oficjalnym maszynowym punktem dostępu do narzędzi z tej strony (zapowiadanym również w llms.txt i ai.json). Agenci są mile widziani w tym samym darmowym planie — opisz swojego agenta w polu przeznaczenia przy rejestracji.

Narzędzie zaawansowane: geokodowanie wsadowe

Masz plik CSV z adresami (lub współrzędnymi)? narzędzie do geokodowania wsadowego przepuszcza przez to API nawet 500 wierszy prosto w Twojej przeglądarce, z Twoim kluczem — w kolejce po ok. 1 zapytaniu na sekundę, z wynikami do pobrania jako CSV lub GeoJSON, a Twój plik nigdy nie trafia na nasz serwer. Przy zadaniach liczących ponad kilka tysięcy wierszy skorzystaj z komercyjnego geokodera zamiast darmowego, społecznościowego.