Reversā ģeokodēšana

Serviss ļauj iegūt adreses informāciju padotajam punktam.

Servisa URL

Servisa saitei jāatbilst šādai formai:

https://api.kartes.lv/v3//reverse_geocoding?

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:

Atbildes parametri atkarībā no parametra type

type = address

Atbildē tiek atgriezti viens vai vairāki (parametrs limit) objekti, tā parametri ir šādi:

type = populated_area

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

type = country

Atbildē tiek atgriezta viens objekts, tā parametrs ir šāds:

type = suggest_place

Atbildē tiek atgriezti vairāki objekti, parametri ir līdzigi type = address atbildes parametriem ar papildus parametru:

type = admin_unit

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

type = territ_unit

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

type = cadastral

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

Kļūdu kodi

Paraugi

Pieprasījums:

https://api.kartes.lv/v3//reverse_geocoding?x=509679&y=6314169

Atbilde:

{
  "valsts": "Latvija",
  "admin_vien": "Rīga",
  "terit_vien": "Vidzemes priekšpilsēta",
  "apdz_vieta": "Rīga",
  "iela": "Brīvības gatve",
  "maja": "197A",
  "index": "LV-1039",
  "korpuss": "",
  "vzd_id": "101867023",
  "distance": 25,
  "x": "509679.56",
  "y": "6314193.80",
  "lon": 24.159217,
  "lat": 56.971222,
  "adrese": "Brīvības gatve 197A, Rīga, Vidzemes pr-pilsēta, Latvija"
}

Pieprasījums:

https://api.kartes.lv/v3//reverse_geocoding?lat=57.208140&lon=24.773591

Atbilde:

{
  "valsts": "Latvija",
  "admin_vien": "Siguldas novads",
  "terit_vien": "Krimuldas pagasts",
  "apdz_vieta": "",
  "iela": "",
  "maja": "Akmeņi",
  "index": "LV-2144",
  "korpuss": "",
  "vzd_id": "104910650",
  "distance": 99,
  "x": "546816.85",
  "y": "6340771.40",
  "lon": 24.775007,
  "lat": 57.207688,
  "adrese": "Akmeņi, Krimuldas pag., Siguldas nov., Latvija"
}

Pielietošanas piemēri

Reversās ģeokodēšanas klases definēšana JavaScript kodā:

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

    // Method to fetch reverse geocoded data by latitude and longitude
    async getReverseGeocodingData(lat, lon) {
        const url = `${this.baseUrl}/${this.apiKey}/reverse_geocoding?lat=${lat}&lon=${lon}`;

        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 };
        }
    }
}

Reversās ģeokodēšanas klases pielietošana:

const api = new ReverseGeocodingAPI();

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

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