Mapa firmy na váš web

Zadarmo: kód na vloženie, plugin pre WordPress, widget a JSON API.

Údaje o 12 063 firmách zo Slovenska a Česka môžete zdarma používať vo svojich projektoch. Bez registrácie a bez API kľúča. Jedinou podmienkou je uviesť zdroj s odkazom: Údaje: supermapa.sk.

1. Mapa firmy na váš web

Vyhľadajte firmu a skopírujte kód do svojho webu. Mapa sa prispôsobí zadanej šírke a výške.

    Mapu môžete vložiť aj pre ľubovoľné miesto (bez firmy z katalógu):

    <iframe src="https://supermapa.sk/mini.php?lat=48.1486&lng=17.1077&zoom=15&nazov=Moja%20firma&adresa=Hlavn%C3%A1%201" width="600" height="400" style="border:0" loading="lazy"></iframe>
    ParameterPopis
    firmaslug firmy z katalógu (prepíše ostatné parametre)
    lat, lngstred mapy
    alat, alngpoloha špendlíka (predvolene stred mapy)
    zoompriblíženie od 3 do 19 (predvolene 15)
    nazov, adresatext v bubline nad špendlíkom

    2. Plugin pre WordPress

    Stiahnuť plugin (ZIP, v1.0.0)

    1. V administrácii WordPressu otvorte Pluginy, kliknite na Pridať nový a potom na Nahrať plugin a vyberte stiahnutý ZIP súbor.
    2. Plugin aktivujte.
    3. Do článku alebo stránky vložte na samostatný riadok odkaz na firmu, napr. https://supermapa.sk/firma/nazov-firmy. WordPress z neho automaticky urobí mapu.

    Alebo použite shortcode (funguje aj v bloku Shortcode, v Elementore a pod.):

    [supermapa firma="nazov-firmy"]
    [supermapa firma="nazov-firmy" sirka="100%" vyska="350"]
    [supermapa lat="48.1486" lng="17.1077" zoom="15" nazov="Moja firma" adresa="Hlavná 1, Bratislava"]

    3. Widget pre ostatné weby

    Pre Wix, Shoptet, Webnode či vlastné HTML stačí vložiť tieto dva riadky na miesto, kde má byť mapa:

    <div data-supermapa-firma="nazov-firmy" data-vyska="400"></div>
    <script src="https://supermapa.sk/widget.js" async></script>

    Pre ľubovoľné miesto použite data-supermapa data-lat="..." data-lng="..." data-nazov="...". Voliteľné sú data-sirka, data-vyska a data-zoom.

    Podporujeme aj štandard oEmbed (https://supermapa.sk/oembed?url=...), takže mapu firmy vedia vložiť aj ďalšie redakčné systémy, ktoré oEmbed podporujú.

    4. JSON API

    Základná adresa: https://supermapa.sk/api/v1/. Všetky odpovede sú vo formáte JSON (UTF-8), povolený je CORS, takže API môžete volať priamo z prehliadača.

    EndpointPopis
    GET /api/v1/hladat?q=...Vyhľadávanie podľa názvu alebo odboru. Voliteľne limit (1 až 50, predvolene 20) a kategoria (slug).
    GET /api/v1/firma/{slug}Detail firmy vrátane popisu a webu.
    GET /api/v1/firma?ico=...Detail firmy podľa IČO.
    GET /api/v1/okolie?lat=...&lon=...Firmy v okolí bodu, zoradené podľa vzdialenosti. Voliteľne r (polomer v km, od 0,1 do 50, predvolene 5), limit a kategoria.
    GET /api/v1/kategorieZoznam odborov s počtom firiem.

    Príklad:

    curl "https://supermapa.sk/api/v1/hladat?q=stavebn%C3%A9&limit=2"
    {
      "data": [
        {
          "name": "...", "slug": "...", "ico": "...", "address": "...",
          "activity": "...", "activity_slug": "...", "lat": 48.14, "lon": 17.10,
          "url": "https://supermapa.sk/firma/...",
          "embed_url": "https://supermapa.sk/mini.php?firma=..."
        }
      ],
      "meta": { "query": "stavebné", "count": 1, "attribution": "Údaje: supermapa.sk (https://supermapa.sk)" }
    }

    5. Pravidlá používania