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.
Parámetros de consulta (1)
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.