Locator Centric is committed to guide and advocate for the use of Location-Based Services (LBS) as the cornerstone of innovation and growth. Our quest is to strengthen all phases of the location-based and location-aware innovation continuum, from discovery to ideation, enablement to empowerment.Subscribe Now

Timezone Offset Changes for Daylight Savings

If you intend to use the GMTOffset from the Location Api response to calculate times local to the location, you MUST be careful to observe the NextOffsetChange property. The offset will change on the date and time specified.

Using the expires header as described above will ensure that you have the most current GMTOffset for the location.

Languages

Below are the available world languages and their corresponding language_code for use with the API. All of the language codes have been derived from the ISO 639-1 Alpha-2 codes. Languages that support additional localizations can be expanded to show a list of the localizations. All of the localization codes have been drived from the Microsoft Language Codes.

Language

Language Code

Localizations

Arabic

ar

Arabic (Algeria)

ar-dz

Arabic (Bahrain)

ar-bh

Arabic (Egypt)

ar-eg

Arabic (Iraq)

ar-iq

Arabic (Jordan)

ar-jo

Arabic (Kuwait)

ar-kw

Arabic (Lebanon)

ar-lb

Arabic (Libya)

ar-ly

Arabic (Morocco)

ar-ma

Arabic (Oman)

ar-om

Arabic (Qatar)

ar-qa

Arabic (Saudi Arabia)

ar-sa

Arabic (Syria)

ar-sy

Arabic (Tunisia)

ar-tn

Arabic (U.A.E.)

ar-ae

Arabic (Yemen)

ar-ye

Bengali* (Coming Soon)

bn

Bosnian* (Coming Soon)

bs

Bulgarian*

bg

Catalan

ca

Croatian*

hr

Czech

cs

Chinese

zh

Chinese (Hong Kong SAR) – Traditional

zh-hk

Chinese (PRC) – Simplified

zh-cn

Chinese (Singapore)

zh-sg

Chinese (Taiwan)

zh-tw

Danish

da

Dutch

nl

Dutch (Belgium)

nl-be

English

en

English (Australia)

en-au

English (Belize)

en-bz

English (Canada)

en-ca

English (Ireland)

en-ie

English (New Zealand)

en-nz

English (South Africa)

en-za

English (Trinidad)

en-tt

English (United Kingdom)

en-gb

English (United States)

en-us

Estonian*

et

Farsi*

fa

Filipino*

ph

Finnish

fi

French

fr

French (Belgium)

fr-be

French (Canada)

fr-ca

French (Luxembourg)

fr-lu

French (Switzerland)

fr-ch

German

de

German (Austria)

de-at

German (Liechtenstein)

de-li

German (Luxembourg)

de-lu

German (Switzerland)

de-ch

Greek

el

Hebrew

he

Hindi

hi

Hungarian

hu

Icelandic* (Coming Soon)

is

Indonesian

id

Italian

it

Italian (Switzerland)

it-ch

Japanese

ja

Kazakh*

kk

Korean

ko

Latvian*

lv

Lithuanian*

lt

Macedonian*

mk

Malaysian*

ms

Montenegrin* (Coming Soon)

sr-me

Norwegian

no

Polish

pl

Portuguese

pt

Portuguese (Brazil)

pt-br

Romanian

ro

Romanian (Republic of Moldova)

ro-mo

Russian

ru

Russian (Republic of Moldova)

ru-mo

Serbian*

sr

Slovak

sk

Slovenian

sl

Spanish

es

Spanish (Argentina)

es-ar

Spanish (Bolivia)

es-bo

Spanish (Chile)

es-cl

Spanish (Colombia)

es-co

Spanish (Costa Rica)

es-cr

Spanish (Dominican Republic)

es-do

Spanish (Ecuador)

es-ec

Spanish (El Salvador)

es-sv

Spanish (Guatemala)

es-gt

Spanish (Honduras)

es-hn

Spanish (Mexico)

es-mx

Spanish (Nicaragua)

es-ni

Spanish (Panama)

es-pa

Spanish (Paraguay)

es-py

Spanish (Peru)

es-pu

Spanish (Puerto Rico)

es-pr

Spanish (Uruguay)

es-uy

Spanish (Venezuela)

es-ve

Swahili* (Coming Soon)

sw

Swedish

sv

Swedish (Finland)

sv-fi

Thai*

th

Turkish

tr

Ukrainian

uk

Urdu* (Coming Soon)

ur

Vietnamese*

vi

