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
VNM: Vietnam
CHN: Taiwan

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	Default = 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)
Taiwan	25.05871, 121.45332	default, CHN	Default = Taiwan CHN = Taiwan, People's Republic of China