Your API keys

4. API keys: what they are and which you need

🆕 Apart from your Nestour beta key, the app works without any key. Everything runs on your device and talks directly to the map, place and AI services. Some of those services need you to have your own key: a long code that says « this is me » to the service. Each tester makes his own keys. They are free or cost a few cents, and they stay on your device. Nobody else, the development team included, sees them.

How to enter a key (the same for all of them): Setup → 🔑 Keys & AI → paste the key in its field → Save → Test (when the row has one). A window says ✅ Works or ❌ Doesn't work, with the reason. A saved key never shows again: the field says « saved — type a new one to replace it ». Remove deletes it.

Summary

For Finland and the Nordics: get OpenTripMap, an AI key and TomTom (if you drive). Add Mapy.com for hiking or skiing in Lapland and the fells. Skip IGN: it is France only. The Swiss map (swisstopo) needs no key and only covers Switzerland.

The sections below each stand alone. Do them in any order.

---

🆕 Nestour beta key — required

What it does: unlocks the beta. Without it the app is the simple GPS (the standard map, your position, the instruments and your data). It is not an API key for a service: it is your personal licence for the beta, checked on your device without going online, and it ends with the beta on 28 February 2027.

Where to get it: your download page on nestour.app shows it. Until the site hands them out, the development team sends it to you.

How to enter it: copy the whole key (one long line starting with « eyJ »), then Setup → 🔑 Keys & AI → 🎟 Beta key (at the top) → paste → Save. The app starts again in the beta, and the line under the field says « Beta key valid until 28 February 2027 ».

On a second device: paste the same key there too. ⬆ Import keys file does not carry it, and the beta key must be in place before you import keys.

---

OpenTripMap — recommended

What it adds: a large database of sights (museums, churches, castles, viewpoints, monuments) with a popularity rating. With it the app finds more places and gives better stars (★★★ worth the journey … ★ interesting). It also helps the fuel search.

Without it: places still come from OpenStreetMap and Wikipedia. You see fewer of them and the stars are rougher.

Cost and limits: free plan, 5,000 requests a day and 10 a second, for non-commercial use. No card.

How to get it:

1. Go to https://dev.opentripmap.org/register (the old address opentripmap.io no longer works).
2. Fill in your name, e-mail and a password, solve the captcha, and click Sign up. Confirm your e-mail if asked.
3. Sign in at https://dev.opentripmap.org. Your API key is shown in your account page.
4. Copy the key.

Where to paste it: Setup → 🔑 Keys & AI → OpenTripMap key → Save → Test. Test answers « OpenTripMap answers: N places within 2 km ».

---

AI provider — recommended

What it adds: ✨ 3 facts, three surprising facts about a place, written by an AI. It also translates place descriptions into your language when the article does not exist in it (for example a Finnish text for a German castle). You need one provider. Each provider you set up keeps its own key, so you can switch back later without typing it again.

Without it: no ✨ 3 facts and no translations. Descriptions come in the place's own language or English.

Cost: a place costs a fraction of a cent. Two providers have a free tier:

How to get a Gemini key (the free start):

1. Go to https://aistudio.google.com/apikey and sign in with a Google account.
2. Accept the terms if asked, then click Create API key. If it asks for a project, let it create one.
3. Copy the key (it starts with « AIza »).

In Finland (EU), Google handles free-tier data under its paid-service terms. Outside Europe, the free tier lets Google use what you send to improve its products. The app only sends place names and short texts.

Where to paste it: Setup → 🔑 Keys & AI → AI for ✨ 3 facts and translations → choose the provider → paste the API key → leave Model empty (the app uses a sensible default) → Save → Test. Test answers « The AI answers: … ».

---

TomTom — recommended if you drive

What it adds:

• Traffic ahead: jams, roadworks and closures on your road, as you drive.
• Traffic on the map, and journey times with traffic when you plan.
• Lanes and exit signs in turn-by-turn navigation.
• Better speed limits and fuel stations.
• The TomTom map (day and night) as a map choice.

TomTom covers Finland and the Nordics well.

Without it: no traffic. Routes, lanes and speed limits come from OpenStreetMap's free services, which are good but less complete.

Cost and limits: free, no credit card. The free allowance is counted per month and per API (for example 2,500 traffic-incident requests and 20,000 routes a month). That is enough for personal use. If a month runs out, traffic simply stops until the next month and the rest of the app goes on.

How to get it:

