FR:User:Petrovsk/Mkgmap styles

From OpenStreetMap Wiki
Jump to: navigation, search
Langues disponibles — User:Petrovsk/Mkgmap styles
· Afrikaans · Alemannisch · aragonés · asturianu · azərbaycanca · Bahasa Indonesia · Bahasa Melayu · Bân-lâm-gú · Basa Jawa · Baso Minangkabau · bosanski · brezhoneg · català · čeština · dansk · Deutsch · eesti · English · español · Esperanto · estremeñu · euskara · français · Frysk · Gaeilge · Gàidhlig · galego · Hausa · hrvatski · Igbo · interlingua · Interlingue · isiXhosa · isiZulu · íslenska · italiano · Kiswahili · Kreyòl ayisyen · kréyòl gwadloupéyen · Kurdî · latviešu · Lëtzebuergesch · lietuvių · magyar · Malagasy · Malti · Nederlands · Nedersaksies · norsk bokmål · norsk nynorsk · occitan · Oromoo · oʻzbekcha/ўзбекча · Plattdüütsch · polski · português · português do Brasil · română · shqip · slovenčina · slovenščina · Soomaaliga · suomi · svenska · Tiếng Việt · Türkçe · Vahcuengh · vèneto · Wolof · Yorùbá · Zazaki · српски / srpski · беларуская · български · қазақша · македонски · монгол · русский · тоҷикӣ · українська · Ελληνικά · Հայերեն · ქართული · नेपाली · मराठी · हिन्दी · অসমীয়া · বাংলা · ਪੰਜਾਬੀ · ગુજરાતી · ଓଡ଼ିଆ · தமிழ் · తెలుగు · ಕನ್ನಡ · മലയാളം · සිංහල · ไทย · မြန်မာဘာသာ · ລາວ · ភាសាខ្មែរ · ⵜⴰⵎⴰⵣⵉⵖⵜ · አማርኛ · 한국어 · 日本語 · 中文(简体)‎ · 吴语 · 粵語 · 中文(繁體)‎ · ייִדיש · עברית · اردو · العربية · پښتو · سنڌي · فارسی · ދިވެހިބަސް

Mkgmap crée des cartes Garmin en convertissant les éléments de carte d'OpenStreetMap en éléments de carte Garmin. Cette conversion s'effectue selon une table de correspondance décrite par les styles de mkgmap.

Je désigne par éléments de carte les points, lignes et polygones figurant les points d'intérêt, les routes, limites et utilisations du terrain, bâtiments...

Les éléments Garmin

Garmin et OpenStreetMap n'utilisent évidemment pas la même nomenclature pour les éléments de carte. La version OSM se trouve ici tandis que l'équivalent Garmin peut être trouvé dans le fichier resources/garmin_feature_list.csv de votre installation de mkgmap, ou bien sur le wiki OSM. On y trouve par exemple qu'une autoroute est décrite comme une Major Highway et représentée par le code 0x01. Le rôle de mkgmap est de faire correspondre les tags OSM avec ces codes hexadécimaux par l'intermédiaire des styles. Avant de nous intéresser aux styles, nous devons nous pencher sur la gestion des éléments de carte dans les cartes Garmin.

Résolution et niveaux

  • La résolution (resolution) est le niveau de zoom auquel la carte est affichée. C'est une valeur comprise entre 1 et 24, indépendante de l'appareil ou logiciel affichant la carte.
  • Le niveau (level) est le niveau de détail affiché par la carte, échelonné de 0 à 16.

Ainsi, si les autoroutes apparaissent à faible zoom, il faut zoomer davantage (monter dans les résolutions) pour faire apparaitre les routes moins importantes dans les niveaux suivants. Dans chaque style, le fichier options définit la correspondance entre niveaux et résolutions, de la manière suivante pour le style par défaut (default) :

levels = 0:24, 1:22, 2:20, 3:18, 4:16

Routage

Pour permettre aux algorithmes de routage de choisir un itinéraire, les routes sont accompagnées de classes (road_class) et de vitesses de trafic (road_speed).

  • La classe est un nombre de 0 à 4, jaugeant la facilité de circulation.


Class Used as
4 Major HW/Ramp
3 Principal HW
2 Arterial St / Other HW
1 Roundabout / Collector
0 Residential Street / Unpaved road / Trail


  • Les vitesses de trafic permettent le calcul du temps estimé de trajet et de choisir le trajet le plus rapide. Les vitesses retenues par Garmin sont les suivantes :


road_speed highest speed
7 No speed limit
6 70 mph / 110 kmh
5 60 mph / 90 kmh
4 50 mph / 80 kmh
3 35 mph / 60 kmh
2 25 mph / 40 kmh
1 15 mph / 20 kmh
0 3 mph / 5 kmh


Les styles

Les styles sont l'ensemble de règles permettant la conversion des éléments de carte et tags OSM en éléments Garmin. Le style en lui-même est constitué d'un dossier situé dans le dossier resources/styles de mkgmap comprenant divers fichiers. Les fichiers lines, points, polygons et relations définissent les équivalences des éléments correspondants, le fichier info décrit le style lui-même, options regroupe les réglages des niveaux et les langues à afficher par exemple.
Le style par défaut (default) reproduit la progressivité d'importance des routes alors que le style noname met en avant les routes n'ayant pas de nom, rejetant les routes nommées à un niveau inférieur.

Le style mkgmap par défaut sur un Oregon 300
Le style mkgmap "noname" sur un Oregon 300

La définition complète d'une route dans une carte Garmin comprend le code du type de route, son ordre d'importance, sa vitesse de trafic et le niveau à partir duquel elle apparaît sur la carte :

highway=primary [0x03 road_class=3 road_speed=4 resolution 19]

Il en est de même pour les éléments de carte ponctuels :

amenity=post_office [0x2f05 resolution 20]

Ainsi que les polygones :

landuse=forest [0x50 resolution 18]

La liste complète se trouve sur le wiki OSM, avec des pages sur la personnalisation des styles et les règles de style.

Utilisation d'un style

Par défaut, mkgmap utilise le style default se trouvant dans le dossier mkgmap-r*/resources/styles.
Pour en utiliser un autre présent dans le dossier des styles, comme noname, invoquer mkgmap avec l'option --style=name. Par exemple :

java -jar mkgmap.jar --style=noname data.osm

Il est aussi possible d'utiliser des styles externes, qui ont l'avantage de ne pas risquer d'être effacés lors de la mise à jour de mkgmap. Il faut alors préciser le chemin absolu du dossier du style, ou bien le chemin relatif par rapport au répertoire de travail actuel avec l'option --style-file=file. Le style default sera utilisé, à moins d'utiliser l'option --style=name.

Pour utiliser le style bicycle dans le dossier ~/OSM/styles :

java -jar mkgmap.jar --style-file=~/OSM/styles --style=bicycle data.osm