Nestour GPS — Beta installation and API keys

Applies to Nestour GPS 0.15.0 (beta), released 5 November 2026 · Android and Windows · the beta works until 28 February 2027

© 2026 The Development Team. All rights reserved.

This guide takes you from nothing to a working Nestour GPS: install it, choose your language, then get your own API keys. Most of it is about the keys. Lines marked 🆕 are new in 0.15.0.

Links and sign-up steps were checked on the providers' sites on 5 November 2026. Provider sites change often. If a screen looks different, look for « API keys », « Credentials » or « My account ».

---

1. Install on Android

1. The development team sends you NestourGPS-0.15.0-arm64.apk. Open it on the phone or tablet (from the download notification, your Files app, or the message it came in).
2. Android asks to allow Install unknown apps for the app you opened it with (Files, Chrome, Gmail…). Allow it, go back, and tap Install.
3. Play Protect may warn about an unknown developer. Tap More details → Install anyway. That is normal for an app that does not come from the Play Store.
4. Open Nestour GPS and answer its questions:
   • Location: allow it, and choose Allow all the time when Android offers it (Android often asks in a second step: Settings → Apps → Nestour GPS → Permissions → Location → Allow all the time). With that the logbook and the warnings keep working with the screen off.
   • Notifications: allow. They bring the places ahead, traffic, the next stretch of a long route and reminders.
   • Physical activity: allow. It tells walking from driving in the logbook.
5. Battery, important for trips: Settings → Apps → Nestour GPS → Battery → Unrestricted. On a Samsung, also open Settings → Battery → Background usage limits and make sure Nestour GPS is not in « Sleeping apps » or « Deep sleeping apps ». Without this, Android may stop the GPS after a few minutes in your pocket.

Updates: install each new APK over the old one. Never uninstall first: uninstalling deletes your favourites, plans, trips and keys.

2. Install on Windows

1. The development team sends you NestourGPS-0.15.0-windows-x64-setup.exe (or the .msi). Run it.
2. Windows SmartScreen may say « Windows protected your PC ». Click More info → Run anyway. The app is not signed with a paid certificate, which is why Windows warns.
3. Start Nestour GPS from the Start menu.
4. A PC usually has no GPS. Give it a position one of three ways, from the position menu at the top:
   • Windows location: Settings → Privacy & security → Location on, with « Let desktop apps access your location ».
   • A USB GPS stick: plug it in, choose 💻 USB GPS (serial), then Connect GPS.
   • None: choose ✍️ Manual location and type a place. That is fine for planning trips at home.

3. Language, units and the beta date

• 🆕 Beta key (first): since 0.15 the beta needs your personal beta key: see « Nestour beta key — required » in section 4. Until you paste it, the app is only the simple GPS: the standard map, your position, the instruments and your data. Searches and places say « This needs your beta key ». That is normal, not a failed install.
• Language: the app follows the device's language. To change it: **Setup → 🖥 Display → App language → Suomi**. The beta speaks English, French, Chinese (中文) and Finnish; any other device language gives English. The place descriptions have their own setting: **Setup → 🔎 Places → Language of descriptions and facts**.
• Units: Setup → 🖥 Display → Units (From the language, Metric, US, UK).
• The beta ends on 28 February 2027. The app reminds you two weeks before. After that date your data stays visible and exportable, but searches and new trips stop. The development team will send a new version before then. The Help tab shows the version and the end date at the bottom.

---

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.

---

5. Move your keys to a second device

In the beta, ⬇ Export keys file is greyed out (« Available with a licence »): the app does not make the keys file. The simplest way: type the keys on each device (section 4), then press Test on each key.

From a Windows PC where the keys work you can also copy its keys.json (in %APPDATA%\com.tjepkema.touristexplorer) to the other device and pick it in Setup → 🔑 Keys & AI → ⬆ Import keys file. Then delete every copy of the file: in Download, in the e-mail or message you sent, and in its trash. The file holds your keys in plain text.

