Šajā lapā apkopoti divi servisi, kuri balstīti Latvijas Valsts zemes dienesta Kadastra informācijas sistēmas un Igaunijas Zemes dienesta Maa-amet atvērtajos datos. Informāciju par kadastra informācijas slāņa WMS skaties ŠEIT.

Kadastra vienību un būvju meklētājs

Autocomplete meklētājs, kas ļauj atrast kadastra vienību (tikai Latvijā un Igaunijā) vai būvi (tikai Latvijā) pēc kadastra apzīmējuma vai numura un saņemt tās ģeometriju.

Servisa URL

Servisa saitei jāatbilst šādai formai:

https://api.kartes.lv/v3//search?layers=cadastral

HTTP metode ir GET.

Pieprasījuma parametri

Iespējams padot šādus GET parametrus:

Parametrs Skaidrojums Pieejamās vērtības
q Kadastra apzīmējums Latvijā (11 cipari zemes vienībām, 14 cipari būvēm) vai numurs Igaunijā (pēc šādas struktūras #####:###:####, kur # apzīmē ciparu).
layers Datu slānis, kurā meklē.
  • cadastral - kadastra vienības (gan Latvijā, gan Igaunijā)
  • cadastral_buildings - kadastra būves (tikai Latvijā)
format Neobligāts parametrs.
  • json (noklusētā vērtība)
  • geojson
fields Satur atgriežamo lauku nosaukumus, jāatdala ar komatu.
  • name - kadastra apzīmējums
  • iso_code - valsts ISO kods
  • the_geom - ģeometrija WKT formātā
cs Neobligāts parametrs. Iespēja norādīt koordinātu sistēmu, kurā tiek atgriezti dati.
  • wgs84 (noklusētā vērtība) - dati tiks atgriezti WGS84 (EPSG:4326) koordinātu sistēmā.
  • lks - dati tiks atgriezti TM Baltic93 (EPSG:25884) koordinātu sistēmā.

Atbildes parametri

Atbildē tiek atgriezts masīvs ar atbilstošajiem kadastra apzīmējumiem, informāciju par koordinātu sistēmu, un tiem parametriem, kas tika ievadīti ievadlaukā fields.

Kļūdu kodi

Kods Skaidrojums
200 Wrong input data. Tiek atgriezts, ja vaicājumā nav ievadīti vai nav korekti ievadīti pieprasījuma parametri.
404 No location found. Tiek atgriezts, ja nekas nav ticis atrasts.
5xx Servera kļūda.

Paraugi

Pieprasījums:

https://api.kartes.lv/v3//search?q=01000242161&fields=name,the_geom&format=geojson&layers=cadastral

Atbilde:

{
   "cadastral":{
      "type":"FeatureCollection",
      "name":"cadastral",
      "crs":{
         "type":"name",
         "properties":{
            "name":"urn:ogc:def:crs:EPSG::4326"
         }
      },
      "features":[
         {
            "type":"Feature",
            "geometry":{
               "type":"Polygon",
               "coordinates":[
                  [
                     [
                        24.121745,
                        56.973326
                     ],
                     [
                        24.123015,
                        56.973876
                     ],
                     [
                        24.123056,
                        56.973848
                     ],
                     [
                        24.12386,
                        56.973294
                     ],
                     [
                        24.12267,
                        56.972794
                     ],
                     [
                        24.121791,
                        56.9733
                     ],
                     [
                        24.121745,
                        56.973326
                     ]
                  ]
               ]
            },
            "properties":{
               "name":"01000242161",
               "iso_code":"LVA"
            }
         }
      ]
   }
}
.....

Pielietošanas piemēri

Kadastra informācijas pieprasīšanas klases definēšana JavaScript kodā:

class CadastreApi {
    constructor() {
        this.apiKey = 'your_api_key_here'; // Replace with your actual API key
        this.baseUrl = 'https://api.kartes.lv/v3';
    }

    // Method to fetch cadastral data
    async getCadastralData(query) {
        const params = new URLSearchParams({
            q: query,
            fields: 'name,the_geom',
            format: 'geojson',
            layers: 'cadastral'
        });

        const url = `${this.baseUrl}/${this.apiKey}/search?${params.toString()}`;

        try {
            const response = await fetch(url);

            // Check if the response is ok (status code 200-299)
            if (!response.ok) {
                throw new Error(`Error fetching data: ${response.statusText}`);
            }

            const data = await response.json();
            return { success: true, data };
        } catch (error) {
            console.error('Fetch error:', error);
            return { success: false, error: error.message };
        }
    }
}

Kadastra informācijas pieprasīšanas klases pielietošana:

const api = new CadastreAPI();

api.getCadastralData('01000242161')
    .then(result => {
        if (!result.success) {
            console.error('Error:', result.error); // Handle the error
            return;
        }

        console.log(result.data);
        // Use the data
    });

Kadastra reversais ģeokodētājs

Atgriež dotajām koordinātām (vai atrašanās vietai) atbilstošo kadastra apzīmējumu (numuru) un papildinformāciju par to.

Servisa URL

Servisa saitei jāatbilst šādai formai:

https://api.kartes.lv/v3//reverse_geocoding?type=cadastral

Noklusētais atgriezto datu formāts ir JSON (pieejami arī JSONP un XML).

HTTP metode ir GET.

Pieprasījuma parametri

Iespējams padot šādus GET parametrus:

Parametrs Skaidrojums Vērtības
x X koordināta TM Baltic93 (EPSG:25884) koordināšu sistēmā.
y Y koordināta TM Baltic93 (EPSG:25884) koordināšu sistēmā.
lat lat koordināta WGS-84 (EPSG:4326) koordināšu sistēmā.
lon lon koordināta WGS-84 (EPSG:4326) koordināšu sistēmā.
type Reversās ģeokodēšanas tips. cadastral
result_data_type Nosaka atgriežamo datu formātu. Ja netiek norādīts, tad pēc noklusējuma atgriež JSON. Pieejami 3 formāti:
  • json
  • jsonp
  • xml
callback Parametrs aktuāls, ja izvēlas result_data_type=jsonp. Tad, datus atgriežot, šī parametra funkcija tiek izsaukta.

Atbildes parametri

Atbildē tiek atgriezts viens objekts, objekta parametri ir šādi:

Parametrs Skaidrojums
code Kadastra apzīmējums (Latvijā) vai numurs (Igaunijā).
ownership_status Kadastra vienības īpašumpiederība (tikai Latvijā).
area Kadastra vienības platība (ha).

Paraugi

Pieprasījums:

https://api.kartes.lv/v3//reverse_geocoding?lat=56.952327646236431&lon=23.90430271953273&type=cadastral

Atbilde:

{
    "code":"80480030366",
    "ownership_status":"Juridiska persona",
    "area":11.64
}

Pielietošanas piemēri

Kadastra reversās ģeokodēšanas pieprasījuma klases definēšana JavaScript kodā:

class CadastreApi {
    constructor() {
        this.apiKey = 'your_api_key_here'; // Replace with your actual API key
        this.baseUrl = 'https://api.kartes.lv/v3';
    }

    // Method to fetch cadastral parcel data using reverse geocoding
    async getCadastralParcel(lat, lon) {
        const params = new URLSearchParams({
            lat: lat,
            lon: lon,
            type: 'cadastral'
        });

        const url = `${this.baseUrl}/${this.apiKey}/reverse_geocoding?${params.toString()}`;

        try {
            const response = await fetch(url);

            // Check if the response is ok (status code 200-299)
            if (!response.ok) {
                throw new Error(`Error fetching data: ${response.statusText}`);
            }

            const data = await response.json();
            return { success: true, data };
        } catch (error) {
            console.error('Fetch error:', error);
            return { success: false, error: error.message };
        }
    }
}

Kadastra reversās ģeokodēšanas pieprasījuma klases pielietošana:

const api = new CadastreAPI();

api.getCadastralParcel(56.952327646236431, 23.90430271953273)
    .then(result => {
        if (!result.success) {
            console.error('Error:', result.error); // Handle the error
            return;
        }

        console.log(result.data);
        // Use the data
    });