Dostupné krajiny

Údaje čerpáme z referenčných registrov verejnej správy. Informácie o adresách sú pravideľne aktualizované zo zdrojových registrov.

Údaje aktualizujeme v závislosti od dostupnosti vydania nových datasetov - zvyčajne raz denne.

Približný odhad údajov

Aktuálne poskytujeme adresy a ich metadáta týchto krajín.

Name
SK
Type
Slovenská republika
Description
1 700 000+ adries
Name
CZ
Type
Česká republika
Description
3 000 000+ adries
Name
PL
Type
Poľská republika
Description
11 500 000+ adries
Name
AT
Type
Rakúsko
Description
2 500 000+ adries
Name
CH
Type
Švajčiarsko
Description
1 600 000+ adries
Name
LI
Type
Lichtenštajnsko
Description
13 600+ adries

Definícia modelu číselníka

Atribúty

Name
place_id
Type
string
Description
Unikátny identifikátor miesta.
Name
name
Type
string
Description
Názov v číselníku.
Name
object
Type
string
Description
Typ objektu, môže byť region, county.
Name
formatted_country
Type
string
Description
Názov krajiny.
Name
country
Type
string
Description
Kód krajiny (dvojmiestny alfabetický kód ISO 3166).

Príklad odpovede

[
    {
        "place_id": "sk_Go1acmQpVyAvyPD1oEa__w",
        "name": "Bratislava I",
        "object": "county",
        "formatted_country": "Slovenská republika",
        "country": "SK"
    },
    {
        "place_id": "sk_k7donKVQqPY_baKM5EdfKQ",
        "name": "Bratislava II",
        "object": "county",
        "formatted_country": "Slovenská republika",
        "country": "SK"
    }
]

GET/v1/places/regions

Číselník krajov

Zobrazenie základného zoznamu obsahujúceho kraje konkrétnej krajiny. Zobrazenie číselníka sa nepočíta do mesačného limitu. Číselníky sa zobrazujú vždy celé.

Povinné parametre

Name
country
Type
string · obsahuje kód dostupnej krajiny
Description
Kód krajiny ktorej zoznam krajov sa zobrazí.
Name
api_key
Type
string
Description
Prístupový API kľúč môžete použiť ako parameter api_key alebo v hlavičke požiadavky X-Swiftyper-API-Key.

Výstup

Výstupom je množina údajov reprezentujúca objekt s popísanými atribútmi. V prípade chyby alebo nesprávnosti parametrov sa zobrazí chyba.

Požiadavka

curl -X POST https://api.swiftyper.sk/v1/places/regions \
  -H 'X-Swiftyper-API-Key: 2SN360bLw7lI7KB9Awu5w8oYvCWv17bsA1NAboFNo01Y' \
  -d country=SK

Odpoveď

[
    {
        "place_id": "sk_qlJ5jhetM_G5lt1SjD5auw",
        "name": "Bratislavský kraj",
        "object": "region",
        "country": "SK"
    },
    {
        "place_id": "sk_OsZo7TUYA53C8dspJk1DhQ",
        "name": "Trnavský kraj",
        "object": "region",
        "country": "SK"
    },
    {
        "place_id": "sk_qSHKHJWJevelNSQKcyqJZQ",
        "name": "Nitriansky kraj",
        "object": "region",
        "country": "SK"
    },
    {...},
    {...}
]

GET/v1/places/counties

Číselník okresov

Zobrazenie základného zoznamu obsahujúceho okresy konkrétnej krajiny. Zobrazenie číselníka sa nepočíta do mesačného limitu. Číselníky sa zobrazujú vždy celé.

Povinné parametre

Name
country
Type
string · obsahuje kód dostupnej krajiny
Description
Kód krajiny ktorej číselník okresov sa zobrazí.
Name
api_key
Type
string
Description
Prístupový API kľúč môžete použiť ako parameter api_key alebo v hlavičke požiadavky X-Swiftyper-API-Key.

Výstup

Výstupom je množina údajov reprezentujúca objekt s popísanými atribútmi. V prípade chyby alebo nesprávnosti parametrov sa zobrazí chyba.

Požiadavka

curl -X POST https://api.swiftyper.sk/v1/places/counties \
   -H 'X-Swiftyper-API-Key: 2SN360bLw7lI7KB9Awu5w8oYvCWv17bsA1NAboFNo01Y' \
   -d country=CZ

Odpoveď

[
    {
        "place_id": "cz_yrWVCzCv7HwQpBYQQwTQOw",
        "name": "Hlavní město Praha",
        "object": "county",
        "formatted_country": "Česká republika",
        "country": "CZ"
    },
    {
        "place_id": "cz_25DCP690H_QSJrSkV0C9vA",
        "name": "Benešov",
        "object": "county",
        "formatted_country": "Česká republika",
        "country": "CZ"
    },
    {
        "place_id": "cz_Mur5F_iluktlE89UOUnR2w",
        "name": "Beroun",
        "object": "county",
        "formatted_country": "Česká republika",
        "country": "CZ"
    },
    {...},
    {...}
]

GET/v1/places/municipalities

Zoznam miest a obcí

Zobrazenie základného zoznamu obsahujúceho mestá a obce konkrétnej krajiny. Zobrazenie zoznamu sa nepočíta do mesačného limitu. Zoznam sa zobrazuje vždy celý.

Povinné parametre

Name
country
Type
string · obsahuje kód dostupnej krajiny
Description
Kód krajiny ktorej zoznam miest a obcí sa zobrazí.
Name
api_key
Type
string
Description
Prístupový API kľúč môžete použiť ako parameter api_key alebo v hlavičke požiadavky X-Swiftyper-API-Key.

Výstup

Výstupom je množina údajov reprezentujúca objekt s popísanými atribútmi. V prípade chyby alebo nesprávnosti parametrov sa zobrazí chyba.

Požiadavka

curl -X POST https://api.swiftyper.sk/v1/places/municipalities \
   -H 'X-Swiftyper-API-Key: 2SN360bLw7lI7KB9Awu5w8oYvCWv17bsA1NAboFNo01Y' \
   -d country=CZ

Odpoveď

[
    {
        "place_id": "sk_Mgxp6-WiQ1WVAIeUA8pVHA",
        "highlight": "Javorina",
        "municipality": "Javorina",
        "county": "Kežmarok",
        "region": "Prešovský kraj",
        "object": "municipality",
        "latlng": {
            "lat": 49.13994,
            "lng": 20.5353399
        },
        "formatted_country": "Slovenská republika",
        "country": "SK"
    },
    {
        "place_id": "sk_0gIB-dXD-SdXa8SCHcuGLw",
        "highlight": "Prešov",
        "municipality": "Prešov",
        "county": "Prešov",
        "region": "Prešovský kraj",
        "object": "municipality",
        "latlng": {
            "lat": 49.0018324,
            "lng": 21.2393119
        },
        "formatted_country": "Slovenská republika",
        "country": "SK"
    },
    {...},
    {...}
]