Time Zone by Location API
On this page
This API returns time zone information for any latitude and longitude coordinates — the IANA time zone identifier, current UTC offset, daylight saving time status and schedule, and current local time.
It's useful when you have a user's geographic coordinates and need to display local time, schedule events correctly, or convert UTC timestamps to the user's local time. Pass in a UTC reference time and the API performs the conversion for you.
If you also need locality information (city, country, etc.) for the same coordinates, the Reverse Geocoding with Timezone API returns both in a single call.
Endpoint
GET
https://api-bdc.net/data/timezone-by-locationParameters
| Parameter | Type | Required | Description |
|---|---|---|---|
latitude | number (double) | Optional | Latitude value as per WGS 84 reference system (GPS system). Expected values are in [-90, 90] range |
longitude | number (double) | Optional | Longitude value as per WGS 84 reference system (GPS system). Expected values are in [-180, 180] range |
utcReference | integer (int64) | Optional | UTC time reference in Unix Time Seconds format. When omitted or invalid, the current time is assumed |
key | string | Optional | Your API key |
Responses
200OK
Sample Request
https://api-bdc.net/data/timezone-by-location?latitude=-34.9313&longitude=138.59669&key=[YOUR API KEY]Sample Response
JSON View
Response Schema
ianaTimeIdstringThe unique identifier of the time zone from the IANA Time Zone Database (e.g., "America/New_York").
displayNamestringThe user-friendly display name for the time zone (e.g., "(UTC-05:00) Eastern Time (US & Canada)").
effectiveTimeZoneFullstringThe full name of the effective time zone, adjusted for daylight saving (e.g., "Eastern Daylight Time").
effectiveTimeZoneShortstringThe abbreviated name of the effective time zone, adjusted for daylight saving (e.g., "EDT").
utcOffsetSecondsintegerThe effective offset from UTC in seconds, adjusted for daylight saving time.
utcOffsetstringThe effective offset from UTC, formatted as a string and adjusted for daylight saving time.
isDaylightSavingTimebooleanA boolean value indicating whether daylight saving time is currently in effect.
localTimestringThe current local time in the specified time zone, formatted in ISO 8601 "O" format.
utcTimestringThe corresponding UTC time, formatted in ISO 8601 "O" format. This value is omitted if the 'utcReference' parameter was not supplied or was invalid.
400Bad request
Sample Response
JSON View
401Invalid coordinates
Sample Response
JSON View
403Access denied, or your quota limit has exceeded
Sample Response
JSON View
404Found no valid entry for the request
Sample Response
JSON View
500An error has occurred and did not complete your request. Please try again
Sample Response
JSON View