Rastra kartes

Pieejamās pakalpes

Jāņa sēta piedāvā piecu veidu karšu slāņus dažādās projekcijās:

• krāsaino (tradicionālo) Jāņa sētas karti;
• pelēktoņu Jāņa sētas karti;
• kadastra informācijas slāni;
• LĢIA topogrāfisko karti;
• LĢIA ortofoto karti.

Rastra kartes var iekļaut savos risinājumos vai lietot darbvirsmas programmās, izmantojot Jāņa sētas WMS vai WMTS pakalpes. Tie atbilst OGC tīmekļa karšu standartiem, ir saderīgi ar populārākajām karšu bibliotēkām un darbvirsmas lietojumprogrammām.

Atsauces

Izmantojot Jāņa sētas piedāvātas karšu pakalpes jebkādā formātā (t.sk., izdrukās), jālieto atsauce. Atsaucei jābūt pieejamai atkarībā no lietotā risinājuma - vai nu uz kartes, vai arī atsauču vai līdzvērtīgā sadaļā. Konkrētā atsauce atkarīga no lietotā slāņa:

• krāsainajai (tradicionālajai) Jāņa sētas un pelēktoņu Jāņa sētas kartei — © Jāņa sēta;
• kadastra informācijas slānim — © Jāņa sēta, Valsts zemes dienests;
• LĢIA topogrāfisko kartei — Topogrāfiskā karte mērogā 1:50 000 © Latvijas Ģeotelpiskās informācijas aģentūra, 2020—2022
• LĢIA ortofoto kartei — Ortofotokarte krāsainajā spektrā © Latvijas Ģeotelpiskās informācijas aģentūra, 2020—2024

WMS

WMS pakalpe tiek izmantota, lai pieprasītu taisnstūrveida kartes fragmenta attēlus brīvi izvēlētās koordinātās. WMS karšu pieprasījumu pamatsaite tiek veidota pēc šādas shēmas:

https://wms<saites_numurs>.kartes.lv/<klienta_atslēga>/<projekcijas_atslēga>/<slāņa_atslēga>/

Katra pamatsaite norāda uz vienu konkrētu kartes slāni noteiktā projekcijā. Šī pamatsaite ir jāievada karšu bibliotēku vai lietojumprogrammu konfigurācijā, kas tālāko rastra karšu pakalpju sagatavošanu un atsevišķo kartes fragmentu ielādi veiks automātiski.

Pakalpes apraksta dokuments

Pakalpē pieejamās koordinātu sistēmas, to robežas, apakšslāņus un citus parametrus var iegūt, veicot GetCapabilities pieprasījumu. Tas atgriež standartizētu XML dokumentu, kuru var izmantot, lai precīzi iestatītu kartes slāņus. Šo dokumentu izmanto karšu lietojumprogrammas. Citos gadījumos tā pieprasīšana vai lasīšana nav nepieciešama.

GetCapabilities pieprasījuma saite tiek veidota pēc šādas shēmas:

https://wms<saites_numurs>.kartes.lv//<projekcijas_atslēga>/<slāņa_atslēga>/?service=WMS&request=GetCapabilities&version=1.3.0

Kartes fragmentu attēli

Lai iegūtu pašus kartes fragmentu attēlus, jāveic GetMap pieprasījums. Tas atgriež attēlu, norādot vēlamo attēla platumu, augstumu un fragmenta stūru ģeogrāfiskās koordinātas. Pieprasījumu saites tiek veidotas, pakalpes pamatsaitei pievienojot šādus GET parametrus:

Paraugi

Krāsainās Jāņa sētas kartes WMS apraksta dokuments:

https://wms.kartes.lv//wgs/15/?SERVICE=WMS&VERSION=1.0.0&REQUEST=GetCapabilities

Krāsainās Jāņa sētas kartes WMS pieprasījums WGS projekcijā:

https://wms.kartes.lv//wgs/15/?SERVICE=WMS&VERSION=1.0.0&REQUEST=GetMap&BBOX=2682999,7748141,2686161,7750701&SRS=EPSG:3857&WIDTH=420&HEIGHT=340

Pelēktoņu Jāņa sētas kartes WMS pieprasījums LKS projekcijā

https://wms2.kartes.lv//lks/15bw/?SERVICE=WMS&VERSION=1.0.0&REQUEST=GetMap&BBOX=495210.2393944038195%2C297323.7185847196961%2C522621.1243179840385%2C316295.4527800377691&SRS=EPSG%3A3059&WIDTH=502&HEIGHT=348&FORMAT=image%2Fpng

Kadastra kartes WMS pieprasījums

