Bölge paketleri · API referansı

İnternetsiz kullanım için bölge başına PMTiles dosyaları.

GET `/v1/packs/{region}`

Current offline pack of a region, with download URLs

Kimlik: X-Api-Key başlığı; gereken kapsam: kapsam tablosu.

Ad	Yer	Tip	Açıklama
`region` zorunlu	yol	`string`	Region slug (`regions.slug`), e.g. `fethiye-babadag` `0–64` chars · `^[a-z0-9]+(?:-[a-z0-9]+)*$`

Durum	Açıklama	İçerik
`200`	Pack description; `Cache-Control: private, no-store`	`application/json` → `PackInfo`
`401`	code: `auth_missing`, `auth_invalid`, `auth_revoked`	`application/json` → `ErrorBody`
`403`	code: `auth_scope`	`application/json` → `ErrorBody`
`404`	code: `pack_not_found`	`application/json` → `ErrorBody`
`422`	code: `request_invalid`	`application/json` → `ErrorBody`
`429`	code: `rate_limited`, `quota_exceeded` (`Retry-After` seconds) Başlıklar: `Retry-After` — Seconds until the exhausted window resets	`application/json` → `ErrorBody`
`503`	code: `pack_download_unavailable`	`application/json` → `ErrorBody`

Download one pack file through a signed URL (no API key)

Kimlik: Anahtar gerekmez.

Ad	Yer	Tip	Açıklama
`region` zorunlu	yol	`string`	Region slug (`regions.slug`), e.g. `fethiye-babadag` `0–64` chars · `^[a-z0-9]+(?:-[a-z0-9]+)*$`
`pack_version` zorunlu	yol	`string`	`YYYYMMDD[-n]` `^\d{8}(?:-(?:[2-9]\|[1-9]\d+))?$`
`file` zorunlu	yol	`string`	`{kind}.pmtiles` `^(?:base\|contours\|terrain\|hillshade\|power)\.pmtiles$`
`expires` zorunlu	sorgu	`integer`	Unix seconds, from the signed URL
`signature` zorunlu	sorgu	`string`	From the signed URL `0–64` chars

Durum	Açıklama	İçerik
`200`	The PMTiles file; `Range` requests answer 206	`application/vnd.pmtiles` → `string` (binary)
`307`	Object store presigned URL (S3 stores)
`403`	code: `pack_url_invalid`, `pack_url_expired`	`application/json` → `ErrorBody`
`404`	code: `pack_not_found`	`application/json` → `ErrorBody`
`422`	code: `request_invalid`	`application/json` → `ErrorBody`
`503`	code: `pack_download_unavailable`	`application/json` → `ErrorBody`