> ## Documentation Index
> Fetch the complete documentation index at: https://waybeyond.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# How do I create and manage heat maps on a dashboard?

FarmRoad Data Studio allows you to easily create and manage heat maps on any dashboard.

## Creating a heat map

1. Go to your Data Studio dashboard

<Frame>
  <img src="https://mintcdn.com/waybeyond/PqHE7fnjCh_qDIg8/images/FarmRoad-dashboard-view.webp?fit=max&auto=format&n=PqHE7fnjCh_qDIg8&q=85&s=298c922ec470f6e61362d66397d75c10" alt="Farm Road Dashboard View" width="1340" height="655" data-path="images/FarmRoad-dashboard-view.webp" />
</Frame>

2. Click **Add graph or widget** button at the bottom of the page. You will be presented with the option to select the type of graph or widget that you want.
3. Select **Heat map**.

<Frame>
  <img src="https://mintcdn.com/waybeyond/PqHE7fnjCh_qDIg8/images/FarmRoad-add-graph-and-widget_1.webp?fit=max&auto=format&n=PqHE7fnjCh_qDIg8&q=85&s=9b3973d5ad3172ff9be00dfd9a1c62c8" alt="Farm Road Add Graph And Widget 1" width="1340" height="654" data-path="images/FarmRoad-add-graph-and-widget_1.webp" />
</Frame>

<Note>
  You can add up to 10 heat maps on a single dashboard.
</Note>

## Configuring a heat map

1. Give your heat map a name 
2. Choose whether you want to add an image to your heat map, or a Google Maps location:

<Frame>
  <img src="https://mintcdn.com/waybeyond/PqHE7fnjCh_qDIg8/images/FarmRoad-set-up-heat-map-background.webp?fit=max&auto=format&n=PqHE7fnjCh_qDIg8&q=85&s=ab5d6c7d619f0a68a8feb17288032a64" alt="Farm Road Set Up Heat Map Background" title="Farm Road Set Up Heat Map Background" className="mx-auto" style={{ width:"70%" }} width="623" height="591" data-path="images/FarmRoad-set-up-heat-map-background.webp" />
</Frame>

Selecting the 'Image' option will allow you to upload an image of your farm or greenhouse: 

<Frame>
  <img src="https://mintcdn.com/waybeyond/PqHE7fnjCh_qDIg8/images/FarmRoad-image-for-heat-map-.webp?fit=max&auto=format&n=PqHE7fnjCh_qDIg8&q=85&s=2caa1d2bef11d11671018d7ade72e456" alt="Farm Road Image For Heat Map" width="945" height="595" data-path="images/FarmRoad-image-for-heat-map-.webp" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/waybeyond/PqHE7fnjCh_qDIg8/images/FarmRoad-image-for-heatp-map---preview.webp?fit=max&auto=format&n=PqHE7fnjCh_qDIg8&q=85&s=a559fa3f0be2bc6f2cace0d828d39d98" alt="Farm Road Image For Heatp Map Preview" width="945" height="605" data-path="images/FarmRoad-image-for-heatp-map---preview.webp" />
</Frame>

Selecting the 'Google Map' option will allow you to enter an address or location of your farm or greenhouse:

<Frame>
  <img src="https://mintcdn.com/waybeyond/PqHE7fnjCh_qDIg8/images/FarmRoad-heat-map---google-map-location.webp?fit=max&auto=format&n=PqHE7fnjCh_qDIg8&q=85&s=758817be53738e29deff41d36e3de54e" alt="Farm Road Heat Map Google Map Location" title="Farm Road Heat Map Google Map Location" className="mx-auto" style={{ width:"62%" }} width="785" height="806" data-path="images/FarmRoad-heat-map---google-map-location.webp" />
</Frame>

You are able to zoom in and out and pan the image around to get the best fit for your heat map:

3. Once you are happy with your image or Google Map location, click **Done**

## Adding Data to a Heat map

Heat maps support data from integrated sensors like Folium.

Heat maps also support data that has been uploaded or manually entered into FarmRoad (this could be Crop Registration or Yield data for example) 

1. Select the data type you would like to display on the Heat map

<Frame>
  <img src="https://mintcdn.com/waybeyond/PqHE7fnjCh_qDIg8/images/FarmRoad-heat-map---add-data-.webp?fit=max&auto=format&n=PqHE7fnjCh_qDIg8&q=85&s=c3a67138e2e77f53626e2c48b9c369d7" alt="Farm Road Heat Map Add Data" title="Farm Road Heat Map Add Data" className="mx-auto" style={{ width:"64%" }} width="796" height="383" data-path="images/FarmRoad-heat-map---add-data-.webp" />
