Live Weather Monitoring API Documentation
Hyperlocal monitoring for weather, with accurate data for criminality and infrastructure. This API provides accurate, up-to-date local details for Indian postal codes for integrating into your applications for Indian markets.
Below are the endpoints for accessing local datasets. Learn how to integrate the API into your application.
Authorization:
- privateId *Specify privateId for site
(e.g., "Bearer example^com-SomeIdString").
Query Parameters:
- zip Specify which data to show
(e.g., 401101). - show Comma-separated list of datasets you need
(e.g., "all"|"state,district").
Route Parameters:
- :region *Please check location table here
(e.g., "WEST_3|ARAB_1|EAST_3|NORD_6").
Response based on params:
{
"success": true,
"data": {
"state": {
"population": {
"people": 123144223,
"population_density": 365,
"area": 307713,
"urban_population": 45.22,
"rural_population": 54.78,
"gender_ratio": 925,
"human_development_index": 0.624,
"life_expectancy": {
"infant_mortality_rate_per_1000": 29,
"male": 66.2,
"female": 69.8
},
"literacy_rate": {
"total": 84.11,
"male": 88.87,
"female": 79.9
},
"official_languages": [
"Marathi"
],
"spoken_languages": [
"Marathi",
"Hindi",
"English",
"Urdu"
],
"religions": {
"Hinduism": 79.83,
"Islam": 11.53,
"Buddhism": 5.67,
"Other": 2.97
}
},
"economy": {
"unit": "USD",
"annual_tourists": 67000000,
"gdp_nominal": {
"value": 459.8,
"year": 2023
},
"gdp_per_capita": {
"value": 3727,
"year": 2023
},
"exports": {
"total_value_billion": 39
}
},
"climate": {
"type": "Tropical Wet and Dry",
"annual_rainfall_mm": 2500,
"avg_temperature": {
"summer": "34",
"winter": "19",
"format": "°C"
}
},
"infrastructure": {
"electricity_access": "100%",
"telecom_connectivity": "96%",
"internet_users": {
"percentage_of_population": 58,
"total_users_million": 71.6
}
},
"service": true,
"info": "Economic Statistics limited to viable Indian territories or states!"
},
"district": {
"name": "Thane",
"weather": {
"base": {
"lon": 73.396,
"lat": 19.4115
},
"weather": {
"id": 804,
"main": "Clouds",
"description": "overcast clouds",
"icon": "04d"
},
"readings": {
"temp": 25.65,
"feels_like": 26.52,
"temp_min": 25.65,
"temp_max": 25.65,
"pressure": 1009,
"humidity": 86,
"sea_level": 1009,
"grnd_level": 1001
},
"visibility": 10000,
"wind": {
"speed": 0.62,
"deg": 48,
"gust": 0.86
},
"clouds": 100,
"sunrise": 1728521952,
"sunset": 1728564435
},
"people": "mix",
"criminality": "mid"
}
}
}This endpoint provides the current hyperlocal details for the requested postal codes.
require 'net/http'
require 'uri'
require 'json'
def fetch_data
# API configuration
base_url = 'https://weathergrid.api.mapwale.com/v1'
params = {
'region' => 'YOUR_REGION' # Replace with actual region value
}
headers = {
'Content-Type' => 'application/json',
'Authorization' => "Bearer <privateId>"
}
query_params = {"zip":"401101","show":"all"}
begin
# Build URL
url = base_url
["region"].each do |param|
url += "/#{URI.encode_www_form_component(params[param])}"
end
# Add query parameters
uri = URI(url)
uri.query = URI.encode_www_form(query_params)
# Create HTTP client
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == 'https'
# Create request
request = case 'GET'
when 'POST'
Net::HTTP::Post.new(uri)
when 'PUT'
Net::HTTP::Put.new(uri)
when 'DELETE'
Net::HTTP::Delete.new(uri)
else
Net::HTTP::Get.new(uri)
end
# Set headers
headers.each { |key, value| request[key] = value }
# Set body for POST/PUT requests
if ['POST', 'PUT'].include?('GET')
request.body = {}.to_json
end
# Send request
response = http.request(request)
# Check for errors
unless response.is_a?(Net::HTTPSuccess)
raise "HTTP error! status: #{response.code}"
end
JSON.parse(response.body)
rescue StandardError => e
puts "Error: #{e.message}"
nil
end
end
# Example usage
result = fetch_data
puts JSON.pretty_generate(result) if result