Geokodeerimise teenus

Geokodeerimine võimaldab leida tekstilise aadressi järgi aadresspunkti(de) koordinaadid.

Geokodeerimist saab teha ühe aadressi kaupa (Ühe asukoha kodeerimine) või mitme aadressi kaupa (Masskodeerimine). Üksiku aadressi geokodeerimist on võimalik teostada ka JSON või XML teenusega. Selleks tuleb teha HTTPS-GET  päring, mille vastuseks kuvatakse kas XML või JSON vastus, vastavalt sellele, kuidas parameetris output see valik ette antud on: https://inaadress.maaamet.ee/geocoder-api/api/online?text=Õnne 1, Tartu&output=json 
Lisaks on pöördkodeerimise võimalus ehk leida asukoha koordinaatide järgi aadressid antud punktis etteantud raadiuses.

Massgeokodeerimise teenuse sisendfailile esitatavad nõuded:

• CSV või XLSX formaadis
• Maksimaalne suurus 5 MB

CSV fail peab olema kodeeritud windows-1257 või siis UTF-8. UTF-8 fail võib olla nii BOM-ga kui ka ilma. Väljade eraldajaks reas on semikoolon - ";". Esimene rida on väljade pealkirjad. Teine ja järgnevad loetakse sisendandmeteks; võib sisaldada tühju ridu, mida ignoreeritakse.

XLSX/XLS faili esimese lehe esimene rida on väljade pealkirjad. Teine ja järgnevad loetakse sisendandmeteks.

Väljundformaadid:

• CSV - eraldajatega tekstifail
• XLSX - Microsoft Office Exceli töövihik (uuem formaat)
• GEOJSON - ruumiandmeid sisaldav JSON vormingul põhinev fail, avatud standardvorming 
• GEOPACKAGE - avatud standardvorming geoinfosüsteemide jaoks
• KML - ruumiandmeid sisaldav fail geoinfosüsteemides kasutamiseks, kasutusel internetipõhistes kaardirakendustes, näiteks Google Earth
• SHP - ruumiandmeid sisaldav fail geoinfosüsteemides kasutamiseks, sobilik ESRI süsteemidele