Server APIAnalytics Queries
Execute heatmap query
Execute a heatmap query. Returns spatial event density as (x, y, value) points within a 3D bounding box, along with the resolved bounds and aggregate statistics. Bounds are looked up from the heatmap definition identified by heatmapData.id.
AuthorizationBearer <token>
Secret server key (prefixed gb_sk_) for server-to-server calls. Send it as Authorization: Bearer <key>. Never ship a secret key in a game client.
In: header
Path Parameters
applicationId*number
Gamebeast project ID
Header Parameters
environment_id*number
Gamebeast environment ID
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
curl -X POST "https://example.com/application/0/analytics/v1/queries/heatmaps/execute" \ -H "environment_id: 0" \ -H "Content-Type: application/json" \ -d '{ "time": { "step": "second", "relative": { "step": "second", "value": 0 } }, "metrics": [ { "visible": true, "id": "string", "data": { "name": "string", "type": "event" } } ], "heatmapData": { "id": "string" }, "options": { "display": "line" } }'Empty