K-GIS Web API Services

Web Services are a method of communication over the network. A Web service is a system dedicated for supporting machine-to-machine transactions over a network. It is a Web API described in WSDL (Web Service Description Language) and Web services are usually self-contained and self-describing. Web services can be discovered using UDDI (Universal Description, Discovery and Integration) protocol. By exchanging SOAP (Simple Object Access Protocol) messages typically over HTTP (with XML), other systems can interact with Web services. Web services are used in number of ways such as RPC (Remote Procedure Calls), SOA(Service Oriented Architecture) and REST (Representational State Transfer).

REST is an architectural style, and an approach to communications that is often used in the development of Web services. The use of REST is often preferred over the more heavyweight SOAP style because REST does not leverage as much bandwidth, which makes it a better fit for use over the Internet. While initially Web APIs were also called Web services, nowadays the use of the latter form signals that the API is RESTful, as opposed to following the SOAP standard.

K-GIS provides a host of Web API’s which includes Spatial and Non-Spatial (Data) Services to share and expose the raw data for any third party/user enabling external developers to build applications, products or to customise data. Because the APIs simply provide data, there are no limits on how a user can then go on to use that data. The Nearby Assets API is for finding the nearest assets of a department from any location within Karnataka State. It returns search results with latitude, longitude and Name of the Asset.

K-GIS Web Services List
Sl No. Service Name Description
1 K-GIS Admin Hierarchy This service is used to fetch K-GIS Admin Hierarchy. User has to pass Department Code, Application Code, Type, Code as parameters.
2 Nearby Admin Hierarchy The service is used to fetch the particular District Name within the specified area when the user passes the Coordinates, Distance, type of Coordinates and AOI (Area of Interest) the services will display District, Taluk, Hobli and survey numbers (Across the District, Taluk, Hobli).
3 Survey Number This service is used to fetch Survey numbers with Village name. User has to pass the KGIS Village code, Coordinates, Distance, type of Coordinates.
4 K-GIS District Code This service is used to fetch KGIS District Code and KGIS District Name for given K-GIS District Name. In this service user has to pass the KGIS District Name as parameter
5 K-GIS Taluk Code This service is used to fetch KGIS District Code, KGIS District Name and KGIS Taluk Code, KGIS Taluk Name for given KGIS Taluk Name.
6 K-GIS Hobli Code This service is used to fetch KGIS District Code, KGIS District Name, KGIS Taluk Code, KGIS Taluk Name, KGIS Hobli Code and KGIS Hobli Name for given KGIS Hobli Name.
7 Geometric Polygon Area The service is used to fetch the geometric polygonal area for survey number.
8 Nearby Assets The service is used to fetch the nearby assets for given layer and co–ordinates.
9 Distance between 2 PIN Codes This service is used to fetch the distance (in meters) between 2 PIN codes.
10 Election Jurisdiction Hierarchy This service is used to fetch the jurisdiction hierarchy for given layer and co–ordinates.
11 Nearby Location Details The service shall enable the user to know the administrative hierarchy of any point (based on co-ordinates) within Karnataka.If the point, falls within any of the town (urban) limits, the hierarchy is returned with details of “Ward, Zone, Town Name, District and a type flag as “Urban” If the point, falls outside the town (urban) limits, the rural admin hierarchy is returned with details of “village, Hobli, Taluk, District along with survey numbers and a type flag as “Rural”
12 Fetching Zonation Data The service shall be enable the user to accesss the standard K-GIS Zonation codes like Gps_Lat, Gps_Lon, Type, KGISZoneCode, KGISZoneName, KGISTownCode, KGISTownName, KGISWardCode, KGISWardName, KGISDistrictCode, KGISDistrictName, AC_CODE, AC_Name, PS_Code, PS_Name, BoothCode, KGISTalukCode, KGISTalukName, KGISHobliCode, KGISHobliName
K-GIS Master Tables

  Click here to View K-GIS Master Tables

This service is used to fetch K-GIS Admin Hierarchy. User has to pass Department Code, Application Code, Type, Code as parameters.

