HOW TO

Calculate and evaluate urban heat risk using Arcade in the Enterprise portal and ArcGIS Online

Last Published: March 3, 2025

Summary

Calculating urban heat risk helps identify areas vulnerable to extreme temperatures, enabling better urban planning, targeted green infrastructure investment, and improved public health strategies to mitigate heat-related risks. For example, a city identifies a high heat risk neighborhood with dense buildings and little greenery, then plants trees to reduce temperatures.

Complete the workflow provided to calculate and evaluate urban heat risk based on building density, surface type, and green coverage using Arcade in the ArcGIS Enterprise portal and ArcGIS Online.

Procedure

  1. Log in to the ArcGIS Enterprise portal or ArcGIS Online and click Content > My Content.
  2. Click the hosted feature layer to open the item page.
  3. Add a new string field. Refer to Portal for ArcGIS: Add a field or ArcGIS Online: Add a field for instructions. In this example, a new field, Risk_Category, is added to the attribute table with three existing fields named Surface_Type, Green_Coverage, and Building_Density.
  4. Open the Arcade window. Refer to Portal for ArcGIS: Calculate values for a field from the item page or ArcGIS Online: Calculate values for a field from the item page for instructions.
  5. In the Expression box, specify the Arcade expression.
    1. To specify the necessary variables to assign the required fields:
var buildingDensity = $feature.Building_Density; // % of built-up area (0-100)
var surfaceMaterial = $feature.Surface_Type; // "Concrete", "Asphalt", "Grass", "Water"
var greenCoverage = $feature.Green_Coverage; // % of area covered by greenery (0-100)
  1. To create a variable selection for the heat absorption score based on the surface type:
var materialScore = When(
    surfaceMaterial == "Concrete", 40,
    surfaceMaterial == "Asphalt", 50,
    surfaceMaterial == "Grass", 10,
    surfaceMaterial == "Water", 0,
    25 // Default for unknown materials
);
  1. To specify the calculation to normalize the green impact score:
var greenImpact = (100 - greenCoverage) * 0.5;
  1. To calculate the final heat risk score:
var heatRiskScore = Min(100, buildingDensity * 0.5 + materialScore + greenImpact);
  1. To create a variable selection for the risk level categorization:
var riskCategory = When(
    heatRiskScore >= 80, "Very High",
    heatRiskScore >= 60, "High",
    heatRiskScore >= 40, "Moderate",
    heatRiskScore >= 20, "Low",
    "Very Low"
);
  1. To return the heat risk category:
return riskCategory;

The code block below demonstrates the full working script.

var buildingDensity = $feature.Building_Density; // % of built-up area (0-100)
var surfaceMaterial = $feature.Surface_Type; // "Concrete", "Asphalt", "Grass", "Water"
var greenCoverage = $feature.Green_Coverage; // % of area covered by vegetation (0-100)

var materialScore = When(
    surfaceMaterial == "Concrete", 40,
    surfaceMaterial == "Asphalt", 50,
    surfaceMaterial == "Grass", 10,
    surfaceMaterial == "Water", 0,
    25 // Default for unknown materials
);

var greenImpact = (100 - greenCoverage) * 0.5;

var heatRiskScore = Min(100, buildingDensity * 0.5 + materialScore + greenImpact);

var riskCategory = When(
    heatRiskScore >= 80, "Very High",
    heatRiskScore >= 60, "High",
    heatRiskScore >= 40, "Moderate",
    heatRiskScore >= 20, "Low",
    "Very Low"
);

return riskCategory;
  1. Click OK.

The image below shows the calculated urban heat risk based on building density, surface type, and green coverage.

The calculated urban heat risk based on building density, surface type, and green coverage

Article ID: 000034799

Software:
  • ArcGIS Online
  • Portal for ArcGIS
  • ArcGIS Enterprise 11 3
  • ArcGIS Enterprise 11 2
  • ArcGIS Enterprise 11 4

Receive notifications and find solutions for new or common issues

Get summarized answers and video solutions from our new AI chatbot.

Download the Esri Support App

Related Information

Discover more on this topic

Get help from ArcGIS experts

Contact technical support

Download the Esri Support App

Go to download options