Geocoder API Developer's Guide

Political Views

Description

The Geocoder provides a feature that can show available territories through the point of view of particular countries.

A neutral international view is made available by default, where territories may have unresolved claims.

Examples

Below is an example of the Kashmiri city of "Srinagar". The Geocoder now represents this neutrally for the International community. India and Pakistan have their own particular views available for this locality using the parameter &politicalview= and their respective 3-Letter ISO country codes.

International View of "Srinagar" (default)

Query:
&prox=34.0922244,74.8193568,1000

Previous Result:

Label: "Ganderbal Road, Khaniyar, Srinagar 190003, India",
Country: "IND",
State: "JK",
County: "Srinagar",
City: "Srinagar",
District: "Khaniyar",
Street: "Ganderbal Road",
PostalCode: "190003",

Current Result:

Empty response (neutral territory)

Indian Political View of "Srinagar"

Query:
&prox=34.0922244,74.8193568,1000&politicalview=IND

Result:

Label: "Ganderbal Road, Khaniyar, Srinagar 190003, India",
Country: "IND",
State: "JK",
County: "Srinagar",
City: "Srinagar",
District: "Khaniyar",
Street: "Ganderbal Road",
PostalCode: "190003",

Pakistani Political View of "Srinagar"

Query:
&prox=34.0922244,74.8193568,1000&politicalview=PAK

Result:

Label: "190003, Pakistan",
Country: "PAK",
PostalCode: "190003",

Currently Supported Disputes

The following views are currently supported:
  • ARE: Abu Musa Island, Tunb Islands
  • ARG: Argentina
  • EGY: Halaib Triangle
  • GRC: Northern Cyprus
  • IND: India
  • ISR: Israel view on East Jerusalem
  • KEN: Ilemi Triangle
  • MAR: Western Sahara
  • PAK: Pakistan
  • RUS: Crimea, Kuril Islands (Shikotan, Iturup, Habomai, and Kunashir)
  • TUR: Northern Cyprus, Southern Cyprus, Kosovo
  • VNM: Vietnam
For any political view that is unsupported, the Geocoder falls back to the default view. For example, politicalview=USA or politicalview=FRA does not impact a response in any way.
Name Example Coordinates Political View Support Description
Northern Arunachal Pradesh 28.6512526, 95.2272352 default, IND

Default = Neutral territory (empty response)

IND = Part of the Indian State of Arunachal Pradesh

Falkland Islands -51.6958016, -57.8529192 default, ARG

Default = Falklands Islands

ARG = Part of Argentina's "Tierra Del Fuego"

South Georgia and South Sandwich Islands -54.2915196, -36.4940174 default, ARG

Default = South Georgia And The South Sandwich Islands

ARG = Part of Argentina's "Tierra Del Fuego"

(Indian-Chinese Border)Kaurik 32.2112327, 78.5563334 default, IND

Default = Neutral territory (empty response)

IND = Part of the Indian State of Himachal Pradesh

(Indian-Chinese Border)Lapthal 30.7338287, 80.1058805 default, IND

Default = Neutral territory (empty response)

IND = Part of the Indian State of Uttarakhand

(Indian-Chinese Border)Sang 31.2917262, 79.0702687 default, IND

Default = Neutral territory (empty response)

IND = Part of the Indian State of Uttarakhand

(Kashmir)Aksai Chin 35.1355791, 79.0428155 default, IND, PAK

Default = Neutral territory (empty response)

IND = Part of the Indian State of Jammu & Kashmir

PAK = Seen as a part of China

(Kashmir)Azad Kashmir 33.9430273, 73.8271172 default, IND, PAK

Default = Neutral territory (empty response)

IND = Part of the Indian State of Jammu & Kashmir

PAK = Seen as a part of Pakistan

(Kashmir)Gilgit-Baltistan 35.8260676, 75.0474641 default, IND, PAK

Default = Neutral territory (empty response)

IND = Part of the Indian State of Jammu & Kashmir

PAK = Seen as a part of Pakistan

(Kashmir)Pa-li-chia-ssu 33.257519, 79.2483097 default, IND, PAK

Default = Neutral territory (empty response)

IND = Part of the Indian State of Jammu & Kashmir

PAK = Seen as a part of Pakistan

(Kashmir)Shaksam Valley 36.0928479, 76.3108918 default, IND, PAK

Default = Neutral territory (empty response)

IND = Part of the Indian State of Jammu & Kashmir

PAK = Seen as a part of China

