Aadressiotsingu juhend

Praktiline juhend näidetega: kuidas teha päringuid, valida väljundeid ja kasutada kõiki teenuse võimalusi. Iga jaotuse juures on käivitatav curl näide ja vastuse näidis.

Endpoint ja meetodid

Kasutab GET- ja POST-meetodit (POST puhul application/x-www-form-urlencoded). NB: POST-i korral peab key olema päringustringis (URL-is); ainult vormikehas antud võtit võtmekontroll ei näe ja vastus on 403.

Parameetrite koondtabel

Andmekogud (gl):

Korda gl parameetrit mitme andmekogu üheaegseks otsinguks (nt &gl=ee_aid&gl=lv).

Esimene päring

curl "https://pump.elemroot.com/jgc_rest/geocode?q=Muuseumi+tee+2&gl=ee_aid&output=json&key=docs_382d376eaaa6d004b7b93b7d"

[
  {
    "name": "Muuseumi tee 2",
    "placemark": [
      {
        "address": "Eesti Vabariik, Tartu maakond, Tartu linn, Tartu linn, Muuseumi tee 2",
        "AddressDetails": { "Accuracy": "8" },
        "LatLonBox": {
          "east": 26.756282629776482,
          "south": 58.39077394011176,
          "north": 58.40077393988824,
          "west": 26.736282630223517
        },
        "point": { "coordinates": [26.74628263, 58.39577394] },
        "relevance": 0.1004990025510281
      }
    ]
  }
]

Vastus on massiiv: üks objekt iga sisendaadressi kohta. Väli name kordab sisendit, placemark sisaldab vasteid asjakohasuse järgi (suurim relevance esimesena). Koordinaadid on [E, N] järjekorras (EPSG:4326 puhul [pikkuskraad, laiuskraad]).

Postiindeksiga täpsustamine

Sama tänavanimi võib esineda mitmes Eesti paigas. Õige aadressi õiges kohas leidmiseks lisa sisendisse postiindeks (5-kohaline); teenus tuvastab selle ja filtreerib vasted õigesse piirkonda.

curl "https://pump.elemroot.com/jgc_rest/geocode?q=Muuseumi+tee+2&gl=ee_aid&output=json2&maxcount=5&key=docs_382d376eaaa6d004b7b93b7d"

Eesti Vabariik, Tartu maakond, Tartu linn, Tartu linn, Muuseumi tee 2      (sihtnr 60532)
Eesti Vabariik, Harju maakond, Rae vald, Lagedi alevik, Muuseumi tee 2     (sihtnr 75303)
Eesti Vabariik, Tartu maakond, Tartu linn, Tartu linn, Muuseumi tee 2/1    (sihtnr 60532)

curl "https://pump.elemroot.com/jgc_rest/geocode?q=Muuseumi+tee+2,+75303&gl=ee_aid&output=json2&srs=EPSG:3301&key=docs_382d376eaaa6d004b7b93b7d"

[
  {
    "name": "Muuseumi tee 2, 75303",
    "placemark": [
      {
        "address": "Eesti Vabariik, Harju maakond, Rae vald, Lagedi alevik, Muuseumi tee 2",
        "AddressDetails": {
          "AddressLines": [
            { "Type": "A0",           "Value": "Eesti Vabariik" },
            { "Type": "A1",           "Value": "Harju maakond" },
            { "Type": "A2",           "Value": "Rae vald" },
            { "Type": "A3",           "Value": "Lagedi alevik" },
            { "Type": "A5",           "Value": "Muuseumi tee" },
            { "Type": "A7",           "Value": "2" },
            { "Type": "A1_EHAK",      "Value": "0037" },
            { "Type": "A2_EHAK",      "Value": "0653" },
            { "Type": "A3_EHAK",      "Value": "4043" },
            { "Type": "POSTCODE",     "Value": "75303" },
            { "Type": "AADRESS_ID",   "Value": "772374" },
            { "Type": "A_STAATUS_ID", "Value": "1" }
          ],
          "Accuracy": "8"
        },
        "point": { "coordinates": [553474.2797853436, 6583771.550346661] },
        "relevance": 0.09405935760739681
      }
    ]
  }
]

