Links
📂

Data API

Connect to the Data APIs to access 3000+ of location attributes, around any lat-long in the country at a granularity of radius 200m, 500m and 1000m.

Data API with Latitude & Longitude

post
https://dataserving-in.geoiq.io/production/v1.0/getvariables
Parameters
Header
x-api-key*
String
Authentication key
Content-Type*
String
application/json
Body
lat*
Float
Latitude co-ordinates should be between -90 to 90
lng*
Float
Longitude co-ordinates should be between -180 to 180
radius*
Integer
(in meters) should be between 100 to 2000
variables*
String
Comma separated list of variables to be fetched. Maximum 50 variables can be fetched in a single call
Responses
200: OK
Success
400: Bad Request
Invalid input, object invalid
403: Forbidden
Authorization Failure. Invalid key.

Sample Request

headers = {
"x-api-key": "Authentication key",
"Content-Type": "application/json"
}
body = {
"lat": 24.966130,
"lng": 77.592247,
"variables": "p_retail_gc_np,w_pop_tt,p_health_hp_np,p_restaurant_rt_np",
"radius": 500
}

Sample Response

{
"data": {
"w_pop_tt": 27950,
"p_health_hp_np": 0.25045,
"p_restaurant_rt_np": 1.39535,
"p_retail_gc_np": 0.93023
},
"status": 200
}
""" Sample Python Code """
import json
import requests
url = "https://dataserving-in.geoiq.io/production/v1.0/getvariables"
payload = json.dumps({
"lat": 12.909151,
"lng": 77.6371584,
"radius": 1000,
"variables": "p_retail_gc_np,w_pop_tt,p_health_hp_np,p_restaurant_rt_np"
})
headers = {
'x-api-key': '<Authentication key>',
'Content-Type': 'application/json'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)

Data API with Address

post
https://dataserving-in.geoiq.io/production/v1.0/getvariables

Sample Request

headers = {
"x-api-key": "Authentication key",
"Content-Type": "application/json"
}
body = {
"address": "35, Vajarahalli, 9th Mile, Kanakapura Road, Bangalore",
"pincode": "560062",
"variables": "p_retail_gc_np,w_pop_tt,p_health_hp_np,p_restaurant_rt_np",
"radius": 500
}

Sample Response

{
"data": {
"w_pop_tt": 27950,
"p_health_hp_np": 0.25045,
"p_restaurant_rt_np": 1.39535,
"p_retail_gc_np": 0.93023
},
"status": 200
}
""" Sample Python Code """
import json
import requests
url = "https://dataserving-in.geoiq.io/production/v1.0/getvariables"
payload = json.dumps({
"address": "GeoIQ,Urbanvault 591, GF, 22nd cross, 15th Main Rd, HSR Layout, Bengaluru",
"pincode": "560102",
"radius": 1000,
"variables": "p_retail_gc_np,w_pop_tt,p_health_hp_np,p_restaurant_rt_np"
})
headers = {
'x-api-key': '<Authentication key>',
'Content-Type': 'application/json'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)