Meklēšanas serviss

Autocomplete meklētājs. Var tikt izmantots arī kā mazāk strikts ģeokodētājs.

Servisa URL

Servisa saitei jāatbilst šādai formai:

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

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 Pieejamās vērtības
q Teksts, kurā ievadīts meklējamā objekta nosaukums vai hešs vai arī, meklējot, cadastral vai cadastral_building slānī, kadastra numurs Parametrs obligāts
mode
  • full (noklusējuma vērtība)
  • compact
layers Datu slāņi, kuros meklēt (sk. zemāk)
iso_code Valstu ISO kodi, starp kurām meklēt objektus
format JSON vai GeoJSON
  • standart (noklusējuma vērtība)
  • geojson
geometry Objekta pilnā ģeometrija Bez parametra
fields Satur atgriežamo lauku nosaukumus, jāatdala ar komatu. Parametrs obligāts
  • name - nosaukums (adreses gadījumā - pilna adrese)
  • maja - ēkas numurs vai mājas nosaukums
  • korpuss - korpuss
  • iela - ielas nosaukums
  • pop_place - apdzīvotas vietas vai pilsētas nosaukums
  • admin_vien - administratīvās vienības nosaukums
  • terit_vien - teritoriālās vienības nosaukums
  • index - pasta indekss
  • valsts - valsts nosaukums
  • iso_code - valsts ISO kods
  • x - X koordināta
  • y - Y koordināta
  • x_min - minimālais ģeometrijas koordinātu X punkts
  • y_min - minimālais ģeometrijas koordinātu Y punkts
  • x_max - maksimālais ģeometrijas koordinātu X punkts
  • y_max - maksimālais ģeometrijas koordinātu Y punkts
  • x_first - ģeometrijas pirmā punkta X koordināta
  • y_first - ģeometrijas pirmā punkta Y koordināta
  • the_geom - ģeometrija WKT formātā
  • hash - unikāla simbolu virkne, kas satur informāciju par objektu (izmantojama citos servisos)
cs Iespēja norādīt koordinātu sistēmu, kurā tiek atgriezti dati.
  • wgs84 - dati tiks atgriezti WGS84 (EPSG:4326) koordinātu sistēmā (noklusējuma vērtība).
  • lks - dati tiks atgriezti TM Baltic93 (EPSG:25884) koordinātu sistēmā.
limit Katrā slānī maksimāli atgriežamo objektu skaits. Skaitlis no 1 līdz 50 (noklusējuma vērtība)
pop_place_level Meklē tikai pilsētās (tikai adresēm).
  • cities
address_code Adreses kods (tikai adresēm).
magicKey Ja ir padots, tad meklēšanā tiek izmantots tikai šis norādītais hešs (tikai adresēm).
region Ja ir padots, tad meklēšana notiek tikai norādītajā apgabalā (pagastā, novadā, rajonā). Iespējams padot arī WKT ģeometriju (vienīgi POLYGON tipam). Aktuāls tikai adresēm.
post Ja ir padots, tad meklēšana notiek tikai norādītajos pasta indeksos (tikai adresēm) Formāts: LV-1021,LV-1050
postGroups Ja ir padots, tad meklēšana notiek tikai norādītajās pasta indeksu "grupās" (tikai adresēm) Formāts: LV-10,LV-54

Pieejamie datu slāņi

  • adrese - adreses,
  • historical_address - vēsturiskās adreses,
  • apdz_vieta - apdzīvotās vietas,
  • admin_vien - administratīvās vienības,
  • terit_vien - teritoriālās vienības,
  • iela - ielas, autoceļi (var meklēt pēc valsts autoceļa numura vai LVM ceļa nosaukuma),
  • river - upes,
  • lake - ezeri,
  • mountain - kalni,
  • swamp - purvi,
  • island - salas,
  • park_forest - parki, meži,
  • nature - dabas objekti,
  • protected_area - aizsargājamās dabas teritorijas,
  • public_institution - sabiedriskās institūcijas, uzņēmumi
  • finance - finanšu iestādes,
  • catering - ēdināšanas uzņēmumi,
  • hotels - viesnīcas,
  • fuel - degvielas vai gāzes uzpildes stacijas, uzlādes stacijas,
  • education - izglītības iestādes,
  • health_care - medicīnas iestādes,
  • religion - reliģiskās celtnes, dievnami,
  • museum - muzeji,
  • sport_recreation -sporta objekti,
  • culture - kultūras objekti,
  • harbor - ostas,
  • shopping - tirdzniecības centri,
  • tourism - tūrisma objekti,
  • skiing - slēpošanas trases,
  • transport - sabiedriskā transporta objekti,
  • public-transport - sabiedriskā transporta pieturas,
  • airports - lidostas,
  • cadastral - kadastra zemes vienība,
  • cadastral_building - kadastra būve.

