Reverse Geocoding with Timezone API

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

  1. Monthly Subscription
    FREE 50,000 queries/month
    Additional 50,000 queries US$3.00/month
  2. Annual Subscription
    FREE 50,000 queries/month
    Additional 50,000 queries US$2.40/month

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, 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

localityLanguageRequested

string

localityLanguage input parameter received

countryName

 string

Country name. Omitted if not available

countryCode

 string

Country code. Omitted if not available

principalSubdivision

 string Principal subdivision. Omitted if not available

locality

 string Locality name. Omitted if not available

postcode

 string

Postcode. Omitted if not 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 area (largest first)

adminLevel

integer

An administrative level as defined by OpenStreetMaps project

name

string

Localised name. The language is as defined by ‘localityLanguage’ request parameter

description

string

Localised description. 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

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

 

Related APIs

  1. Time Zone by Location API
    FREE 10,000 queries/month
    Additional 10,000 queries
    US$1.00
    /month

    Returns detailed time-zone information when provided with Latitude/Longitude coordinates.

    • Very fast
    • Daylight saving
    • Local time
    • Past/future time
    Read More
  2. Reverse Geocoding to City API
    FREE 50,000 queries/month
    Additional 50,000 queries
    US$2.00
    /month

    Returns detailed locality information for provided Latitude/Longitude coordinates

    • Lightning fast (sub-millisecond response time)
    • Detailed locality data
    • Localised to the language of choice
    Read More
  3. FREE Client Side Reverse Geocoding to City API
    FREE
    Unlimited

    FREE client-side reverse geocoding API translates any GPS location in the world into usable location information

    • Lightning fast (sub-millisecond response time)
    • Detailed locality data
    • Localised to the language of choice
    • Free and unlimited, no credit card required
    Read More

Sidebar