https://wms1.kartes.lv//wgs/cadastral/?SERVICE=WMS&VERSION=1.1.1&REQUEST=GetMap&FORMAT=image%2Fpng&TRANSPARENT=true&WIDTH=256&HEIGHT=256&CRS=EPSG%3A4326&STYLES=&BBOX=2737057.1094378084%2C7756218.134887848%2C2738280.1018904033%2C7757441.127340443

LKS labākās izšķirtspējas iestatīšana

Vislabākās kvalitātes attēli tiek iegūti, pieprasot kartes fragmentus mērogos, kas precīzi atbilst kartes tuvinājuma līmeņiem. WGS projekcijā (EPSG:3857) tas tiek iestatīts automātiski, taču LKS projekcijā (EPSG:3059) mērogu līmeņu izšķirtspējas karšu bibliotēkās jānorāda manuāli.

Ja tiek izmantota LKS projekcija un flīžu WMS (tiled WMS), tad optimālākai darbībai vēlams karšu bibliotēkā iestatīt arī flīžu režģa sākumpunkta (tile origin) koordinātas (x, y):
-5682840.1444699997, 4997050.3242600001

WMTS

WMTS pakalpe tiek izmantota, lai pieprasītu kvadrātveida kartes fragmentus (flīzes, tiles), norādot flīzes tuvinājuma, rindas un kolonnas kārtas numurus.

Pakalpes apraksta dokuments

Pakalpē pieejamās koordinātu sistēmas, to robežas, precīzu kartes flīžu izvietojumu, apakšslāņus un citus parametrus var iegūt, veicot GetCapabilities pieprasījumu. Tas atgriež standartizētu XML dokumentu, kuru var izmantot, lai precīzi iestatītu kartes slāņus. Šo dokumentu izmanto karšu lietojumprogrammas. Citos gadījumos tā lasīšana nav nepieciešama.

Pakalpes apraksta XML dokumentu var iegūt pieprasot šādu saiti:

https://wms.kartes.lv//wgs/WMTS/?request=GetCapabilities

Šī saite ir jāievada karšu bibliotēku vai lietojumprogrammu konfigurācijā, kas tālāko rastra karšu pakalpes sagatavošanu un atsevišķo kartes flīžu pieprasījumu izveidi veiks automātiski.

Kartes flīžu attēli

Lai iegūtu pašus kartes flīžu attēlus, jāveic pieprasījums, norādot flīzes mēroga, kolonnas un rindas numurus. Pieprasījuma saite tiek veidota pēc šādas shēmas:

https://wms<saites_numurs>.kartes.lv/<klienta_atslēga>/wgs/<slāņa_atslēga>/<mēroga_nr>/<kolonnas_nr>/<rindas_nr>.png

WMTS pakalpe ir pieejama tikai WGS—84 (EPSG:3857) projekcijā atbilstoši Google Maps kartes flīžu izkārtojuma (režģa) standartam. Mēroga, kolonnu un rindu kārtu numuri tiek skaitīti no nulles. Nulltajā mēroga līmenī ir viena flīze (0,0), kas ietver visu pasauli. Katrā nākamajā mēroga līmenī flīzes tiek sadalītas četrās vienādās daļās. Precīzas katra līmeņa mēroga vērtības un koordinātu sākumpunktus var iegūt pakalpes apraksta dokumentā (GetCapabilities). Pieprasījuma rezultātā tiks atgriezts 256 pikseļus plats un augsts PNG attēls.

Paraugi

Krāsainās Jāņa sētas pamatkartes flīze:

https://wms.kartes.lv//wgs/15/12/2336/1251.png

Kļūdu kodi

Piemēri iestatīšanai karšu bibliotēkās

Leaflet

Turpmāk aprakstīti divi rastra karšu ieviešanas piemēri Leaflet tīmekļa karšu bibliotēkā:

1. pelēktoņu Jāņa sētas kartes WMS pakalpe;
2. apvienotas LĢIA ortofoto un VZD kadastra WMTS pakalpes.

Abos piemēros tiek izmantota WGS projekcija, karte sākotnēji tiek centrēta Rīgā.

const map = L.map('mapId', {
    layers: [
        L.tileLayer.wms('https://wms{s}.kartes.lv/<span class="kijs_key"></span>/wgs/15bw/', {
            subdomains: ['', '1', '2', '3', '4'],
            attribution: '<a href="https://balticmaps.eu" target="_blank">Jāņa sēta</a>',
        }),
    ],
    center: [56.96, 24.11],
    zoom: 12,
})