Väljundvormingud

Sama päring eri output väärtustega.

xml

curl "https://pump.elemroot.com/jgc_rest/geocode?q=Muuseumi+tee+2&gl=ee_aid&output=xml&key=docs_382d376eaaa6d004b7b93b7d"

<?xml version='1.0' encoding='UTF-8'?>
<kml xmlns="http://earth.google.com/kml/2.0">
  <Response>
    <name>Muuseumi tee 2</name>
    <Placemark>
      <address>Eesti Vabariik, Tartu maakond, Tartu linn, Tartu linn, Muuseumi tee 2</address>
      <LatLonBox>
        <north>58.40077393988824</north><south>58.39077394011176</south>
        <east>26.756282629776482</east><west>26.736282630223517</west>
      </LatLonBox>
      <Point><coordinates>26.74628263,58.39577394</coordinates></Point>
      <relevance>0.1004990025510281</relevance>
      <AddressDetails Accuracy="8" />
    </Placemark>
  </Response>
</kml>

kml (Google Earth)

curl "https://pump.elemroot.com/jgc_rest/geocode?q=Muuseumi+tee+2&gl=ee_aid&output=kml&key=docs_382d376eaaa6d004b7b93b7d"

Sama struktuur kui xml, kuid Content-Type on application/vnd.google-earth.kml+xml, sobib otse Google Earthi / kaardirakendustesse.

json2 / xml2: lameda struktuuriga aadress

json2 ja xml2 annavad aadressi nimekirjana (AddressLines). Iga rida on tüübistatud komponent (Type, valikuline Subtype, Value). Andmekogu ee_aid kasutab tüübikoode A0, A1, …

curl "https://pump.elemroot.com/jgc_rest/geocode?q=Muuseumi+tee+2&gl=ee_aid&output=json2&key=docs_382d376eaaa6d004b7b93b7d"

[
  {
    "name": "Muuseumi tee 2",
    "placemark": [
      {
        "address": "Eesti Vabariik, Tartu maakond, Tartu linn, Tartu linn, Muuseumi tee 2",
        "AddressDetails": {
          "AddressLines": [
            { "Type": "A0",           "Value": "Eesti Vabariik" },
            { "Type": "A1",           "Value": "Tartu maakond" },
            { "Type": "A2",           "Value": "Tartu linn" },
            { "Type": "A3",           "Value": "Tartu linn" },
            { "Type": "A5",           "Value": "Muuseumi tee" },
            { "Type": "A7",           "Value": "2" },
            { "Type": "A1_EHAK",      "Value": "0079" },
            { "Type": "A2_EHAK",      "Value": "0793" },
            { "Type": "A3_EHAK",      "Value": "8151" },
            { "Type": "POSTCODE",     "Value": "60532" },
            { "Type": "AADRESS_ID",   "Value": "3069760" },
            { "Type": "A_STAATUS_ID", "Value": "1" }
          ],
          "Accuracy": "8"
        },
        "LatLonBox": { "east": 26.756282629776482, "south": 58.39077394011176,
                       "north": 58.40077393988824, "west": 26.736282630223517 },
        "point": { "coordinates": [26.74628263, 58.39577394] },
        "relevance": 0.1004990025510281
      }
    ]
  }
]

Tüübikoodide tähendus:

XML-vaste (output=xml2) mähib read elementi <AddressLines>:

<AddressDetails Accuracy="8">
  <AddressLines>
    <AddressLine Type="A0">Eesti Vabariik</AddressLine>
    <AddressLine Type="A1">Tartu maakond</AddressLine>
    <AddressLine Type="A2">Tartu linn</AddressLine>
    <AddressLine Type="A3">Tartu linn</AddressLine>
    <AddressLine Type="A5">Muuseumi tee</AddressLine>
    <AddressLine Type="A7">2</AddressLine>
    <AddressLine Type="POSTCODE">60532</AddressLine>
  </AddressLines>
