---
title: "Uhi Predict"
method: GET
path: "/api/tools/uhi/predict"
tags: ["Tools (analyse and convert EPW files)"]
---

# Uhi Predict

`GET /api/tools/uhi/predict`

## Request

- Base URL: `https://epw.tools`
- URL: `https://epw.tools/api/tools/uhi/predict`
- Auth: none declared

Predict site-level UHI ΔT (°C) relative to an open, unpaved site in the same city at the same elevation.

Night-time and day-time increments from the 2026 within-city model (1,056 professional stations in 43
cities). `/api/tools/uhi/features` fetches all inputs for a coordinate. Use `delta_t_night` as
`custom_delta_c` in `/api/tools/uhi-adjust`.

## Query parameters

- `imperv_pct` number, required: Impervious surface % within about 1 km
- `dist_km` number: Distance from city centre (km); accepted, not used by the model
- `H_mean_m` number: Mean building height (m)
- `lambda_p` number: Plan-area ratio (0–1); accepted, not used by the model
- `tree_canopy_pct` number: Tree canopy % within about 1 km
- `water_pct` number: Open water % within about 1 km
- `tpi_m` number: Elevation minus the mean elevation within about 1 km (m)

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/epw/apis/epw-tools-api.md) · [All operations](https://skmtc.dev/epw/apis/epw-tools-api/llms.txt) · [OpenAPI document](https://skmtc.dev/epw/apis/epw-tools-api/revisions/e6b60fc7a6d7?raw)