Timezone at coordinates API

Latitude/longitude → IANA timezone, current local time, UTC offset, and DST status — using the timezone-boundary map an agent can't derive itself. Answers 'what timezone is this point in', 'local time at these coordinates', 'is it daylight-saving there right now', 'UTC offset here'.

Price$0.01per request

MethodPOST

Route/v1/maps/timezone

StatusLive

MIME typeapplication/json

Rate limit120/minute

Cache60s public

mapstimezoneianalocal-timedstutc-offsetgeospatialscheduling

API URLhttps://x402.hexl.dev/v1/maps/timezone

Integration docs

Example request

{
  "latitude": 35.6762,
  "longitude": 139.6503
}

Example response

{
  "latitude": 35.6762,
  "longitude": 139.6503,
  "timezone": "Asia/Tokyo",
  "localTime": "2026-06-02T21:00:00",
  "utcOffsetMinutes": 540,
  "utcOffset": "+09:00",
  "isDST": false,
  "asOf": "2026-06-02T12:00:00.000Z"
}

Input schema

{
  "type": "object",
  "required": [
    "latitude",
    "longitude"
  ],
  "properties": {
    "latitude": {
      "type": "number",
      "examples": [
        35.6762
      ]
    },
    "longitude": {
      "type": "number",
      "examples": [
        139.6503
      ]
    },
    "at": {
      "type": "string",
      "examples": [
        "2026-06-02T12:00:00Z"
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}