---
title: "Get Layer Mvt Agg Tile"
method: GET
path: "/api/v1/map/{layer_id}/agg-tiles/{z}/{x}/{y}.pbf"
tags: ["map"]
---

# Get Layer Mvt Agg Tile

`GET /api/v1/map/{layer_id}/agg-tiles/{z}/{x}/{y}.pbf`

Serve an aggregate (bin-count) MVT tile for low-zoom rendering.

Emits one MVT point per occupied grid cell with a ``count`` property —
the client renders bubbles sized by count at zoom levels below the
detail-layer threshold so panning over dense data doesn't tessellate
tens of thousands of features the user can't actually see.

``filter_id`` — same as detail tiles; the aggregate counts then reflect
the active filter instead of the layer total. Favorites-only resolution
matches ``get_layer_mvt_tile`` so agg bubbles count only the favorites
when that toggle is on.

## Path parameters

- `z` integer, required
- `x` integer, required
- `y` integer, required
- `layer_id` string, uuid, required

## Query parameters

- `v` string
- `filter_id` string, uuid, nullable
- `token` string, nullable — Firebase ID token for MVT authentication

## Response `200`

Successful Response

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/maia-analytics/apis/maia-api.md) · [All operations](https://skmtc.dev/maia-analytics/apis/maia-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/maia-analytics/maia-api/revisions/0382310d5ade/schema)