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.
Ukážka:
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>
| Parameter | Popis |
|---|---|
firma | slug firmy z katalógu (prepíše ostatné parametre) |
lat, lng | stred mapy |
alat, alng | poloha špendlíka (predvolene stred mapy) |
zoom | priblíženie od 3 do 19 (predvolene 15) |
nazov, adresa | text v bubline nad špendlíkom |
2. Plugin pre WordPress
- V administrácii WordPressu otvorte Pluginy, kliknite na Pridať nový a potom na Nahrať plugin a vyberte stiahnutý ZIP súbor.
- Plugin aktivujte.
- 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.
| Endpoint | Popis |
|---|---|
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/kategorie | Zoznam 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
- Limit: 60 požiadaviek za minútu z jednej IP adresy. Stav vidíte v hlavičkách
X-RateLimit-LimitaX-RateLimit-Remaining; po prekročení API vráti chybu 429 s hlavičkouRetry-After. - Uvedenie zdroja: pri zobrazení údajov uveďte „Údaje: supermapa.sk“ s odkazom na supermapa.sk.
- Pôvod údajov: údaje pochádzajú z verejných registrov právnických osôb a môžu byť neúplné; API ich poskytuje bez záruky.
- Chyby vracajú JSON v tvare
{"error": {"code": "...", "message": "..."}}so zodpovedajúcim HTTP kódom (400, 404, 429).