Home Help Center

Map Marker Help Center

To get started with the help center, choose the platform you are using:

Map Marker help center for Android

Map Marker help center for iOS

Map Marker web app help center

User interface description
Main map interface
Main menu interface
Marker info window
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 other people 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)?
FAQ
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?
Troubleshooting and known problems
Problems with Google My Maps
Premium troubleshooting
Problems with corrupted files on app launch (code 14 SQLITE_CANTOPEN)
Problems with Google Play Services

User interface description

Main map interface

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

  • The action bar (top left)
  • menu button
  • ‎jump button
  • ‎organize button
  • ‎search button
  • share button
  • The “my location” button (top right)
  • The add button (bottom right)

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
  • Folders
  • Add folder button
  • Map type button
  • Settings button
  • About button
  • Premium-related elements

Marker info window

When you select a marker (when clicking on it for example), you will see the marker info window. The info window has 4 buttons:

  • Marker edit button (top left)
  • Copy to clipboard button (top right)
  • Navigation button (bottom left)
  • Call button (bottom right)

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 one marker:

  • select the marker (by clicking it for example)
  • click the edit button in the info window, this will open the marker edit page
  • click the 3 dots at the top to bring up the menu
  • 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.

At the top of the screenshot below, we can see from left to right:

  • Select all button: select all the markers in the list
  • Move to folder button: move the selected markers to another folder
  • Copy to folder button: move the selected markers to another folder
  • Delete button: delete the selected markers

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 left drawer
  2. Click on the map file to open the file options menu
  3. Select the "cloud sync" option
  4. Select "Google Drive"
  5. Select your account
  6. Click ok

How to create a new map folder on the cloud

  1. Open the left drawer
  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. Select "Google Drive"
  6. Select your account
  7. select the folder where you want the cloud folder to be saved
  8. Click ok

How to share your map cloud folder with other people on the cloud

  1. Open the left drawer
  2. Click on the map file to open the file options menu
  3. Select "share cloud map"
  4. Open with the Google Drive app
  5. Open the cloud folder details
  6. Select "add people" and add give "write permissions" to your friends
  7. Have your friends install Map Marker
  8. Your friends will then need to open the existing map file from the cloud

How to open an existing map file from the cloud?

  1. Open the left drawer
  2. Select the "open map file" option
  3. Select the "open cloud map" option
  4. Select "Google Drive"
  5. Select the cloud map you want to open

How to restore a previous version from history?

  1. open the left drawer
  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. Select the app to export to (Gmail, Google Drive, Dropbox, etc.)

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

  1. Download the file to your device
  2. Open the side drawer by clicking the left button of the main action bar
  3. Open the settings by clicking "settings"
  4. Scroll down and click "Import/Export"
  5. Select "Import"
  6. Select the file to import from the in-app file explorer

Note: the CSV file import will only work if the file has "Latitude" and "Longitude" columns. 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.

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

For the users who used the search feature in Map Marker before, you're probably wondering why it changed that way. Please see the Map Marker Search Feature Changes FAQ for more details.

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. From user feedback so far, "HERE" seems like the best option because it's easy to setup and the search result quality is pretty good.

