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.
Ukázka:
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>
| Parametr | Popis |
|---|---|
firma | slug firmy z katalogu (přepíše ostatní parametry) |
lat, lng | střed mapy |
alat, alng | poloha špendlíku (výchozí je střed mapy) |
zoom | přiblížení od 3 do 19 (výchozí 15) |
nazov, adresa | text v bublině nad špendlíkem |
2. Plugin pro WordPress
- V administraci WordPressu otevřete Pluginy, klikněte na Instalovat plugin a potom na Nahrát plugin.
- Plugin aktivujte.
- 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.
| Endpoint | Popis |
|---|---|
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/kategorie | Seznam 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í
- Limit: 60 požadavků za minutu z jedné IP adresy. Stav vidíte v hlavičkách
X-RateLimit-LimitaX-RateLimit-Remaining; po překročení API vrátí chybu 429 s hlavičkouRetry-After. - Uvedení zdroje: při zobrazení údajů uveďte „Údaje: supermapa.sk“ s odkazem na supermapa.sk.
- Původ údajů: údaje pocházejí z veřejných rejstříků právnických osob a mohou být neúplné; API je poskytuje bez záruky.
- Chyby vracejí JSON ve tvaru
{"error": {"code": "...", "message": "..."}}s odpovídajícím HTTP kódem (400, 404, 429). Texty chyb jsou ve slovenštině.