/api/astro/geocode/1 créditoBúsqueda de lugares
Convierte el nombre de un lugar en las coordenadas y la diferencia con UTC que necesitan los demás endpoints. Envía un GET con un parámetro de consulta `address`, como 'Jaipur, India', y recibirás `latitude`, `longitude`, el `timezone_name` de IANA, el `timezone_offset` en horas con decimales, la cadena `address` del propio geocodificador y el `source`, el proveedor que respondió. La diferencia horaria ya tiene en cuenta el horario de verano cuando el proveedor lo indica, así que es la diferencia actual de ese lugar, no necesariamente la que regía en una fecha de nacimiento histórica. Para una carta natal, pasa estas coordenadas a /api/astro/date_time/ con la fecha real y deja que ese endpoint calcule la diferencia horaria del momento correcto. `source` indica qué proveedor respondió: 'google' cuando el despliegue tiene configurada una clave de Google Maps; si no, 'nominatim', el servicio de OpenStreetMap que se usa como alternativa. Un lugar que no se encuentra devuelve 404, y si falta `address` se devuelve 400.
https://api.occultapi.com/api/astro/geocode/Autenticación
Envía tu clave en la cabecera X-API-Key. La clave es una credencial de servidor: nunca la pongas en el JavaScript del navegador ni en una app móvil.
X-API-Key: yt_live_a1b2c3d4_…Parámetros de consulta (1)
Van en la URL. Son opcionales salvo que se indique lo contrario y se pueden combinar: primero se filtra, luego se pagina y al final se ordena.
| Parámetro | Tipo | Ejemplo | Para qué sirve | |
|---|---|---|---|---|
| address | string | obligatorio | Jaipur, Rajasthan, India | El nombre de la ciudad o del lugar que se busca Nombre del lugar que se busca. Texto libre: normalmente basta con la ciudad; añade el estado o el país si hay ambigüedad. |
Ejemplo de solicitud
curl "https://api.occultapi.com/api/astro/geocode/?address=Jaipur" \
-H "X-API-Key: $OCCULT_API_KEY"Respuesta
{
"address": "Jaipur, Rajasthan, India",
"latitude": 26.9124336,
"longitude": 75.7872709,
"timezone_name": "Asia/Calcutta",
"timezone_offset": 5.5,
"source": "google"
}Obtenida de una llamada real con la solicitud de arriba, tal cual. Los resultados van dentro de data.
Errores
Los errores de control de uso devuelven { "error": "…", "message": "<code>", "is_error": true }. Muestra error al usuario y usa message para decidir qué hace tu código. Consulta la referencia de errores.