Start with the São Paulo map. It shows modeled heat conditions and, when connected, live SPTrans buses and arrivals.
Load the required São Paulo data, then HEATLINK lists stops where heat, local heat risk and service gaps overlap.
Use Journey heat and Compare actions to see whether walking, waiting or transferring is the main problem before planning a response.
Live city operations
Start here. The map helps a São Paulo team see current heat conditions, connect SPTrans transit data, and open a stop when waiting in heat may deserve attention. It is built to support field checks and planning, not to declare medical risk.
waiting for weather
city-scale weather estimate
across São Paulo
connect a SPTrans line
waiting for enough information
waiting for city data
Live city map
Loading base map and weather grid…Reconnect to show the map. Live bus markers appear only when official data is available.
Selected place
citySão Paulo
City heat watch
available when weather loads
available after selecting a live stop
available after selecting a live route
shows when it was last refreshed
available after heat-risk data loads
from São Paulo’s official Favela map
available after the transit schedule loads
São Paulo activates its high-temperature response when temperature or thermal sensation reaches 32°C or more. HEATLINK uses city-scale weather to help you watch conditions; official activation still follows municipal criteria.
Connect live transit or select a mapped stop
Heat alone does not tell you what to change. Add a stop arrival or journey observation and HEATLINK can show whether the main issue is walking, waiting, riding or transferring.
Priority finder
Waiting for datauses only matched city data
Live transit
offlinebuses • stops • arrival times
Find São Paulo stops that deserve a field check
This page is a decision queue, not a scientific ranking of danger. It compares official São Paulo stops and shows the ones where heat, published local heat risk and weaker scheduled service overlap. Results appear only after the required São Paulo data is loaded.
load the required city data first
stops ready to compare
official polygon membership
repeated comparison for a steadier list
how similar repeated results are
selected hour and loaded sources
used only when enough approved counts are available
weather and timetable use the same hour
attention score, not a probability
Data ready for this view
0 of 4 sources readyPriority map
real stop locations after data loadsPrepare the required São Paulo sources, confirm the published heat-risk field, then click Find priorities. HEATLINK does not draw example priority stops.
Why the stops are flagged
not a mapStops to look at first
not readyWhy this stop stands out
what is driving the resultNo stop selected
Select a stop from the list to see why it stands out.
attention score, not a probability
compared with other stops
how much repeated comparisons differ
from the city heat view
from the published local dataset
from the official timetable
shown when enough stops have counts
from São Paulo’s official map
No priority result
Select a priority stop to see which conditions are contributing most. This is a planning signal, not a prediction of illness or harm.
Where does this journey get hottest?
Break a journey into walking, waiting, riding, transferring and the final walk. HEATLINK shows which part contributes most to the heat burden using the threshold you choose.
Journey inputs
missing values stay missingWhere the heat burden comes from
not calculated yetAdd journey details first
Add the journey details to see which stage contributes most.
Try a change
what-if onlyChoose actions within your budget
Use this only after you have local cost and effect estimates. HEATLINK compares the options you enter and shows the best mix within the selected budget. It does not invent the price or benefit of a shelter, water point or service change.
Your planning inputs
complete the fields you want to compareSuggested mix
not calculatedall available mixes
within your budget
same units as your budget
your chosen measure
Add local action estimates
Add your local costs and expected effects before comparing actions. HEATLINK will not fill these in for you.
Helpful references
background onlyA São Paulo Urban Climate study simulated substantial thermal-comfort improvement from street trees, with TEP reductions of about 6°C in high-rise and 8°C in low-rise urban tissues. This is locally relevant but is a simulated TEP result, not a bus-stop WBGT/apparent-temperature effect, so HEATLINK never auto-converts it into the planner. Urban Climate
Field observations reported tree-shaded bus-stop areas about 3.2°C cooler in WBGT than unshaded areas. Different climate, metric and intervention context: HEATLINK does not insert 3.2°C into the São Paulo calculator. Transportation Research Part D
The Transit Heat Exposure Index literature demonstrates why walk/wait/ride/transfer stages should be separated and reports that walking can dominate exposure in Miami. It supports the workflow, not a São Paulo effect coefficient. Journal of Transport Geography
Outside studies can help you choose a sensible range, but use local pilot results whenever the decision depends on local cost or effect.
Import local action estimates
CSVaction,cost,effect,measure,source
Load São Paulo data
This example is set up for São Paulo. Use the preparation button below first: it tries the required public São Paulo sources directly, and uses the included gateway when one is configured. Other cities need their own local data connections before priority results should appear.
This loads the three core sources used for ranking — weather, published heat risk and the SPTrans timetable — and also tries the official Favela layer for the optional equity filter. Live buses are separate and optional.
Connections
connection statusCurrent conditions and the next 24 hours. Refreshes about every 5 minutes. This is city-scale weather, not a street measurement.
Official line search, stops, bus positions and arrival predictions. A SPTrans connection is needed for live transit.
OpenStreetMap basemap. If it cannot load, HEATLINK says so instead of drawing a fake map.
Published São Paulo heat-risk layer
Muñoz et al. 2025 • CC BY 4.0Mendeley Data DOI 10.17632/6j7by525fy.1. The dataset contains the heat-risk shapefile and official styling resources; risk follows a hazard–vulnerability–exposure framework.
Favela areas
GeoSampa official mapOfficial São Paulo municipal polygons; GeoSampa metadata describes this vector layer as the boundaries of favelas and lists daily update frequency.
SPTrans timetable
official scheduleHEATLINK reads the official SPTrans timetable for the selected date and uses it to compare stops, routes and planned service. Nothing is filled in when schedule information is missing.
Passenger counts (optional)
approved or locally collected countsYou can add approved stop-level passenger counts if you have them. This is optional; HEATLINK never invents ridership. When the file covers enough stops for the selected time, passenger demand is included in the priority list.
stop_id,service_date,hour,passenger_count,source
Import route observations
stays on this deviceThis file stays in your browser and is not uploaded by the standalone page.
stage ∈ walk, wait, ride, transfer, egress
Recent activity
latest firstWhat can be shown now
current limitsNot yet verified in this browser session.
Live transit is not connected, so current bus positions and wait times are unavailable.
Published heat-risk data is not ready, so local heat-risk comparisons are unavailable.
The official Favela layer is not ready, so HEATLINK will not label a stop as inside or outside a Favela area.
The official transit schedule is not ready, so scheduled service comparisons are unavailable.
Passenger counts are optional. Without them, the priority list is about operating conditions, not the number of people affected.
Waiting for the required city data before showing priority stops.
Journey heat needs complete stage times and heat values. Blank fields are not guessed.
No action effect is assumed by default. Add a local estimate only when you are ready to test it.
About HEATLINK
This page explains where the information comes from, how the calculations work and what the tool should not be used to claim.
Information sources
external referencesOfficial documentation states that the API supports authenticated line search, stops, vehicle positions, and arrival forecasts. Authentication requires a token generated in “Meus Aplicativos”. Official API docs
Provides current and hourly weather used in the heat map. These are modeled weather conditions, not street measurements. Documentation
Municipal pages state that the operation is activated when temperature or thermal sensation reaches 32°C or more. In January 2026 the city reported ten tents operating during qualifying heat days. Municipal reference
Published Mendeley Data V1 (17 Sep 2025), DOI 10.17632/6j7by525fy.1, CC BY 4.0. Covers 26,506 urban census tracts using Landsat 8/9 and other geodata. Open dataset
HEATLINK compares the pattern at each stop with the wider city and highlights unusual combinations of heat, local heat risk and service gaps. The result is an attention score, not a probability. The comparison is repeated so one random run does not decide the list.
Official municipal Favela boundaries. HEATLINK loads the published layer rather than drawing its own areas. Metadata
Official transit schedule used for stops and planned service. A timetable is never shown as an observed wait. Official source
SPTrans states that the municipal bus system has about 19.5 thousand stop points; approximately 6.5 thousand stops have shelter modules. HEATLINK uses this only to motivate the city-scale adaptation opportunity and never infers a specific stop's shelter status unless an authoritative stop-level inventory is supplied. Official stop-infrastructure page
Used only as the basemap.
How the calculations work
city planning toolHEATLINK samples city-scale apparent temperature across São Paulo so you can see how conditions change by place and time. It does not replace street-level heat measurements or personal exposure monitoring.
Journey heat load adds the time spent above your chosen heat threshold across walking, waiting, riding, transferring and the final walk. For formal city use, validate the measure against the local exposure framework you plan to use.
HEATLINK compares each stop using current heat, published local heat risk and the planned service gap. It repeats the comparison several times and combines the results. Passenger counts are added only when enough approved stop-level data is available. The result helps decide where to investigate first; it is not a health-risk probability, a causal estimate or a count of people affected.
When Favela focus is on, the list is limited to stops inside São Paulo’s official Favela map. HEATLINK does not invent population counts or turn unrelated administrative indicators into heat-vulnerability scores.
Suggestions are based on the information currently available for the selected stop or journey. They are planning prompts, not claims about health outcomes or guaranteed benefits.
The planner checks every combination of the actions you enter and finds the best mix within your budget, using the common benefit measure you choose. It does not guess costs, effects or interactions between actions.
Do not use HEATLINK to claim
unless you have supporting local evidenceIf SPTrans is not connected, HEATLINK simply says live buses are unavailable. It does not add simulated vehicles.
The heat map cannot tell you the exact temperature under a particular shelter, tree or street canyon. Use local measurements for that.
HEATLINK does not estimate deaths, hospital visits or “people protected” without a locally validated health model and population data.
If the published heat-risk data or official timetable is missing, no priority list is shown.
The action planner starts blank. Outside studies are background information and are never treated as São Paulo effects automatically.
HEATLINK does not repurpose unrelated administrative scores as resident heat vulnerability.