Karolar ve stiller

Karo sunucusu (https://maps.updraftmaps.com) MapLibre stillerini, vektör karoları (MVT), yazı tiplerini (glif), simgeleri ve raster PNG karoları sunar.

Stiller

Stil	Adres
Pilot gözü, açık	`https://maps.updraftmaps.com/styles/pilot-light.json`
Pilot gözü, koyu	`https://maps.updraftmaps.com/styles/pilot-dark.json`

Pilot gözü: eş yükselti ve sırtlar belirgin, elektrik hatları ve teleferikler vurgulu, açık tarlalar (iniş adayı) ormandan ve makiden ayrık, şehir sade; Updraft'ın onaylı kalkış, iniş ve tehlike nesneleri en üstte. Stili değiştirebilirsiniz (renk, katman, yazı); atıf satırı korunur ve değiştirilmiş harita Updraft'ın onayladığı izlenimi vermez (Atıf).

3B arazi stilde kapalıdır; açmak için: map.setTerrain({ source: 'terrain', exaggeration: 1.3 }).

Kaynaklar

Her kaynağın TileJSON'u https://maps.updraftmaps.com/{kaynak} adresindedir; karolar /{kaynak}/{z}/{x}/{y}.

Kaynak	Tür	Zoom	İçerik
`base`	vektör (OpenMapTiles 3.16 şeması)	0–14	Arazi örtüsü, su, yollar, teleferik, sınırlar, etiketler
`contours`	vektör, katman `contour` (`ele`, `idx`)	9–14	Eş yükselti eğrileri (z≤10 100 m, z11–12 50 m, z13 20 m, z14 10 m)
`hillshade`	raster 512 px	5–12	Tepe gölgesi
`terrain`	raster-dem 512 px, `terrarium`	5–11	3B arazi
`power`	vektör, katman `power` (`class`, `voltage`, `cables`, `name`)	9–14	Elektrik hatları ve direkler (OSM)
`sites`	vektör	6–14	Onaylı kalkış ve iniş noktaları
`hazards`	vektör	9–14	Tehlikeler (elektrik hattı, kablo …)
`skyways`	vektör	7–14	Skyway hatları
`thermals`	vektör, katman `thermals`	8–14	Termik ızgarası (aşağıda)
`regions`	vektör	4–12	Uçuş bölgeleri

Bilgi katmanları (sites, hazards, skyways, thermals, regions) kesin pilot sayısı taşımaz: confidence_tier (low, medium, high) ve min_pilots (3, 5, 10, 20, 50, 100 basamakları) verir (Gizlilik).

Termik ızgarası

thermals bir fonksiyon kaynağıdır: kırılım TileJSON adresinin sorgu dizisiyle seçilir, karo adresleri bunu taşır.

https://maps.updraftmaps.com/thermals                               bütün aylar, bütün gün, bütün yönler
https://maps.updraftmaps.com/thermals?month=7                       temmuz
https://maps.updraftmaps.com/thermals?month=7&hour_bucket=6         temmuz, 12:00–14:00
https://maps.updraftmaps.com/thermals?hour_bucket=7&wind_sector=6   14:00–16:00, batıdan esen rüzgâr

Parametre	Değerler	Varsayılan ("hepsi")	Anlamı
`month`	1–12	0	Yerel ay (`Europe/Istanbul`)
`hour_bucket`	0–11	12	Yerel iki saatlik dilim: 0 = 00–02, 6 = 12–14, 11 = 22–24
`wind_sector`	0–7	8	850 hPa rüzgârının geldiği 45° dilim: 0 kuzey, 1 kuzeydoğu, 2 doğu … 7 kuzeybatı

Geçersiz değer boş karo döndürür. z8–10'da ~5 km², z11–14'te ~0,1 km² H3 altıgenleri; z8'in altında karo yoktur, z14'ün üstünde istemci büyütür.

Alan	Anlamı
`h3`	Hücrenin H3 kimliği
`avg_climb_ms`	Ortalama tırmanış, m/s (0,1'e yuvarlanmış)
`confidence_tier`	`low`, `medium`, `high`
`min_pilots`	"En az N farklı pilot" (3, 5, 10, 20, 50, 100)

Bir hücre yalnız yeterli sayıda farklı pilot (varsayılan 5) orada termik bulduysa gelir. Rüzgâr dilimi uçuşun kalkış hücresindeki model rüzgârından atanır; modelin olmadığı uçuşlar yalnız "bütün yönler" kırılımına girer.

Raster karolar

Vektör çizemeyen istemciler için aynı stilden çizilmiş PNG:

	Adres
256 px	`https://maps.updraftmaps.com/raster/pilot-light/{z}/{x}/{y}.png`
512 px (aynı alan, yüksek yoğunluklu ekran)	`https://maps.updraftmaps.com/raster/pilot-light/{z}/{x}/{y}@2x.png`
TileJSON	`https://maps.updraftmaps.com/raster/pilot-light.json`

Zoom 5–16 (dışında 404); koyu tema pilot-dark. Raster karoda yalnız taban harita vardır (arazi örtüsü, su, yollar, teleferik, eş yükselti, gölge, elektrik hatları, etiketler); termik, skyway, kalkış ve iniş girmez. Örnek: flutter_map.

Önbellek

Yanıt	`Cache-Control`
Taban, eş yükselti, gölge, arazi, elektrik (kalıcı adlar)	`public, max-age=3600`
Bilgi katmanları ve termik	`public, max-age=60`
Raster PNG	`public, max-age=3600, stale-while-revalidate=86400, stale-if-error=604800`, `Last-Modified` + 304

Taban harita ayda bir, elektrik hatları haftada bir, termik ızgarası her gece yenilenir. Mobil uygulamada internetsiz kullanım için önbellek tazeliğini istemcide uzatın ya da bölge paketlerini kullanın (bölge başına PMTiles; yalnız taban harita, eş yükselti ve arazi).

Anahtarlı ve anahtarsız erişim

Yol	Denetim	Kullanım sayılır mı
Anahtarsız	İstemci adresi başına kaba sınır; aşımda gövdesiz 429	Hayır
Anahtarlı (`X-Api-Key` başlığı ya da `?key=`)	`tiles` kapsamı, anahtar başına oran sınırı; 401/403/429 API gövdesiyle	Evet

Tarayıcıdan gelen isteklerde karo sunucusu yalnız kayıtlı kökenlere izin verir (CORS); anahtarı alırken sitenizin kökenini bildirin. Uygulamanızda anahtarlı yolu kullanın: sınırlar anahtarınıza göre ayarlanır, kullanımınızı görebiliriz ve sorun çıkarsa size ulaşabiliriz.