Guide: how to embed mapy.cz on your website in 5 steps

Blog Tips and Advice
26. 05. 2026
Kateřina Mrenová

Do you want to use map features from Mapy.cz on your website? The first step is to obtain an API key that will allow you access to interactive maps, route planning, and geocoding. You don't have to worry about complicated setup – we will assist you with inserting the key and activating the map services so you can focus on your website's content while we ensure the technical side runs smoothly.

Why You Need an API Key for Mapy.cz and How to Obtain It

Mapy.cz as a map service provider has updated its terms of use for the API, which means that to fully utilize maps on your website, you will need your own API key. This change provides you with better map feature displays but requires registration and obtaining the API key.

If you are still using the JS SDK Mapy.cz (a tool for working with maps on websites) to display maps on your site, it is high time to switch to the new REST API. The old map features are now displaying warnings that will gradually increase and will soon start to limit their use. By the end of 2025, they will stop functioning completely.

What Does This Mean for You?

  • You are already seeing warnings on the maps about the upcoming end of support.
  • Starting in early 2025, these warnings will increasingly affect functionality.
  • By the end of 2025, maps in this old system will cease to function entirely – the exact date is still unknown. 

An API key is like a ticket that opens the door to using various online services, such as maps. It helps verify whether you have permission to access and use these features on your website.

To make the entire process easier for you, we have prepared a simple guide on how to obtain an API key and activate the interactive map on your website. This way, you can avoid complicated setups.

Mapy.cz offers a basic plan with free API usage. You will especially appreciate this if you have a small business or a project that is just getting started. If your project grows and attracts more users, you can switch to a paid plan with higher limits for displaying map features.
To ensure fair billing, Mapy.cz uses a credit system that allows you to pay only for the features you actually use. Different operations, such as displaying a map, geocoding, or route planning, have different costs expressed in credits.  Additionally, you will receive up to 10,000,000 credits for free each month – this will cover most of your project's common needs.

Mapy.cz are up to 96× cheaper than Google Maps

When it comes to costs, Mapy.cz is the clear choice – their API is up to 96 times cheaper than Google Maps, while offering similar features and options. With the credit system from Mapy.cz, you only pay for what you actually use.

Example:
Imagine that your project renders 100,000 map tiles per month – this is where the cost difference will be most noticeable.

Mapy.cz: The basic plan covers this volume for free (1 tile = 1 credit).

Google Maps: Such an amount would cost approximately 700–1000 USD per month, depending on the API usage conditions.

Step by step: this is how you get the API key

1. Register or log in to the My Account portal:

  • Visit the My Account portal and log in using your Seznam account. Make sure you use the correct email address. Important notifications will be sent to it, such as monthly closures or information about credit usage.

2. Create a new API project:

  • After logging in, click on the option "Create a new project." Enter the project name and confirm.
  • The first API key will be generated automatically when the project is created.

3. Set API key restrictions:

  • In the "API keys" section, click on "key settings" that you want to modify.
  • Go to the "Key restrictions" section and set restrictions on HTTP referrers – the domains and subdomains where you want to allow the API keys. This ensures that your API key cannot be used on any other website. 
  • Enter the URL of your site, for example, www.mojedomena.cz* with an asterisk at the end to allow all subpages.
  • Examples of URLs: www.mojedomena.cz*, mojedomena.cz*, subdomena.mojedomena.cz* and if you are working in a local environment, we ask you to add in the form localhost:12345*

4. Save changes:

  • Once you set all the necessary parameters, click on "Save."

5. Now it's time for the developer's work:

  • The setup is complete? Great! Now it's time to hand over the work to the developer to integrate the API into the application.

If you are our client, let us know and we will take care of the rest. We will ensure the correct setup, transition to the new API, and further adjustments in the future.