1. Go to https://my.tomtom.com and create an account (Get started / Sign up). Confirm your e-mail.
2. In the dashboard, open Keys (or API keys). A first key is usually there already. If not, create one.
3. If the key lets you choose products, make sure Traffic, Map Display, Routing and Search are on.
4. Copy the key.

Where to paste it: Setup → 🔑 Keys & AI → TomTom key → Save → Test. Test answers « Key works: N traffic incidents within 25 km ». N can be 0 on a quiet day: that still means it works.

---

Mapy.com — optional (hiking and skiing)

What it adds: two extra maps, 🥾 Mapy hiking (marked trails, huts, contours) and ⛷ Mapy winter (ski runs, cross-country tracks, lifts). They work everywhere and are best across Europe. In Finland they are useful for Lapland, the national parks and the fells.

Without it: the other maps stay (standard, satellite, terrain).

Cost and limits: free, 250,000 credits a month, enough for personal use. Nothing is charged unless you turn on paid consumption yourself.

How to get it:

1. Go to https://developer.mapy.com/account/ (« My Account »).
2. Sign in with a Seznam account, or create one there (Seznam is the Czech company behind Mapy.com). Use an e-mail address you read: they write when credits run low.
3. Create a new API project. Its first API key is created automatically.
4. Copy the key.

Where to paste it: Setup → 🔑 Keys & AI → Mapy.com key → Save. This row has no Test button. To check it, open Setup → 🖥 Display → Map and choose 🥾 Mapy hiking: the map should show, with the Mapy.com logo at the bottom left.

---

Google Contacts — optional, advanced

What it adds: your Google contacts' postal addresses appear in the destination picker, so « drive to Mum's » is one tap. Contacts are read when you search, never copied.

Without it: you type addresses yourself. On Android, 📱 This phone's contacts (below) often does the same with no key at all.

Cost: free, but it takes about 15 minutes in Google's developer console. Ask the development team (hello@nestour.app) before you try it.

How to get it:

1. Go to https://console.cloud.google.com and sign in. Create a project if asked.
2. APIs & Services → Library → search People API → Enable.
3. APIs & Services → OAuth consent screen: fill in the app name and your e-mail, and add yourself as a test user.
4. APIs & Services → Credentials → Create credentials → OAuth client ID, type Desktop app.
5. Copy the Client ID (it ends in .apps.googleusercontent.com) and the Client secret.

Where to paste it: Setup → 🔑 Keys & AI → Google Contacts → OAuth client ID and Client secret → Save → Sign in with Google → allow « See your contacts » → Test.

---

Contacts from this phone and from Nextcloud — optional

📱 This phone's contacts (Android) needs no key. Setup → 🔑 Keys & AI → Contacts → switch it On and allow the contacts permission. Only postal addresses are read.