Atbildes parametri

Atbildē tiek atgriezti pieprasītie datu slāņi, katrā slānī ir masīvs ar objektiem, kas satur ievadlaukā fields definētos parametrus.

Kļūdu kodi

Kods Skaidrojums
400 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

Adrešu meklēšana

Pieprasījums:

https://api.kartes.lv/v3//search?q=krasta%20105%20riga&layers=adrese&cs=wgs84&fields=name,maja,iela,pop_place,terit_vien,admin_vien,iso_code,index,x,y

Atbilde:

{
  "adrese": [
    {
      "name": "Krasta iela 105, Rīga, Latgales pr-pilsēta, Latvija",
      "maja": "105",
      "iela": "Krasta iela",
      "pop_place": "Rīga",
      "terit_vien": "Latgales priekšpilsēta",
      "admin_vien": "Rīga",
      "iso_code": "LVA",
      "index": "LV-1019",
      "x": 24.16781,
      "y": 56.921167
    },
    {
      "name": "Krasta iela 105A, Rīga, Latgales pr-pilsēta, Latvija",
      "maja": "105A",
      "iela": "Krasta iela",
      "pop_place": "Rīga",
      "terit_vien": "Latgales priekšpilsēta",
      "admin_vien": "Rīga",
      "iso_code": "LVA",
      "index": "LV-1019",
      "x": 24.168581,
      "y": 56.921337
    }
  ]
}

Citi

Pieprasījums:

https://api.kartes.lv/v3//search?q=rododendru%20iela%20rīga&layers=iela&cs=wgs84&fields=name,pop_place,iso_code,x_min,y_min,x_max,y_max,x_first,y_first,the_geom

Atbilde:

{
  "iela": [
    {
      "name": "Rododendru iela",
      "pop_place": "Rīga",
      "iso_code": "LVA",
      "x_min": "24.047660",
      "y_min": "56.947559",
      "x_max": "24.054698",
      "y_max": "56.949043",
      "x_first": "24.054698",
      "y_first": "56.949043",
      "the_geom": "{\"type\":\"LineString\",\"coordinates\":[[24.054698,56.949043],[24.054496,56.949013],[24.054241,56.948963],[24.054123,56.948921],[24.053951,56.94885],...}"
  }
]
}

Pieprasījums:

https://api.kartes.lv/v3//search?q=berlīne&cs=wgs84&format=geojson&fields=name,pop_place,iso_code,x_min,y_min,x_max,y_max,x_first,y_first,the_geom

Atbilde:

