User interface description
Main interface
Main menu interface
Using markers, lines and polygons
Creating markers
Creating lines
Creating polygons
Editing markers, lines and polygons
Deleting markers, lines and polygons
Using the organizer
Using map folders
Create a folder
Edit a folder
Marker templates: custom fields
Mass assign color and custom fields
Presets, templates and bulk icons with folders
Cloud and collaborating
How to sync a local map folder on the cloud
How to create a new map folder on the cloud
How to share your map cloud folder with collaborators on the cloud
How to open an existing map file from the cloud?
How to restore a previous version from history?
Importing and exporting markers
How to export/share your markers?
How to import your markers from a KML, KMZ or CSV file?
Migrating your data to a new device
Advanced features
Configuring third party search sources
How to use offline maps?
How can I import my starred locations from Google Maps (locations marked with a star on Google Maps)?
How can I extract POI images from Map Marker?
FAQ
What is the premium upgrade?
I want to try early features, how can I use the beta?
How can I help with translations?
I have a feature idea, how should I submit the idea?
How can I stay tuned about what’s coming soon for Map Marker?
Why is Map Marker not a navigation app?
How do I add locations on Google Maps?
A place in Google Maps has wrong/inaccurate data, how do I fix it?
How to install the old map marker app
Where can I find the help center for Map Marker V2?
Troubleshooting and known problems
Collecting a log file
Problems importing CSV files
Cloud sync error: 404 file not found
GPS location inaccurate
Problems with Google My Maps
Premium troubleshooting
Problems with Google Play Services
Problems with map display: blank map
Problems with blocked internet access
App launch error: "DatabaseException Row too big..."
KMZ archive size limitations

User interface description

Main interface

In the screenshot below, from left to right and from top to bottom, we have:

• The action bar at the top left, composed of:
• The "menu" button, opening the main menu
• The "jump" button, opening the browse view
• The "organize" button, opening the organizer view
• The "search" button, opening the search view
• The "export" button, opening the export menu
• The "my location" button at the top right
• The "add" button at the bottom right, above the POI info window
• The POI info window at the bottom, displaying the selected POI details, with 4 buttons:
• Marker edit button (top left): opens the marker details for editing
• Copy to clipboard button (top right): copies the marker details to the clipboard
• Navigation button (bottom left): opens the marker's location into another navigation app
• More button (bottom right): presents a list of possible actions on the marker (call phone, text phone, delete, etc.)

Main menu interface

Clicking the menu button will open the main menu. The main menu has the following elements (from top to bottom):

• Map file header
• Map type button
• Folders
• Add folder button
• Settings button
• About button
• Premium-related elements

Using markers, lines and polygons

Creating markers

To create a new marker, click on the add button from the main map interface, then move the map around to place the target where you want to place the marker. When the target is at the desired location, click “OK” to place the marker.

Creating lines

To create a new line, click on the add button from the main map interface and then click the line button on the left. Place new points with the “+” button, move from one point to another with the arrow buttons and click the save button when you’re done.

Creating polygons

To create a new polygon, click on the add button from the main map interface and then click the polygon button on the left. Place new points with the “+” button, move from one point to another with the arrow buttons and click the save button when you’re done.

Editing markers, lines and polygons

To edit a marker, a line or a polygon, start by selecting it (by clicking on it for example) and hit the edit button of the info window showing up. This will open the marker edit page. From there you will be able to edit all the attributes of the marker. Note: if you’re editing a line or polygon, you will have the option to edit the points of the line or polygons from this page by clicking the “edit” button in the “Coordinates” section.

Deleting markers, lines and polygons

To delete a POI:

• select the POI (by clicking it for example)
• click the "more" button in the info window
• select the "delete" option
• confirm the deletion

To delete multiple markers at once, you can use the organizer (see the "organizer" section from this help page)

Using the organizer

You can open the organizer by clicking the organize button from the top bar of the main page.
The organizer will allow you to perform actions on multiple markers at once, or on multiple folders at once.

At the top of the screenshot below, the visible buttons are:

• Select all button: select all the elements in the list
• Organize POIs / Organize Folders switch button: switch between organising POIs or Folders

