• Welcome
  • API Reference
Precipitation Data
    Daily Precipitation DatagetHourly Precipitation DatagetLast 48 Hours Precipitation DatagetRecent Rain Eventget
Soil Data
    Daily Soil MoisturegetHourly Soil MoisturegetSoil Temperatureget
Atmospheric Data
    Air TemperaturegetSpecific HumiditygetRelative HumiditygetWind SpeedgetWind GustsgetWind DirectiongetCloud CovergetSolar Radiationget
Bulk Export
    Create Bulk Exportpost
Map Services
    Esri Image Server IntegrationgetMap Layer TilesgetQueryget
Embed Widgets
    Embeddable HTML UIget
Other endpoints
    Redirect to Dev PortalgetRedirect to new Dev PortalgetMCP Serverpost
Schemas
powered by Zudoku
Precipitation & Weather Data API
Precipitation & Weather Data API

Map Services

Endpointhttps://api.precip.ai

Map tile and visualization services

Esri Image Server Integration

GET
https://api.precip.ai
/api/v1/map/{serviceName}/ImageServer

Image Service compatible with Esri products. This url eg https://api.precip.ai/api/v1/map/last-48/ImageServer can be added to ArcGIS Online, ArcGIS Pro or QGIS to load raster tiles for the last 48 hours of precipitation data.

Esri Image Server Integration › path Parameters

serviceName
string · required

The layer or service name.

  • last-48 - total precipitation in the last 48 hours
  • hourly - total hourly precipitation
  • wind-speed-hourly - average hourly wind speed
  • wind-direction-hourly - average hourly wind direction
  • temperature-hourly - average hourly temperature
Example: last-48

Esri Image Server Integration › Headers

Authorization
string · required

The Authorization header is used to authenticate with the API using your API key.

Example: Bearer YOUR_API_KEY

Esri Image Server Integration › Responses

200

Successful Response

No data returned
GET/api/v1/map/{serviceName}/ImageServer
curl --request GET \
  --url https://api.precip.ai/api/v1/map/:serviceName/ImageServer \
  --header 'Authorization: <string>'
shell
Example Responses
{}
json
application/json

Map Layer Tiles

GET
https://api.precip.ai
/api/v1/map/{serviceName}/ImageServer/tile/{z}/{y}/{x}

Map tiles compatible with most web mapping or GIS tools. Software such as Mapbox, Google Maps, ArcGIS, Leaflet, OpenLayers or QGIS will require an x/y/z url eg https://api.precip.ai/api/v1/map/last-48/ImageServer/tile/{z}/{y}/{x}. See the examples for more details.

Map Layer Tiles › path Parameters

serviceName
string · required

The layer or service name.

  • last-48 - total precipitation in the last 48 hours
  • hourly - total hourly precipitation
  • wind-speed-hourly - average hourly wind speed
  • wind-direction-hourly - average hourly wind direction
  • temperature-hourly - average hourly temperature
Example: last-48
x
integer · required

map tile id x

Example: 5
y
integer · required

map tile id y

Example: 4
z
integer · required

map tile id z

Example: 3

Map Layer Tiles › query Parameters

time
string

,

Example: 1711411200000,1711497600000

Map Layer Tiles › Headers

Authorization
string · required

The Authorization header is used to authenticate with the API using your API key.

Example: Bearer YOUR_API_KEY

Map Layer Tiles › Responses

200

Successful Response

No data returned
GET/api/v1/map/{serviceName}/ImageServer/tile/{z}/{y}/{x}
curl --request GET \
  --url https://api.precip.ai/api/v1/map/:serviceName/ImageServer/tile/:z/:y/:x \
  --header 'Authorization: <string>'
shell
Example Responses
{}
plain
image/png

Query

GET
https://api.precip.ai
/api/v1/map/{serviceName}/ImageServer/getSamples

Query value of map tiles at point(s).

Query › path Parameters

serviceName
string · required

The layer or service name.

  • last-48 - total precipitation in the last 48 hours
  • hourly - total hourly precipitation
  • wind-speed-hourly - average hourly wind speed
  • wind-direction-hourly - average hourly wind direction
  • temperature-hourly - average hourly temperature
Example: last-48

Query › query Parameters

object · required

points to query

Example: {"points":[{"0":-97.06138,"1":32.837},{"0":-97.06133,"1":32.836},{"0":-97.06124,"1":32.834},{"0":-97.06127,"1":32.832}],"spatialReference":{"wkid":4326}}
geometryType
string · required
time
string

,

Example: 1711411200000,1711497600000

Query › Headers

Authorization
string · required

The Authorization header is used to authenticate with the API using your API key.

Example: Bearer YOUR_API_KEY

Query › Responses

GET/api/v1/map/{serviceName}/ImageServer/getSamples
curl --request GET \
  --url 'https://api.precip.ai/api/v1/map/:serviceName/ImageServer/getSamples?geometry=%3Cvalue%3E&geometryType=%3Cstring%3E' \
  --header 'Authorization: <string>'
shell
Example Responses
{
  "samples": [
    {
      "value": 21.5
    },
    {
      "value": 21.5
    },
    {
      "value": 21.5
    },
    {
      "value": 21.5
    }
  ]
}
json
application/json
Bulk ExportEmbed Widgets