"Here" Places Search API (very 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://developer.here.com/projects
  3. Click "Select a plan for a new project"
  4. Select the "Fremium" plan and create your new project
  5. Go back to the projects page here: https://developer.here.com/projects
  6. Click on your project
  7. Under "JS REST" / "REST & XYZ HUB API/CLI" click on "Generage App ID and App Code"
  8. Under "JS REST" / "REST & XYZ HUB API/CLI" find your App ID under "APP ID" and your App Code under "APP CODE"
  9. Save the App ID and the App Code in a way that you can paste them into Map Marker
"Algolia" Places Search API (pretty easy)

Notes:

  • You will need to use or create a free Algolia 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 Application ID and Search-Only API Key

Steps:

  1. Create an account here: https://www.algolia.com/users/sign_up
  2. Open the dashboard link here: https://www.algolia.com/dashboard
  3. Click "API Keys" in the left menu
  4. Look at the page to find "Application ID" and "Search-Only API Key" values
  5. Save the Application ID and the Search-Only API Key in a way that you can paste them 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: http://ftp-stud.hs-esslingen.de/pub/Mirrors/download.mapsforge.org/maps/v3/
  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 "Storage folder"
  8. Select the folder where the offline map files are
  9. Go back to the main view and open the side drawer
  10. Click "Map type"
  11. Select "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

FAQ

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:

http://mapmarkerapp.com/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:

http://mapmarkerapp.com/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:

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"

Troubleshooting and known problems

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.

Problems with corrupted files on app launch (code 14 SQLITE_CANTOPEN)

This problem typically indicates a problem with the system data restoring from Google Drive on app install. After installing the app, the app data has been restored in a corrupted state causing this issue.

If you encounter this problem:

  1. IMPORTANT: make sure you have backed up your data because this involves deleting the app data from the device
  2. Open the system settings
  3. Applications
  4. Map Marker
  5. Storage
  6. CLEAR STORAGE

Problems with Google Play Services

Some problems with the Google Play Services app can prevent the map display from loading. 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
User interface description
Main map interface
Main menu interface
Marker info window
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
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 other people 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 KMZ file?
Migrating your data to a new device
Advanced features
Configuring third party search sources
How can I import my starred locations from Google Maps (locations marked with a star on Google Maps)?
FAQ
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?
What should I know about the premium upgrade?

User interface description

Main map interface

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

  • The action bar (top left)
  • menu button
  • ‎jump button
  • ‎search button
  • share button
  • The “my location” button (top right)
  • The add button (bottom right)

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
  • Folders
  • Add folder button
  • Map type button
  • Settings button
  • About button
  • Premium-related elements

Marker info window

When you select a marker (when clicking on it for example), you will see the marker info window. The info window has 4 buttons:

  • Marker edit button (top left)
  • Copy to clipboard button (top right)
  • Navigation button (bottom left)
  • Call button (bottom right)

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 one marker:

  • select the marker (by clicking it for example)
  • click the edit button in the info window, this will open the marker edit page
  • scroll down to click on the delete button
  • 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.

At the top of the screenshot below, we can see from left to right:

  • Select all button: select all the markers in the list
  • Move to folder button: move the selected markers to another folder
  • Copy to folder button: move the selected markers to another folder
  • Delete button: delete the selected markers

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

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 left drawer
  2. Click on the map file to open the file options menu
  3. Select the "cloud sync" option
  4. Select your account
  5. Click ok

How to create a new map folder on the cloud

  1. Open the left drawer
  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. Select your account
  6. Click ok

How to share your map cloud folder with other people on the cloud

  1. Open the left drawer
  2. Click on the map file to open the file options menu
  3. Select "share cloud map"
  4. Open with the Google Drive app
  5. Open the cloud folder details
  6. Select "add people" and add give "write permissions" to your friends
  7. Have your friends install Map Marker
  8. Your friends will then need to open the existing map file from the cloud

How to open an existing map file from the cloud?

  1. Open the left drawer
  2. Select the "open map file" option
  3. Select the "open cloud map" option
  4. Select the cloud map you want to open

How to restore a previous version from history?

  1. open the left drawer
  2. click on the map file to open the file options menu
  3. select the "view history/restore" option
  4. 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 app to export to (Gmail, Google Drive, Dropbox, etc.)

How to import your markers from a KMZ file?

  1. Open the KMZ file details
  2. Find the "open with" option
  3. You should see a list of apps to open the file with
  4. In the list of apps, select Map Marker
  5. Map Marker will start and you will show a confirmation prompt
  6. Click yes to import the file

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

⇒ Depending on your iCloud settings, the app data might have been backed up. If that wasn't the case, then there is no other way to retrieve the data to my knowledge :'(

Advanced features

Configuring third party search sources

For the users who used the search feature in Map Marker before, you're probably wondering why it changed that way. Please see the Map Marker Search Feature Changes FAQ for more details.

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. From user feedback so far, "HERE" seems like the best option because it's easy to setup and the search result quality is pretty good.

"Here" Places Search API (very 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://developer.here.com/projects
  3. Click "Select a plan for a new project"
  4. Select the "Fremium" plan and create your new project
  5. Go back to the projects page here: https://developer.here.com/projects
  6. Click on your project
  7. Under "JS REST" / "REST & XYZ HUB API/CLI" click on "Generage App ID and App Code"
  8. Under "JS REST" / "REST & XYZ HUB API/CLI" find your App ID under "APP ID" and your App Code under "APP CODE"
  9. Save the App ID and the App Code in a way that you can paste them into Map Marker
"Algolia" Places Search API (pretty easy)

Notes:

  • You will need to use or create a free Algolia 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 Application ID and Search-Only API Key

Steps:

  1. Create an account here: https://www.algolia.com/users/sign_up
  2. Open the dashboard link here: https://www.algolia.com/dashboard
  3. Click "API Keys" in the left menu
  4. Look at the page to find "Application ID" and "Search-Only API Key" values
  5. Save the Application ID and the Search-Only API Key in a way that you can paste them 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 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

FAQ

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:

http://mapmarkerapp.com/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:

http://mapmarkerapp.com/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:

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"

What should I know about the premium upgrade?

When you purchase the premium, it becomes available for life for your Apple account. The Apple 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 iOS devices as you want. However you will need to use the exact same Apple account to perform the installation of Map Marker on your other device.
To restore the premium on a newly installed iOS device:

  1. Open the side drawer by clicking the top left button on the main action bar
  2. Click premium
  3. Click "restore purchases"

If these steps don't work you can send me your order number for confirmation and I will help you.

User interface description
How to open the Web App
Main map interface
Main menu interface
Marker info window
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
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 other people 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 KMZ file?
Migrating your data to a new device
Advanced features
Configuring third party search sources
How can I import my starred locations from Google Maps (locations marked with a star on Google Maps)?
FAQ
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?

User interface description

How to open the Web App

The web app is meant to be opened from your computer's web browser. You can reach the web app from the home page by clicking "Launch the Web App" or by clicking here

Main map interface

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

  • The action bar (top left)
  • menu button
  • ‎jump button
  • ‎search button
  • share button
  • The add button (bottom right)

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
  • Folders
  • Add folder button
  • Map type button
  • Settings button
  • About button
  • Premium-related elements

Marker info window

When you select a marker (when clicking on it for example), you will see the marker info window. The info window has 4 buttons:

  • Marker edit button (top left)
  • Copy to clipboard button (top right)
  • Navigation button (bottom left)
  • Call button (bottom right)

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 one marker:

  • select the marker (by clicking it for example)
  • click the edit button in the info window, this will open the marker edit page
  • scroll down to click on the delete button
  • 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.

At the top of the screenshot below, we can see from left to right:

  • Select all button: select all the markers in the list
  • Move to folder button: move the selected markers to another folder
  • Copy to folder button: move the selected markers to another folder
  • Delete button: delete the selected markers

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

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 left drawer
  2. Click on the map file to open the file options menu
  3. Select the "cloud sync" option
  4. Select your account
  5. Click ok

How to create a new map folder on the cloud

  1. Open the left drawer
  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. Select your account
  6. Click ok

How to share your map cloud folder with other people on the cloud

  1. Open the left drawer
  2. Click on the map file to open the file options menu
  3. Select "share cloud map"
  4. Open with the Google Drive app
  5. Open the cloud folder details
  6. Select "add people" and add give "write permissions" to your friends
  7. Have your friends install Map Marker
  8. Your friends will then need to open the existing map file from the cloud

How to open an existing map file from the cloud?

  1. Open the left drawer
  2. Select the "open map file" option
  3. Select the "open cloud map" option
  4. Select the cloud map you want to open

How to restore a previous version from history?

  1. open the left drawer
  2. click on the map file to open the file options menu
  3. select the "view history/restore" option
  4. 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. The exported file should download from your browser

How to import your markers from a KMZ file?

  1. Open the left drawer
  2. Click on the map file to open the file options menu
  3. Select the "import markers" option
  4. Select the KMZ file from your computer and the import will start

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

⇒ Since the web app is on your browser only, there is no other way to retrieve the data to my knowledge :'(

Advanced features

Configuring third party search sources

For the users who used the search feature in Map Marker before, you're probably wondering why it changed that way. Please see the Map Marker Search Feature Changes FAQ for more details.

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. From user feedback so far, "HERE" seems like the best option because it's easy to setup and the search result quality is pretty good.

"Here" Places Search API (very 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://developer.here.com/projects
  3. Click "Select a plan for a new project"
  4. Select the "Fremium" plan and create your new project
  5. Go back to the projects page here: https://developer.here.com/projects
  6. Click on your project
  7. Under "JS REST" / "REST & XYZ HUB API/CLI" click on "Generage App ID and App Code"
  8. Under "JS REST" / "REST & XYZ HUB API/CLI" find your App ID under "APP ID" and your App Code under "APP CODE"
  9. Save the App ID and the App Code in a way that you can paste them into Map Marker
"Algolia" Places Search API (pretty easy)

Notes:

  • You will need to use or create a free Algolia 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 Application ID and Search-Only API Key

Steps:

  1. Create an account here: https://www.algolia.com/users/sign_up
  2. Open the dashboard link here: https://www.algolia.com/dashboard
  3. Click "API Keys" in the left menu
  4. Look at the page to find "Application ID" and "Search-Only API Key" values
  5. Save the Application ID and the Search-Only API Key in a way that you can paste them 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 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

FAQ

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:

http://mapmarkerapp.com/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:

http://mapmarkerapp.com/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:

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"