Nextcloud (only if you have one): type the Nextcloud address (https://…), your user name and an app password (Nextcloud → Personal settings → Security → « Create new app password », not your login password) → Save. ↻ Check shows how many addresses each source found.

---

Own Overpass server — not needed

This is a field for people who run their own OpenStreetMap search server. Leave it empty. The public servers are used, and that is what you want.

---

IGN SCAN 25 — not needed in Finland

What it adds: France's official 1:25,000 hiking map, in France only.

Who can get it: IGN gives this key only to French professionals and associations (the sign-up at https://cartes.gouv.fr asks for a SIRET company number). Without it, the free 🇫🇷 IGN plan map still works in France, and Mapy hiking covers France too. Skip this one.

---

4. Clés API : ce que c'est et lesquelles il vous faut

L'app fonctionne sans aucune clé. Tout tourne sur votre appareil et parle directement aux services de carte, de lieux et d'IA. Certains de ces services demandent que vous ayez votre propre clé : un long code qui dit « c'est moi » au service. Chaque testeur crée ses propres clés. Elles sont gratuites ou coûtent quelques centimes, et elles restent sur votre appareil. Personne d'autre, l’équipe de développement comprise, ne les voit.

Comment saisir une clé (pareil pour toutes) : Réglages → 🔑 Clés et IA → collez la clé dans son champ → Enregistrer → Tester (quand la ligne en a un). Une fenêtre affiche ✅ Ça marche ou ❌ Ça ne marche pas, avec la raison. Une clé enregistrée ne s'affiche plus jamais : le champ indique « enregistrée — saisissez-en une nouvelle pour la remplacer ». Retirer la supprime.

Résumé

Pour la Finlande et les pays nordiques : prenez OpenTripMap, une clé d'IA et TomTom (si vous conduisez). Ajoutez Mapy.com pour la randonnée ou le ski en Laponie et sur les fjells. Laissez IGN de côté : c'est la France seulement. La carte suisse (swisstopo) ne demande aucune clé et ne couvre que la Suisse.

Chacune des sections ci-dessous se suffit à elle-même. Faites-les dans l'ordre que vous voulez.

---

OpenTripMap — recommandée

Ce qu'elle apporte : une grande base de curiosités (musées, églises, châteaux, points de vue, monuments) avec une note de popularité. Avec elle, l'app trouve plus de lieux et donne de meilleures étoiles (★★★ vaut le voyage … ★ intéressant). Elle aide aussi la recherche de carburant.

Sans elle : les lieux viennent toujours d'OpenStreetMap et de Wikipédia. Vous en voyez moins et les étoiles sont plus approximatives.

Coût et limites : formule gratuite, 5 000 requêtes par jour et 10 par seconde, pour un usage non commercial. Sans carte bancaire.

Comment l'obtenir :

1. Allez sur https://dev.opentripmap.org/register (l'ancienne adresse opentripmap.io ne marche plus).
2. Indiquez votre nom, votre e-mail et un mot de passe, résolvez le captcha et cliquez sur Sign up. Confirmez votre e-mail si on vous le demande.
3. Connectez-vous sur https://dev.opentripmap.org. Votre clé API s'affiche sur la page de votre compte.
4. Copiez la clé.

Où la coller : Réglages → 🔑 Clés et IA → Clé OpenTripMap → Enregistrer → Tester. Le test répond « OpenTripMap répond : N lieux à moins de 2 km ».

---

Fournisseur d'IA — recommandé

Ce qu'il apporte : ✨ 3 anecdotes, trois faits étonnants sur un lieu, écrits par une IA. Il traduit aussi les descriptions des lieux dans votre langue quand l'article n'existe pas dans celle-ci (par exemple un texte en finnois pour un château allemand). Il vous faut un seul fournisseur. Chaque fournisseur configuré garde sa propre clé : vous pouvez donc revenir à un autre plus tard sans la retaper.

Sans lui : pas de ✨ 3 anecdotes ni de traductions. Les descriptions arrivent dans la langue du lieu ou en anglais.

Coût : un lieu coûte une fraction de centime. Deux fournisseurs ont une offre gratuite :

Comment obtenir une clé Gemini (le départ gratuit) :

1. Allez sur https://aistudio.google.com/apikey et connectez-vous avec un compte Google.
2. Acceptez les conditions si on vous le demande, puis cliquez sur Create API key. S'il demande un projet, laissez-le en créer un.
3. Copiez la clé (elle commence par « AIza »).

En Finlande (UE), Google traite les données de l'offre gratuite selon les conditions de son service payant. Hors d'Europe, l'offre gratuite permet à Google d'utiliser ce que vous envoyez pour améliorer ses produits. L'app n'envoie que des noms de lieux et des textes courts.

Où la coller : Réglages → 🔑 Clés et IA → IA pour ✨ 3 anecdotes et les traductions → choisissez le fournisseur → collez la Clé API → laissez Modèle vide (l'app prend une valeur par défaut raisonnable) → Enregistrer → Tester. Le test répond « L'IA répond : … ».

---

TomTom — recommandée si vous conduisez

Ce qu'elle apporte :

• Le trafic devant vous : bouchons, travaux et routes fermées sur votre route, pendant que vous roulez.
• Le trafic sur la carte, et des temps de trajet avec le trafic quand vous préparez un voyage.
• Les voies et panneaux de sortie dans le guidage pas à pas.
• De meilleures limites de vitesse et stations-service.
• La carte TomTom (jour et nuit) parmi les choix de carte.

TomTom couvre bien la Finlande et les pays nordiques.

Sans elle : pas de trafic. Les itinéraires, les voies et les limites de vitesse viennent des services gratuits d'OpenStreetMap, bons mais moins complets.

Coût et limites : gratuite, sans carte bancaire. Le quota gratuit est compté par mois et par API (par exemple 2 500 requêtes d'incidents de circulation et 20 000 itinéraires par mois). Cela suffit pour un usage personnel. Si un mois est épuisé, le trafic s'arrête simplement jusqu'au mois suivant et le reste de l'app continue.

Comment l'obtenir :

1. Allez sur https://my.tomtom.com et créez un compte (Get started / Sign up). Confirmez votre e-mail.
2. Dans le tableau de bord, ouvrez Keys (ou API keys). Une première clé y est en général déjà. Sinon, créez-en une.
3. Si la clé permet de choisir des produits, vérifiez que Traffic, Map Display, Routing et Search sont activés.
4. Copiez la clé.

Où la coller : Réglages → 🔑 Clés et IA → Clé TomTom → Enregistrer → Tester. Le test répond « La clé fonctionne : N incidents de circulation dans un rayon de 25 km ». N peut valoir 0 un jour calme : cela veut quand même dire que la clé marche.

---

Mapy.com — facultative (randonnée et ski)

Ce qu'elle apporte : deux cartes de plus, 🥾 Mapy rando (sentiers balisés, refuges, courbes de niveau) et ⛷ Mapy hiver (pistes de ski, pistes de fond, remontées). Elles marchent partout et sont les meilleures en Europe. En Finlande, elles sont utiles pour la Laponie, les parcs nationaux et les fjells.

Sans elle : les autres cartes restent (standard, satellite, relief).

Coût et limites : gratuite, 250 000 crédits par mois, assez pour un usage personnel. Rien n'est facturé tant que vous n'activez pas vous-même la consommation payante.

Comment l'obtenir :

1. Allez sur https://developer.mapy.com/account/ (« My Account »).
2. Connectez-vous avec un compte Seznam, ou créez-en un sur place (Seznam est l'entreprise tchèque derrière Mapy.com). Utilisez une adresse e-mail que vous lisez : ils écrivent quand les crédits s'épuisent.
3. Créez un nouveau API project. Sa première clé API est créée automatiquement.
4. Copiez la clé.

Où la coller : Réglages → 🔑 Clés et IA → Clé Mapy.com → Enregistrer. Cette ligne n'a pas de bouton Tester. Pour vérifier, ouvrez Réglages → 🖥 Affichage → Carte et choisissez 🥾 Mapy rando : la carte doit s'afficher, avec le logo Mapy.com en bas à gauche.

---

Contacts Google — facultatif, avancé

Ce qu'il apporte : les adresses postales de vos contacts Google apparaissent dans le choix de destination, et « aller chez maman » se fait d'un seul toucher. Les contacts sont lus quand vous cherchez, jamais copiés.

Sans lui : vous tapez les adresses vous-même. Sur Android, 📱 Contacts de ce téléphone (plus bas) fait souvent la même chose sans aucune clé.

Coût : gratuit, mais cela prend environ 15 minutes dans la console développeur de Google. Demandez à l’équipe de développement (hello@nestour.app) avant d'essayer.

Comment l'obtenir :

1. Allez sur https://console.cloud.google.com et connectez-vous. Créez un projet si on vous le demande.
2. APIs & Services → Library → cherchez People API → Enable.
3. APIs & Services → OAuth consent screen : indiquez le nom de l'app et votre e-mail, et ajoutez-vous comme utilisateur de test.
4. APIs & Services → Credentials → Create credentials → OAuth client ID, type Desktop app.
5. Copiez le Client ID (il se termine par .apps.googleusercontent.com) et le Client secret.

Où les coller : Réglages → 🔑 Clés et IA → Contacts Google → ID client OAuth et Code secret du client → Enregistrer → Se connecter avec Google → autorisez « Voir vos contacts » → Tester.

---

Contacts de ce téléphone et de Nextcloud — facultatif

📱 Contacts de ce téléphone (Android) ne demande aucune clé. Réglages → 🔑 Clés et IA → Contacts → mettez-le sur Oui et autorisez l'accès aux contacts. Seules les adresses postales sont lues.

Nextcloud (seulement si vous en avez un) : tapez l'Adresse Nextcloud (https://…), votre Nom d'utilisateur Nextcloud et un Mot de passe d'application (Nextcloud → Paramètres personnels → Sécurité → « Créer un nouveau mot de passe d'application », pas votre mot de passe de connexion) → Enregistrer. ↻ Vérifier indique combien d'adresses chaque source a trouvé.

---

Serveur Overpass personnel — inutile

Ce champ est destiné à ceux qui font tourner leur propre serveur de recherche OpenStreetMap. Laissez-le vide. Les serveurs publics sont utilisés, et c'est ce qu'il vous faut.

---

IGN SCAN 25 — inutile hors de France

Ce qu'elle apporte : la carte de randonnée officielle de la France au 1:25 000, en France seulement.

Qui peut l'obtenir : l'IGN ne donne cette clé qu'aux professionnels et associations français (l'inscription sur https://cartes.gouv.fr demande un numéro SIRET d'entreprise). Sans elle, le plan 🇫🇷 IGN gratuit marche toujours en France, et Mapy rando couvre aussi la France. Laissez celle-ci de côté.

---