Skip to content
getgeolens.com

Tile Endpoint

GET
/tiles/{table_path}/{z}/{x}/{y}.pbf
curl --request GET \
--url https://example.com/tiles/example/1/1/1.pbf \
--header 'Authorization: Bearer <token>'

Serve a vector tile as gzipped MVT binary.

URL pattern: /tiles/data.{table_name}/{z}/{x}/{y}.pbf

Non-public datasets require valid HMAC signature params (sig, exp, scope). Public datasets can be accessed without any signature.

cols is a runtime opt-in for additional attribute columns the client needs at all zooms (e.g. data-driven styling columns referenced by MapLibre paint expressions). Format: comma-separated column names. Each name is validated against the dataset column list before it flows into the MVT projection; invalid names are silently dropped. Does not need to be signed — sig already authorizes dataset access and cols can only project columns the caller already has REST access to.

table_path
required
Table Path
string
z
required
Z
integer
x
required
X
integer
y
required
Y
integer
sig
Any of:
string
exp
Any of:
integer
scope
Any of:
string
cols
Any of:
string

Successful Response

Bad request — invalid query parameters or payload

ProblemDetail
object
detail
required
Detail
string
status
required
Status
integer
title
required
Title
string
type
Type
string
default: about:blank
Example
{
"type": "about:blank"
}

Not found

ProblemDetail
object
detail
required
Detail
string
status
required
Status
integer
title
required
Title
string
type
Type
string
default: about:blank
Example
{
"type": "about:blank"
}

Validation error

ProblemDetail
object
detail
required
Detail
string
status
required
Status
integer
title
required
Title
string
type
Type
string
default: about:blank
Example
{
"type": "about:blank"
}

Internal server error

ProblemDetail
object
detail
required
Detail
string
status
required
Status
integer
title
required
Title
string
type
Type
string
default: about:blank
Example
{
"type": "about:blank"
}