Skip to content

Commit 268c1e4

Browse files
committed
Updated website
1 parent dcead54 commit 268c1e4

File tree

2 files changed

+70
-158
lines changed

2 files changed

+70
-158
lines changed

help/help_template_source/index_content.html

Lines changed: 19 additions & 41 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
<h1>User interface description</h1>
44

55
<h2 class="devices_web">How to open the Web App</h2>
6-
<p>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 <a href="https://www.mapmarker.app/webapp">here</a></p>
6+
<p>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 <a href="https://www.mapmarker.app/webapp" target="_blank" rel="noopener">here</a></p>
77

88
<h2>Main interface</h2>
99

@@ -427,25 +427,7 @@ <h2>Configuring third party search sources</h2>
427427
<li>Check the displayed result (success/failure)</li>
428428
</ol>
429429
<p>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.
430-
<b>"Here" Places Search API</b> seems like the best option because it's easy to setup.</p>
431-
<b>"Here" Places Search API (easy)</b>
432-
<p>Notes:</p>
433-
<ul>
434-
<li>You will need to use or create a free HERE account to retrieve the configuration values</li>
435-
<li>There is no need for a credit card (you can skip the "billing details" step)</li>
436-
<li>The free quota is plenty for a single user</li>
437-
<li>The configuration value you will need to obtain is an <b>API key</b></li>
438-
</ul>
439-
<p>Steps:</p>
440-
<ol>
441-
<li>Create an account here (skip billing details): <a href="https://platform.here.com/sign-up?step=verify-identity">https://platform.here.com/sign-up?step=verify-identity</a></li>
442-
<li>Navigate to the apps management page: <a href="https://platform.here.com/admin/apps">https://platform.here.com/admin/apps</a></li>
443-
<li>Click the "Register new app" button at the top right</li>
444-
<li>Under the "Register new app" prompt, enter "My App" as the app name, then click the "Register" button</li>
445-
<li>On the next page, if no API key is already present, click "Create API key"</li>
446-
<li>On the API key, click either the "Copy" or "View" buttons so you can copy the API key to the clipboard</li>
447-
<li>Note that you can later come back to your app to view/copy the API key from the apps management page: <a href="https://platform.here.com/admin/apps">https://platform.here.com/admin/apps</a></li>
448-
</ol>
430+
<b>"Tomtom" Places Search API</b> seems like the best option because it's easy to setup and cannot accidentally cause billing on a credit card.</p>
449431
<b>Tomtom places search API (easy)</b>
450432
<p>Notes</p>
451433
<ul>
@@ -456,33 +438,29 @@ <h2>Configuring third party search sources</h2>
456438
</ul>
457439
<p>Steps:</p>
458440
<ol>
459-
<li>Create an account here: https://developer.tomtom.com/user/register?destination=/how-to-get-tomtom-api-key</li>
441+
<li>Create an account here: <a href="https://developer.tomtom.com/user/register?destination=/how-to-get-tomtom-api-key" target="_blank" rel="noopener">https://developer.tomtom.com/user/register?destination=/how-to-get-tomtom-api-key</a></li>
460442
<li>Activate your account by clicking the "Activate account" button received in your registration email</li>
461-
<li>Navigate to the apps section of your account: https://developer.tomtom.com/user/me/apps</li>
443+
<li>Navigate to the apps section of your account: <a href="https://developer.tomtom.com/user/me/apps" target="_blank" rel="noopener">https://developer.tomtom.com/user/me/apps</a></li>
462444
<li>You should see an API key called "My First API Key"</li>
463445
<li>Under the "Key" column, click on the key to copy it to the clipboard</li>
464446
</ol>
465-
<b>"Google" Places Search API (very hard)</b>
466-
<p>Notes:</p>
447+
<b>Other places search APIs providers</b>
448+
<p>Important notes:</p>
467449
<ul>
468-
<li>!!!FOR ADVANCED USERS ONLY!!!</li>
469-
<li>You will need to use or create a free Google account to retrieve the configuration values</li>
470-
<li>The free quota should be enough for a single user</li>
471-
<li>The configuration value you will need to obtain is the <b>API key</b></li>
472-
<li>To get a functional API key, you will need to give your credit card information to Google</li>
473-
<li>Google may charge you on the API usage</li>
474-
<li>There are ways to limit the usage to only the free quota, to avoid being charged, but they depend on your configuration</li>
450+
<li>To get a functional API key, you will need to provide credit card information</li>
451+
<li>The provider may charge you on the API usage</li>
452+
<li>There are ways to limit the usage to only the free quota to avoid being charged, but they depend on your configuration</li>
475453
<li>It is impossible to use the free quota without providing a credit card</li>
476454
<li>It is impossible to guarantee no expenses due to an accidental bad configuration</li>
477-
<li>I will not provide support for this, you will have to interact with Google directly: <a href="https://developers.google.com/places/web-service/support">https://developers.google.com/places/web-service/support</a></li>
455+
<li>The free quota should be enough for a single user</li>
456+
<li>I will not provide support for this, you will have to refer to the provider's documentation (see links below)</li>
457+
<li>The configuration value you will need to obtain is the <b>API key</b></li>
458+
</ul>
459+
Providers (from easiest to hardest):
460+
<ul>
461+
<li>"Here" Places Search API (easy): see documentation <a href="https://www.here.com/docs/bundle/identity-and-access-management-developer-guide/page/topics/plat-using-apikeys.html" target="_blank" rel="noopener">here</a></li>
462+
<li>"Google" Places Search API (difficult): see documentation <a href="https://developers.google.com/maps/documentation/places/web-service/get-api-key#creating-api-keys" target="_blank" rel="noopener">here</a></li>
478463
</ul>
479-
<p>Steps:</p>
480-
<ol>
481-
<li>Get an API key here: <a href="https://developers.google.com/places/web-service/get-api-key">https://developers.google.com/places/web-service/get-api-key</a></li>
482-
<li>Enable billing for your google cloud console account</li>
483-
<li>Set a limit on your Places API usage</li>
484-
<li>Save the API key in a way that you can paste it into Map Marker</li>
485-
</ol>
486464

