With the Mapme editor, you can add media to the locations on your map. However, if you want to add media to many locations, it can be time-consuming. Therefore, the CSV media import provides a solution to add media very efficiently. For each location, you can import one, or multiple media.
Media types
The media import is very flexible and can be used to add all the media types Mapme supports.
- Images
- Streaming videos (YouTube and Vimeo)
- Video uploads
- PDF’s
- Embeds like Matterport tours
To upload media files such as images, videos, and PDFs, they must be hosted on a publicly accessible server over HTTPS.
You can upload up to 1,000 images and 10 videos at a time.
There are no limits for streaming imports or embedded content.
How to import media to your map?
Our Google Sheet template lets you easily import media. You select the type of media and other import options, and the sheets will automatically generate the media import string.
The media import uses the syntax below:
- The “media” field in the Mapme CSV file is used to set the media import.
- “|” separates between media items.
- “;” separates media item settings
- “\” separates the segment’s key and value
The following table describes the settings available for all the media types (image, video, pdf, embed). The limitations for URL lengths, file types, and file size are the same as when adding media through the editor.
| Media type | Settings | Description |
|---|---|---|
| Images | media type indicator | image |
| url | Image URL | |
| caption | Image caption | |
| creditText | Image credit text | |
| creditUrl | Image credit URL | |
| fitMode | Image fit mode Set to “cover” for crop to fit space (default) Set to “contain” for full image |
|
| Videos | media type indicator | video |
| url | YouTube or Vimeo or any Video URL | |
| coverImageUrl | Video cover image URL | |
| PDFs | media type indicator | |
| url | PDF URL | |
| Embeds | media type indicator | embed |
| url | Embed URL | |
| title | Embed title | |
| coverImageUrl | Cover image URL |
Examples
Import an image
image;url\https://dummyimage.com/640×360/f00/fff.jpgImport an image with a caption and image fit mode set to cover
image;url\https://dummyimage.com/640×360/f00/fff.jpg;caption\Red placeholder;fitMode\cover
Import a YouTube video
video;url\https://www.youtube.com/watch?v=yP2w5kPZaEgImport 2 Embeds (Matterport tours)
embed;url\https://my.matterport.com/show/?m=sP1Dd8Saghb&title\Fascinating Matterport model of a cathedral|embed;url\https://my.matterport.com/show/?m=ZWCXcPzmXLA&title\An amazing tourImport different media types
image;url\https://dummyimage.com/640×360/f00/fff.jpg;fitMode\contain|video;url\http://static-resources-stg.mapme.com/media-import-test/video.mp4;coverImageUrl\https://dummyimage.com/640×360/f00/fff|pdf;url\https://static-resources-stg.mapme.com/media-import-test/mapme.pdfHow to delete media from your map?
You can use the CSV import file to automatically delete media from your map. Simply add the character “|” in the media field in the locations where you would like to delete all media files. Keep in mind that once a media file has been deleted, it cannot be recovered.