API для разработчиков

Бесплатный документированный REST API для прямого и обратного геокодирования, определения часового пояса, высоты, а также времени солнца и луны — те же бережные к приватности прокси, на которых работает сайт. Банковская карта не нужна: ключ выдаётся мгновенно и показывается один раз.

1000 запросов в день · 60 в минуту

Получить бесплатный ключ

Имя

Эл. почта

Что вы создаёте? (необязательно)

Введите показанный код

Не разобрать? Перезагрузите страницу, чтобы получить новый код. Проверка идёт на нашем сервере — без сторонних сервисов капчи, никакие ваши данные не покидают сайт.

Мы используем вашу почту только для сообщений о критических изменениях API или злоупотреблениях. Без рассылок и передачи третьим лицам.

Эндпоинты

Эндпоинт	Что делает	Пример
`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, а ваш файл не попадает на наш сервер. Для задач в несколько тысяч строк лучше взять коммерческий геокодер, а не бесплатный общественный.