# Point

In CARTO Builder, the Point layer visualization option allows you to render and style point features on your map. This layer type offers various advanced styling options to enhance the visual representation of your data such as creating heatmap or grid visualizations dynamically from your original source.

<figure><img src="https://3029946802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FybPdpmLltPkzGFvz7m8A%2Fuploads%2Fgit-blob-2c505209b64a220f459cae13ae214ce451d71231%2FPoint.gif?alt=media" alt=""><figcaption></figcaption></figure>

## Visualization

You have different visualization options when it comes to point data. Using this functionality, we allow users to dynamically aggregate the original source to:

* [**Grid**](https://docs.carto.com/carto-user-manual/maps/layers/point/grid-point-aggregation) : Aggregated geometry into grid cells.
* [**H3**](https://docs.carto.com/carto-user-manual/maps/layers/h3): Aggregated geometry into hexagonal bins.
* [**Heatmap**](https://docs.carto.com/carto-user-manual/maps/layers/point/heatmap-point-aggregation): Aggregated geometry by density.
* [**Cluster**](https://docs.carto.com/carto-user-manual/maps/layers/point/cluster-point-aggregation): Aggregated geometry into circles.

Within the **Advanced visualization options** <img src="https://3029946802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FybPdpmLltPkzGFvz7m8A%2Fuploads%2Fgit-blob-0284a6e8c3b0d674f33e4bac8912e003925dd056%2Fimage.png?alt=media" alt="" data-size="line"> , you can access **Zoom Visibility** to define the range at which your layer should be visualized. This ensures that your lines are displayed at appropriate zoom levels, improving the clarity and relevance of your map.

<figure><img src="https://3029946802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FybPdpmLltPkzGFvz7m8A%2Fuploads%2Fgit-blob-141fb3a706f2cc97c82e2343ab872ad0ba4c0c89%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

If your data source contains identical geometries with varying attributes (e.g., weather stations or buildings), you can use the **Aggregate by geometry** functionality to aggregate your layer based on a distinct spatial column. [Learn more in this section](https://docs.carto.com/carto-user-manual/maps/layers/..#visibility-by-zoom-level-1).

## Symbol

When configuring your point layer symbol, you either use a simple point shape <img src="https://3029946802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FybPdpmLltPkzGFvz7m8A%2Fuploads%2Fgit-blob-39956ca57a30083d38c06ea913488edb9c90d355%2Fimage.png?alt=media" alt="" data-size="line"> to render your point layer or you can use a custom marker <img src="https://3029946802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FybPdpmLltPkzGFvz7m8A%2Fuploads%2Fgit-blob-e302993b981cdc94e783da0c658e939e56a08264%2Fimage.png?alt=media" alt="" data-size="line">.

**Custom markers** allows you to set an icon or an image as a marker in your map, either a single marker or use multiple markers by property. Out-of-the-box options from [Maki icons collection](https://labs.mapbox.com/maki-icons/) is readily available. Additionally, you can upload your own .png or .svg file to be used as marker in the map.

You can modify the **Radius/Size** of your symbol using a simple slider when set to fixed, or by defining a radius range when configured by a property.

<figure><img src="https://3029946802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FybPdpmLltPkzGFvz7m8A%2Fuploads%2Fgit-blob-305789e8576e305aabde24eaf6e244c53d93b588%2Fimage.png?alt=media" alt="" width="303"><figcaption></figcaption></figure>

{% hint style="warning" %}
When uploading custom markers, the **maximum allowed resolution is 120×120 pixels** and the **maximum file size is 200K**
{% endhint %}

| imageResolutionExceededError: 'The file is too large. Allowed maximum resolution is {size}x{size}px',                                              |                                                      |
| -------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- |
| [169](https://github.com/CartoDB/cloud-native/blob/a6fadbbfcf442422bec4151225bb1c83f605f426/workspace-www/src/app/localization/en/builder.ts#L169) | fileTooLargeError: 'Allowed maximum size is {size}', |

## Fill

In this section you can define **Color** that will be used to fill your point symbol. You can set a simple color or use a [color schema](https://docs.carto.com/carto-user-manual/maps/layers/..#fill-color) based on a given property to add depth and meaning to your lines. Additionally, you can adjust the fill opacity to your desired percentage for better visual effects.

<figure><img src="https://3029946802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FybPdpmLltPkzGFvz7m8A%2Fuploads%2Fgit-blob-35f313c149c6016d3c5fe80c2707fb8ffa673928%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

When configuring either the color based on a property, you can access **Advanced fill options** <img src="https://3029946802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FybPdpmLltPkzGFvz7m8A%2Fuploads%2Fgit-blob-0284a6e8c3b0d674f33e4bac8912e003925dd056%2Fimage.png?alt=media" alt="" data-size="line"> to set the [color scale](https://docs.carto.com/carto-user-manual/maps/layers/..#fill-color-2). This allows for a more granular and informative visualization.

## Stroke

The stroke of your line layer can be customized in various ways to suit your visualization needs:

* **Stroke Color**: Set a simple color or use a color schema based on a given property to add depth and meaning to your lines. Additionally, you can adjust the stroke opacity to your desired percentage for better visual effects.
* **Stroke Weight**: Define the stroke weight as either a fixed value or based on a given property. You can modify the stroke weight using a simple slider when set to fixed, or by defining a weight range when configured by a property.

<figure><img src="https://3029946802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FybPdpmLltPkzGFvz7m8A%2Fuploads%2Fgit-blob-68c06cd39da4187ad15958828d131a6d75d89077%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

When configuring either the stroke color or stroke weight based on a property, you can access **Advanced stroke options** <img src="https://3029946802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FybPdpmLltPkzGFvz7m8A%2Fuploads%2Fgit-blob-0284a6e8c3b0d674f33e4bac8912e003925dd056%2Fimage.png?alt=media" alt="" data-size="line"> to set the color scale or weight scale. This allows for a more granular and informative visualization.

## Labels

You can add labels for your point layer visualization. It can be either single label or double label. You can style and set the label size as well as configuring the placement of the label.

<figure><img src="https://3029946802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FybPdpmLltPkzGFvz7m8A%2Fuploads%2Fgit-blob-c1a3376e36b589a556d40a25e9ec70070ee52733%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

## Using `_carto_point_density` attribute

When working with point dynamic tiling sources in Builder, points are automatically aggregated for optimal visualization. The closer you zoom into the map, the more granular the view becomes, showing individual points.

In Builder, you can now leverage the automatically added `_carto_point_density` property to style the radius, fill and stroke of your layer based on the number of points aggregated at each visible point.

<figure><img src="https://3029946802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FybPdpmLltPkzGFvz7m8A%2Fuploads%2Fgit-blob-80e057044467adee064e1bd143e9e225a3a9a193%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.carto.com/carto-user-manual/maps/layers/point.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
