# 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é | Clé | Statut | Ce que vous obtenez | Coût | |---|---|---|---| | OpenTripMap | **Recommandée** | Plus de lieux, de meilleures étoiles | Gratuite | | Fournisseur d'IA (un parmi plusieurs) | **Recommandée** | ✨ 3 anecdotes, descriptions traduites | Gratuite (Gemini, Groq) ou quelques centimes | | TomTom | **Recommandée si vous conduisez** | Trafic devant, temps avec le trafic, voies, limites de vitesse, carte TomTom | Gratuite, sans carte bancaire | | Mapy.com | Facultative (randonnée, ski) | Cartes de randonnée et d'hiver dans toute l'Europe | Gratuite | | Contacts Google | Facultative, avancée | Les adresses de vos contacts comme destinations | Gratuite | | Contacts Nextcloud | Facultative | Les adresses de votre Nextcloud | Votre propre Nextcloud | | Serveur Overpass personnel | Inutile | Des recherches sur votre propre serveur de carte | — | | IGN SCAN 25 | **Inutile hors de France** | La carte de randonnée de France au 1:25 000 | Professionnels seulement | **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 : | Fournisseur (nom dans l'app) | Où obtenir la clé | Coût | |---|---|---| | **Gemini** (le départ gratuit le plus simple) | https://aistudio.google.com/apikey | Offre gratuite avec un compte Google, sans carte bancaire | | **Groq** | https://console.groq.com/keys | Formule gratuite avec limites quotidiennes | | **Claude** | https://platform.claude.com/settings/keys | À l'usage : achetez d'abord un peu de crédit (Billing) | | **ChatGPT** | https://platform.openai.com/api-keys | Crédit prépayé, à partir de 5 $ (distinct d'un abonnement ChatGPT) | | **Mistral** | https://console.mistral.ai (API Keys) | Voir leurs formules | | **DeepSeek** | https://platform.deepseek.com/api_keys | Crédit prépayé | | **OpenRouter** | https://openrouter.ai/settings/keys | Modèles gratuits : 50 requêtes par jour ; 1 000 par jour après l'achat de 10 $ de crédit | | **Ollama** / **Autre (compatible OpenAI)** | Votre propre serveur d'IA à la maison | Gratuit, votre matériel | **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.