GET/api/astro/geocode/1 кредит

Поиск места

Превращает название места в координаты и смещение UTC, которые нужны остальным эндпоинтам. Отправьте GET-запрос с параметром `address` в URL, например 'Jaipur, India', и получите `latitude`, `longitude`, название часового пояса IANA `timezone_name`, смещение `timezone_offset` в часах десятичным числом, строку адреса от геокодера `address` и `source` — источник, который дал ответ. Смещение уже учитывает летнее время, если провайдер его сообщает, поэтому это текущее смещение для этого места, и оно не обязательно совпадает со смещением на историческую дату рождения. Для натальной карты передайте эти координаты вместе с фактической датой в /api/astro/date_time/ — он определит смещение для нужного момента. `source` показывает, какой провайдер ответил: 'google', если для развёртывания настроен ключ Google Maps, иначе 'nominatim' — сервис OpenStreetMap, который используется как запасной. Если место не найдено, возвращается 404, если не передан `address` — 400.

https://api.occultapi.com/api/astro/geocode/

Попробовать запрос

Аутентификация

Передавайте ключ в заголовке X-API-Key. Ключ — это серверные учётные данные: никогда не вставляйте его в JavaScript на стороне браузера или в мобильное приложение.

X-API-Key: yt_live_a1b2c3d4_…

Параметры строки запроса (1)

Передаются в URL. Все необязательны, если не отмечено иное, и их можно сочетать: сначала фильтр, затем страница, затем сортировка.

Параметр	Тип		Пример	Назначение
address	string	обязательный	`Jaipur, Rajasthan, India`	Название города или места для поиска Название места для поиска. Произвольный текст — обычно достаточно города; для однозначности добавьте штат или страну.

Пример запроса

curl "https://api.occultapi.com/api/astro/geocode/?address=Jaipur" \
  -H "X-API-Key: $OCCULT_API_KEY"

Ответ

{
  "address": "Jaipur, Rajasthan, India",
  "latitude": 26.9124336,
  "longitude": 75.7872709,
  "timezone_name": "Asia/Calcutta",
  "timezone_offset": 5.5,
  "source": "google"
}

Записано с реального вызова ровно с этим запросом. Результаты лежат в data.

Ошибки

Ошибки списания кредитов приходят в виде { "error": "…", "message": "<code>", "is_error": true }. Людям показывайте error, а логику стройте на message. Подробнее — в справочнике ошибок.