API для розробників
Безкоштовний документований REST API для прямого й зворотного геокодування, визначення часового поясу, висоти та часу сонця й Місяця — ті самі проксі з повагою до приватності, на яких працює цей сайт. Без банківської картки; ключ видається миттєво й показується один раз.
1000 запитів/день · 60 за хвилину
| Кінцева точка | Що робить | Приклад |
|---|---|---|
GET /api/v1/geocode | Адреса / місце → координати (5 найкращих збігів) | ?q=Eiffel+Tower |
GET /api/v1/reverse-geocode | Координати → адреса | ?lat=48.858&lng=2.294 |
GET /api/v1/timezone | Координати → часовий пояс IANA + зміщення від UTC | ?lat=28.61&lng=77.21 |
GET /api/v1/elevation | Координати → висота рельєфу (Copernicus DEM) | ?lat=27.99&lng=86.93 |
GET /api/v1/sun-times | Схід, захід сонця, світанок, сутінки, тривалість дня | ?lat=51.5&lng=-0.12&date=2026-07-19 |
GET /api/v1/moon | Фаза Місяця, освітленість, схід/захід Місяця | ?lat=51.5&lng=-0.12 |
Автентифікація: надсилайте ключ у заголовку X-Api-Key (бажано) або як параметр ?key=. Кожна відповідь містить X-RateLimit-Remaining-Today. Помилки повертаються у форматі JSON із кодом error. Дані геокодування © учасники OpenStreetMap (ODbL) — кешуйте результати замість повторних запитів і показуйте атрибуцію в застосунках для кінцевих користувачів.
# 1. Геокодувати адресу
curl -H "X-Api-Key: wiml_YOURKEY" "https://whatismylocation.ai/api/v1/geocode?q=Taj+Mahal"
# 2. Зворотне геокодування
curl -H "X-Api-Key: wiml_YOURKEY" "https://whatismylocation.ai/api/v1/reverse-geocode?lat=27.1751&lng=78.0421"
# 3. Час сонця на сьогодні
curl -H "X-Api-Key: wiml_YOURKEY" "https://whatismylocation.ai/api/v1/sun-times?lat=27.1751&lng=78.0421"
Добросовісне використання: безкоштовний тариф призначений для прототипів, агентів і невеликих застосунків. Потрібно більше? Напишіть нам.
Цей API — офіційна машинна точка доступу до інструментів цього сайту (також вказана в llms.txt та ai.json). Агенти можуть користуватися тим самим безкоштовним тарифом — зазначте свого агента в полі мети під час реєстрації.
Маєте CSV з адресами (або координатами)? Інструмент пакетного геокодування обробляє до 500 рядків через цей API просто у вашому браузері з вашим ключем — черга з делікатною швидкістю ~1 запит/секунду, результати можна завантажити як CSV або GeoJSON, а ваш файл ніколи не потрапляє на наш сервер. Для завдань понад кілька тисяч рядків використовуйте комерційний геокодер, а не безкоштовний громадський.