const map = L.map('mapId', {
    layers: [
        L.tileLayer('https://wms{s}.kartes.lv/<span class="kijs_key"></span>/wgs/orto/{z}/{x}/{y}', {
            subdomains: ['', '1', '2', '3', '4'],
            attribution: '<a href="https://balticmaps.eu" target="_blank">Jāņa sēta</a>, <a href="https://www.lgia.gov.lv/" target="_blank">LĢIA</a>',
        }),
        L.tileLayer('https://wms{s}.kartes.lv/<span class="kijs_key"></span>/wgs/cadastral/{z}/{x}/{y}', {
            subdomains: ['', '1', '2', '3', '4'],
            attribution: '<a href="https://www.vzd.gov.lv/" target="_blank">VZD</a>',
        }),
    ],
    center: [56.96, 24.11],
    zoom: 12,
})

OpenLayers

Turpmāk aprakstīti vairāki piemēri Jāņa sētas pakalpju ieviešanai OpenLayers tīmekļa bibliotēkā.

WMS pakalpe

Pirmajā piemērā tiek izveidots Jāņa sētas krāsainās pamatkartes WMS slānis. Kā arī izveidots kartes objekts, karte tiek centrēta Rīgā un tai pievienots iepriekš izveidotais myLayer slānis.

Citos piemēros izveidotie slāņi jāpievieno kartes objektam tā, kā tas tiek darīts šajā piemērā.

import Map from 'ol/Map.js';
import View from 'ol/View.js';
import TileLayer from 'ol/layer/Tile.js';
import OSM from 'ol/source/OSM.js';

const myLayer = new TileLayer({
    source: new TileWMS({
        url: 'https://wms{1-4}.kartes.lv/<span class="kijs_key"></span>/wgs/15/',
        attributions: ['<a href="https://balticmaps.eu" target="_blank">Jāņa sēta</a>'],
    }),
})

const myMap = new Map({
    view: new View({
        center: [24.11, 56.96],
        zoom: 12,
    }),
    layers: [
        myLayer, // slāņus ievietot šeit
    ],
    target: 'mapId',
});

WMTS pakalpe

Šajā piemērā izveidotais slānis izmanto kadastra WMTS pakalpi, pieprasot attēlu pēc flīžu x, y un z koordinātām.

import TileLayer from 'ol/layer/Tile.js';
import XYZ from 'ol/source/XYZ.js';

const myLayer = new TileLayer({
    source: new XYZ({
        url: 'https://wms{1-4}.kartes.lv/<span class="kijs_key"></span>/wgs/cadastral/{z}/{x}/{y}',
        attributions: ['<a href="https://balticmaps.eu" target="_blank">Jāņa sēta</a>', '<a href="https://www.vzd.gov.lv/" target="_blank">VZD</a>'],
    })
})

LKS koordinātu sistēma

Šajā piemērā attēlota LKS koordinātu sistēmas izmantošana OpenLayers bibliotēkā.

1. Vispirms nepieciešams definēt LKS koordinātu sistēmu, lai bibliotēka spētu pareizi salikt kopā karšu fragmentus. Tas tiek darīts, padodot sistēmas parametrus proj4.defs(…) funkcijai.
2. Tālāk tiek definētas LKS izšķirtspējas. Jānorāda flīžu izvietojuma sākumpunkta koordinātas un tuvinājuma līmeņu izšķirtspēja.
3. Tad tiek izveidots Jāņa sētas pelēktoņu pamatkartes WMS pakalpes slānis, norādot arī EPSG:3059 projekciju un iepriekš izveidoto flīžu izvietojumu.

import TileLayer from 'ol/layer/Tile';
import TileWMS from 'ol/source/TileWMS';
import TileGrid from 'ol/tilegrid/TileGrid';
import proj4 from 'proj4';
import { register } from 'ol/proj/proj4';

proj4.defs(
    'EPSG:3059',
    '+proj=tmerc +lat_0=0 +lon_0=24 +k=0.9996 +x_0=500000 +y_0=-6000000 +ellps=GRS80 +towgs84=0,0,0,0,0,0,0 +units=m +no_defs +axis=neu',
)

const lksTileGrid = new TileGrid({
    origin: [-5682840.1444699997, 4997050.3242600001],
    resolutions: [
        6007.4787274574555,
        3003.7393637287278,
        1501.8695495724326,
        750.93477478621628,
        375.46751968503941,
        187.73362755058844,
        93.86694606722547,
        46.933473033612735,
        23.4667365168063,
        11.733235966471934,
        5.8666179832359671,
        2.9334412835492341,
        1.4665883498433665,
        0.73342646685293378,
        0.36671323342646689,
    ],
})

const myLayer = new TileLayer({
    source: new TileWMS({
        url: 'https://wms{1-4}.kartes.lv/<span class="kijs_key"></span>/lks/15bw/',
        projection: 'EPSG:3059',
        tileGrid: lksTileGrid,
    }),
})

Datu avoti

LĢIA - Latvijas Ģeotelpiskās informācijas aģentūra
VZD - Valsts zemes dienests