</AddressDetails>

ads_liik_staatus (aadressi liik ja staatus)

Eesti aadressiandmestiku jaoks on eraldi XML-vorming ads_liik_staatus, mis annab aadressi eestikeelsete väljadena (EHAK-koodid, liigid, staatus, sihtnumber jne):

curl "https://pump.elemroot.com/jgc_rest/geocode?q=Muuseumi+tee+2&gl=ee_aid&output=ads_liik_staatus&key=docs_382d376eaaa6d004b7b93b7d"

<?xml version='1.0' encoding='UTF-8'?>
<aadressideNimekiri>
  <aadress>
    <aadressSisse>Muuseumi tee 2</aadressSisse>
    <vaste>
      <aid>3069760</aid>
      <maakondEhak>0079</maakondEhak>
      <maakond>Tartu maakond</maakond>
      <omavalitsusEhak>0793</omavalitsusEhak>
      <omavalitsus>Tartu linn</omavalitsus>
      <asustusyksusEhak>8151</asustusyksusEhak>
      <asustusyksus>Tartu linn</asustusyksus>
      <liikluspind>Muuseumi tee</liikluspind>
      <aadressinumber>2</aadressinumber>
      <sihtnumber>60532</sihtnumber>
      <aadressValja>Eesti Vabariik, Tartu maakond, Tartu linn, Tartu linn, Muuseumi tee 2</aadressValja>
      <abStaatusId>1</abStaatusId>
      <vastavuseHeadus>Korras</vastavuseHeadus>
      <koordinaadid>26.74628263,58.39577394</koordinaadid>
      <relevantsus>0.1004990025510281</relevantsus>
      <latLonBox>
        <north>58.40077393988824</north><south>58.39077394011176</south>
        <east>26.756282629776482</east><west>26.736282630223517</west>
      </latLonBox>
    </vaste>
  </aadress>
</aadressideNimekiri>

Näites on tühjad elemendid (nt <korterinumber/>, <vaikekoht/>) lühiduse mõttes välja jäetud. See vorming on saadaval ainult kui server on selle andmekogu jaoks lubanud.

Koordinaatsüsteemid

Vaikimisi EPSG:4326 (WGS84, kraadid). Eesti tasapinnaliseks süsteemiks (meetrites) kasuta EPSG:3301 (L-EST97). Kood on tõstutundetu (epsg:3301 töötab) ja aktsepteeritakse ka aliaseid wgs84 / l-est97; muu väärtus (paljas 3301, EPSG:3857) annab 400. Soovitame kanoonilist kuju.

curl "https://pump.elemroot.com/jgc_rest/geocode?q=Muuseumi+tee+2&gl=ee_aid&srs=EPSG:3301&key=docs_382d376eaaa6d004b7b93b7d"

"point": { "coordinates": [660545.9498807918, 6476102.220117778] },
"LatLonBox": {
  "east": 661107.3382034153,  "south": 6475521.90091788,
  "north": 6476682.619832239, "west": 659984.3920757968
}

Hulgipäring (bulk)

Mitu aadressi korraga: korda parameetrit q:

curl "https://pump.elemroot.com/jgc_rest/geocode?q=Muuseumi+tee+2&q=Ülikooli+18&gl=ee_aid&maxcount=1&key=docs_382d376eaaa6d004b7b93b7d"

[
  {
    "name": "Muuseumi tee 2",
    "placemark": [
      { "address": "Eesti Vabariik, Tartu maakond, Tartu linn, Tartu linn, Muuseumi tee 2",
        "AddressDetails": { "Accuracy": "8" },
        "point": { "coordinates": [26.74628263, 58.39577394] },
        "relevance": 0.1004990025510281 }
    ]
  },
  {
    "name": "Ülikooli 18",
    "placemark": [
      { "address": "Eesti Vabariik, Tartu maakond, Tartu linn, Tartu linn, Ülikooli tänav 18",
        "AddressDetails": { "Accuracy": "8" },
        "point": { "coordinates": [26.71952943, 58.38076991] },
        "relevance": 0.09787157650387346 }
    ]
  }
]