---

6. Feedback and the debug file

• Feedback: Help → ✉️ Send feedback opens the form on nestour.app, with the version, platform and language filled in. You can also write to the development team (hello@nestour.app). Say what you did, what you expected and what happened. A screenshot helps.
• Something went wrong on the road? Soon after the problem: **Setup → 📦 Your data → 🐞 Debug log → 🐞 Export the debug file, then ↗ Share** and send it to the development team (hello@nestour.app) with a line on what happened and roughly when. The file holds positions and network requests from about the last 5 hours. It never holds your keys.

The full user guide (USER-GUIDE-EN) explains everything else: planning trips, the logbook, the instruments.

Nestour GPS — Installation de la bêta et clés API

S'applique à Nestour GPS 0.15.0 (bêta), publiée le 5 novembre 2026 · Android et Windows · la bêta fonctionne jusqu'au 28 février 2027

© 2026 L’équipe de développement. Tous droits réservés.

Ce guide vous mène de zéro à un Nestour GPS qui marche : l'installer, choisir votre langue, puis obtenir vos propres clés API. L'essentiel porte sur les clés. Les lignes marquées 🆕 sont nouvelles dans la 0.15.0.

Les liens et les étapes d'inscription ont été vérifiés sur les sites des fournisseurs le 5 novembre 2026. Ces sites changent souvent. Si un écran est différent, cherchez « API keys », « Credentials » ou « My account ».

---

1. Installer sur Android

1. L’équipe de développement vous envoie NestourGPS-0.15.0-arm64.apk. Ouvrez-le sur le téléphone ou la tablette (depuis la notification de téléchargement, l'app Fichiers, ou le message qui l'a apporté).
2. Android demande d'autoriser Installer des applis inconnues (« Sources inconnues ») pour l'app avec laquelle vous l'avez ouvert (Fichiers, Chrome, Gmail…). Autorisez, revenez en arrière et touchez Installer.
3. Play Protect peut avertir d'un développeur inconnu. Touchez Plus d'informations → Installer quand même. C'est normal pour une app qui ne vient pas du Play Store.
4. Ouvrez Nestour GPS et répondez à ses questions :
   • Position : autorisez-la, et choisissez Toujours autoriser quand Android le propose (Android le demande souvent dans un second temps : **Paramètres → Applications → Nestour GPS → Autorisations → Position → Toujours autoriser**). Ainsi le carnet de voyage et les avertissements continuent de fonctionner écran éteint.
   • Notifications : autorisez. Elles apportent les lieux devant vous, le trafic, le tronçon suivant d'un long itinéraire et les rappels.
   • Activité physique : autorisez. Elle distingue la marche de la conduite dans le carnet.
5. Batterie, important pour les voyages : Paramètres → Applications → Nestour GPS → Batterie → Sans restriction. Sur un Samsung, ouvrez aussi Paramètres → Batterie → Limites d'utilisation en arrière-plan et vérifiez que Nestour GPS n'est ni dans « Applications en veille » ni dans « Applications en veille prolongée ». Sans cela, Android peut arrêter le GPS après quelques minutes dans votre poche.

Mises à jour : installez chaque nouvel APK par-dessus l'ancien. Ne désinstallez jamais d'abord : la désinstallation efface vos favoris, plans, voyages et clés.

2. Installer sur Windows

1. L’équipe de développement vous envoie NestourGPS-0.15.0-windows-x64-setup.exe (ou le .msi). Lancez-le.
2. Windows SmartScreen peut afficher « Windows a protégé votre ordinateur ». Cliquez sur **Informations complémentaires → Exécuter quand même**. L'app n'est pas signée avec un certificat payant, c'est pour cela que Windows avertit.
3. Lancez Nestour GPS depuis le menu Démarrer.
4. Un PC n'a en général pas de GPS. Donnez-lui une position de l'une de ces trois façons, depuis le menu de position en haut :
   • La localisation de Windows : Paramètres → Confidentialité et sécurité → Localisation activée, avec « Autoriser les applications de bureau à accéder à votre localisation ».
   • Une clé GPS USB : branchez-la, choisissez 💻 GPS USB (série), puis Connecter le GPS.
   • Aucune : choisissez ✍️ Position manuelle et tapez un lieu. Cela suffit pour préparer des voyages à la maison.

