Welcome

Copy page

ArcGIS layer access

Precip layers are exposed in ways that work with ArcGIS products. Use the right URL and pattern for your use case.

Raster layers (Image Server)

Precip serves raster layers (precipitation, soil moisture, wind, etc.) as an Esri Image Service. This gives high compatibility with ArcGIS Online, ArcGIS Pro, ArcGIS JavaScript API, and other clients that support Image Server REST APIs.

Base URL

Use your Precip API base URL. For example:

• Image Server root (add this URL as a layer):
  https://tiles.precip.ai/api/v1/map/{serviceName}/ImageServer

• REST-style (some clients expect this path):
  https://tiles.precip.ai/api/v1/map/rest/services/{serviceName}/ImageServer

Replace {serviceName} with one of the supported layer IDs below.

Authentication (API key as URL parameter)

ArcGIS products cannot send custom HTTP headers, so the API accepts your API key as a query parameter as well as the standard Authorization: Bearer header.

• Query parameter: append apiKey=YOUR_API_KEY to any Image Server URL.
• Example layer URL with key:
  https://tiles.precip.ai/api/v1/map/last-48/ImageServer?apiKey=YOUR_API_KEY

When adding the layer in ArcGIS, use the full URL including the apiKey parameter. ArcGIS will forward the query string to tile and export requests, so the key is sent with every request. Keep your key private (e.g. use a proxy or short-lived key for public maps).

Adding a layer in ArcGIS

ArcGIS Online / Map Viewer

1. Add → Add Layer from Web.
2. Choose "An ArcGIS Server Web Service".
3. Enter the Image Server URL including your API key, e.g.
   https://tiles.precip.ai/api/v1/map/last-48/ImageServer?apiKey=YOUR_API_KEY
4. Add the layer.

ArcGIS Pro

1. Add Data → Data from Path (or paste URL in the catalog).
2. Use the Image Server URL as above.

ArcGIS Map Viewer (new)
Use "Add layer" → "From URL" and paste the Image Server URL.

ArcGIS JavaScript API

Use ImageryLayer with the Image Server URL (include apiKey in the URL when required):

Code
const layer = new ImageryLayer({
  url: "https://tiles.precip.ai/api/v1/map/last-48/ImageServer?apiKey=YOUR_API_KEY"
});
map.add(layer);

Time parameters (time-enabled layers)

For layers that support time (e.g. precip-hourly, precip-daily), use the time or start and end query parameters on requests. ArcGIS clients that support time-aware image services will send these when you use the time slider.

• Single time: ?time=2025-02-15T12:00:00Z
• Range: ?start=2025-02-14T00:00:00Z&end=2025-02-15T23:59:59Z

Querying and identify behavior

You normally do not call query endpoints manually.

When you add the Image Server URL as a layer, ArcGIS and QGIS automatically call the appropriate service endpoints under the hood (such as identify/getSamples or WMS GetFeatureInfo) when users click the map.

Manual endpoint calls are only useful for troubleshooting integration issues.

If your GIS client is not returning point values, contact support with the exact request URL the client sent and we can quickly diagnose compatibility.

Supported Image Server layers

Use any of these as {serviceName} in the Image Server URL. Common ones:

Layer ID	Description
last-12, last-24, last-48, last-168	Precipitation in the last 12/24/48/168 hours
next-12, next-24	Forecast precipitation (next 12/24 hours)
precip-hourly, hourly	Hourly precipitation (time-enabled)
precip-daily, daily	Daily precipitation (time-enabled)
temperature-hourly, wind_speed-hourly, etc.	Other hourly bands (time-enabled)

---

Vector layers (Feature Server) — join-layer

For vector layers (e.g. polygons with aggregated precipitation stats), Precip can be consumed via a Feature Server that is powered by our Koop-based service. That service calls the Precip insights API and exposes the result as an Esri Feature Service so you can add it in ArcGIS as a feature layer.

• Typical base URL (Koop/Feature Server):
  Your organization’s Koop/Feature Server base (e.g. https://koop-xxxx.run.app).
• Path pattern:
  /{provider}/rest/services/{layerId}/FeatureServer/0/query
  with provider join-layer and a layer ID that corresponds to a configured join (e.g. polygon boundaries with raster stats).

Use the Feature Server URL in ArcGIS the same way you would any other ArcGIS Feature Service (Add Layer from Web → ArcGIS Server Web Service, or From URL with the service URL). Parameters such as key, band, time_agg_func, spatial_agg_funcs, start, and end are configured per layer on the server side.

If you need vector/join-layer access, contact [email protected] for the correct base URL and available layer IDs.

---

Compatibility notes

• Spatial reference: Image Server uses Web Mercator (WKID 102100 / EPSG:3857) for extent and tiles; this matches default web maps in ArcGIS.
• Authentication: The API accepts the key via the apiKey query parameter (e.g. ?apiKey=YOUR_API_KEY) because ArcGIS cannot send the Authorization header. Append it to the layer URL when adding the service; ArcGIS will include it on subsequent tile and export requests.

For a full list of Image Server operations (exportImage, identify, getSamples, legend, etc.), see the API Reference.