When organizing POIs, with at least one POI selected, the following buttons will become visible:

• Move to folder button: move the selected POIs to another folder
• Copy to folder button: move the selected POIs to another folder
• Delete button: delete the selected POIs

When organizing Folders, with at least one Folder selected, the following buttons will become visible:

• Move to folder button: move the selected Folders to another folder
• Copy to folder button: move the selected Folders to another folder
• Delete button: delete the selected Folders

Using map folders

You can use map folders to organize your markers into different sections. Things you can do with folders:

• create a folder
• ‎edit a folder
• ‎marker templates: custom fields
• ‎mass assign color
• ‎mass assign custom fields

Create a folder

To create a folder:

1. open the sidebar
2. ‎click "Add folder"
3. ‎enter the desired folder information
4. ‎click ok to save the new folder

Edit a folder

To edit a folder:

1. open the sidebar
2. ‎long press on the folder you wish to edit
3. ‎modify the folder to your liking
4. ‎click ok to save the changes

Marker templates: custom fields

While creating or editing a folder, you can define custom fields into the folder. Those folder custom fields will act as a template: when creating a new marker with only one folder selected, if that folder has custom fields then the folder's custom fields will automatically be added to the newly created marker.

To create a folder's custom fields from the folder create/edit page:

1. click "more options"
2. ‎select "add custom field"
3. ‎edit the custom field to your liking and save it

To edit a folder's custom fields from the folder create/edit page:

1. click on the custom field from the custom fields list
2. ‎edit the custom field to your liking and save it

Mass assign color and custom fields

When changing a folder’s color or custom fields, a prompt will offer you to mass-assign the color or custom fields to the markers inside that folder.

Presets, templates and bulk icons with folders

If you want markers to be automatically created with a specific combination of icon, color and custom fields you can achieve this through folders. Folders will act as templates for their children markers. To do this:

1. Create a folder
2. Choose the icon, color and custom fields that you would like to see by default for new markers
3. Save the folder
4. Double click on the folder from the main menu to select only that folder
5. And any new marker that you create will inherit its parent folder’s attributes

Cloud and collaborating

How to sync a local map folder on the cloud

If your map file is local and has not been synced on the cloud yet, follow those steps:

1. Open the main menu
2. Click on the map file to open the file options menu
3. Select the "cloud sync" option
4. Select the cloud provider to sync to
5. Authenticate to your account if prompted to

How to create a new map folder on the cloud

1. Open the left drawer by clicking the left button of the main action bar
2. Click on the map file to open the file options menu
3. Select the "create map file" option
4. Select "create cloud map"
5. In the "map's name" prompt, enter the new cloud map name and click OK
6. Select the cloud provider to sync to
7. Authenticate to your account if prompted to

How to share your map cloud folder with collaborators on the cloud

1. Open the left drawer by clicking the left button of the main action bar
2. Click on the map file to open the file options menu
3. Select "share cloud map"
4. This should open the cloud map folder outside the app
5. Open the cloud folder details, and grant the access to your collaborators
6. Your collaborators should have access to the cloud map

How to open an existing map file from the cloud?

1. Open the left drawer by clicking the left button of the main action bar
2. Select the "open cloud map" option
3. Select the cloud map you want to open

How to restore a previous version from history?

1. Open the left drawer by clicking the left button of the main action bar
2. click on the map file to open the file options menu
3. select the "advanced" option
4. select the "view history/restore" option
5. select the version to restore from the list

Importing and exporting markers

How to export/share your markers?

1. Click the "share" button of the main action bar (last button)
2. Select "All markers and folders"
3. Select the format of export
4. Wait for the export to complete
5. Choose whether you want to save the file or share it

How to import your markers from a KML, KMZ or CSV file?

1. Open the left drawer by clicking the left button of the main action bar
2. Click on the map file at the top to open the file options menu
3. Select "Import markers"
4. Select the file to import
5. If the format was not auto-detected, select the import format
6. Wait for the import to complete

Migrating your data to a new device

If you lost your device or did a factory reset or simply got a new device, you might need to migrate your previous markers data to this new device. Depending on your case, there are several ways to do this...

