Weather Forecast API

Introduction

NextBillion.ai's Weather Forecast API provides point-based weather forecast data for any location worldwide. The service offers two methods:

• Hourly Weather Forecast: returns hour-by-hour forecast information for up to the next 24 hours, including temperature, precipitation, wind, humidity, pressure, and UV index.
• Daily Weather Forecast: returns day-by-day forecast information for up to the next 14 days, including minimum and maximum temperature, precipitation, wind, UV index, and sun and moon timing.

Both methods share a common authentication scheme and accept a single (lat, lon) point as input. They are designed to support a wide range of use cases such as trip planning, fleet routing, field operations, and weather-aware delivery scheduling.

Hourly Weather Forecast

The Hourly Weather Forecast method returns hour-by-hour forecast information for the location specified by lat and lon. Forecast entries begin at the current hour and extend up to 24 hours into the future. Each entry includes both a UTC timestamp (dateTime) and the equivalent local time (dateTimeLocal).

Request Parameters

Response Schema

Example

The following query retrieves a 3-hour weather forecast for Amsterdam.

Sample API Request

1
curl --location 'https://api.nextbillion.io/map/weather/hourly?key=<your_api_key>&at=52.37,4.9&forecastHours=3'

Sample API Response

1
{
2
 "data": { "hourlyWeatherInfo": [...] }
3
}

Daily Weather Forecast

The Daily Weather Forecast method returns day-by-day forecast information for the location specified by lat and lon. Forecast entries begin on the current day (in the station's local time) and extend up to 14 days into the future.

Request Parameters

Response Schema

Example

The following query retrieves a 3-day weather forecast for Amsterdam.

Sample API Request

1
curl --location 'https://api.nextbillion.io/map/weather/daily?key=<your_api_key>&at=52.37,4.9&forecastDays=3'

Sample API Response

1
{
2
 "data": { "dailyWeatherInfo": [...] }
3
}

Weather Codes

The weatherCode field is a 9-character string that encodes the weather condition in a structured form: {T}_{XX}_{PPP}{L}. The components are described below.

The weatherDescription field provides a pre-decoded, human-readable English description of the same condition. The table below shows a few examples.

API Query Limits

• The maximum value for forecastHours is 24.
• The maximum value for forecastDays is 14.
• NextBillion.ai allows a maximum rate limit of 6000 queries per minute or 100 queries per second for continuous requests.
  Note: We can increase the quota if needed on request. Contact support@nextbillion.ai for more details.

API Error Codes