Iga sisendaadress saab vastuses oma objekti samas järjekorras.

Aadressiotsing ID järgi (aidq)

Kui sul on salvestatud aadressi ID (AADRESS_ID: sama number, mille gl=ee_aid vastus tagastab), saad aidq=true-ga küsida selle ID aadressi otse: iga q väärtus on siis ID, mitte aadressitekst. Vastus on tavaline geokodeerimisvastus (kõik väljundvormingud ja srs/rs toimivad), nii et olemasolev parsimine sobib muutmata kujul.

curl "https://pump.elemroot.com/jgc_rest/geocode?q=3069760&gl=ee_aid&aidq=true&output=json2&key=docs_382d376eaaa6d004b7b93b7d"

[
  {
    "name": "3069760",
    "placemark": [
      { "address": "Eesti Vabariik, Tartu maakond, Tartu linn, Tartu linn, Muuseumi tee 2",
        "AddressDetails": { "AddressLines": [ …, { "Type": "AADRESS_ID", "Value": "3069760" }, … ] },
        "point": { "coordinates": [26.74628263, 58.39577394] } }
    ]
  }
]

• Vastuses on täpselt see punkt, mille AADRESS_ID võrdub küsitud ID-ga (tavaliselt 1 vaste).
• Tundmatu või mittenumbriline ID annab 0 vastet ("name" on olemas, placemark puudub); viga ei teki.
• q on korduv ka ID-režiimis: mitu ID-d ühe päringuga (vt hulgipäring).
• Toetatud andmekogud: ee, ee_aid, lv, lt. Eesti puhul kasuta gl=ee_aid, siis on ID ka tavavastuses näha. Läti ja Leedu puhul on AADRESS_ID vastuses juba gl=lv / gl=lt juures; lv_aid ja lt_aid ei ole olemas ja annavad 400.
• /jgc_rest_lyh teenuses annab korteri ID selle maja aadressi, sest lühiteenuse andmestikus korteritasandit ei ole. Korteritäpsuse jaoks kasuta /jgc_rest.

curl "https://pump.elemroot.com/jgc_rest/geocode?q=101020361&gl=lv&aidq=true&output=json2&key=docs_382d376eaaa6d004b7b93b7d"

[
  {
    "name": "101020361",
    "placemark": [
      { "address": "Latvija, Valmieras nov., Valmiera, Jumaras iela 195 k-1",
        "AddressDetails": {
          "AddressLines": [ …, { "Type": "A7", "Value": "195 k-1" },
                            { "Type": "POSTCODE", "Value": "4201" },
                            { "Type": "AADRESS_ID", "Value": "101020361" } ],
          "Accuracy": "8" },
        "point": { "coordinates": [25.390738, 57.520503] } }
    ]
  }
]

Mitu andmekogu

Otsi korraga mitmest andmekogust: korda parameetrit gl. Tulemused koondatakse aadresside kaupa ja järjestatakse asjakohasuse järgi.

curl "https://pump.elemroot.com/jgc_rest/geocode?q=Pärnu+mnt+1&gl=ee_aid&gl=lv&key=docs_382d376eaaa6d004b7b93b7d"

Eesti aadresside otsimine

Otsing tuleb toime nii ametliku aadressi kui ka igapäevaste kirjapiltidega: allolev tabel näitab, millised kujud annavad sama vastuse.

Kirjavahemärkide tähendus Eesti aadressis:

• Sidekriips eraldab maja ja korterit: Anne tn 1-1 on maja 1 korter 1; vastuses on maja rida A7 ja korter A8. Nimega aadressil sama: Kivimõisa-2 on talu Kivimõisa korter 2.
• Kaldkriips majanumbris tähendab ühe maja paralleelnumbrit, mitte korterit: Muuseumi tee 2/1 on omaette maja (A7=2/1).
• Täht kuulub majanumbri juurde: Anne tn 14a (A7=14a).
• Otsing on sisendis leplik: korterit leiab ka 1/1 ja krt 1 kujul; kui küsitud korterit ei ole, tuleb vastuseks maja.