Case 1: You were using the premium cloud sync on your previous device

⇒ Simply open the existing cloud map by following the instructions in this section: How to open an existing map file from the cloud?

Case 2: You were not using the cloud sync, but you saved your markers into a file with the export feature

⇒ To import your markers into the new device, follow the instructions in this section: Importing and exporting markers

Case 3: You created no backup but you still have access to the previous device's data

⇒ You will need to export the markers data from your previous device, and then import your markers data into your new device. For more information on how to export and import data, see the following section: Importing and exporting markers

Case 4: You created no backup and you do not have access to your previous device's data

⇒ If your previous device had Android 6 or up installed, it might have backed up some app data automatically through Google Drive, depending on your settings at the time. Upon installing the app on your new device, the data might be restored automatically. If that's not the case, there is no other way to retrieve the data to my knowledge :'(

Advanced features

Configuring third party search sources

You can add or configure third party search sources in Map Marker from the "Places search sources" section menu.

Once you have obtained a third party search source configuration, you can re-use this same configuration on any device running Map Marker.

To use a configuration, from the search source menu in Map Marker:

1. Click "Add or configure search source"
2. Click on the search source that you want to add/configure
3. Enter/paste the requested configuration values
4. Check the displayed result (success/failure)

Below are the different third party sources that can be configured with instructions on how to obtain the configuration values, by increasing order of difficulty. Microsoft Bing Places Search seems like the best option because it's easy to setup and the search result quality is pretty good.

Bing Places Search API (very easy)

Notes:

• You will need to use or create a free microsoft account to retrieve the configuration values
• There is no need for a credit card
• The free quota is plenty for a single user
• The configuration value you will need to obtain is a Bing Places API Key

Steps:

1. Follow the instructions here: https://docs.microsoft.com/en-us/bingmaps/getting-started/bing-maps-dev-center-help/getting-a-bing-maps-key
2. Use the following key type: "Bing Maps Keys for Business and Personal Use"
3. Use the following application type: "Website"
4. You can then create/retrieve the key from here: https://www.bingmapsportal.com/Application under "My Account" > "My Keys"

"Here" Places Search API (easy)

Notes:

• You will need to use or create a free HERE account to retrieve the configuration values
• There is no need for a credit card
• The free quota is plenty for a single user
• The configuration values you will need to obtain are App ID and App Code

Steps:

1. Create an account here: https://developer.here.com/authenticationpage
2. Open the projects page here: https://platform.here.com/management/projects
3. A project "Starter Project" should already have been created automatically for you
4. Click that "Starter Project" to open it
5. Navigate to the "Access and permissions" tab
6. Click on the "Grant access" button
7. Under "New app", click "Create"
8. Enter a random app name (e.g. "My app") and hit the "register" button
9. This should take you to the newly created app's page (otherwise you can find the app again by viewing the apps list here: https://platform.here.com/admin/apps
10. Under the app's page, under "Credentials", navigate to "API Keys"
11. Click the "Create API key" button
12. The API key should now appear at the bottom of the screen
13. Use the "Copy" button next to the API key to copy it to the clipboard
14. Paste the API key into Map Marker

"Google" Places Search API (very hard)

Notes:

• !!!FOR ADVANCED USERS ONLY!!!
• You will need to use or create a free Google account to retrieve the configuration values
• The free quota should be enough for a single user
• The configuration value you will need to obtain is the API key
• To get a functional API key, you will need to give your credit card information to Google
• Google may charge you on the API usage
• There are ways to limit the usage to only the free quota, to avoid being charged, but they depend on your configuration
• It is impossible to use the free quota without providing a credit card
• It is impossible to guarantee no expenses due to an accidental bad configuration
• I will not provide support for this, you will have to interact with Google directly: https://developers.google.com/places/web-service/support

Steps:

1. Get an API key here: https://developers.google.com/places/web-service/get-api-key
2. Enable billing for your google cloud console account
3. Set a limit on your Places API usage
4. Save the API key in a way that you can paste it into Map Marker

How to use offline maps?

1. Download map files manually from here: https://ftp-stud.hs-esslingen.de/pub/Mirrors/download.mapsforge.org/maps/v5/
2. Once you have downloaded the map files, put them in a specific folder
3. Open Map Marker
4. Open the side drawer
5. Click settings
6. Scroll down to the "Offline maps" section
7. Click the "Offline maps" row displaying the offline map files count
8. Click "Add offline map file"
9. Select the offline map file to import it into the app
10. Go back to the main view, and switch the map type to "Offline (Mapsforge BETA)"

How can I import my starred locations from Google Maps (locations marked with a star on Google Maps)?

1. Open the Google Takout page here: https://takeout.google.com/settings/takeout
2. Click "Select None" to uncheck everything
3. Scroll down and toggle "Maps (your places)"
4. Scroll to the bottom
5. Click "Next"
6. Select a convenient way for you get the files and click "Create archive"
7. Click "Download" to download the created archive
8. Unzip the archive file and retrieve the file named "Saved Places.json"
9. Convert the file to KMZ with this page: https://mygeodata.cloud/converter/
10. Import the resulting KMZ file into Map Marker

Important note: This only works for starred locations, not other lists. Unfortunately, at the moment, it seems Google does not provide a way to export those.

How can I extract POI images from Map Marker?

If you want to extract POI images from Map Marker, there are several ways you can go about this.

Image extraction - Method 1: the KMZ export

1. Find out how to change a file extension on your system (Linux / Windows / MacOS / etc.): if you don't know how to do this, search for "How to change a file extention in Linux/Windows/MacOS/WhatEverYourSystemIs" in your favorite search engine
2. Export your map as a KMZ file
3. Change the KMZ file extension from .kmz to .zip
4. Extract the zip file with a zip files manager
5. Image files will be in the extracted "local_media" and "cloud_media" folders, without extensions
6. Depending on your system, for the system to detect and open these files as images, you might have to change the extension of image files as well to ".jpg" or ".jpg"

Image extraction - Method 2: the premium cloud sync (paid)

1. Sync your map file to the cloud with the premium cloud sync
2. Open the map file menu by clicking at the top of the left drawer menu
3. Click "Share cloud map" to open the Google Drive folder of the cloud map
4. Filter the view to only see image files, they should all be there

Image extraction - Method 3: the image share feature

When viewing an image from the app, you can share it externally by clicking the "share" button at the top right. However you can only extract images one by one that way.

1. Open the image from within the app
2. Click the share button at the top right

FAQ

What is the premium upgrade?

The Map Marker lifetime premium upgrade for the Android app grants you lifetime access to the Map Marker premium on an unlimited number of Android devices.
The premium grants you access to:

• Cloud sync with Google Drive or Dropbox
• Cloud map collaboration with other premium users
• Map versions history with restore ability

I want to try early features, how can I use the beta?

If you're impatient to test new upcoming features and you are not afraid to encounter bugs in the app, you can join the beta.
Note that it is HIGHLY RECOMMENDED that you know how to save/restore your markers via the manual export/import or the cloud sync BEFORE joining the beta.
Also note that if I'm not working on any special feature, the beta might not have anything different from the production app.
With all that being noted, you can join the beta here:

https://play.google.com/apps/testing/com.exlyo.mapmarker

How can I help with translations?

Follow the instructions on the github page for translations: https://github.com/androidseb/mapmarkerapptranslations

I have a feature idea, how should I submit the idea?

First you should take a look at the Map Marker roadmap to see if the idea is not already there:

https://mapmarker.app/wip.html

Then if the idea is not already submitted, you can send me an email and I’ll check it out :-)

