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“.