Tool detail

geoprimitives

For a latitude/longitude and optional ISO instant, returns the IANA timezone, current UTC offset, DST status, and local wall-clock time.

Categories: Maps places, Utilities

Use when

find the timezone for a given latitude/longitude
check whether DST applies at a location on a given date
convert a location and instant into local wall-clock time

Not for

not reliable for historical timezone-boundary changes after May 2016 (map frozen at tzdb 2016d)
not a geocoder — needs coordinates, not place names

Inputs

GET query params: lat (number -90..90, required), lon (number -180..180, required), at (ISO 8601 instant 1900-2100, optional, default now)

Admitted input schema

{
  "type": "object",
  "properties": {
    "at": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "format": "date-time",
      "description": "Optional ISO 8601 instant to answer for, e.g. 2026-07-04T16:00:00Z. Defaults to now. Must fall between 1900 and 2100."
    },
    "lat": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude in decimal degrees, EPSG:4326. Refused outside -90..90 rather than normalised."
    },
    "lon": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitude in decimal degrees, EPSG:4326. Refused outside -180..180."
    }
  },
  "required": [
    "lat",
    "lon"
  ],
  "additionalProperties": false
}

Endpoint

Method: GET
URL: https://api.geoprimitives.dev/v1/timezone

Payment

Protocol: x402
Listed price: 0.005 USDC per call on Base
Payment method: exact
Network: eip155:8453
Asset: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Listed terms are catalog metadata. The caller supplies inputs and calls the tool outside Onelayer. If payment is required, the caller uses a compatible wallet to pay.

Source

Directory: Coinbase x402 Bazaar
Record: GET https://api.geoprimitives.dev/v1/timezone
Retrieved: 2026-09-30T20:37:07.382Z
Catalog file SHA-256: 6837ccddf886f0007cf3727ea9d27faaa5047b51b4f425345c554ce1c271a524
Catalog built: 2026-09-30T22:31:58.034Z