<!-- generated by scripts/docs/generate-reference.ts — do not edit -->
astro_geocode
Place-name → coordinates + timezone. basic Free; atlas Paid (historical TZ + DST).
- Layer: utility
- Methods: basic, atlas
- Free tier: basic
- Paid tier: atlas
Description
Place-name → coordinates + timezone. `basic` Free; `atlas` Paid (historical TZ + DST).
Methods:
basic [Free] — place name → matching places with coordinates + IANA timezone (Photon/OSM backend)
atlas [Paid] — timezones + UTC offset at a coordinate (historical TZ via Intl)
Input schema
basic
| Field | Type | Required | Constraints |
|---|
| query | string | yes | minLength 2 |
| limit | integer | no | min 1, max 10, int |
atlas
| Field | Type | Required | Constraints |
|---|
| latitude | number | yes | min -90, max 90 |
| longitude | number | yes | min -180, max 180 |
| atUtc.year | integer | yes | int |
| atUtc.month | integer | yes | min 1, max 12, int |
| atUtc.day | integer | yes | min 1, max 31, int |
| atUtc.hour | integer | yes | min 0, max 23, int |
| atUtc.minute | integer | yes | min 0, max 59, int |