Method Type : GET
Response Type : JSON
Parameter Sample Value Description
deptcode 1 department code
applncode 102 application code
code 604199 kgisvillagecode/lgdvillagecode/bhoomivillagecode
type lgd kgis/lgd/bhoomi
Sl No. Response Description
1 success Returns the K-GIS Admin Hierarchy
2 Failure Status Message.
[{"districtName":"Haveri","districtCode":"11","talukName":"Haveri","talukCode":"1104","hobliName":"HAVERI","hobliCode":"110401","villageName":"Gowrapura.M.Adura","villageCode":"1104010013","message":"Data Available"}]

The service is used to fetch the particular District Name within the specified area when the user passes the Coordinates, Distance, type of Coordinates and AOI (Area of Interest) the services will display District, Taluk, Hobli and survey numbers (Across the District, Taluk, Hobli).

Method Type : GET
Response Type : JSON
Parameter Sample Value Description
coordinates 16.208,75.739
or
1853272.6735999994,546739.9227999998
Latitude, Longitude
distance 5000 In meters
type DD or UTM UTM - UTM zone 43, North Coordinates in Meters (Y, X)
DD - Latitude and Longitude in Decimal degree
aoi d /t / h can be either one of the following parameters or any combination of these parameters separated by a comma:
d - District
t - Taluk
h - Hobli
Sl No. Response Description
1 success Returns the District, Taluk, Hobli, name.
2 Failure Status Message.

This service is used to fetch Survey numbers with Village name. User has to pass the KGIS Village code, Coordinates, Distance, type of Coordinates.