Läti aadresside otsimine

Läti aadressimudel erineb Eesti omast: maja nimi ja number on ühes väljas ning korpus on selle sees. Otsing tuleb toime kõigi levinud kirjapiltidega: allolev tabel näitab, millised kujud annavad sama vastuse.

• Diakriitikud ei ole kohustuslikud: Rinni, Vecates pagasts leiab Riņņi.
• Maapiirkonnas on küla ja maja nimi ühes aadressiosas: Dzērbene Ciedras tähendab küla Dzērbene ja maja Ciedras.
• Paljas majanimi ilma kontekstita leitakse, aga vastus on sageli mitmene; samanimelisi majapidamisi on palju. Küla või pagasti lisamine kitsendab tulemuse.
• Väljad AddressLines-is: tänav A5, maja number koos korpusega A7, korter A8. A4 ja A6 Läti vastustes ei esine.
• gl=lv vastuses on AADRESS_ID alati kaasas: eraldi lv_aid andmekogu ei ole.

Leedu aadresside otsimine

Leedu aadress koosneb savivaldybėst, seniūnijast (linnades sageli puudub), asulast, tänavast ja majanumbrist; korpus on majanumbri osa (2A K1). Otsing tuleb toime nii ametliku postiaadressi kui ka igapäevaste kirjapiltidega; allolev tabel näitab, millised kujud annavad sama vastuse.

• Diakriitikud ei ole kohustuslikud: Perkuno g. 2A K1, Rokiskis leiab Perkūno g. 2A K1.
• 2A-1 tähendab korterit 1 majas 2A, mitte korpust: korpus kirjutatakse 2A K1.
• Seniūnija tuleb vastuses reana A2; linnades, kus seniūnijaid ei ole, see rida puudub.
• Haldusüksuste nimed tulevad vastuses registri lühikujus (Vilniaus miesto sav., Kartenos sen.); otsingus töötab nii lühend kui täissõna.
• Asula tuleb vastuses registri ametlikul aadressikujul: linn ja alevik nimetavas (Kaunas, Gelvonai), küla ja üksiktalu omastavas koos liigilühendiga (Ežeraičių k., Lapkalnio vs.). Otsingus töötavad mõlemad kujud — Ežeraičiai leiab Ežeraičių k.. Nii eristuvad ka samanimelised asulad (alevik Gelvonai ja küla Gelvonų k.) juba vastuste loendis.
• Sama nimega asulad samas seniūnijas (näiteks küla ja talu) annavad mitu vastet; liigilühend (Lapkalnio vs. 1) kitsendab tulemuse.
• Väljad AddressLines-is: tänav A5, maja number koos korpusega A7, korter A8. A4 ja A6 Leedu vastustes ei esine.
• gl=lt vastuses on AADRESS_ID kaasas kõigil tasemetel: maja ja korter (Registrų centrase objektikood) ning savivaldybė, seniūnija, asula ja tänav (registri kood); sama kood töötab aidq=true otsinguga; eraldi lt_aid andmekogu ei ole.

Vastete arv ja täpsus

Vaikimisi tagastatakse kuni 10 vastet aadressi kohta. Piira parameetriga maxcount:

curl "https://pump.elemroot.com/jgc_rest/geocode?q=Tartu&gl=ee_aid&maxcount=3&key=docs_382d376eaaa6d004b7b93b7d"

Vasted on järjestatud asjakohasuse järgi. Iga vaste juures on:

Accuracy väärtused:

Loetletud on Eesti andmestikus esinevad väärtused; Läti ja Leedu kasutavad sama skaalat oma haldusjaotuse tasemetega (maja on ka seal 8).

Asukohaeelistus (ll + spn)

Piira vasted geograafilise aknaga. ll on keskpunkt (lat,lon), spn akna suurus (spanLat,spanLon); aken on ll ± spn/2.

