Search documentation
karat

+

K

User Documentation ↗
Version 2.0

Render Symbol Map

PUT/api/v2/gaia/maps/renderSymbol
Warning

This endpoint is in preview and may be modified or removed at any time. To use this endpoint, add preview=true to the request query parameters.

Fetches the PNG for the given symbol identifier

Third-party applications using this endpoint via OAuth2 must request the following operation scope: api:map-read.

Query parameters

preview
boolean
optional

Enables the use of preview functionality.

Request body

RenderSymbolMapRequest
object
Hide child attributes

Hide child attributes

value
union
Show child attributes

Show child attributes

Response body

body
string

Examples

Request

Copied!
1 2 3 4 5 curl -X PUT \ \t-H "Content-type: application/json" \ \t-H "Authorization: Bearer $TOKEN" \ "https://$HOSTNAME/api/v2/gaia/maps/renderSymbol?preview=true" \ -d '{"value":{"type":"MilsymSymbol","sidc":"SHG-USTI-------"}}'

Error responses

Error Name
ErrorExportingSymbolError CodeINTERNAL
Status Code500
DescriptionFailed to export symbol.
Parameters
UnknownSymbolTypeError CodeINVALID_ARGUMENT
Status Code400
DescriptionUnknown symbol type not supported, must be either IconSymbol or MilsymSymbol.
ParametersunknownType
InvalidUrlSymbolError CodeINVALID_ARGUMENT
Status Code400
DescriptionUrl Symbol not supported, must be either IconSymbol or MilsymSymbol.
Parameters
RenderSymbolMapPermissionDeniedError CodePERMISSION_DENIED
Status Code403
DescriptionCould not renderSymbol the Map.
Parameters