Embedding a Map into Your Website

If you need to place an interactive map window on a website, including shared content (personal data displayed on the map), you can do so using the Embed map in your own site function. Open it through the Share tool and the relevant tab and set optional parameters. Then simply insert the generated HTML code into the source code of your page.

What can be shared on the map

Through the so-called iFrame component, you can display all content in the map that you can share, i.e., these include for example:

• Group of points of interest
• Content of a selected folder in My Mapy
• Planned Route
• Manual Measurement
• Custom Points
• Photo on Photomap
• View from the Panorama service
• Result of searching

Settings

When sharing via iFrame, you can set several parameters that then affect the final appearance of the map and its content:

• Size of the resulting shared map (small, medium, large, custom)
• Display of the preview map of CZ/world
  • If you want to help users orient themselves on where your shared place is located in the context of the entire Czech Republic/world, you can turn on the display of the preview map in the shared map. You activate the preview map’s display by switching the “Preview Map” switch in the map preview dialog. You can choose either a preview map of CZ or the world.
  • After selecting the type of preview map, the map will regenerate. The preview map will automatically display in the upper left corner, and the blue point automatically shows the location of the item you shared, for instance, it corresponds to the center of your shared map.
• Display of custom labels on your shared content
  • You can specify a custom label for a custom point or any item you save in My Mapy and where you manually specify a custom label, either immediately when saving, or where you later modify the default name to your preferred one. This way, you can add labels to saved any points of interest, planned routes, custom measurements, etc.
  • The very display of custom labels on the shared map is then activated by the “Labels on map” switch in the sharing dialog with the map preview. You can select the option “None” or “Custom”
  • After selecting the “Custom” option, the preview is regenerated, and custom labels automatically display in the map preview on those shared items where you entered them manually. For other items, the original markers with icons without labels remain displayed.

Click-through on shared items

End users viewing your shared maps can view the details of shared items by clicking through to the Mapy.com website. Therefore, if you share a tip for a trip (e.g., to an interesting castle), clicking on this shared item displays its detail on the Maps, including a text description, address, links, and other information. For a shared route, a detail of the planned route with an itinerary and route profile will be displayed after the click-through. Clicking through works automatically on all shared items, i.e., it is not activated anywhere.

If you want to share a record on the map recorded, for example, by an external device in GPX format, you need to follow these steps:

• Download the file with the route in GPX format
• Import the GPX file into the maps
• The record will appear on the map as so-called manual measurement (note: an imported, i.e., unsaved manual measurement, however, doesn’t have a geometry and thus cannot be shared directly)
• Save the manual measurement in any folder in My Mapy
• Display the folder where you saved the manual measurement in the form of the uploaded route
• Select the item and view the detail of the saved route/manual measurement
• Then proceed as usual with step 3 according to the procedure mentioned above (i.e., select the “Share” button)

For more complex applications based on our map data and functions, you can use our development REST API. More detailed information on its use, practical examples, documentation, and licensing terms can be found here.