curl "https://pump.elemroot.com/jgc_rest/geocode?q=Kesktee&gl=ee_aid&key=docs_382d376eaaa6d004b7b93b7d"
# esimene vaste: Harju maakond, Tallinn, Pirita linnaosa, Kesktee

curl "https://pump.elemroot.com/jgc_rest/geocode?q=Kesktee&gl=ee_aid&ll=58.38,26.72&spn=0.2,0.4&key=docs_382d376eaaa6d004b7b93b7d"
# esimene vaste: Tartu maakond, Kastre vald, Haaslava küla, Kesktee

Aken filtreerib: aknast välja jäävad vasted ei tule vastusesse. Kui tahad neid alles jätta ja ise ümber järjestada, jäta aken ära ja kasuta suuremat maxcount-i.

Automaattäitmine (ac)

Otsingukasti („as-you-type”) jaoks lülita sisse ac: mootor laiendab sisendi viimast sõna:

curl "https://pump.elemroot.com/jgc_rest/geocode?q=Muuseu&gl=ee_aid&output=json2&ac&maxcount=10&key=docs_382d376eaaa6d004b7b93b7d"

Käitumine on tasemepõhine: pakutakse alati järgmise taseme jätke:

• Tänav ilma numbrita → selle tänava majad; majanumber → sama maja korterid. Kui maxcount ruumi jääb, täidetakse ülejäänu järgmise taseme ridadega: q=Pae tn 43 → 43, 43b, 43-1, 43-2 …
• Sõnajärg ei loe: Kannikese 33, Tartu linn ja Tartu linn, Kannikese 33 annavad sama loendi.
• Lõpetamissignaal: tühik või sidekriips numbri järel (q=Kannikese 33  või 33-) piirab loendi selle majaga: 33a enam ei pakuta.

Sõnade vahelejätmine (st)

Kui sisendis on tundmatuid või liigseid sõnu, luba neid vahele jätta parameetriga st (vahelejäetavate sõnade maksimum):

curl "https://pump.elemroot.com/jgc_rest/geocode?q=ettevõte+OÜ+Muuseumi+tee+2&gl=ee_aid&st=2&key=docs_382d376eaaa6d004b7b93b7d"

Suurem st annab rohkem vasteid, kuid võib alandada täpsust.

Laiendatud andmed (xd)

xd=true lisab igale vastele ExtendedData ploki: kuidas sisendit tõlgendati (millised sõnad sobitati, mis tunti ära, mis jäi tundmatuks), sisendi korterinumber, sihtnumber jne.

curl "https://pump.elemroot.com/jgc_rest/geocode?q=Muuseumi+tee+2-1&gl=ee_aid&xd=true&st=1&key=docs_382d376eaaa6d004b7b93b7d"

"ExtendedData": {
  "recognizedTokens": [
    { "start": 15, "end": 16, "token": "1", "skipped": 0 }
  ],
  "unrecognizedTokens": [],
  "isCharsimApplied": false,
  "isPostcodeSkipped": false,
  "matchedTokens": [
    { "start": 0,  "end": 12, "token": "Muuseumi tee", "skipped": 0 },
    { "start": 13, "end": 14, "token": "2",            "skipped": 0 }
  ],
  "skippedTokenCount": 0,
  "inputFlatNumber": "1"
}

Reeglikomplektid (rs)

Parameeter rs valib serveris seadistatud reeglistiku. Kaks toetatud väärtust:

rs=reverse: address-string tuleb komponentide vastupidises järjekorras (täpsem enne); struktureeritud AddressLines ja kõik muu ei muutu. Töötab ka _lyh-teenusel ja LV/LT andmekogudel. Sobib otse kuvamiseks:

curl "https://pump.elemroot.com/jgc_rest/geocode?q=Muuseumi+tee+2,+Tartu&gl=ee_aid&rs=reverse&maxcount=1&key=docs_382d376eaaa6d004b7b93b7d"