How can I stay tuned about what’s coming soon for Map Marker?

If you want to know what’s coming next you can check this page:

https://mapmarker.app/wip.html

If you want to be notified when new features come out, follow me on twitter:

https://twitter.com/mapmarkerapp

Why is Map Marker not a navigation app?

Navigation apps are complex and hard to get right, and there are already a lot of good navigation apps out there. I believe that as a single developer, the way I can provide most value with Map Marker is by focusing on the ability to organize your places, and have an easy way to start navigation into navigation-focused apps. Map Marker’s focus is different from navigation.

How do I add locations on Google Maps?

Map Marker does not provide such features. Instead, try using one of those links:

• https://www.google.ca/mybusiness
• https://play.google.com/store/apps/details?id=com.google.android.apps.vega

A place in Google Maps has wrong/inaccurate data, how do I fix it?

Map Marker does not interact with Google Maps data, instead, try using the Google platform:

• go on Google Maps from a desktop computer:
• click the location that needs fixing
• click "suggest an edit"

How to install the old map marker app

If you need to switch back to the old Map Marker V2, you can install it from the APK file available here: https://github.com/androidseb/mapmarker/releases/tag/map_marker_v2.
Note: if you updated from Map Marker V2 to Map Marker V3 without uninstalling the app, re-installing the app like this over Map Marker V3 will switch you back to the old Map Marker V2 without losing your user data. However any data created from the V3 app will not be accessible from the newly installed V2 app.