(Kashmir)State of Jammu & Kashmir 33.5625116, 76.9892775 default, IND, PAK

Default = Neutral territory (empty response)

IND = Part of the Indian State of Jammu & Kashmir

PAK = Seen as a part of Pakistan

(Golan Heights) UN Buffer Zone

33.2053155, 35.8740408

default Default = Neutral territory (empty response)
(Argentinian-Chilean Border)South Patagonian Ice Field -49.4286077, -73.2129860 default Default = Neutral territory (empty response)
Paracel Islands 16.2438621, 111.7561099 default, VNM

Default = Neutral territory (empty response)

VNM = Vietnamese Islands

Spratly Islands 7.6808132, 111.5774475 default, VNM

Default = Neutral territory (empty response)

VNM = Vietnamese Islands

Suriname-French Guiana Triangle 2.8357961, -54.1090861 default

Default = Neutral territory (empty response)

Suriname-Guyana Triangle 2.1528005, -57.3365359 default

Default = Neutral territory (empty response)

Macclesfield Bank 15.8434538, 114.3056814 default Default = Neutral territory (empty response)
Scarborough Shoal 15.4895344, 113.8210957 default Default = Neutral territory (empty response)
James Shoal 3.973889, 112.348889 default Default = Neutral territory (empty response)
Senkaku/Diaoyutai 25.7446986, 123.4709205 default Default = Neutral territory (empty response)
West Bank 31.9998544, 35.2998283 default Default = No Country
East Jerusalem 31.766327, 35.2453382 default, ISR

Default = As part of West Bank

ISR = As part of Israel

Northern Cyprus 35.2453975, 33.3968783 default, GRC, TUR

Default = Turkish-Cypriot Administered Area

GRC = As a part of Cyprus (Republic of Cyprus)

TUR = Turkish Republic of Northern Cyprus

Southern Cyprus 35.0441914, 33.1554733 default, TUR

Default = Cyprus (Republic of Cyprus)

TUR = Greek Cypriot Admin of Southern Cyprus
Cyprus UN Neutral Zone 35.1691202, 33.2394362 default Default = UN Neutral Zone
Cyprus British Bases 34.6024439, 32.9538086 default Default = British Sovereign BSB Areas
Kinmen Islands 24.4642701, 118.3791237 default Default = Taiwanese Islands
Matsu Islands 26.2238182, 119.9946911 default Default = Taiwanese Islands
Kosovo 42.6718168, 21.1624711 default, TUR

Default = No Country

TUR = Kosovo as a Country
Western Sahara 24.118844, -13.7725855 default, MAR

Default = Neutral territory (empty response)

MAR = As a part of Morocco
Abu Musa Island 25.8871195, 55.0354848 default, ARE

Default = Neutral territory (empty response)

ARE = As a part of the United Arab Emirates
Tunb Islands

26.2623118, 55.308378

25.8871195, 55.0354848
default, ARE

Default = Neutral territory (empty response)

ARE = As a part of the United Arab Emirates
Ilemi Triangle 4.7502929, 35.2197958 default, KEN

Default = Neutral territory (empty response)

KEN = As a part of Kenya
Halaib Triangle 22.2363029, 35.1661332 default, EGY

Default = Neutral territory (empty response)

EGY = As a part of Egypt
Crimea 44.95748, 34.10827 default, RUS

Default = Part of Ukraine

RUS = As part of Russia
Kuril Islands (Shikotan, Iturup, Habomai, and Kunashir) 45.1279501, 147.80728 (Iturup) default, RUS

Default = Neutral territory (empty response)

RUS = As part of Russia
Liancourt Rocks 37.2393599, 131.8758573 default Default = Neutral territory (empty response)
Lake Malawi -9.98382, 34.39834 default Default = Neutral territory (empty response)
Vukovar and Sarengrad Islands

45.34718, 19.03334

45.26123, 19.24687

default Default = Neutral territory (empty response)

You cannot use this account to purchase a commercial plan on Developer Portal, as it is already associated to plans with different payment methods.

To purchase a commercial plan on Developer Portal, please register for or sign in with a different HERE Account.

Something took longer than expected.

The project should be available soon under your projects page.

Sorry, our services are not available in this region.

Something seems to have gone wrong. Please try again later.

We've detected that your account is set to Australian Dollars (AUD).
Unfortunately, we do not offer checkouts in AUD anymore.
You can continue using your current plan as normal, but to subscribe to one of our new plans,
please register for a new HERE account or contact us for billing questions on selfservesupport@here.com.