* – Denotes a language that is only supported in the new API architecture. They will be available in future releases of the Mobile and Traditional websites.

limit: Integer indicates the number of resources to return with the request. Default value set to 25.

Location key: Unique ID that can be used to search for a specific location.

Localization: The process of translating information into different languages or adapting a product for a specific country or region. Within the API setting, this term is used to represent languages, including the localized dialects.

max: Integer specifies the total list size. This cannot exceed 100. Default value set to 100.

offset: Integer along with the limit determines the first resource to return. Default value set to 0.

Rank: Number applied to locations set by factors such as population, political importance, and geographic size. Location search results are returned in rank order. A lower rank number represents a city of larger population, political importance, an important location of commerce or larger geographic size. A rank value of “10” would be considered the highest ranking location.

Resolution: Measure of the sharpness of an image. This can be found as a parameter for the Imagery API.

REST: Representational State Transfer

start: Date indicating the start date of a range.

Verified Location: A term used to describe a location that has been verified by our primary location data provider. For searches that return multiple results, verified locations will always be returned at the top of the list. Only verified locations will be used in GeoLookup and AutoComplete searches. Also, only verified locations will be supported for localizations (translations). An unverified location can be added to the verified list, provided that there is credible information to confirm the latitude/longitude, name, country, and primary administrative code.

Postal Codes

Verified postal code searching is available for the following countries, with the root level of the code in red:

Canada – Follows the format A0A 0A0. All lookups are based on the Forward Sortation Areas, or FSA, part of the postal code.

Germany – Follows the format 00000. Many of the postal code names are available in German as well as English.

United Kingdom – Follows the format A0 0AA, A00 0AA, AA0 0AA, AA00 0AA, A0A 0AA, or AA0A 0AA. All lookups are based on the Postcode Sector. The UK Postal Code system also includes support for the following areas: Guernsey, Isle of Man, and Jersey.

United States – Follows the format 00000. The US Postal Code system also includes support for the following areas: American Samoa, Federated States of Micronesia, Guam, Marshall Islands, Northern Mariana Islands, Palau, Puerto Rico, and the US Virgin Islands.

One postal code can point to many locations; Use Location Key to get back to a specific postal code.

In many cases, the name for a particular postal code is derived from the location of the post office responsible for that postal code. These names often differ from the cities located in that same area.

Since postal codes can cover a large area, derived data is mapped based on what best represents the whole area of the postal code.

Points of Interest

Abbreviated as POI, a Point of Interest is frequently used to refer to business location, tourist location, or other well know site. Common examples of POIs available are Airports, Stadiums, and Parks.

More than 50,000 searchable Points of Interest.

More than 12,000 worldwide airports, including the ability to search by airport codes (FAA, ICAO, IATA codes supported).

Primarily focused on the US, with plans to expand to other countries in the near future, including support for localized names

Only cities can be seached through Autocomplete. Not designed to work with postal codes.

Regions

Below are the available regions and their corresponding region_code for use with the API. While each country will only have one primary region listed, any country that spans more than one region will be returned for every region the country falls within. For example, the country of Russia will be returned in both the Europe and Asia lists.

Region Code

Region Name

AFR

Africa

ANT

Antarctica

ARC

Arctic

ASI

Asia

CAC

Central America

EUR

Europe

MEA

Middle East

NAM

North America

OCN

Oceania

SAM

South America

Countries

Below are the available countries, dependent territories, and special areas of geographical interest along with their corresponding country_code and region_code for use with the API. All of the country codes have been derived from the ISO 3166-1 Alpha-2 codes.

Administrative Areas

Primary Administrative Areas

Every location will have will have one primary administrative area assigned to it.

The primary administrative area is designated by the Level: 1 code in the AdministrativeArea block of the response.

Admin Codes have been derived from the ISO 3166-2 codes, where available, focusing on the principal subdivisions.

If the principal subdivisions of a particular country are not available, the code “00” will be assigned to all locations in that country. The name of the country will be assigned as the administrative name for any “00” codes.

In the event that a principal subdivision has not yet had an ISO 3166-2 code assigned to it, codes ranging from “X01” to “X99” will be assigned a place holder until the official code has been released.

Each primary administrative area will also include the administrative classification, such as State, Province, etc.

Examples

Country Code

Admin Code

Admin Name

Admin Type

US

NY

New York

State

CA

ON

Ontario

Province

FR

J

Île-De-France

Region

KR

11

Seoul

Special City

VA

00

Vatican City

TH

X01

