BigDataCloud Logo

Reverse Geocoding with Timezone API

Introduction

The Reverse Geocoding with Timezone API combines the data output of Reverse Geocoding to City API and Time Zone by Location API, providing a comprehensive API solution for building location-based applications.

It replaces the need for calling these two APIs separately, making your application faster and saving your monthly API quotas. This is particularly important for applications that rely heavily on location-based data and require frequent API calls.

Get Started

This API is part of the Reverse Geocoding API Package and is available in free and paid plans. Please visit the Reverse Geocoding API Package package page for limits and pricing information.

Endpoint

GET
https://api-bdc.net/data/reverse-geocode-with-timezone

Request

Parameter
latitude
Type
number (double)
Required
Yes
Description
Latitude value as per WGS 84 reference system (GPS system). Expected values are in [-90, 90] range
Parameter
longitude
Type
number (double)
Required
Yes
Description
Longitude value as per WGS 84 reference system (GPS system). Expected values are in [-180, 180] range
Parameter
localityLanguage
Type
string
Required
Optional, default value: en
Description
Preferred language for locality names in ISO 639-1 format, such as 'en' for English, 'es' for Spanish etc. If the requested language is unavailable for a requested location, it will default to English. If no English variant is available, will provide the native, local names. Use 'default' as the requested value to automatically adjust the language to the first administrative language in the Country.
Parameter
key
Type
string
Required
Yes
Description
Your API key

Responses

200
OK

Sample Query

GET
https://api-bdc.net/data/reverse-geocode-with-timezone?latitude=-34.93126&longitude=138.5967&localityLanguage=en&key=[YOUR API KEY]

Schema

application/json
latitudenumber
Requested Latitude
longitudenumber
Requested Longitude
localityLanguageRequestedstring
localityLanguage input parameter received
continentstring
Localised Continent name in the requested language, if available
continentCodestring
Continent code
countryNamestring
Localised Country name in the requested language, if available
countryCodestring
Country code as defined by ISO 3166-1 standard
principalSubdivisionstring
Localised principal subdivision name in the requested language, if available
principalSubdivisionCodestring
Principal subdivision code as defined by ISO 3166-2 standard
citystring
The most significant populated place this location belongs. It will likely be the City name in the language requested. If unavailable, use the locality name field as a failover
localitystring
Represents the smallest geographic area recognised to which the target belongs. The language, if available, is as defined by 'localityLanguage' request parameter
postcodestring
Postcode, if available
plusCodestring
Open Location Code
fips
FIPS code object, omitted if unavailable. FIPS (Federal Information Processing Standards) Codes are codes used by the Census Bureau to uniquely identify places in the US. Visit FIPS FAQ page for more information.
statestring
State-level FIPS codes have two digits
countystring
A three digits County-level FIPS code.
countySubdivisionstring
FIPS five digits County Subdivision Code
placestring
FIPS five digits place code, omitted if unavailable
csdCodestring
CSD (Census Subdivision) code, omitted if unavailable. Canadian Geographic Codes. Visit CSD FAQ page for more information.
localityInfo
localityInfo object
administrativearray
Administrative authorities as ordered by area (most significant first). Omitted if no administrative boundaries are available
namestring
Localised name of the place in the requested language, if available. The language is as defined by the 'localityLanguage' request parameter
descriptionstring
Localised description of the place in the requested language, if available. The language is as defined by the 'localityLanguage' request parameter
isoNamestring
ISO 3166-2 standard name, if available
orderinteger
Order value consistent across all entities in the Locality Info parent object. Ordered by geographic area (most significant first)
adminLevelinteger
An administrative level as defined by OpenStreetMaps project
isoCodestring
ISO 3166-2 standard code, if available
wikidataIdstring
Wikidata item identifier, if available
geonameIdinteger
Unique identifier given by GeoNames.org, if available
chinaAdminCodestring
China Administrative division code. Only available for locations based in China and omitted for others
informativearray
Non-administrative boundaries as ordered by area (most significant first). Omitted if unavailable
namestring
Localised name of the place in the requested language, if available. The language is as defined by the 'localityLanguage' request parameter
descriptionstring
Localised description of the place in the requested language, if available. The language is as defined by the 'localityLanguage' request parameter
isoNamestring
ISO 3166-2 standard name, if available
orderinteger
Order value consistent across all entities in the Locality Info parent object. Ordered by geographic area (most significant first)
adminLevelinteger
An administrative level as defined by OpenStreetMaps project
isoCodestring
ISO 3166-2 standard code, if available
wikidataIdstring
Wikidata item identifier, if available
geonameIdinteger
Unique identifier given by GeoNames.org, if available
chinaAdminCodestring
China Administrative division code. Only available for locations based in China and omitted for others
timeZone
timeZone object
ianaTimeIdstring
The unique identifier of the time zone from the IANA Time Zone Database (e.g., "America/New_York").
displayNamestring
displayName object
effectiveTimeZoneFullstring
The full name of the effective time zone, adjusted for daylight saving (e.g., "Eastern Daylight Time").
effectiveTimeZoneShortstring
The abbreviated name of the effective time zone, adjusted for daylight saving (e.g., "EDT").
utcOffsetSecondsinteger
The effective offset from UTC in seconds, adjusted for daylight saving time.
utcOffsetstring
The effective offset from UTC, formatted as a string and adjusted for daylight saving time.
isDaylightSavingTimeboolean
A boolean value indicating whether daylight saving time is currently in effect.
localTimestring
The current local time in the specified time zone, formatted in ISO 8601 "O" format.
utcTimestring
The corresponding UTC time, formatted in ISO 8601 "O" format. This value is omitted if the 'utcReference' parameter was not supplied or was invalid.

Sample Response

JSON View
400
Bad request

Sample Response

JSON View
401
Invalid coordinates

Sample Response

JSON View
403
Access denied, or your quota limit has exceeded

Sample Response

JSON View
500
An error has occurred and did not complete your request. Please try again

Sample Response

JSON View
Was this page helpful?