---
title: "Query Project-Level Signal Heatmap"
method: POST
path: "/openapi/v2.0/manage/api/v1/projects/{uuid}/signal-maps"
tags: ["Map/Signal Heatmap"]
---

# Query Project-Level Signal Heatmap

`POST /openapi/v2.0/manage/api/v1/projects/{uuid}/signal-maps`

## Request

- Base URL: `https://41b04hdzmc.apifox.cn` (the document declares no server; this is the origin it was published from)
- URL: `https://41b04hdzmc.apifox.cn/openapi/v2.0/manage/api/v1/projects/{uuid}/signal-maps`
- Auth: none required

Query signal strength heatmap of regions historically flown by aircraft under a project by device SN list (H3 index grid aggregation; returned by SDR / 4G link). device_sns up to 3000; exceeding is truncated by server with warning logged (no error).

## Path parameters

- `uuid` string, required

## Headers

- `X-Project-Uuid` string, required
- `X-Request-Id` string
- `x-user-token` string, required

## Request body

- object
  - `device_sns` string[]: Device SN List (up to 3000; server truncates excess)
  - `data_types` string[], required: Data Type: sdr / 4g / all
  - `resolution` integer: H3 Grid Resolution (server default configuration if omitted)

## Response `200`

OK

- object
  - `code` integer, required: Business Status Code: 0=Success; non-zero=Error Code (see message for meaning)
  - `message` string: Error Description Message (Omitted on Success)
  - `data` object: Signal Heatmap Data
    - `list` object[]: Device Signal Data List
      - `device_sn` string: Device Serial Number
      - `grid` object[]: H3 Grid Signal Data List
        - `h3_index` string: H3 Grid Index
        - `sdr_avg` number, nullable: SDR Video Signal Average
        - `sdr_max` integer, nullable: SDR Video Signal Maximum
        - `sdr_min` integer, nullable: SDR Video Signal Minimum
        - `4g_avg` number, nullable: 4G Signal Average
        - `4g_max` integer, nullable: 4G Signal Maximum
        - `4g_min` integer, nullable: 4G Signal Minimum

## Other responses

- `400`: Invalid Request Parameter
- `500`: Internal Service Error

---

[API](https://skmtc.dev/dji/apis/flighthub-2-openapi-v2-0-on-premises.md) - [All operations](https://skmtc.dev/dji/apis/flighthub-2-openapi-v2-0-on-premises/llms.txt) - [OpenAPI document](https://skmtc.dev/dji/apis/flighthub-2-openapi-v2-0-on-premises/revisions/e4544b7809ea?raw)