Teenus muudab aadressi (nt Muuseumi tee 2) üheks või mitmeks struktureeritud
vasteks koos koordinaatide, asjakohasuse skoori ja aadressikomponentidega.
Kaetud on Eesti, Läti ja Leedu aadressid, vt juhendi peatükke
Läti aadresside otsimine ja
Leedu aadresside otsimine.
Loe juhendit →
Kõik võimalused samm-sammult: vormingud, bulk, aken, laiendatud andmed, vead.
API viide (Swagger UI) →
Kõik parameetrid ja interaktiivne „proovi järele”.
OpenAPI spec (YAML-fail) →
Masinloetav API kirjeldus tööriistadele: impordi Postman'i või genereeri klientkood (OpenAPI Generator). NB: avaneb toore YAML-failina, brauser võib selle alla laadida.
Endpoint
| Meetod | Aadress |
|---|---|
GET | https://pump.elemroot.com/jgc_rest/geocode |
GET | https://pump.elemroot.com/jgc_rest_lyh/geocode („lüh”: sama API ja JSON-struktuur, aga lühema aadressivormiga: nt Eesti, Tartumaa, Tartu linn, … tavalise Eesti Vabariik, Tartu maakond, Tartu linn, … asemel; mõeldud sagedastele lühipäringutele, nt automaattäitele: põhiliiklus hoia jgc_rest peal) |
Kohustuslikud parameetrid
| Parameeter | Tähendus |
|---|---|
q kohustuslik | Geokodeeritav aadress (korduv = mitu aadressi) |
gl kohustuslik | Andmekogumi ID, nt ee_aid (korduv = mitu andmekogu) |
key kohustuslik | API-võti (ilma võtmeta 403) |
Kiire näide
curl "https://pump.elemroot.com/jgc_rest/geocode?q=Muuseumi+tee+2&gl=ee_aid&output=json&key=docs_382d376eaaa6d004b7b93b7d"Täielik selgitus ja rohkem näiteid: Geokodeerimise juhend.