FR:Mkgmap

From OpenStreetMap Wiki
Jump to: navigation, search
Help
Available languages
Deutsch English Français 日本語 Nederlands Русский ‪中文(简体)‬
Quick links
Documentation
Development
Download maps
Mkgmap4.png
Mkgmap-screenshot-6.png
Mkgmap-screenshot-9.png
Warnemünde.png

Ce programme permet de convertir des données OpenStreetMap en cartes qui peuvent être chargées dans un GPS Garmin. Il réalise la conversion en une seule étape sans l'aide d'aucun autre programme.

Le but de ce projet est de récupérer les données de OpenStreetMap et de les placer sur mon Garmin Legend Cx pour m'aider à déterminer ce qui a été fait du reste. De plus, c'est amusant d'utiliser la carte que vous avez créée.

Il nécessite Java, et donc devrait fonctionner partout où JOSM est accessible.

Il a été écrit par Steve Ratcliffe. Les rapports de boggues ou suggestions peuvent être envoyés par courriel à AcousticNewt (en anglais) ou ajouté à la page de discussion.

Contents

Téléchargements

Les téléchargements sont maintenant disponibles en fichiers zip (qui sont plus pratiques sur les machines Windows), ainsi qu'en fichiers tar compressés. Le contenu des archives est identique.

La version stable actuelle est 1188.

Les principaux changements depuis 1067 sont :

Téléchargement

Mkgmap nécessite Java 1.6 (ça marche avec 1.5, mais certainement plus lentement). Si votre système d'exploitation n'a pas déjà java installez-le.

Créer une carte

   wget http://www.informationfreeway.org/api/0.6/*[bbox=-3.5,51.5,-1.0,53.5] -O data.osm

ou

   curl -L "http://www.informationfreeway.org/api/0.6/map?bbox=-3.5,51.5,-1.0,53.5" -o data.osm
   java -jar mkgmap.jar [options] data.osm

Il est possible que le programme plante à un moment donné, particulièrement si vous traitez une grande zone, avec des erreurs Exception in thread "main" java.lang.OutOfMemoryError: Java heap space. Si cela arrive, allouez plus de mémoire à java comme ceci :

   java -Xmx512M -jar mkgmap.jar [options] data.osm

Cela alloue 512 Mo de mémoire physique à java.

Options de la ligne de commande

Pour de grande cartes, vous pouvez souhaiter modifier les détails de la carte par défaut. Voici les options que vous pouvez choisir. Si vous souhaitez modifier plusieurs options, il peut être plus facile de les mettre dans un fichier et l'appeler avec l'option -c.
Pour une liste complète, voir la liste des options.

Utilisation : mkgmap [options...] <file.osm>
Options :

--help=topic
       Affiche l'aide sur le sujet choisi. Si le sujet n'est pas indiqué, 
       une liste de tous les sujets est affichée.
-c filename
       Spécifie un fichier de configuration plutôt que des options en ligne de commande.
       Dans le fichier, chaque ligne est une option sous la forme option=valeur, comme 
       en ligne de commande mais sans le '--' de tête.
-n name
--mapname=name
       Change le nom de la carte. Les cartes Garmin sont un nom de 8 chiffres.
       Le nom par défaut est 63240001. Il vaut mieux changer le nom si vous devez 
       créer plusieurs cartes sans que les noms interfèrent, donnez-leur un nom unique.
NOTE : entrez seulement le nom, sans l'extension .img, cela provoquerait une exception.
--description=text
       Texte descriptif pour la carte. Cela sera affiché dans 
       QLandkarte, MapSource, sur un GPS etc...
--country-name
       Nom du pays de la carte. C'est "UNITED KINGDOM" par défaut.
--country-abbr
       Nom abrégé du pays de la carte. C'est "GBR" par défaut.
--region-name
       Nom de la région de la carte. Par défaut, la carte n'a pas de nom de région.
--region-abbr
       Nom abrégé de la région de la carte. Par défaut, la carte n'a pas de nom de région abrégé.

Options des noms:

--latin1
       Cette option permet l'utilisation de caractères non-ascii dans les noms de rue. 
       Ce qui est réellement supporté dépend de l'appareil. Certains appareils ne supportent
       que les caractères ascii.
       Mkgmap convertit d'une certaine manière les caractères non-affichables
       par défaut (même sans cette option), en convertissant les caractères vers 
       des caractères ascii non-accentués quand c'est possible.
--charset=name
       Utilise le jeu de caractères spécifié.
--code-page=number
       Utilise le code page donné
