GeoRisk API

What it does:

The GeoRisk API allows you to input a latitude and longitude, and in return, it provides deep insights about that location. This includes administrative boundaries (like city/district), environmental risks (like flood or seismic zones), infrastructure proximity (like distance to cemeteries or drains), and overall risk profiling of that land.

Perfect for teams working in real estate, insurance, urban planning, logistics, or risk analysis.

Key Benefits for Business

• Instant risk assessment of any land parcel.

• Understand if land is buildable, encroached, green-belt protected, or near hazards.

• Supports automation and large-scale geospatial intelligence workflows.

• Simplifies compliance and feasibility analysis for property developers.

How It Works

API Endpoint

GET {base_url}/api/?latitude=<float>&longitude=<float>

Required Headers

Header	Value	Description
Access-key	your-api-key-here	Required for authentication

Parameters (Inputs)

Name	Type	Required	Description
latitude	Float	Yes	GPS latitude of the point
longitude	Float	Yes	GPS longitude of the point

Example: latitude=12.9716, longitude=77.5946

Successful Response (200 OK)

{
"City": "Bangalore",
"District": "Bangalore Urban",
"Taluk": "Bangalore North",
"Vacant": "building_present",
"GroundWaterAvailability": "average",
"FloodProne": "not_flood_prone_but_near_water_body",
"SeismicZone": "Zone_2-Low_Damage_Risk",
...
}

This is a snapshot of all relevant spatial and hazard information about the location. Use it to understand where it is, what's nearby, and what's risky.

Response Fields Explained

Field	Type	Description
City	string	Name of the city closest to the coordinates
District	string	District in which the coordinates fall
Taluk	string	Sub-district or taluk name
Town	string	Town name, if applicable
Village	string	Village name
Mandal	string	Another subdivision name; alternative to Taluk
Hobli	string	Cluster of villages within a Taluk
City_center	string	Location string of the nearest city center (reverse geocoded)
DistanceFromCityCenter	string	Distance to the city center in meters
Vacant	string	Indicates land status: "building_present" or "vacant_land"
WithinGreenBelt	boolean	Whether the point lies in a green belt zone
GroundWaterAvailability	string|null	"scarce" | "average" | "good" | null (not available)
WaterBody	string	"Encroachment_of_lake_bed" | "lake_bed_converted" | "on_lake_bed" | "none"
FloodProne	string	"flood_prone" | "not_flood_prone_but_near_water_body" | "no_flood_risk"
SeismicZone	string	"Zone_2-Low_Damage_Risk" | "Zone_3-Moderate_Damage_Risk" | "Zone_4-High_Damage_Risk" | "Zone_5-Very_High_Damage_Risk"
LandSlideZone	string	"Very_Low_Risk" | "Low_Risk" | "Medium_Risk" | "High_Risk" | "Very_High_Risk"
WindHazardZone	string	"Low_Damage_Risk" | "Moderate_Damage_Risk_Zone-B" | "Moderate_Damage_Risk_Zone-A" | "High_Damage_Risk" | "Very_High_Damage_Risk_Zone-B" | "Very_High_Damage_Risk_Zone-A"
CycloneRiskLevel	string	"Cyclonic_Storm" | "Severe_Cyclonic_Storm" | "Very_Severe_Cyclonic_Storm" | "Extremely_Severe_Cyclonic_Storm"
WithinASIMonument	boolean	Whether point is within 100m of an ASI monument
CongestedLane	boolean	True if point is in a lane too narrow (<4.5m)
PropertyAccessibility	string	"One Side Access" | "Two Side Access" | "Landlocked"
StormWaterDrainage	string	"On a Drain" | "10 m" | "30 m" | "500 m" | "> 500 m" | "No Drains"
NearestCemetary	string | null	Distance to cemetery in meters or null
NearestPowerline	string | null	Distance to powerline in meters or null
Datasetversion	string	Version of the dataset used
h3	string	H3 geospatial index (hex-based spatial ID)
version	string	API version used for this request

Error Scenarios

Status	Message (Example)
400	Missing latitude or longitude
403	Invalid Access-key
500	Coordinates do not belong to supported regions

Example Usage (Developers)

cURL

curl -X GET "{base_url}/api/?latitude=12.9716&longitude=77.5946" \
-H "Access-key: your-api-key"

Python

import requests
url = "{base_url}/api/" headers = {"Access-key": "your-api-key"}
params = {"latitude": 12.9716, "longitude": 77.5946}
response = requests.get(url, headers=headers, params=params) print(response.json())