Where can I find the help center for Map Marker V2?

If you are using the legacy Map Marker V2 app version, you can find the help center archive here.

Troubleshooting and known problems

Collecting a log file

When facing a particular problem with the app that requires an investigation, it can help to provide an error log file in some cases.
To collect an error log file, follow these steps:

1. First, activate the log file:
1. Open the left drawer by clicking the left button of the main action bar
2. Click "About"
3. Click "Troubleshooting"
4. Click "Enable log file"
5. Exit the app completely (e.g. swipe it off your recent apps)
6. Start the app again
2. Then, run through the flow producing your problem so that app logs capture it
3. Then, export the log file:
1. Open the left drawer by clicking the left button of the main action bar
2. Click "About"
3. Click "Troubleshooting"
4. Click "Export log file"
5. Send the exported log file, for example by email
4. Lastly, deactivate the log file, to avoid slowing down the app:
1. Open the left drawer by clicking the left button of the main action bar
2. Click "About"
3. Click "Troubleshooting"
4. Click "Disable log file"

Problems importing CSV files

Importing CSV files will only reliably work if all of these conditions are met:

• the file content has columns labeled "Latitude" and "Longitude"
• the file contains actual CSV: "Commas Separated Values" using the comma character ",".
• the file is using UTF-8 encoding

Files exported from Map Marker will meet the above conditions; to see an example of how the file should look like, you can export a CSV file from Map Marker and send it to yourself.

If you edit the CSV file from another software (e.g. Excel), keep in mind that the software might save the file using other delimiter characters than "," or using another encoding than UTF-8 depending on your system preferences and regional settings, so make sure you select the correct encoding (UTF-8) and the correct delimiter character (",") when saving the CSV file from another software, or importing your CSV into Map Marker might not work as expected.

Cloud sync error: 404 file not found

