Reverse Geocoding with Time Zone

Introduction

The Reverse geocoding with Timezone API provides a combined output version of the Reverse Geocoding to City API and Time Zone by Location API.

The primary purpose of this API is to reduce the number of API calls and provide you with an option of getting more productive data points within a single API request.

Example Response

The response is only available in JSON format. The below response should be expected for the following request:

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

Awaiting request submission...

API Pricing

Monthly Subscription

FREE 50,000 queries/month

Additional 50,000 queries US$3.00/month

Add To My Subscription
Annual Subscription

FREE 50,000 queries/month

Additional 50,000 queries US$2.40/month

Add To My Subscription

Request Format

NEW! Payload compression is supported, simply add Accept-Encoding: gzip header.
Use the form below to try out this API.

Parameter	Your Input Value	Description
latitude		Latitude value as per WGS 84 reference system (GPS system). Expected values are in [-90, 90] range.
longitude		Longitude value as per WGS 84 reference system (GPS system). Expected values are in [-180, 180] range.
localityLanguage		Preferred language for locality names in ISO 639-1 format, such as 'en' for English, 'es' for Spanish etc. Please note: 147 common world languages are supported, full list here, but not all languages are available for every location. If requested language is not available for a requested location it will default to English, if no English is available, the native, local names will be provided
key		Your API key Don't have an API Key? Click here to register and get your free API Key If you already have a BigDataCloud account, you can log in to automatically fill this field with your Api Key.

The live query

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

CURL Example

curl -X GET --header 'Accept: application/json' 'https://api.bigdatacloud.net/data/reverse-geocode-with-timezone'

Visit our SDK page to access API clients in specific languages like Javascript, Python + PHP.

Response

Awaiting request submission...

Response Format

Field	Data type	Description
latitude	float	Requested Latitude
longitude	float	Requested Longitude
plusCode	string	Open Location Code (read more here plus codes)
localityLanguageRequested	string	localityLanguage input parameter received
continent	string	Localised Continent name in the requested language, if available
continentCode	string	Continent code
countryName	string	Localised Country name in the requested language, if available
countryCode	string	Country code as defined by ISO 3166-1 standard
principalSubdivision	string	Localised principal subdivision name in the requested language, if available
principalSubdivisionCode	string	Principal subdivision code as defined by ISO 3166-2 standard
city	string	Localised city name in the requested language, if available
locality	string	Represents the smallest geographic area recognised to which the target belongs. The language, if available, is as defined by ‘localityLanguage’ request parameter
postcode	string	Postcode, if available
localityInfo	<LocalityInfo> object	Detailed reverse geocoded locality information localised to the language as defined by ‘localityLanguage’ request parameter
timeZone	<Time Zone> object	Detailed time zone information

API Endpoint

Endpoint:	/data/reverse-geocode-with-timezone
Full URL:	https://api.bigdatacloud.net/data/reverse-geocode-with-timezone

Data Objects

Locality Info object

Field	Data type	Description
administrative	Aray of <LocalityProperty> objects	Administrative boundarires ordered by area (largest first). Omitted if no administrative boundaries are available
informative	Aray of <LocalityProperty> objects	Non-administrative boundarires ordered by area (largest first). Omitted if not available

Locality Property object

Field	Data type	Description
order	integer	Order value consistent across all entities in the Locality Info parent object. Ordered by geographic area (largest first)
adminLevel	integer	An administrative level as defined by OpenStreetMaps project
name	string	Localised name of the place in the requested language, if available. The language is as defined by ‘localityLanguage’ request parameter
description	string	Localised description of the place in the requested language, if available. The language is as defined by ‘localityLanguage’ request parameter
isoName	string	ISO 3166-2 standard name, if available
isoCode	string	ISO 3166-2 standard code, if available
wikidataId	string	Wikidata item identifier, if available
geonameId	integer	Unique identifier given by GeoNames.org
chinaAdminCode	string	China Administrative division code. This is available only for locations based in China, and is omitted for others.

Timezone Object

Field	Data type	Description
ianaTimeId	string	Time Zone name in IANA format
displayName	string	Display name
effectiveTimeZoneFull	string	Effective time zone full name (adjusted to the daylight saving status)
effectiveTimeZoneShort	string	Effective time zone short name (adjusted to the daylight saving status)
UtcOffsetSeconds	32 bit integer	Effective offset from UTC time in seconds
UtcOffset	string	Effective offset from UTC time
isDaylightSavingTime	boolean	Indicates if the daylight saving is on
localTime	string	Local time in ISO 8601 format

Introduction

Example Response

API Pricing

Monthly Subscription

Annual Subscription

Request Format

Response

Response Format

API Endpoint

Data Objects

Locality Info object

Locality Property object

Timezone Object

Related APIs

Time Zone by Location API

Reverse Geocoding to City API

FREE Client Side Reverse Geocoding to City API

Sidebar

Registered Users

Or

Create Account

Reset Your Password