Method Type : GET
Response Type : JSON
Parameter Sample Value Description
KGIS village code 201020003 KGISVillageCode of Village
coordinates 16.208,75.739
or
1853272.6735999994,546739.9227999998
latitude, longitude
type DD or UTM UTM - UTM zone 43, North Coordinates in Meters (Y, X)
DD - Latitude and Longitude in Decimal degree
distance 5000 In meters
Sl No. Response Description
1 success Returns the survey numbers with Village name.
2 Failure Status Message.
{"adminhierarchy":[{"districtName":"Bagalkot","talukName":"Jamakhandi","hobliName":"SAVALAGI","villageName":"Ghote"}],"surveynumber":[{"sno":"STREAM"},{"sno":"107"},{"sno":"108"},{"sno":"117"},{"sno":"118"},{"sno":"119"},{"sno":"109"},{"sno":"120"},{"sno":"121"},{"sno":"97"},{"sno":"95"},{"sno":"122"},{"sno":"99"},{"sno":"98"},{"sno":"94"},{"sno":"127"},{"sno":"126"},{"sno":"91"},{"sno":"STREAM"},{"sno":"98"},{"sno":"STREAM"},{"sno":"97"},{"sno":"90"},{"sno":"128"},{"sno":"106"},{"sno":"129"},{"sno":"175"},{"sno":"100"},{"sno":"173"},{"sno":"174"},{"sno":"89"},{"sno":"177"},{"sno":"116"},{"sno":"123"},{"sno":"96"},{"sno":"104"},{"sno":"110"},{"sno":"105"},{"sno":"STREAM"},{"sno":"178"},{"sno":"93"},{"sno":"102"},{"sno":"178"},{"sno":"180"},{"sno":"92"},{"sno":"STREAM"},{"sno":"88"},{"sno":"87"},{"sno":"115"},{"sno":"180"},{"sno":"181"},{"sno":"125"},{"sno":"STREAM"},{"sno":"176"},{"sno":"182"},{"sno":"181"},{"sno":"132"},{"sno":"101"},{"sno":"131"},{"sno":"STREAM"},{"sno":"STREAM"},{"sno":"130"},{"sno":"182"},{"sno":"ROAD"},{"sno":"114"},{"sno":"112"},{"sno":"184"},{"sno":"185"},{"sno":"124"},{"sno":"186"},{"sno":"183"},{"sno":"187"},{"sno":"189"},{"sno":"86"},{"sno":"82"},{"sno":"83"},{"sno":"84"},{"sno":"191"},{"sno":"103"},{"sno":"220"},{"sno":"190"},{"sno":"226"},{"sno":"227"},{"sno":"192"},{"sno":"ROAD"},{"sno":"236"},{"sno":"113"},{"sno":"228"},{"sno":"237"},{"sno":"111"},{"sno":"192"},{"sno":"STREAM"},{"sno":"STREAM"},{"sno":"241"},{"sno":"242"},{"sno":"225"},{"sno":"134"},{"sno":"133"},{"sno":"239"},{"sno":"240"},{"sno":"238"},{"sno":"STREAM"},{"sno":"219"},{"sno":"STREAM"},{"sno":"236"},{"sno":"172"},{"sno":"225_STREAM"},{"sno":"STREAM"},{"sno":"STREAM"},{"sno":"221"},{"sno":"190"},{"sno":"85"},{"sno":"80"},{"sno":"229"},{"sno":"225"},{"sno":"235"},{"sno":"229"},{"sno":"224"},{"sno":"STREAM"},{"sno":"135"},{"sno":"189"},{"sno":"136"},{"sno":"247"},{"sno":"171"},{"sno":"179"},{"sno":"169"},{"sno":"168"},{"sno":"164"},{"sno":"243"},{"sno":"248"},{"sno":"188"},{"sno":"49"},{"sno":"50"},{"sno":"STREAM"},{"sno":"188"},{"sno":"193"},{"sno":"51"},{"sno":"52"},{"sno":"53"},{"sno":"79"},{"sno":"81"},{"sno":"73"},{"sno":"74"},{"sno":"275"},{"sno":"54"},{"sno":"78"},{"sno":"57"},{"sno":"58"},{"sno":"218"},{"sno":"166"},{"sno":"165"},{"sno":"222"},{"sno":"170"},{"sno":"223"},{"sno":"276"},{"sno":"230"},{"sno":"277"},{"sno":"217"},{"sno":"STREAM"},{"sno":"279"},{"sno":"STREAM"},{"sno":"186"},{"sno":"162"},{"sno":"163"},{"sno":"281"},{"sno":"280"},{"sno":"199"},{"sno":"138"},{"sno":"137"},{"sno":"75"},{"sno":"77"},{"sno":"STREAM"},{"sno":"162"},{"sno":"282"},{"sno":"284"},{"sno":"ROAD"},{"sno":"284"},{"sno":"198"},{"sno":"283"},{"sno":"155"},{"sno":"249"},{"sno":"234"},{"sno":"156"},{"sno":"246"},{"sno":"216"},{"sno":"245"},{"sno":"55"},{"sno":"56"},{"sno":"244"},{"sno":"157"},{"sno":"167"},{"sno":"ROAD"},{"sno":"195"},{"sno":"215"},{"sno":"194"},{"sno":"48"},{"sno":"ROAD"},{"sno":"STREAM"},{"sno":"163"},{"sno":"233"},{"sno":"200"},{"sno":"197"},{"sno":"76"},{"sno":"231"},{"sno":"STREAM"},{"sno":"ROAD"},{"sno":"STREAM"},{"sno":"164"},{"sno":"STREAM"},{"sno":"165"},{"sno":"166"},{"sno":"139"},{"sno":"STREAM"},{"sno":"167"},{"sno":"196"},{"sno":"251"},{"sno":"47"},{"sno":"70"},{"sno":"STREAM"},{"sno":"67"},{"sno":"72"},{"sno":"68"},{"sno":"59"},{"sno":"232"},{"sno":"160"},{"sno":"161"},{"sno":"250"},{"sno":"214"},{"sno":"ROAD"},{"sno":"213"},{"sno":"46"},{"sno":"274"},{"sno":"212"},{"sno":"158"},{"sno":"202"},{"sno":"43"},{"sno":"201"},{"sno":"208"},{"sno":"209"},{"sno":"252"},{"sno":"210"},{"sno":"287"},{"sno":"159"},{"sno":"254"},{"sno":"253"},{"sno":"140"},{"sno":"278"},{"sno":"154"},{"sno":"42"},{"sno":"258"},{"sno":"289"},{"sno":"66"},{"sno":"150"},{"sno":"149"},{"sno":"71"},{"sno":"271"},{"sno":"273"},{"sno":"45"},{"sno":"69"},{"sno":"206"},{"sno":"259"},{"sno":"153"},{"sno":"148"},{"sno":"60"},{"sno":"44"},{"sno":"255"},{"sno":"203"},{"sno":"211"},{"sno":"207"},{"sno":"62"},{"sno":"152"},{"sno":"141"},{"sno":"291"},{"sno":"288"},{"sno":"151"},{"sno":"290"},{"sno":"272"},{"sno":"39"},{"sno":"41"},{"sno":"270"},{"sno":"269"},{"sno":"296"},{"sno":"205"},{"sno":"37"},{"sno":"65"},{"sno":"257"},{"sno":"256"},{"sno":"260"},{"sno":"147"},{"sno":"261"},{"sno":"297"},{"sno":"63"},{"sno":"61"},{"sno":"ROAD"},{"sno":"268"},{"sno":"38"},{"sno":"299"},{"sno":"142"},{"sno":"292"},{"sno":"40"},{"sno":"36"},{"sno":"143"},{"sno":"144"},{"sno":"64"},{"sno":"342"},{"sno":"341"},{"sno":"300"},{"sno":"266"},{"sno":"267"},{"sno":"265"},{"sno":"262"},{"sno":"22"},{"sno":"145"},{"sno":"204"},{"sno":"298"},{"sno":"146"},{"sno":"21"},{"sno":"ROAD"},{"sno":"293"},{"sno":"29"},{"sno":"35"},{"sno":"343"},{"sno":"28"},{"sno":"263"},{"sno":"301"},{"sno":"318"},{"sno":"11"},{"sno":"344"},{"sno":"12"},{"sno":"264"},{"sno":"10"},{"sno":"9"},{"sno":"304"},{"sno":"303"},{"sno":"347"},{"sno":"302"},{"sno":"34"},{"sno":"305"},{"sno":"295"},{"sno":"30"},{"sno":"27"},{"sno":"14"},{"sno":"294"},{"sno":"23"},{"sno":"7"},{"sno":"13"},{"sno":"319"},{"sno":"320"},{"sno":"STREAM"},{"sno":"339"},{"sno":"8"},{"sno":"STREAM"},{"sno":"32"},{"sno":"23"},{"sno":"33"},{"sno":"20"},{"sno":"345"},{"sno":"310"},{"sno":"321"},{"sno":"311"},{"sno":"308"},{"sno":"317"},{"sno":"340"},{"sno":"316"},{"sno":"307"},{"sno":"15"},{"sno":"322"},{"sno":"31"},{"sno":"26"},{"sno":"306"},{"sno":"25"},{"sno":"315"},{"sno":"348"},{"sno":"STREAM"},{"sno":"24"},{"sno":"362"},{"sno":"323"},{"sno":"346"},{"sno":"19"},{"sno":"6"},{"sno":"17"},{"sno":"309"},{"sno":"312"},{"sno":"314"},{"sno":"349"},{"sno":"325"},{"sno":"517"},{"sno":"518"},{"sno":"16"},{"sno":"519"},{"sno":"351"},{"sno":"350"},{"sno":"313"},{"sno":"18"},{"sno":"5"},{"sno":"352"},{"sno":"4"},{"sno":"326"},{"sno":"337"},{"sno":"STREAM"},{"sno":"336"},{"sno":"522"},{"sno":"528"},{"sno":"338"},{"sno":"335"},{"sno":"2"},{"sno":"1"},{"sno":"333"},{"sno":"529"},{"sno":"SETTLEMENT"},{"sno":"3"},{"sno":"353"},{"sno":"332"},{"sno":"357"},{"sno":"358"},{"sno":"STREAM"},{"sno":"530"},{"sno":"359"},{"sno":"533"},{"sno":"534"},{"sno":"532"},{"sno":"360"},{"sno":"334"},{"sno":"356"},{"sno":"331"},{"sno":"364"},{"sno":"394"},{"sno":"355"},{"sno":"460"},{"sno":"394"},{"sno":"361"},{"sno":"531"},{"sno":"STREAM"},{"sno":"396"},{"sno":"365"},{"sno":"527"},{"sno":"460"},{"sno":"ROAD"},{"sno":"363"},{"sno":"393"},{"sno":"362"},{"sno":"354"},{"sno":"457"},{"sno":"367"},{"sno":"ROAD"},{"sno":"449"},{"sno":"450"},{"sno":"451"},{"sno":"392"},{"sno":"ROAD"},{"sno":"455"},{"sno":"456"},{"sno":"366"},{"sno":"STREAM"},{"sno":"366"},{"sno":"372"},{"sno":"STREAM"}]}