487465
<h2 class="devices_android">How to use offline maps?</h2>
488466
<ol>
@@ -705,7 +683,7 @@ <h2 class="devices_android">Premium troubleshooting</h2>
705683
</ol>
706684
<p>
707685
If these steps don't work you can send me your order number for confirmation and I will help you.
708-
You can find your order number from the email you received when making the purchase, or from <a target="_blank" href="https://payments.google.com/">https://payments.google.com/</a> under the "Activity" tab.
686+
You can find your order number from the email you received when making the purchase, or from <a href="https://payments.google.com/" target="_blank" rel="noopener">https://payments.google.com/</a> under the "Activity" tab.
709687
</p>
710688

711689
<h2 class="devices_android">Problems with Google Play Services</h2>
@@ -779,7 +757,7 @@ <h2 class="devices_android">App launch error: "DatabaseException Row too big..."
779757
In this case, you will need to find and fix the offending POI with the following steps:
780758
</p>
781759
<ol>
782-
<li>From the device with the problematic app installed, click <a href="https://mapmarker.app/dl?dbCursorWindowSizeOverride=100">this</a></li>
760+
<li>From the device with the problematic app installed, click <a href="https://mapmarker.app/dl?dbCursorWindowSizeOverride=100" target="_blank" rel="noopener">this</a></li>
783761
<li>This should open Map Marker successfully and display a special message reading "sCursorWindowSize => 100MB"</li>
784762
<li><a href="#devices_android_How_to_exportshare_your_markers">Export your markers as a CSV file (text only)</a></li>
785763
<li><a href="#devices_android_How_to_exportshare_your_markers">Import your markers</a></li>

0 commit comments

Comments
 (0)