Latvijos adresų ir pašto kodų WEB API

Dokumentacija

WEB API adresas: https://api.postit.lt/lv/v1/

Užklausa pateikiama GET metodu, o atsakymas grąžinamas JSON formatu.

Užklausos parametrai

Taip* – būtina pateikti term arba address.

Paieška

Pašto kodo galima ieškoti formatais LV-1010, LV 1010 arba 1010. Atsakyme pašto kodas visada pateikiamas formatu LV-NNNN.

Ieškoma pagal visą adresą, gatvę, numerį, patalpų grupę, vietovę, valsčių, savivaldybę ir oficialius identifikatorius. Galima rašyti latviškomis raidėmis arba be diakritinių ženklų, pavyzdžiui, Rīga arba Riga.

Įprasta paieška grąžina pastatus ir užstatyti skirtus žemės vienetus. Įvedus visą adresą su patalpų grupės numeriu arba tikslų patalpų grupės identifikatorių, paieška taip pat grąžina patalpų grupes.

Adreso struktūra

savivaldybė (novads) arba valstybės miestas (valstspilsēta)
→ valsčius (pagasts, gali nebūti)
→ vietovė (gali nebūti): miestas (pilsēta), kaimas (ciems) arba mažasis kaimas (mazciems)
→ gatvė (gali nebūti)
→ pastatas arba užstatyti skirtas žemės vienetas
→ patalpų grupė (telpu grupa, gali nebūti)

Ne visi lygiai eina vienas po kito: savivaldybės miestas gali neturėti valsčiaus, o valstybės miestas pats yra aukščiausias rezultato administracinis lygis. Trūkstami neprivalomi lygiai atsakyme pateikiami kaip null.

Užklausos pavyzdys

https://api.postit.lt/lv/v1/?term=Brīvības+iela+10,+Rīga&limit=10&key=YOUR_API_KEY

Atsakymo parametrai

data rezultatų masyvo laukai

Kiekvienas rezultatas turi tuos pačius laukus; nesami neprivalomi duomenys pateikiami kaip null. Kai coordinates yra null, vidiniai koordinačių laukai nepateikiami.

Atsakymo pavyzdys

{
    "status": "success",
    "success": true,
    "message": "",
    "message_code": 0,
    "total": 1,
    "data": [
        {
            "adr_id": "110000001",
            "building_id": "101000001",
            "object_type": "premise",
            "country_code": "LV",
            "post_code": "LV-1010",
            "address": "Brīvības iela 10",
            "address_full": "Brīvības iela 10-12, Rīga, LV-1010",
            "street": "Brīvības iela",
            "street_full": "Brīvības iela, Rīga",
            "street_id": "100000107",
            "number": "10",
            "flat": "12",
            "city": "Rīga",
            "city_full": "Rīga",
            "locality": null,
            "locality_full": null,
            "locality_type": null,
            "locality_id": null,
            "parish": null,
            "parish_full": null,
            "parish_id": null,
            "municipality": "Rīga",
            "municipality_full": "Rīga",
            "municipality_type": "state_city",
            "municipality_id": "100000104",
            "post_office_code": "100000901",
            "is_planned": false,
            "coordinates": {
                "latitude": 56.95,
                "longitude": 24.11,
                "lks92_x": 311000.5,
                "lks92_y": 507000.25,
                "source_building_id": "101000001"
            }
        }
    ]
}

Klaidų kodai

Duomenų šaltinis

Naudojami Latvijos valstybinės žemės tarnybos (latv. Valsts zemes dienests, VZD) Valstybinio adresų registro (Valsts adrešu reģistrs) atvirieji duomenys, skelbiami pagal CC BY 4.0 licenciją. Oficialus duomenų rinkinys ir VZD duomenų aprašymas.

Nemokamas išbandymas

Gauti nemokamą API raktą pasirinkus v1. Jis taip pat suteikia bandomąją prieigą prie Latvijos API ir leidžia atlikti iki 100 užklausų iš vieno IP adreso arba domeno per dieną.

Pasiekus dienos ribą, grąžinamas toks atsakymas:

{
    "status": "error",
    "success": false,
    "message": "Viršytas dienos užklausų limitas",
    "message_code": 1002,
    "total": 0,
    "data": []
}

Mokami planai

Jei reikia daugiau nei 100 užklausų, tai siūlome API planus:

• 4 €/mėn.* - 1000 užklausų per diena
• 8 €/mėn.* - neribojamas** užklausų kiekis per diena.
  * - apmokant už 12 mėn.
  ** - Atsižvelgiant į serverio technines galimybes užklausų kiekis neturi viršyti 6 užklausų per sekunde.

Jei pasirenkamas vienas iš šių mokamų variantų, tai nuorodos talpinimas nėra būtinas.

Susisiekti nurodytais kontaktais.