Timezone from Coordinates

Timezone from Coordinates API

Utilities

Convert latitude and longitude coordinates to timezone identifiers. Get IANA timezone names like "America/New_York" or "Asia/Tokyo" from any location.

Authentication

All API requests require a valid API key passed in the Authorization header as a Bearer token.

Endpoints

1 endpoint available

Overview

The Timezone from Coordinates API converts geographic coordinates (latitude and longitude) into IANA timezone identifiers. Simply provide a location's coordinates and receive the standardized timezone name used by that location.

What You Get

The API returns timezone information for the given coordinates:

  • Timezone ID - IANA timezone identifier (e.g., "America/New_York", "Asia/Aden")
  • UTC Offset - Current UTC offset for the timezone
  • DST Status - Whether daylight saving time is currently in effect

Coordinate Format

  • Latitude - Decimal degrees from -90 to 90 (negative = South)
  • Longitude - Decimal degrees from -180 to 180 (negative = West)

Use Cases

  • Converting GPS coordinates to local timezone
  • Scheduling applications with location awareness
  • Travel and booking platforms
  • IoT devices reporting location-based time
  • Analytics systems requiring timezone normalization

Endpoints

GET
/v1/tools/timezone-from-coordinates
Get timezone identifier from latitude and longitude coordinates

Response Example

{
  "success": true,
  "timezone": {
    "id": "Asia/Aden",
    "utcOffset": "+03:00",
    "isDst": false
  },
  "coordinates": {
    "lat": 12.7797,
    "lng": 45.0095
  }
}

Error Codes

400
Invalid coordinates provided
401
Missing or invalid API key
500
Internal server error

Code Examples

curl -X GET "https://toolshed.app/api/v1/tools/timezone-from-coordinates?lat=12.7797&lng=45.0095" \
  -H "Authorization: Bearer YOUR_API_KEY"

Ready to get started?

Create an API key to start using the Timezone from Coordinates API.