This service is used to fetch KGIS District Code and KGIS District Name for given K-GIS District Name. In this service user has to pass the KGIS District Name as parameter

Method Type : GET
Response Type : JSON
Parameter Sample Value Description
districtname Bangalore(urban) K-GIS District Name
Sl No. Response Description
1 success Returns the KGIS District name and code.
2 Failure Status Message.
[{"districtName":"Bidar","districtCode":"05","message":"Data available"}]

This service is used to fetch KGIS District Code, KGIS District Name and KGIS Taluk Code, KGIS Taluk Name for given KGIS Taluk Name.

Method Type : GET
Response Type : JSON
Parameter Sample Value Description
talukname Bangalore-South K-GIS Taluk Name
Sl No. Response Description
1 success Returns the District name, code and Taluk name, code.
2 Failure Status Message.
[{"districtName":"Bengaluru (Urban)","districtCode":"20","talukName":"Bangalore-South","talukCode":"2002","message":"Data available"}]

This service is used to fetch KGIS District Code, KGIS District Name, KGIS Taluk Code, KGIS Taluk Name, KGIS Hobli Code and KGIS Hobli Name for given KGIS Hobli Name.

Method Type : GET
Response Type : JSON
Parameter Sample Value Description
hobliname UTTARAHALLI -4 K-GIS Hobli Name
Sl No. Response Description
1 success Returns the District name, code, Taluk name, code and Hobli name and code.
2 Failure Status Message.
[{"districtName":"Bagalkot","districtCode":"02","talukName":"Badami","talukCode":"0204","hobliName":"KULAGERI","hobliCode":"020404","message":"Data available"}]