</Frame>

2. Select the source of your data

<Frame>
  <img src="https://mintcdn.com/waybeyond/PqHE7fnjCh_qDIg8/images/FarmRoad-heat-map---select-data-source.webp?fit=max&auto=format&n=PqHE7fnjCh_qDIg8&q=85&s=7ff434e4d260f16e057a08f83033749c" alt="Farm Road Heat Map Select Data Source" title="Farm Road Heat Map Select Data Source" className="mx-auto" style={{ width:"64%" }} width="789" height="406" data-path="images/FarmRoad-heat-map---select-data-source.webp" />
</Frame>

You can pick between a location (such as Farm, Compartment or Sector) or you can pick an integrated sensor that has been linked to your FarmRoad account. 

* **Sensor data** is fed into FarmRoad automatically, think of it like 'live data'. 
* **Location data** is manually entered or uploaded into FarmRoad. This can be data that is collected with handheld instruments, or crop registration data for example. 

## Positioning markers on a heat map

1. Once you have chosen your data type and sources, you now need to position the markers on the heat map 
2. Each data source is assigned a marker
3. Drag and drop each marker to the corresponding location on your farm. This could be the location of the sensor, or the area where the data was manually collected 
4. Hovering over the marker will show you the source of the data 

You can add as many markers to the heat map as you like. 

<Frame>
  <img src="https://mintcdn.com/waybeyond/PqHE7fnjCh_qDIg8/images/FarmRoad-position-marker-on-heat-map.webp?fit=max&auto=format&n=PqHE7fnjCh_qDIg8&q=85&s=12b7cfd1ae8ac565d8152e33a9f638f9" alt="Farm Road Position Marker On Heat Map" width="945" height="605" data-path="images/FarmRoad-position-marker-on-heat-map.webp" />
</Frame>

5. Once you have positioned your markers, hit **Done**

## Using your heat maps

Once you setup your heat maps you can view the data that is being displayed. Each marker will display the most recent reading.

* Hovering over the marker will give you more information
* If the marker does not have up to date data, it will be blank

<Frame>
  <img src="https://mintcdn.com/waybeyond/PqHE7fnjCh_qDIg8/images/FarmRoad-using-heat-map-.webp?fit=max&auto=format&n=PqHE7fnjCh_qDIg8&q=85&s=4c5901a9d59370bfa4edf0f2aa3b15b3" alt="Farm Road Using Heat Map" width="945" height="611" data-path="images/FarmRoad-using-heat-map-.webp" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/waybeyond/PqHE7fnjCh_qDIg8/images/FarmRoad-heat-map-view-of-Auckland-garden-temperatures.webp?fit=max&auto=format&n=PqHE7fnjCh_qDIg8&q=85&s=1371d1f9e9dc3eec39d21e1e68f69c3a" alt="Farm Road Heat Map View Of Auckland Garden Temperatures" width="945" height="499" data-path="images/FarmRoad-heat-map-view-of-Auckland-garden-temperatures.webp" />
</Frame>

If you are using Google Maps with your heat map, you can zoom and pan within that heat map. This will not change any settings on your heat map, once you refresh the page your heat map will return to your saved configuration. 

## Frequently asked questions about FarmRoad heat maps

<AccordionGroup>
  <Accordion title="What images types are supported?">
    The images that are supported are JPEG and PNG up to 20MB in size.
  </Accordion>

  <Accordion title="What's the best format or aspect ratio for my uploaded images?">
    Ideal images will have a ‘landscape view’ (16:9 aspect ratio), similar to the dimensions of a postcard.
  </Accordion>

  <Accordion title="How many markers can I add to a heat map?">
    There is no limit to the number of markers you can add to a heat map
  </Accordion>

  <Accordion title="How many heat maps can I add to a dashboard?">
    Currently you are able to add up to 10 heat maps on a dashboard
  </Accordion>

  <Accordion title="How old can sensor data be before the marker displays as blank? ">
    Sensor data can be up to 20 minutes old before the marker displays as blank 
  </Accordion>

  <Accordion title="How old can location data be before the marker displays as blank? ">
    Location data can be up to 7 days old before the marker displays as blank.
  </Accordion>

  <Accordion title="How many measurement types can I view on a heatmap?">
    The heat maps supports one measurement type (e.g CO2).
  </Accordion>
</AccordionGroup>
