Report how the Android Auto map drew on this device

POST

/v1/telemetry/car-renderer

curl --request POST \
  --url https://api.tareky.com/v1/telemetry/car-renderer \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "events": [ { "kind": "SESSION", "renderer": "godot", "reason": "example", "at": "2026-04-15T12:00:00Z", "appVersion": "example", "engineVersion": "example", "device": { "model": "example", "soc": "example", "gpu": "example", "sdk": 1, "abi": "example", "ramMb": 1 }, "carHost": "example", "surface": "example", "seconds": 1, "initMs": 1, "firstFrameMs": 1, "fpsP50": 1, "fpsP5": 1, "frameMsP95": 1, "jankPct": 1, "module": { "state": "example", "errorCode": 1, "bytes": 1, "ms": 1 }, "seq": 1 } ] }'

Authorizations

• key
• access_token
• legacy

Parameters

Header Parameters

x-access-key-id

string

Legacy key id (until its sunset)

Request Body^required

Media typeapplication/json

object

events

required

Array<object>

>= 1 items <= 50 items

object

kind

required

string

Allowed values: SESSION INIT_FAILED FALLBACK MODULE BREAKER

renderer

required

string

Allowed values: godot maplibre

reason

string

>= 1 characters <= 64 characters

at

required

When it happened on the device (ISO 8601)

string format: date-time

/^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$/

appVersion

required

string

>= 1 characters <= 32 characters

engineVersion

string

>= 1 characters <= 32 characters

device

required

object

model

required

Build.MODEL

string

>= 1 characters <= 64 characters

soc

System-on-chip, as Build.SOC_MODEL reports it

string

>= 1 characters <= 64 characters

gpu

GL_RENDERER of the context the map drew with

string

>= 1 characters <= 128 characters

sdk

required

Android SDK level

integer

>= 1 <= 100

abi

required

The ABI the app runs as (arm64-v8a)

string

>= 1 characters <= 32 characters

ramMb

required

Total RAM in MB

integer

<= 1000000

carHost

string

>= 1 characters <= 64 characters

surface

string

>= 1 characters <= 64 characters

seconds

number

<= 86400

initMs

integer

<= 600000

firstFrameMs

integer

<= 600000

fpsP50

number

<= 1000

fpsP5

number

<= 1000

frameMsP95

number

<= 60000

jankPct

number

<= 100

module

object

state

required

Where the download or install stands (requested, downloading, installed, failed, …)

string

>= 1 characters <= 32 characters

errorCode

Any of:

integer

integer

>= -9007199254740991 <= 9007199254740991

string

string

>= 1 characters <= 64 characters

bytes

integer

<= 2147483647

ms

integer

<= 86400000

seq

The app queue’s own sequence number, for its ack. Ignored here

integer

<= 9007199254740991

Responses

202

Media typeapplication/json

object

accepted

required

Events stored

integer

>= -9007199254740991 <= 9007199254740991

Example^generated

{
  "accepted": 1
}

429

Rate limit or monthly quota exceeded; see Retry-After

Media typeapplication/json

object

error

required

object

code

required

Stable machine-readable code, e.g. quota_exceeded, no_route

string

message

required

string

status

required

integer

>= -9007199254740991 <= 9007199254740991

details

For invalid_request: the validation issues

docsUrl

required

string

requestId

string

Example^generated

{
  "error": {
    "code": "example",
    "message": "example",
    "status": 1,
    "details": "example",
    "docsUrl": "example"
  },
  "requestId": "example"
}

default

Any other error, in the /v1 error envelope

Media typeapplication/json

object

error

required

object

code

required

Stable machine-readable code, e.g. quota_exceeded, no_route

string

message

required

string

status

required

integer

>= -9007199254740991 <= 9007199254740991

details

For invalid_request: the validation issues

docsUrl

required

string

requestId

string

Example^generated

{
  "error": {
    "code": "example",
    "message": "example",
    "status": 1,
    "details": "example",
    "docsUrl": "example"
  },
  "requestId": "example"
}