The service turns an address (e.g. Muuseumi tee 2) into one or more structured
matches with coordinates, relevance score and address components.
Estonian, Latvian and Lithuanian addresses are covered, see the guide chapters
Searching Latvian addresses and
Searching Lithuanian addresses.
Read the guide →
All options step by step: formats, bulk, window, extended data, errors.
API reference (Swagger UI) →
All parameters and interactive try-it-out.
OpenAPI spec (YAML file) →
Machine-readable API description for tooling: import into Postman or generate client code (OpenAPI Generator). Note: opens as a raw YAML file; your browser may download it.
Endpoint
| Method | URL |
|---|---|
GET | https://pump.elemroot.com/jgc_rest/geocode |
GET | https://pump.elemroot.com/jgc_rest_lyh/geocode ("lyh": same API and JSON structure but with a shorter address form: e.g. Eesti, Tartumaa, Tartu linn, … instead of the usual Eesti Vabariik, Tartu maakond, Tartu linn, …; meant for frequent short queries such as autocomplete: keep main traffic on jgc_rest) |
Required parameters
| Parameter | Meaning |
|---|---|
q required | Address to geocode (repeat for multiple addresses) |
gl required | Dataset ID, e.g. ee_aid (repeat for multiple datasets) |
key required | API key (without it: 403) |
Quick example
curl "https://pump.elemroot.com/jgc_rest/geocode?q=Muuseumi+tee+2&gl=ee_aid&output=json&key=docs_382d376eaaa6d004b7b93b7d"Full explanation and more examples: Geocoding guide.