3. Langue, unités et date de la bêta

• 🆕 Clé bêta (d'abord) : depuis la 0.15, la bêta demande votre clé bêta personnelle. Vous la trouvez sur votre page de téléchargement de nestour.app (ou l’équipe de développement vous l'envoie). Copiez-la, puis **Réglages → 🔑 Clés et IA → 🎟 Clé bêta, collez-la et touchez Enregistrer** : l'app redémarre dans la bêta, et la ligne sous le champ dit jusqu'à quand elle est valable. Sans clé, l'app n'est qu'un simple GPS (la carte standard, votre position, les instruments, vos données).
• Langue : l'app suit la langue de l'appareil. Pour la changer : **Réglages → 🖥 Affichage → Langue de l'app → Suomi**. La bêta parle anglais, français, chinois (中文) et finnois ; une autre langue d'appareil donne l'anglais. Les descriptions des lieux ont leur propre réglage, dans toutes les langues : **Réglages → 🔎 Lieux → Langue des descriptions et anecdotes**.
• Unités : Réglages → 🖥 Affichage → Unités (Selon la langue, Métriques, US, Royaume-Uni).
• La bêta se termine le 28 février 2027. L'app vous prévient deux semaines avant. Après cette date, vos données restent visibles et exportables, mais les recherches et les nouveaux voyages s'arrêtent. L’équipe de développement enverra une nouvelle version avant. L'onglet Aide montre la version et la date de fin, tout en bas.

---

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é.

---

5. Passer vos clés sur un second appareil

Dans la bêta, ⬇ Exporter les clés est grisé (« Disponible avec une licence ») : l'app ne fabrique pas le fichier de clés. ⬆ Importer un fichier de clés fonctionne toujours.

• Depuis un PC Windows où les clés marchent : copiez keys.json depuis %APPDATA%\com.tjepkema.touristexplorer vers l'autre appareil (par e-mail à vous-même, ou par câble). Sur l'autre appareil : **Réglages → 🔑 Clés et IA → ⬆ Importer un fichier de clés, choisissez le fichier, puis appuyez sur Tester** pour chaque clé.
• Depuis un téléphone ou une tablette : Android garde ce fichier hors de portée. Saisissez les clés à la main sur l'autre appareil (section 4).
• Supprimez toutes les copies du fichier ensuite : dans Download, dans l'e-mail ou le message envoyé, et dans sa corbeille. Le fichier contient vos clés en clair.

---

6. Retours et fichier de débogage

• Retours : Aide → ✉️ Envoyer un avis ouvre le formulaire de nestour.app (version, plateforme et langue déjà remplies). Vous pouvez aussi écrire à l’équipe de développement (hello@nestour.app). Dites ce que vous avez fait, ce que vous attendiez et ce qui s'est passé. Une capture d'écran aide.
• Un problème sur la route ? Peu après le problème : **Réglages → 📦 Vos données → 🐞 Journal de débogage → 🐞 Exporter le fichier de débogage, puis ↗ Partager** et envoyez-le à l’équipe de développement (hello@nestour.app) avec une ligne sur ce qui s'est passé et à peu près quand. Le fichier contient les positions et les requêtes réseau des 5 dernières heures environ. **Il ne contient jamais vos clés.**

Le guide utilisateur complet (GUIDE-UTILISATEUR-FR) explique tout le reste : préparer des voyages, le carnet de voyage, les instruments.