The service is used to fetch the geometric polygonal area for survey number.

Method Type : GET
Response Type : JSON
Parameter Sample Value Description
K-GIS VillageId 1 K-GIS VillageId
Survey Number 1 Survey Number
type DD or UTM UTM - UTM zone 43, North Coordinates in Meters (Y, X)
DD - Latitude and Longitude in Decimal degree
Sl No. Response Description
1 Msg: 200 Returns polygon of survey number
2 Msg: 204 No data available for given survey number, KGISVillageId
[{"message":"200","geom":"POLYGON ((74.290819818000045 15.811494721000031, 74.290765080000028 15.811283119000052, 74.291027236000048 15.810526233000076, 74.29144578000006 15.809931221000056, 74.291505510000036 15.808460220000029, 74.29189634800008 15.808494052000071, 74.291895952000061 15.808500727000023, 74.292045752000035 15.808662970000057, 74.292366540000046 15.808964447000051, 74.292468565000036 15.808999503000052, 74.292648128000053 15.811411445000033, 74.292197912000063 15.81143697400006, 74.291920311000069 15.811391354000023, 74.291752167000084 15.811433145000024, 74.291429372000039 15.811245316000054, 74.291305381000029 15.811236746000077, 74.291290057000083 15.811361736000038, 74.291162254000085 15.811457036000036, 74.290819818000045 15.811494721000031))"},{"message":"200","geom":"POLYGON ((74.292434404000062 15.808540625000035, 74.292452818000072 15.808787976000076, 74.292406752000034 15.80875334600006, 74.292132638000055 15.808534601000076, 74.292126314000029 15.808513958000049, 74.292434404000062 15.808540625000035))"}]
[{"message":"200","geom":"POLYGON ((424051.30510000046 1748212.2298000008, 424045.3638000004 1748188.8422999997, 424073.15799999982 1748105.0209999997, 424117.76180000044 1748039.0499000009, 424123.61060000025 1747876.3066000007, 424165.48199999984 1747879.9080999997, 424165.44199999981 1747880.6466000006, 424181.54600000009 1747898.5398999993, 424216.01460000034 1747931.7736000009, 424226.9545 1747935.6147000007, 424247.0831000004 1748202.3583000004, 424198.87519999966 1748205.3445999995, 424169.12760000024 1748200.3981999997, 424151.13520000037 1748205.0818000007, 424116.4944000002 1748184.4206000008, 424103.21190000046 1748183.5174000002, 424101.61730000004 1748197.3493000008, 424087.9654000001 1748207.9375, 424051.30510000046 1748212.2298000008))"},{"message":"200","geom":"POLYGON ((424223.125 1747884.8661000002, 424225.18919999991 1747912.2213000003, 424220.24270000029 1747908.4070999995, 424190.80370000005 1747884.3083999995, 424190.11870000046 1747882.0272000004, 424223.125 1747884.8661000002))"}]

