Návod: jak v 5 krocích vložit mapy.cz na web

Blog Rady a tipy
29. 11. 2024
Kateřina Mrenová

Chcete na svém webu využívat mapové funkce od Mapy.cz? Prvním krokem je získání API klíče, který vám umožní přístup k interaktivním mapám, plánování tras a geokódování. Nemusíte se bát složitého nastavení – pomůžeme vám s vložením klíče i s aktivací mapových služeb, abyste se mohli soustředit na obsah svého webu, zatímco my zajistíme hladký chod technické stránky.

Proč potřebujete API klíč pro Mapy.cz a jak ho získáte

Mapy.cz jako poskytovatel mapových služeb aktualizovaly své podmínky pro používání API, což znamená, že pro plnohodnotné využití map na vašem webu budete potřebovat vlastní API klíč. Tato změna vám přináší lepší zobrazení mapových funkcí, ovšem vyžaduje registraci a získání právě API klíče.

Pokud stále používáte JS SDK Mapy.cz (nástroj pro práci s mapami na webových stránkách) k zobrazování map na vašem webu, je nejvyšší čas přejít na nové REST API. Staré mapové funkce už vám teď zobrazují upozornění, která se budou postupně zvětšovat a brzy začnou omezovat jejich použití. Na konci roku 2025 přestanou fungovat úplně.

Co to pro vás znamená?

  • Na mapách vám už teď vyskakuje upozornění na blížící se konec podpory.
  • Od začátku roku 2025 budou tato upozornění více zasahovat do funkčnosti.
  • Na konci roku 2025 už mapy v tomto starém systému přestanou fungovat úplně – přesný termín ještě neznáme. 

API klíč je něco jako vstupenka, která vám otevře dveře k používání různých internetových služeb, třeba map. Pomáhá ověřit, zda máte povolení k přístupu a používání těchto funkcí na vašem webu.

Abychom vám celý proces usnadnili, připravili jsme jednoduchý návod, jak získáte API klíč a aktivujete interaktivní mapu na vašich stránkách. Vyhnete se tak složitému nastavování.

Mapy.cz nabízí základní tarif s bezplatným využitím API. To oceníte obzvlášť, pokud máte menší firmu nebo projekt, který se teprve rozjíždí. Jestliže váš projekt roste a přitahuje více uživatelů, můžete přejít na placený tarif s vyššími limity pro zobrazování mapových funkcí.
Aby Mapy.cz zajistily férové účtování, používá systém kreditů, který vám umožňuje platit jen za funkce, které skutečně využíváte. Různé operace, jako například zobrazení mapy, geokódování nebo plánování tras, mají různé náklady vyjádřené v kreditech.  Každý měsíc navíc získáte zdarma až 10 000 000 kreditů – to pokryje většinu běžných potřeb vašeho projektu.

Mapy.cz jsou až 96× levnější než Google Maps

Když přijde na náklady, Mapy.cz jsou jasnou volbou – jejich API vychází až 96krát levněji než Google Maps, a to při podobných funkcích a možnostech. Díky systému kreditů od Mapy.cz platíte jen za to, co skutečně využijete.

Příklad:
Představte si, že váš projekt vykreslí 100 000 mapových dlaždic za měsíc – právě tady se rozdíl v nákladech projeví nejvíce.

Mapy.cz: Základní tarif pokryje tento objem zdarma (1 dlaždice = 1 kredit).

Google Maps: Takové množství by stálo přibližně 700–1000 USD měsíčně, v závislosti na podmínkách využití API.

Krok za krokem: takhle API klíč získáte

1. Zaregistrujte se nebo přihlaste se do portálu Můj účet:

  • Navštivte portál Můj účet a přihlaste se pomocí svého Seznam účtu. Ujistěte se, že používáte správnou e-mailovou adresu. Budou vám na ní chodit důležité notifikace, například měsíční uzávěrky nebo informace o čerpání kreditů.

2. Vytvořte nový API projekt:

  • Po přihlášení klikněte na možnost „Vytvořit nový projekt.“ Zadejte název projektu a potvrďte.
  • První API klíč se vám vygeneruje automaticky při vytvoření projektu.

3. Nastavte omezení API klíče:

  • V sekci „API klíče“ klikněte na „nastavení klíče“, které chcete upravit.
  • Přejděte do sekce „Omezení klíče“ a nastavte omezení na HTTP referery – domény a subdomény, na kterých chcete API klíče povolit. Díky tomu váš API klíč nepoužije nikdo na jiném webu. 
  • Zadejte URL vašich stránek, například www.mojedomena.cz* s hvězdičkou na konci pro povolení všech podstránek.
  • Příklady URL: www.mojedomena.cz*, mojedomena.cz*, subdomena.mojedomena.cz* a v případě práce na lokálním prostředí vás požádáme o přidání ve tvaru localhost:12345*

4. Uložte změny:

  • Jakmile nastavíte všechny potřebné parametry, klikněte na „Uložit.“

5. Teď přichází na řadu práce vývojáře:

  • Nastavení je hotové? Skvělé! Teď je na čase předat práci vývojáři, aby API integroval do aplikace.

Pokud jste naším klientem, dejte nám vědět a my se postaráme o zbytek. Zajistíme vám správné nastavení, přechod na nové API a další úpravy do budoucna.