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

Пошук місця

Перетворює назву місця на координати й зміщення від UTC, потрібні іншим ендпоінтам. Надішліть GET-запит із параметром `address`, напр. '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. Детальніше — у довіднику помилок.