The service is used to fetch the nearby assets for given layer and co–ordinates.

Method Type : GET
Response Type : JSON
Parameter Sample Value Description
coordinates 16.208,75.739
or
1853272.6735999994,546739.9227999998
Latitude, Longitude
Layer Code 1312130 Layer Code
Number 5 Number of assets to be returned
type DD or UTM UTM - UTM zone 43, North Coordinates in Meters (Y, X)
DD - Latitude and Longitude in Decimal degree
Sl No. Response Description
1 Msg: 200 Service Returns parameters successfully
2 Msg: 400 Mandatory Parameters are missing
3 Msg: 204 No content for the given layer code/co-ordinates
[ { "assetName": "NARAYANA E TECHNO SCHOOL", "y": 1449444.4800000004, "x": 777477.8898, "msg": "200", "distance": 656.15, "address": "", "asseType": "" }, { "assetName": "SRI JNANAKSHI VIDYA MANDIR", "y": 1449480.3734000009, "x": 777526.8750999998, "msg": "200", "distance": 668.76, "address": "", "asseType": "" }, { "assetName": "GMPS DODDABETTA HALLI", "y": 1448877.8354000002, "x": 777078.0976, "msg": "200", "distance": 696.2, "address": "Vidyaranapura Post, Bangalore North ", "asseType": "" }, { "assetName": "HOLY FAITH POBLIC HIGH SCHOOL", "y": 1448345.3906999994, "x": 777303.0153000001, "msg": "200", "distance": 696.86, "address": "A.M.S. LAYOUT VIDYARANYAPURA, BANGALORE -97 , "asseType": "" }, { "assetName": "GULPS CHIKKABETTA HALLI", "y": 1448465.852499999, "x": 777078.3492, "msg": "200", "distance": 799.07, "address": "CHIKKABETTAHALLI VIDYARANYAPURA BANGALORE ", "asseType": "" }]

This service is used to fetch the distance (in meters) between 2 PIN codes.

Method Type : GET
Response Type : JSON
Parameter Sample Value Description
6 digit PIN code 560097 , 560091 6 digit PIN code (comma separated) within Karnataka State
Sl No. Response Description
1 success keymsg: 200 - Returns distance between two pin codes (in meters)
2 Failure keymsg: 401 - Invalid PIN code

This service is used to fetch the jurisdiction hierarchy for given layer and co–ordinates.

Method Type : GET
Response Type : JSON
Parameter Sample Value Description
Coordinates 16.208,75.739 or 1853272.6735999994,546739.92279999981 Latitude, Longitude
Layer code 01 Web Service Code and Parameters provided in reference table.
type DD or UTM UTM - UTM zone 43, North Coordinates in Meters (Y, X)
DD - Latitude and Longitude in Decimal degree

Web Service Layer Codes and Parameters reference table
Layer Code Description Output Parameters Message Code
01 Election : Returns the jurisdictional hierarchy of Election / Constituency boundaries
  • Polling Booth Number
  • Polling Booth Name
  • Assembly Constituency Number
  • Assembly Constituency Name
  • Parliament Constituency Number
  • Parliament Constituency Name
Msg : 200
Msg : 202
Msg : 400
Msg : 401
02 Home : Returns the jurisdictional hierarchy of Police Station.
  • Police Station ID
  • Police Station Name
  • Circle ID
  • Circle Name
  • Sub Division ID
  • Sub Division Name
  • Division ID
  • Division Name
Msg : 200
Msg : 202
Msg : 400
Msg : 401
03 Education : Returns the jurisdictional hierarchy
  • Block Code
  • Block Name
  • District Code
  • District Name
Msg : 200
Msg : 202
Msg : 400
Msg : 401
04 Bescom : Returns the jurisdictional hierarchy of Bescom
  • Section Code
  • Section Name
  • Sub Division Code
  • Sub Division Name
  • Division Code
  • Division Name
  • Circle Code
  • Circle Name
  • Zonal Code
  • Zonal Name
Msg : 200
Msg : 202
Msg : 400
Msg : 401
05 Health : Returns the jurisdictional hierarchy.
  • Sub Centre Code
  • Sub Centre Name
  • Primary Health Centre Code
  • Primary Health Centre Name
  • Taluk Code
  • Taluk Name
  • District Code
  • District Name
Msg : 200
Msg : 202
Msg : 400
Msg : 401
Sl No. Response Description
1 Msg: 200 Service Returns parameters successfully
2 Msg : 202 The co-ordinates entered is out of bounds of Karnataka State boundary
3 Msg: 400 Mandatory Parameters are missing
4 Msg: 401 The code passed is invalid
[{"msg":"200","boothNumber":"143","boothName":"Karnataka Maratha Welfare Association Vidhyanikethan, Room No - 2, West of Chord Road, B-86","assemblyconstituencyNumber":"156","assemblyconstituencyName":"Mahalakshmi Layout","parliamentconstituencyNumber":"24","parliamentconstituencyName":"Bangalore North"}]
[{"msg":"202","boothNumber":"","boothName":"","assemblyconstituencyNumber":"","assemblyconstituencyName":"","parliamentconstituencyNumber":"","parliamentconstituencyName":""}]

The service shall enable the user to know the administrative hierarchy of any point (based on co-ordinates) within Karnataka.

  • If the point, falls within any of the town (urban) limits, the hierarchy is returned with details of “Ward, Zone, Town Name, District and a type flag as “Urban”
  • If the point, falls outside the town (urban) limits, the rural admin hierarchy is returned with details of “village, Hobli, Taluk, District along with survey numbers and a type flag as “Rural”

Web Service Response :

  • Urban location : Ward code ward name, zone code and zone name, town code , town name, district code, district name for given co-ordinates.
  • Rural location : Survey number (if available), village name , village code, hobli name, hobli code, taluk name, taluk code, district name and district code for given co-ordinates.
Input Parameters :
  • Coordinates (coordinates), type of coordinates (type), Area of Interest (aoi)
Method Type : GET
Response Type : JSON
Parameter Sample Value Description
coordinates 16.208,75.739
or
1853272.6735999994,546739.9227999998
Co-ordinates can be in (Latitude, Longitude) in Decimal Degrees OR in Projected Planar co-ordinate system UTM Zone 43-North in (X,Y) (Easting and Northing)
type DD or UTM UTM - UTM zone 43, North Coordinates in Meters (Y, X)
DD - Latitude and Longitude in Decimal degree
aoi d /t / h These are optional parameters. By default, the web service returns the complete administrative hierarchy of the point of interest based on its co-ordinate. If the user is interested in getting only a specific parameter (ex: only district name or taluk name), then if these optional parameter need to be mentioned. Area of interest can be either one of the following parameters or any combination of these parameters separated by a comma:
d - District
t - Taluk
h - Hobli
aoi w This is an optional parameter. If the user is interested in getting only ward name, then the optional parameter “w” need to be used.
Sl No. Response Description
1 Msg: 200 Service Returns parameters successfully
2 Msg : 202 The co-ordinates entered is out of bounds of Karnataka State boundary
3 Msg: 400 Mandatory Parameters are missing
4 Msg: 401 The code passed is invalid

Note : If area of interest (aoi) – the optional parameters is not specified, the web service shall return the complete admin hierarchy as per the K-GIS database for the given co-ordinates

(for Urban Area)
[{"message":"200","type":"Urban","districtCode":"20","districtName":"Bengaluru (Urban)","townCode":"2003","townName":"BBMP","zoneCode":"20038","zoneName":"YELAHANKA","wardCode":"2003009","wardName":"Vidyaranyapura"}]
(if urban area)
[{"message":"200","type":"Urban","districtCode":"20","districtName":"Bengaluru (Urban)","townCode":"2003","townName":"BBMP","zoneCode":"20038","zoneName":"YELAHANKA","wardCode":"2003009","wardName":"Vidyaranyapura"}]
(If Rural Area)
[{"message":"200","type":"Rural","districtCode":"03","districtName":"Vijayapura","talukCode":"0310","talukName":"Tikota","hobliCode":"031005","hobliName":"TIKOTA","villageCode":"0310050006","villageName":"Honawada","surveynum":"STREAM"}]

[{"message":"204:co-ordinates lie outside urban boundary","type":"","districtCode":"","districtName":"","townCode":"","townName":"","zoneCode":"","zoneName":"","wardCode":"","wardName":""}]

[{"message":"200","type":"Urban","districtCode":"20","districtName":"Bengaluru (Urban)","townCode":"2003","townName":"BBMP","zoneCode":"20038","zoneName":"YELAHANKA","wardCode":"2003009","wardName":"Vidyaranyapura"}]

The service shall be enable the user to accesss the standard K-GIS Zonation codes like Gps_Lat, Gps_Lon, Type, KGISZoneCode, KGISZoneName, KGISTownCode, KGISTownName, KGISWardCode, KGISWardName, KGISDistrictCode, KGISDistrictName, AC_CODE, AC_Name, PS_Code, PS_Name, BoothCode, KGISTalukCode, KGISTalukName, KGISHobliCode, KGISHobliName

Method Type : POST
Response Type : JSON
Parameter Sample Value Description
Gps_Lat "Gps_Lat": 13.03063015, Can pass single or multiple Latitude Values
Gps_Lon "Gps_Lon": 77.61886905 Can pass single or multiple Longitude Values
Sl No. Response Description
1 "statusCode": 200 Success
2 "statusCode": 500 Internal server error
3 "statusCode": 101 invalid start date
4 "statusCode": 102 invalid end date
Input Payload: [ { "ID": 198, "Gps_Lat": 13.03063015, "Gps_Lon": 77.61886905 }, { "ID": 200, "Gps_Lat": 13.03138907, "Gps_Lon": 77.61987634 } ]
{ "status": true, "statusCode": 200, "count": 9, "dataList": [ { "ID": "29", "Gps_Lat": 12.9452655, "Gps_Lon": 77.5652559, "Type": "Urban", "KGISZoneCode": "20036", "KGISZoneName": "SOUTH", "KGISTownCode": "2003", "KGISTownName": "BBMP", "KGISWardCode": "2003142", "KGISWardName": "Sunkenahalli", "KGISDistrictCode": "20", "KGISDistrictName": "Bengaluru (Urban)", "AC_CODE": "169", "AC_Name": "Chickpet", "PS_Code": "116", "PS_Name": "Niveditha School Room No 3,GavPuram Extension", "BoothCode": "29169116", "KGISTalukCode": "2001", "KGISTalukName": "Bangalore (North)", "KGISHobliCode": "200141", "KGISHobliName": "kasaba " }, { "ID": "20", "Gps_Lat": 12.9716124, "Gps_Lon": 77.5823311, "Type": "Urban", "KGISZoneCode": "20037", "KGISZoneName": "WEST", "KGISTownCode": "2003", "KGISTownName": "BBMP", "KGISWardCode": "2003109", "KGISWardName": "Chickpete", "KGISDistrictCode": "20", "KGISDistrictName": "Bengaluru (Urban)", "AC_CODE": "164", "AC_Name": "Gandhinagara", "PS_Code": "178", "PS_Name": "Office Of The Deputy Director Department Of Public Instructions, Old Central Junior College Premises, Kempegowda Road Room No. ", "BoothCode": "29164178", "KGISTalukCode": "2001", "KGISTalukName": "Bangalore (North)", "KGISHobliCode": "200141", "KGISHobliName": "kasaba " } ] }