Bueng Kan

Province

Supplemental Administrative Areas

Supplemental Administrative Areas can be used to help distinguish between locations that look similar.

Each area is assigned a number to describe the scale of the administrative subdivisions for countries. As the Level number increases, the scale of the subdivision will decrease.

Political boundaries

Internationally recognized areas focusing on the secondary subdivisions, where available.

Level 0

Used to categorize the Constituent Country, or subcountry, for locations that belong to a country that makes up a part of a larger entity.

Currently used for locations in the UK to represent England, Scotland, Wales, and Northern Ireland.

Primary use case – Replace Country Name with Constituent Country Name

London, United Kingdom

London, England

Level 2

Used to represent secondary subdivisions of the primary administrative areas.

Primary use case – Include in parentheses after the primary adminstrative information.

Location API Response Parameters

Number appiled to locations set by factors such as population, political importance, and geographic size

LocalizedName

Display name in local dialect set with language code in URL. Default is US English (us-en)

EnglishName

Location name as displayed in English

PrimaryPostalCode

Official postal code provided by our main location data provider for the requested location

Region

ID

Unique region code for location

LocalizedName

Region name displayed in the local dialect set with the language code in the URL. If no language code is selected, the default is US English (us-en)

EnglishName

Region name displayed in English

Country

ID

Unique ISO or Microsoft Localization Code for the country

LocalizedName

Country name as displayed in the local dialect set with language code in the URL. If no language code is selected, the default is US English (us-en)

EnglishName

Country name displayed in English

AdministrativeArea

ID

Unique administrative area ID

LocalizedName

Administrative area name as displayed in local dialect set with language code in the URL. If no language code is selected, the default is English

EnglishName

Administrative area name displayed in English

Level

An assigned number to describe the scale of the administrative subdivisions for countries. As the Level number increases, the scale of the subdivision will decrease. Numbers of 10 or greater are reserved for non-political boundaries and should be used independently

TimeZone

Code

Official abbreviation code for designated Time Zone

Name

Official name of designated Time Zone

GmtOffset

Number of hours offset from local GMT time

IsDaylightSaving

A “true” or “false” verification of whether a location is currently observing Day Light Saving time

NextOffsetChange

Next time that daylight saving time changes

GeoPosition

Latitude

Geographical coordinate that specifies the north-south position of a point on the Earth’s surface

Longitude

Geographical coordinate that specifies the east-west position of a point on the Earth’s surface

Elevation

Metric

m

Imperial

ft

Value

Rounded value of elevation in above units

Unit

Type of unit for the elevation value above

IsAlias

“True” or “false” verification of whether a location is an “alias” or an alternative name or spelling for a requested location

SupplementalAdminAreas

Level

An assigned number to describe the scale of the administrative subdivisions for countries. As the Level number increases, the scale of the subdivision will decrease. Numbers of 10 or greater are reserved for non-political boundaries and should be used independently

LocalizedName

Administrative area name as displayed in local dialect set with language code in the URL. If no language code is selected, the default is English

EnglishName

Administrative area name displayed in English

Key

Unique ID to identify a location

StationCode

Weather station code of the location

StationGmtOffset

GMT offset of the weather station

BandMap

Temperature and precipitation band map code

Climo

Source of climatology data for the location

LocalRadar

Local radar code associated with the location

MediaRegion

Media region associated with the location

Metar

Metar station of the location

NXMetro

City level radar code

NXState

State level radar code

Population

Reported population of the location

PrimaryWarningCountyCode

Primary warning county code

PrimaryWarningZoneCode

Primary warning zone code

Satellite

Satellite associated with the location

Synoptic

Synoptic station associated with the location

MarineStation

Marine station code

MarineStationGMTOffset

GMT offset of the marine station

VideoCode

Code that identifies city or region for video

DMA

Designated market area

ID

Numeric id to identify the marketing area

EnglishName

Name of the designated market area

Sources

Official sources of data by type

DataType

The type of data the source provides

Source

Name of the data provider

SourceId

Id associated witht the source. Can be used as a key

CanonicalPostalCode

Optimized postal code which may be the postal code of the location or a nearby metropolitan area. May be empty.

CanonicalLocationKey

Optimized locationKey which may be the locationKey of the location or a nearby metropolitan area. May be empty.

Location API Code Samples

JavaScript:

Locator Centric’s global suite of IP solutions enables the world’s leading brands, from progressive start-ups to multinational enterprises, to produce an impermeable ecosystem of location-based and location-aware services.