"address": "Muuseumi tee 2, Tartu linn, Tartu linn, Tartu maakond, Eesti Vabariik"

Ilma rs-ita: "Eesti Vabariik, Tartu maakond, Tartu linn, Tartu linn, Muuseumi tee 2". Sama tähendus mis pöördgeokodeerimise s=ADDRESS_reverse.

rs=A2A3: lisab A2-taseme (omavalitsus) vaste alla kõik A3-taseme alamkohad (ainult Eesti andmestikul). Kasulik kohavaliku liidestes: üks päring annab omavalitsuse koos kõigi tema asustusüksustega, ilma eraldi kataloogipäringuteta. Vaikimisi piirab ridade arvu maxcount (10):

curl "https://pump.elemroot.com/jgc_rest/geocode?q=Saaremaa&gl=ee_aid&rs=A2A3&key=docs_382d376eaaa6d004b7b93b7d"

Väärtus on tõstutundlik (REVERSE annab 400); tundmatu rs väärtus annab 400.

XAL2 tüübi asendus (replaceType)

json2/xml2 väljundis saab komponendi tüübinime ümber nimetada. Parameeter on kujul vana uus (tühikuga eraldatud paar) ja korduv. Näiteks nimeta tüüp A5 (liikluspind) ümber street-iks:

curl "https://pump.elemroot.com/jgc_rest/geocode?q=Muuseumi+tee+2&gl=ee_aid&output=json2&replaceType=A5+street&key=docs_382d376eaaa6d004b7b93b7d"

{ "Type": "street", "Value": "Muuseumi tee" }

JSONP (callback)

Teenus tagastab Access-Control-Allow-Origin: *; moodsas brauseris piisab tavalisest fetch()-ist. JSONP on alles vanemate klientide jaoks.

JSONP jaoks lisa callback: vastus mähitakse funktsioonikutsesse:

curl "https://pump.elemroot.com/jgc_rest/geocode?q=Muuseumi+tee+2&gl=ee_aid&callback=naita&key=docs_382d376eaaa6d004b7b93b7d"

naita && naita([{"name":"Muuseumi tee 2","placemark":[{"address":"Eesti Vabariik, Tartu maakond, Tartu linn, Tartu linn, Muuseumi tee 2","AddressDetails":{"Accuracy":"8"},"point":{"coordinates":[26.74628263,58.39577394]},"relevance":0.1004990025510281}]}])

Content-Type on siis application/javascript.

Millal mida kasutada

Sagedasemad ülesanded ja neile vastav parameetrikombinatsioon. Kõik read on elusalt kontrollitud.

curl "https://pump.elemroot.com/jgc_rest/geocode?q=Muuseu&gl=ee_aid&output=json2&ac&maxcount=10&key=docs_382d376eaaa6d004b7b93b7d"

curl "https://pump.elemroot.com/jgc_rest/geocode?q=Muuseumi+tee+2&q=%C3%9Clikooli+18&q=Kannikese+33,+Tartu&gl=ee_aid&output=json2&maxcount=1&key=docs_382d376eaaa6d004b7b93b7d"

Vastuses on kolm objekti, sisendiga samas järjekorras.

Veakäsitlus

curl -i "https://pump.elemroot.com/jgc_rest/geocode?q=Tartu&gl=puudub&key=docs_382d376eaaa6d004b7b93b7d"

HTTP/1.1 400 Bad Request
Content-Type: text/html;charset=utf-8

<html><head><title>Apache Tomcat - Error report</title> ... </head>
<body> ... No dataset puudub ... </body></html>

Veakeha on rakendusserveri (Tomcat) HTML-vealeht, mis sisaldab veateadet (siin „No dataset puudub”).

Näited galeriis

• Aadressiotsing L-EST97 rasterkaardil
• Aadressiotsing Elemrooti rasterkaardil
• Üks otsing: Eesti, Läti ja Leedu aadressid
• Aadressiotsing Elemrooti vektorkaardil
• Aadresside nimekirja geokodeerimine
• Aadressiväli tellimusvormis