--lower-case
       Permet l'utilisation de noms en minuscules. Notez que cela ne marche pas
       avec de nombreux (la plupart, tous ?) appareils Garmin. 

Options de style :

Voir aussi la documentation sur les styles personnalisés.

--style=name
       Spécifie un nom de style différent, plutôt que celui par défaut.
--style-file=file
       Spécifie un fichier externe duquel obtenir le style. Le "fichier" peut être
       un dossier ou un fichier zip contenant le style. Cela peut aussi être une URL.
       S'il y a plus d'un style dans le fichier zip, alors l'argument --style doit être
       utilisé pour indiquer le style à choisir.
       Pour des raisons de compatibilité ascendante, vous pouvez aussi fournir un fichier
       map-features.csv. Voir l'aide des styles personnalisés.
--list-styles
       Liste les styles disponibles.
--levels=levels code
       Change la façon dont les niveaux de la carte correspondent aux niveau de zoom 
       sur l'appareil. Voir l'aide des styles personnalisés. Le défaut est l'équivalent de 
       "0=24, 1=22, 2=21, 3=19, 4=18, 5=16", mais cela peut changer.
--name-tag-list
       Spécifie le tag qui sera utilisé pour fournir les noms. C'est utile pour afficher les 
       noms dans une langue précise.
       Vous pouvez indiquer une liste de tags, le premier trouvé sera utilisé.
       (ex. ;--name-tag-list=name:en,int_name,name)
--map-features=file
       Option obsolète. Utilisez plutôt l'option --style-file.

Options de description de produit :

--family-id
       C'est un nombre qui identifie une famille de produits.
--product-id
       C'est un nombre qui identifie un produit au sein d'une famille.
       C'est souvent 1.
--series-name
--family-name
--area-name
--overview-mapname

Options diverses :

--block-size=number
       Change la taille de bloc utilisée pour générer la carte.
       Il n'y a pas de raison générale pour faire cela.
--net
       Crée un fichier supportant l'option lock to road.
--gmapsupp
       Écrit un fichier gmapsupp.img qui peut être envoyé sur un appareil Garmin par USB.
--ignore-osm-bounds
       À la lecture des fichiers OSM, ignore les éléments bounds.
--road-name-pois[=GarminCode]
       Génère un POI pour chaque route nommée. Par défaut, les POI ont le type code 
       Garmin 0x640a. Si souhaité, un code différent peut être spécifié par cette option.
--tdbfile
       Écrit un fichier .tdb
--draw-priority=25
       Quand deux cartes couvrent la même zone, cette option contrôle l'ordre 
       d'affichage. Les fortes priorités s'affichent au-dessus des faibles priorités. 
--transparent
       Rend la carte transparente, cela permet de voir la carte du dessous à travers
       la carte du dessus. Utile pour les courbes de niveau par exemple.
--version
       Affiche la version du programme.

Installation

Problèmes connus

Problèmes connus actuellement.

Recherche de rues

Actuellement nous ne savons pas comment rendre les rues disponibles dans la recherche de rues Garmin. Des méthodes comme rendre chaque rue comme POI ont été proposées (voir la page de discussion).

Ligne de côte

La ligne de côte est visible, mais la mer devrait apparaître comme polygone. (NDT : problème résolu par les différentes variantes de l'option --generate-sea)

Zone trop vaste

Si vous essayez d'utiliser mkgmap sur une zone trop vaste, il ne peut pas la traiter (erreur Area too large). Vous devez partager le fichier OSM original en fichiers plus petits. Voici comment faire :

java -Xmx1000m -jar splitter.jar file.osm
java -Xmx1000m -jar mkgmap.jar -c template.args

Développement

Il y a une page wiki pour le développement, principalement basée sur l'usage OSM.

Il y a aussi une page externe mgkmap.

Licence

Le logiciel est fourni sous licence GPL version 2. Les cartes qu'il produit doivent être fournies selon la licence des données desquelles elles dérivent, dans le cas des données OSM il s'agit de Creative Commons CC-BY-SA 2.0. Il n'y a donc pas de conflit de licence qui pourrait exister avec une autre approche.

GUIs

Il y a actuellement au moins quatre projets donnant une interface graphique (GUI) à mkgmap, de sorte que les utilisateurs puissent cliquer sur des boutons plutôt que de se souvenir de lignes de commande :

Scripts

Pour les utilisateurs de bash : un Script Bash.

Liens

Personal tools
Namespaces
Variants
Actions
site
Toolbox