Mapa firmy na váš web

Zdarma: kód pro vložení, plugin pro WordPress, widget a JSON API.

Údaje o 12 063 firmách ze Slovenska a Česka můžete zdarma používat ve svých projektech. Bez registrace a bez API klíče. Jedinou podmínkou je uvést zdroj s odkazem: Údaje: supermapa.sk.

1. Mapa firmy na váš web

Vyhledejte firmu a zkopírujte kód na svůj web. Mapa se přizpůsobí zadané šířce a výšce.

    Mapu můžete vložit i pro libovolné místo (bez firmy z katalogu):

    <iframe src="https://supermapa.sk/mini.php?lat=50.0755&lng=14.4378&zoom=15&nazov=Moje%20firma&adresa=Hlavn%C3%AD%201" width="600" height="400" style="border:0" loading="lazy"></iframe>
    ParametrPopis
    firmaslug firmy z katalogu (přepíše ostatní parametry)
    lat, lngstřed mapy
    alat, alngpoloha špendlíku (výchozí je střed mapy)
    zoompřiblížení od 3 do 19 (výchozí 15)
    nazov, adresatext v bublině nad špendlíkem

    2. Plugin pro WordPress

    Stáhnout plugin (ZIP, v1.0.0)

    1. V administraci WordPressu otevřete Pluginy, klikněte na Instalovat plugin a potom na Nahrát plugin.
    2. Plugin aktivujte.
    3. Do článku nebo stránky vložte na samostatný řádek odkaz na firmu, například https://supermapa.sk/firma/nazev-firmy. WordPress z něj automaticky udělá mapu.

    Nebo použijte shortcode (funguje i v bloku Shortcode, v Elementoru a podobně):

    [supermapa firma="nazev-firmy"]
    [supermapa firma="nazev-firmy" sirka="100%" vyska="350"]
    [supermapa lat="50.0755" lng="14.4378" zoom="15" nazov="Moje firma" adresa="Hlavní 1, Praha"]

    3. Widget pro ostatní weby

    Pro Wix, Shoptet, Webnode nebo vlastní HTML stačí vložit tyto dva řádky na místo, kde má být mapa:

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

    Pro libovolné místo použijte data-supermapa data-lat="..." data-lng="..." data-nazov="...". Volitelné jsou data-sirka, data-vyska a data-zoom.

    Podporujeme také standard oEmbed (https://supermapa.sk/oembed?url=...), takže mapu firmy umí vložit i další redakční systémy s podporou oEmbed.

    4. JSON API

    Základní adresa: https://supermapa.sk/api/v1/. Všechny odpovědi jsou ve formátu JSON (UTF-8) a povolený je CORS, takže API můžete volat přímo z prohlížeče.

    EndpointPopis
    GET /api/v1/hladat?q=...Vyhledávání podle názvu nebo oboru. Volitelně limit (1 až 50, výchozí 20) a kategoria (slug).
    GET /api/v1/firma/{slug}Detail firmy včetně popisu a webu.
    GET /api/v1/firma?ico=...Detail firmy podle IČO.
    GET /api/v1/okolie?lat=...&lon=...Firmy v okolí bodu seřazené podle vzdálenosti. Volitelně r (poloměr v km, od 0,1 do 50, výchozí 5), limit a kategoria.
    GET /api/v1/kategorieSeznam oborů s počtem firem.

    Příklad:

    curl "https://supermapa.sk/api/v1/hladat?q=stavebn%C3%AD&limit=2"
    {
      "data": [
        {
          "name": "...", "slug": "...", "ico": "...", "address": "...",
          "activity": "...", "activity_slug": "...", "lat": 50.07, "lon": 14.43,
          "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. Pravidla používání