Přechod z JS SDK na nové REST API

Používáte na svém webu (již zastaralé) JS SDK api.mapy.cz (viz https://api.mapy.cz/oldindex) a chcete přejít na nové REST API Mapy.cz? Zde je doporučený postup.

V případě problémů či nejasností s přechodem na nové REST API nás kontaktujte, rádi vám poradíme.

Založení Projektu a získání API klíče

V portále Můj účet si založte projekt pro vaši aplikaci.
V rámci projektu založte jeden nebo více API klíčů – vhodný je jeden api klíč pro testování/vývoj, poté samostatné produkční API klíče pro každou z aplikací patřících do tohoto projektu.
Více viz Jak začít s REST API .

Volba vhodné technologie

Nové REST API je pouze datové/funkční rozhraní. Je proto potřeba zvolit k němu vhodnou zobrazovací technologii dle technologických požadavků a preferencí vývojářů.

Zobrazení mapy

V případě základního scénáře zobrazení mapy na webu doporučujeme použít některou z open source Mapových knihoven.
Nejjednodušší je začít zkopírováním kódu některého z našich tutoriálů, například Přepínání mapových vrstev. V tutoriálech je rovnou správně vyřešeno požadované atributování.
Nad mapou je obvykle potřeba vykreslit různá data (ikony, geometrie, vyskakovací okna,…). Zde je již potřeba podívat se do dokumentací a příkladů zvolené knihovny, odkazy najdete zde.

Našeptávání adres

dalším běžným scénářem je našeptávání adres
REST API pro to poskytuje funkce s mnoha možnostmi nastavení
vývojář musí jen zajistit vhodnou implementaci na front endu aplikace
existuje opět spousta hotových komponent, do které se REST funkce snadno napojí
pro inspiraci se můžete podívat na tutoriál našeptávání

Mobilní a desktopové aplikace

původní JS API umožňovalo vývoj pouze pro webové aplikace
nyní můžete data využít v mobilních, desktopových i serverových aplikacích
tak se nenechte omezovat 🙂.

Před nasazením do produkce

Je třeba odhadnout měsíční spotřebu kreditů a podle toho zvolit vhodný obchodní tarif.
Jestliže nahrazujete staré JS SDK API v již běžícím projektu, můžeme vám pomoci s odhadem měsíční spotřeby – napište nám, ze kterých domén API používáte.
Dle odhadnuté spotřeby a zvoleného obchodního tarifu bude pro větší projekty nutné zapnout placenou spotřebu.
V případě spotřeby nad 20 milionů kreditů kontaktujte našeho obchodníka, je možné domluvit individuální ceny v rámci „Tarifu Na míru“.