Meklēšanas serviss

Autocomplete meklētājs.

Servisa URL

Servisa saitei jāatbilst šādai formai:

https://api.kartes.lv/v3/<klienta_atslega>/search?

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

HTTP metode ir GET.

  • klienta_atslega: klienta atslēga, kura tika Jums piešķirta.

Pieprasījuma parametri

Iespējams padot sekojošus GET parametrus:

Parametrs Skaidrojums Pieejamās vērtības
q Teksta ievads, kurā ievadīts meklējamā objekta nosaukums.
limit Katrā slānī maksimāli atgriežamo objektu skaits (maksimāli var pieprasīt līdz 50 objektiem).
mode
  • compact
  • full
layers Datu slāņi, kuros meklēt
iso_code Valstis, starp kuru objektiem meklēt
format
  • standart
  • geojson
geometry
fields Satur atgriežamo lauku nosaukumus, jāatdala ar komatu.
  • name - Ielas nosaukums
  • pop_place - Apdzīvotas vietas vai pilsētas nosaukums
  • iso_code - Valsts kods
  • x_min - minimālais ielas ģeometrijas koordinātu X punkts
  • y_min - minimālais ielas ģeometrijas koordinātu Y punkts
  • x_max - maksimālais ielas ģeometrijas koordinātu X punkts
  • y_max - maksimālais ielas ģ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 - objekta hešs (izmantojams citos servisos)
cs Neobligāts parametrs. Noklusējumā wgs84 (EPSG:4326). Iespēja norādīt koordinātu sistēmu, kurā tiek atgriezti dati.
  • wgs84 - dati tiks atgriezti wgs84 (EPSG:4326) koordinātu sistēmā.
  • lks - dati tiks atgriezti LKS-92 (EPSG:25884) koordinātu sistē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 (strādā vienīgi POLYGON tipam).
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,
  • apdz_vieta - apdzīvotās vietas,
  • admin_vien - administratīvās vienības,
  • terit_vien - teritoriālās vienības,
  • iela - ielas,
  • river - upes,
  • lake - ezeri,
  • mountain - kalni, pilskalni,
  • public-transport - sabiedriskā transporta pieturas,
  • hotels - viesnīcas,
  • fuel - DUS,
  • education - izglītības iestādes,
  • airports - lidostas,
  • religion - reliģiskās celtnes,
  • museum - muzeji,
  • culture - kultūras objekti,
  • shopping - tirdzniecības centri,
  • skiing - slēpošana,
  • nature - dabas objekti.

Atbildes parametri

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

Paraugi

Ievads: https://api.kartes.lv/v3/<klienta_atslega>/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

Rezultāts:

{
    "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":"LINESTRING(24.054698 56.949043,24.054371 56.948994,24.054241 56.948963,24.054074 56.948904,24.053951 56.94885, ...)"
        }
    ]
}

Ievads:

https://api.kartes.lv/v3/<klienta_atslega>/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

Rezultāts:

{
  "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.328814481721,
            56.97748106838
          ]
        },
        "properties": {
          "name": "Berlīne, Cesvaines pag., Cesvaines nov., Latvija",
          "iso_code": "LVA"
        }
      },
      {
        "type": "Feature",
        "geometry": {
          "type": "Point",
          "coordinates": [
            25.6685722292,
            57.192809547425
          ]
        },
        "properties": {
          "name": "Berlīne, Dzērbene, Dzērbenes pag., Vecpiebalgas nov., Latvija",
          "pop_place": "Dzērbene",
          "iso_code": "LVA"
        }
      },
      {
        "type": "Feature",
        "geometry": {
          "type": "Point",
          "coordinates": [
            26.606173067191,
            56.826337109232
          ]
        },
        "properties": {
          "name": "Berlīne, Meirāni, Indrānu pag., Lubānas nov., Latvija",
          "pop_place": "Meirāni",
          "iso_code": "LVA"
        }
      },
      {
        "type": "Feature",
        "geometry": {
          "type": "Point",
          "coordinates": [
            24.946031608715,
            57.347813667374
          ]
        },
        "properties": {
          "name": "Berlīne, Straupe, Straupes pag., Pārgaujas 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.616222,
                56.894474
              ],
              [
                24.617474,
                56.893912
              ],
              ...
            ],
            ...
          ]
        },
        "properties": {
          "name": "Berlīnes līnija",
          "iso_code": "LVA",
          "x_min": "24.616222",
          "y_min": "56.893680",
          "x_max": "24.687871",
          "y_max": "56.908783",
          "x_first": "24.616222",
          "y_first": "56.894474"
        }
      }
    ]
  },
  "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": []
  }
}