When performing cloud sync, this error can occur if some remote cloud files have been deleted.
This can happen if you (or one of your collaborators if you're sharing access) have deleted the cloud files from your cloud storage account.
When this error happens, you can no longer sync to the cloud map and it also probably means that the only copy of your data is on your device, since the cloud data is gone.
The recommended way to proceed in case you encounter this error is the following:

1. Export your markers as a KMZ file
2. To minimize the risks of losing the data, create a copy of that exported file somewhere like a secondary device, or a cloud storage account
3. By default, Map Marker creates a dedicated folder in your cloud storage account called "Map Marker Places Organizer": identify the source of the cloud data deletion so that it doesn't happen again, for example, if one of your collaborators deleted some file accidentally (e.g. "accidental cleanup"), explain them why not deleting these files is important
4. Create a new cloud map
5. Import the data from the KMZ file
6. Sync your cloud map

GPS location inaccurate

On some Android devices, it can happen that the GPS location becomes inaccurate over time. In some cases, it's even possible to see a correct accurate location in one app and a completely inaccurate location in another app. This is due to the way location tracking works at the system level and can sometimes be resolved by restarting your device. Note that only restarting your device can be insufficient, as some components like the GPS chip might not have been fully powered off in the process. The following steps can often work to resolve the issue:

1. Power off your device completely
2. Wait for 10 seconds
3. Power your device back on

Problems with Google My Maps

Google My Maps cannot import the KML/KMZ files produced by Map Marker if they contain the default folder, because it cannot handle an empty folder name. To work around this, you will need to import only one folder at a time, that is not the default folder.

Premium troubleshooting

When you purchase the premium, it becomes available for life for your Google account. The Google account granted with the premium access is the one used to perform the purchase. Upon purchasing the premium, you will receive a confirmation email with an order number. From then on, you can use the premium on as many devices as you want. However you will need to use the exact same Google account to perform the installation of Map Marker on your other device.

If you cannot use the premium:

1. Backup your markers outside of the app
2. Un-install the app
3. ‎Open the Google play app
4. Make sure you are signed in with your Google account owning the premium in the left drawer of the Google Play app
5. Download and install Map Marker again

If these steps don't work you can send me your order number for confirmation and I will help you. You can find your order number from the email you received when making the purchase, or from https://payments.google.com/ under the "Activity" tab.

Problems with Google Play Services

Some problems with the Google Play Services app can cause various issues with Google-related services.
Sometimes, you can fix this by clearing the Google Play Services app data:

1. Open the system settings
2. Applications
3. Google Play Services
4. Storage
5. CLEAR STORAGE
6. CLEAR ALL DATA

Problems with map display: blank map

Some problems with the Google Maps component can prevent the map display from loading properly, resulting in an empty blank map.
Sometimes you can fix this by clearing the Google Play Services app data.
Unfortunaltey sometimes this will not be enough and you will need to clear the app data completely to resolve the issue. Since clearing the app data will result in all your markers being deleted, you have to careful follow these steps to avoid losing your data:

1. Export your markers as a KMZ file
2. Copy the KMZ file to an other device
3. Confirm you can import back your markers from the KMZ file
4. Keep the KMZ file in a safe location
5. ONLY after your markers data is secured, proceed with next steps
6. Turn on the problematic device
7. Open the system settings
8. Applications
9. Map Marker
10. Storage
11. CLEAR STORAGE
12. CLEAR ALL DATA
13. Restart the app
14. Import your markers back from the KMZ file

Problems with blocked internet access

In some cases, even though your device has correct internet access, the system can block internet access to Map Marker, preventing the app from accessing internet, and preventing sync and causing the map not to load. This can be caused by battery savers and/or incorrect system parameters. If that happens, you can try the following steps to troubleshoot:

• Check for any power-saving / network blocking apps and ensure that Map Marker is allowed to use the network
• If that doesn't work, reset your network settings:
1. Open the system settings
2. Navigate to network settings
3. Select "Reset network settings"
4. Restart your device
• If that doesn't work, back-up your data and re-install the app:
1. Export your markers
2. Import your markers back to another device to confirm that the backup worked
3. Once you're confident your data is safely backed-up, uninstall the app
4. Restart your device
5. Install the app again

App launch error: "DatabaseException Row too big..."

In rare cases where you accidentally imported one or more POIs containing very large data, the app might fail to start with this initialization error:
"DatabaseException Row too big to fit into CursorWindow..."
In this case, you will need to find and fix the offending POI with the following steps:

1. From the device with the problematic app installed, click this
2. This should open Map Marker successfully and display a special message reading "sCursorWindowSize => 100MB"
3. Export your markers as a CSV file (text only)
4. Import your markers
5. The import should fail with an error message giving you the name of the POI with the offending data
6. Edit the POI to fix it
7. Exit the app completely, and launch it again: the initialization error should be gone

KMZ archive size limitations

Map Marker can handle KMZ archives with a size of up to 2GB without issues. Above 2GB, some limitations apply:

• The Map Marker PC web app will fail to import or export archives exceeding 2GB
• All versions of Map Marker will fail to import or export archives exceeding 4GB

You can work around these limitations in different ways:

• If you're trying to export an archive exceeding the limit, try to export a smaller subset of POIs (e.g. export only a few folders at a time instead of exporting everything)
• If you're trying to import an archive exceeding the limit, try to re-create that archive by splitting it into smaller chunks