Vibe coding s REST API Mapy.com

Jak si díky AI může mapovou aplikaci vytvořit úplně každý, není nutná znalost programování.

Moderní AI umí během několika minut vytvořit funkční prototyp mapové aplikace – stačí jí jen popsat, co má udělat, a dodat jí aktuální dokumentaci. K tomu slouží náš otevřený repozitář github.com/mapycom/developer, kde najdete kompletní a vždy aktuální technické informace a příklady v samostatných .md souborech.

Vibe coding funguje jednoduše: místo ručního psaní kódu popíšete aplikaci pomocí promptu a AI (ChatGPT, Gemini, Cursor, GitHub Copilot…) vám vygeneruje funkční kód.

Proč musíte AI dodat dokumentaci

AI modely mají často několik let stará tréninková data. Mapy.com API je naopak nové a průběžně se vyvíjí – proto AI nemůže vycházet z interní znalosti API.

Aby AI generovala správný kód, je nutné jí přiložit aktuální .md soubory z našeho GitHubu.

Repozitář: https://github.com/mapycom/developer

Jak stáhnout dokumentaci

Stažení dokumentace z GitHubu je snadné, nepotřebujete ani přihlášení. Takto stáhnete vybraný soubor dokumentace (bude mít přípomu .md)

Je též možné stáhnout celý repozitář naráz. K promtu je ale lepší přiložy vždy pouze dokumentaci těch funkcí, které potřebujete, např.

• pokud stavíte aplikaci s mapou → přiložte map-tiles.md
• pokud chcete autocomplete adres → přiložte forward-geocoding.md
• pokud plánujete trasy → přiložte routing.md

Přehled všech funkcí najdete zde:
https://github.com/mapycom/developer/blob/master/docs/rest-api/README.md

API projekt a API klíč

Pro volání REST API Mapy.com si potřebujete založit API Projekt a v něm získáte svůj API klíč. To vše je možné zcela zdarma. V rámci Základního tarifu, získáte 250 000 kreditů měsíčně., které můžete využít na testování API. Jak získat API klíč se dočtete v tomto článku.
Dočasný API klíč pak můžete přímo vložit do promtu pro AI.

Konkrétní příklad

Tento prompt můžete použít přímo v ChatGPT, Gemini nebo Cursoru:

Připrav single-page HTML aplikaci, kterou spustím v prohlížeči.
Aplikace obsahuje mapu přes celou stránku a pravý panel se vstupy Start, Cíl a způsob plánování.
Uživatel může zadat adresy – při psaní použij forward geocoding s autocomplete.
Start i cíl může uživatel vybrat také kliknutím do mapy (vybírám start nebo cíl podle toho, ve kterém poli mám focus).
Po zadání obou bodů vypočítej trasu pomocí Routing API a vykresli ji na mapu. Také vypiš její délku a čas.
Přidej přepínač mapových vrstev: základní, turistická a zimní.
Řiď se přiloženými .md soubory dokumentace a jako API klíč použij „{zde vložte svůj API klíč}“.

K tomuto konkrétnímu promptu je potřeba přiložit následující soubory s dokumentaci:

• map-tiles.md – práce s mapovými podklady
• forward-geocoding.md – autocomplete a vyhledávání adres
• routing.md – plánování tras

A nechte AI pracovat. Výsledný kód (html + javascript) pak zkopírujte a uložte do souboru index.html. Ten pak stačí otevřít v prohlížeči a měla by se objevit aplikace podobná této (každý AI model si se zadáním poradí trochu jinak).

Vyzkoušejte vibe coding ještě dnes

Vytvořit první mapovou aplikaci s Mapy.com API nebylo nikdy jednodušší:

• Stáhněte dokumentaci z GitHubu
• Získejte API klíč na developer.mapy.com
• Vložte svůj prompt do AI a během pár minut máte funkční prototyp

Ať už jste vývojář, designer nebo úplný začátečník – vibe coding vám umožní vytvořit mapovou aplikaci rychle, intuitivně a přesně podle vašich představ.