{
    "apdz_vieta": {
        "type": "FeatureCollection",
        "name": "apdz_vieta",
        "crs": {
            "type": "name",
            "properties": {
                "name": "urn:ogc:def:crs:EPSG::4326"
            }
        },
        "features": []
    },
    "adrese": {
        "type": "FeatureCollection",
        "name": "adrese",
        "crs": {
            "type": "name",
            "properties": {
                "name": "urn:ogc:def:crs:EPSG::4326"
            }
        },
        "features": [
            {
                "type": "Feature",
                "geometry": {
                    "type": "Point",
                    "coordinates": [
                        26.328814,
                        56.977481
                    ]
                },
                "properties": {
                    "name": "Berlīne, Cesvaines pag., Madonas nov., Latvija",
                    "iso_code": "LVA"
                }
            },
            {
                "type": "Feature",
                "geometry": {
                    "type": "Point",
                    "coordinates": [
                        25.668572,
                        57.19281
                    ]
                },
                "properties": {
                    "name": "Berlīne, Dzērbene, Dzērbenes pag., Cēsu nov., Latvija",
                    "pop_place": "Dzērbene",
                    "iso_code": "LVA"
                }
            },
            {
                "type": "Feature",
                "geometry": {
                    "type": "Point",
                    "coordinates": [
                        26.606173,
                        56.826337
                    ]
                },
                "properties": {
                    "name": "Berlīne, Meirāni, Indrānu pag., Madonas nov., Latvija",
                    "pop_place": "Meirāni",
                    "iso_code": "LVA"
                }
            },
            {
                "type": "Feature",
                "geometry": {
                    "type": "Point",
                    "coordinates": [
                        24.946032,
                        57.347814
                    ]
                },
                "properties": {
                    "name": "Berlīne, Straupe, Straupes pag., Cēsu nov., Latvija",
                    "pop_place": "Straupe",
                    "iso_code": "LVA"
                }
            }
        ]
    },
    "admin_vien": {
        "type": "FeatureCollection",
        "name": "admin_vien",
        "crs": {
            "type": "name",
            "properties": {
                "name": "urn:ogc:def:crs:EPSG::4326"
            }
        },
        "features": []
    },
    "terit_vien": {
        "type": "FeatureCollection",
        "name": "terit_vien",
        "crs": {
            "type": "name",
            "properties": {
                "name": "urn:ogc:def:crs:EPSG::4326"
            }
        },
        "features": []
    },
    "iela": {
        "type": "FeatureCollection",
        "name": "iela",
        "crs": {
            "type": "name",
            "properties": {
                "name": "urn:ogc:def:crs:EPSG::4326"
            }
        },
        "features": [
            {
                "type": "Feature",
                "geometry": {
                    "type": "MultiLineString",
                    "coordinates": [
                        [
                            [
                                24.820069,
                                56.534862
                            ],...
                        ],...
                    ]
                },
                "properties": {
                    "name": "Berlīnes ceļš",
                    "iso_code": "LVA",
                    "x_min": "24.820069",
                    "y_min": "56.523434",
                    "x_max": "24.826498",
                    "y_max": "56.534862",
                    "x_first": "24.820069",
                    "y_first": "56.534862"
                }
            },
            {
                "type": "Feature",
                "geometry": {
                    "type": "MultiLineString",
                    "coordinates": [
                        [
                            [
                                24.616246,
                                56.894385
                            ],...
                        ],...
                },
                "properties": {
                    "name": "Berlīnes līnija",
                    "iso_code": "LVA",
                    "x_min": "24.616246",
                    "y_min": "56.893761",
                    "x_max": "24.687871",
                    "y_max": "56.908783",
                    "x_first": "24.616246",
                    "y_first": "56.894385"
                }
            }
        ]
    },
    "river": {
        "type": "FeatureCollection",
        "name": "river",
        "crs": {
            "type": "name",
            "properties": {
                "name": "urn:ogc:def:crs:EPSG::4326"
            }
        },
        "features": []
    },
    "lake": {
        "type": "FeatureCollection",
        "name": "lake",
        "crs": {
            "type": "name",
            "properties": {
                "name": "urn:ogc:def:crs:EPSG::4326"
            }
        },
        "features": []
    },
    "mountain": {
        "type": "FeatureCollection",
        "name": "mountain",
        "crs": {
            "type": "name",
            "properties": {
                "name": "urn:ogc:def:crs:EPSG::4326"
            }
        },
        "features": []
    },
    "cadastral": {
        "type": "FeatureCollection",
        "name": "cadastral",
        "crs": {
            "type": "name",
            "properties": {
                "name": "urn:ogc:def:crs:EPSG::4326"
            }
        },
        "features": []
    },
    "cadastral_building": {
        "type": "FeatureCollection",
        "name": "cadastral_building",
        "crs": {
            "type": "name",
            "properties": {
                "name": "urn:ogc:def:crs:EPSG::4326"
            }
        },
        "features": []
    },
    "hotels": {
        "type": "FeatureCollection",
        "name": "hotels",
        "crs": {
            "type": "name",
            "properties": {
                "name": "urn:ogc:def:crs:EPSG::4326"
            }
        },
        "features": []
    },
    "fuel": {
        "type": "FeatureCollection",
        "name": "fuel",
        "crs": {
            "type": "name",
            "properties": {
                "name": "urn:ogc:def:crs:EPSG::4326"
            }
        },
        "features": []
    },
    "education": {
        "type": "FeatureCollection",
        "name": "education",
        "crs": {
            "type": "name",
            "properties": {
                "name": "urn:ogc:def:crs:EPSG::4326"
            }
        },
        "features": []
    },
    "religion": {
        "type": "FeatureCollection",
        "name": "religion",
        "crs": {
            "type": "name",
            "properties": {
                "name": "urn:ogc:def:crs:EPSG::4326"
            }
        },
        "features": []
    },
    "culture": {
        "type": "FeatureCollection",
        "name": "culture",
        "crs": {
            "type": "name",
            "properties": {
                "name": "urn:ogc:def:crs:EPSG::4326"
            }
        },
        "features": []
    },
    "shopping": {
        "type": "FeatureCollection",
        "name": "shopping",
        "crs": {
            "type": "name",
            "properties": {
                "name": "urn:ogc:def:crs:EPSG::4326"
            }
        },
        "features": []
    },
    "nature": {
        "type": "FeatureCollection",
        "name": "nature",
        "crs": {
            "type": "name",
            "properties": {
                "name": "urn:ogc:def:crs:EPSG::4326"
            }
        },
        "features": [
            {
                "type": "Feature",
                "geometry": {
                    "type": "Point",
                    "coordinates": [
                        25.3277100919886,
                        57.3563960998154
                    ]
                },
                "properties": {
                    "name": "Berlīne",
                    "iso_code": "LVA"
                }
            }
        ]
    },
    "catering": {
        "type": "FeatureCollection",
        "name": "catering",
        "crs": {
            "type": "name",
            "properties": {
                "name": "urn:ogc:def:crs:EPSG::4326"
            }
        },
        "features": []
    },
    "finance": {
        "type": "FeatureCollection",
        "name": "finance",
        "crs": {
            "type": "name",
            "properties": {
                "name": "urn:ogc:def:crs:EPSG::4326"
            }
        },
        "features": []
    },
    "health_care": {
        "type": "FeatureCollection",
        "name": "health_care",
        "crs": {
            "type": "name",
            "properties": {
                "name": "urn:ogc:def:crs:EPSG::4326"
            }
        },
        "features": []
    },
    "public_institution": {
        "type": "FeatureCollection",
        "name": "public_institution",
        "crs": {
            "type": "name",
            "properties": {
                "name": "urn:ogc:def:crs:EPSG::4326"
            }
        },
        "features": []
    },
    "sport_recreation": {
        "type": "FeatureCollection",
        "name": "sport_recreation",
        "crs": {
            "type": "name",
            "properties": {
                "name": "urn:ogc:def:crs:EPSG::4326"
            }
        },
        "features": []
    },
    "tourism": {
        "type": "FeatureCollection",
        "name": "tourism",
        "crs": {
            "type": "name",
            "properties": {
                "name": "urn:ogc:def:crs:EPSG::4326"
            }
        },
        "features": [
            {
                "type": "Feature",
                "geometry": {
                    "type": "Point",
                    "coordinates": [
                        24.1041293486792,
                        56.9585196144391
                    ]
                },
                "properties": {
                    "name": "Berlīnes mūra fragments",
                    "pop_place": "Rīga",
                    "iso_code": "LVA"
                }
            }
        ]
    },
    "transport": {
        "type": "FeatureCollection",
        "name": "transport",
        "crs": {
            "type": "name",
            "properties": {
                "name": "urn:ogc:def:crs:EPSG::4326"
            }
        },
        "features": []
    },
    "swamp": {
        "type": "FeatureCollection",
        "name": "swamp",
        "crs": {
            "type": "name",
            "properties": {
                "name": "urn:ogc:def:crs:EPSG::4326"
            }
        },
        "features": []
    },
    "island": {
        "type": "FeatureCollection",
        "name": "island",
        "crs": {
            "type": "name",
            "properties": {
                "name": "urn:ogc:def:crs:EPSG::4326"
            }
        },
        "features": []
    },
    "park_forest": {
        "type": "FeatureCollection",
        "name": "park_forest",
        "crs": {
            "type": "name",
            "properties": {
                "name": "urn:ogc:def:crs:EPSG::4326"
            }
        },
        "features": []
    },
    "protected_area": {
        "type": "FeatureCollection",
        "name": "protected_area",
        "crs": {
            "type": "name",
            "properties": {
                "name": "urn:ogc:def:crs:EPSG::4326"
            }
        },
        "features": []
    },
    "historical_address": {
        "type": "FeatureCollection",
        "name": "historical_address",
        "crs": {
            "type": "name",
            "properties": {
                "name": "urn:ogc:def:crs:EPSG::4326"
            }
        },
        "features": [
            {
                "type": "Feature",
                "geometry": {
                    "type": "Point",
                    "coordinates": [
                        25.668572,
                        57.19281
                    ]
                },
                "properties": {
                    "name": "Berlīne, Dzērbenes pag., Cēsu raj., Latvija",
                    "iso_code": "LVA"
                }
            }
        ]
    }
}