Precip API
See below for our available endpoints.
https://api.precip.aiAuthentication
Map Tiles
Esri Integration
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.
Path Parameters
serviceName
The layer or service name.
last-48- total precipitation in the last 48 hourshourly- total hourly precipitationwind-speed-hourly- average hourly wind speedwind-direction-hourly- average hourly wind directiontemperature-hourly- average hourly temperature
1
Map Layer Tiles
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.
Query Parameters
time
<start timestamp>,<end timestamp>
Path Parameters
serviceName
The layer or service name.
last-48- total precipitation in the last 48 hourshourly- total hourly precipitationwind-speed-hourly- average hourly wind speedwind-direction-hourly- average hourly wind directiontemperature-hourly- average hourly temperature
x
map tile id x
y
map tile id y
z
map tile id z
1
Query
Query value of map tiles at point(s).
Query Parameters
geometry
points to query
geometryType
time
<start timestamp>,<end timestamp>
Path Parameters
serviceName
The layer or service name.
last-48- total precipitation in the last 48 hourshourly- total hourly precipitationwind-speed-hourly- average hourly wind speedwind-direction-hourly- average hourly wind directiontemperature-hourly- average hourly temperature
1
Daily
Returns daily precipitation data for the given time range and location(s). Includes historical and/or forecast data depending on the time range requested.
Headers
Authorization
The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Query Parameters
start
ISO 8601 date %Y-%m-%d or datetime %Y-%m-%dT%H:%M:%S
end
ISO 8601 date %Y-%m-%d or datetime %Y-%m-%dT%H:%M:%S
longitude
comma separated list of longitudes
latitude
comma separated list of latitudes
timeZoneId
IANA timezone identifier e.g. America/Chicago
format
Output format: geojson, json or csv
1
Hourly
Returns hourly precipitation data for the given time range and location(s). Includes historical and/or forecast data depending on the time range requested.
Headers
Authorization
The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Query Parameters
start
ISO 8601 date %Y-%m-%d or datetime %Y-%m-%dT%H:%M:%S
end
ISO 8601 date %Y-%m-%d or datetime %Y-%m-%dT%H:%M:%S
longitude
comma separated list of longitudes
latitude
comma separated list of latitudes
timeZoneId
IANA timezone identifier e.g. America/Chicago
format
Output format: geojson, json or csv
1
Last 48 Hours
Total precipitation in the last 48 hours for the given location(s).
Headers
Authorization
The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Query Parameters
longitude
comma separated list of longitudes
latitude
comma separated list of latitudes
timeZoneId
IANA timezone identifier e.g. America/Chicago
format
Output format: geojson, json or csv
1
Recent Rain
Returns the most recent rain event for the given location(s). How long ago and how much it rained. An event is defined as more than 1/10 inch of rain with less than a 24 hour gap.
Headers
Authorization
The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Query Parameters
longitude
comma separated list of longitudes
latitude
comma separated list of latitudes
timeZoneId
IANA timezone identifier e.g. America/Chicago
format
Output format: geojson, json or csv
1