Niveaux de zoom et EndLevel¶

Le format Garmin IMG organise les données cartographiques en niveaux de zoom. Chaque niveau correspond a une résolution de coordonnées et détermine quelles features sont visibles quand l'utilisateur zoome ou dézoome sur son GPS. Bien configurer les niveaux est essentiel pour obtenir une carte performante et lisible.

Concepts clés¶

Résolution (bits)¶

La résolution d'un niveau est exprimée en bits (1 à 24). Plus la valeur est élevée, plus le niveau est détaillé :

Niveaux (levels)¶

Les niveaux sont numérotés à partir de 0 (le plus détaillé). Chaque niveau est associé à une résolution :

--levels "24,20,16"

Crée 3 niveaux :

EndLevel (dans le fichier .mp)¶

Chaque feature (route, bâtiment, contour...) porte un attribut EndLevel qui définit jusqu'à quel niveau elle reste visible :

[POLYLINE]
Type=0x01
EndLevel=2
Data0=(45.18,5.16),(45.19,5.17)
[END]

La règle est simple : une feature avec EndLevel=N est visible aux niveaux 0 à N.

Correspondance EndLevel / Levels¶

Avec --levels "24,20,16" (3 niveaux)¶

Avec --levels "24,22,20,18,16" (5 niveaux)¶

Recommandations¶

Nombre de niveaux¶

EndLevel par catégorie de feature¶

Le tableau ci-dessous propose des valeurs d'EndLevel optimisées pour une configuration à 3 niveaux (--levels "24,20,16") :

Cohérence Levels du header MP et --levels¶

Les fichiers .mp générés par mpforge contiennent un header avec les niveaux de zoom :

[IMG ID]
Levels=2
Level0=24
Level1=18
[END]

L'option --levels d'imgforge remplace ces valeurs. Il est recommandé de maintenir la cohérence :

• Si le header déclare Levels=2 avec Level0=24, Level1=18, utilisez --levels "24,18" ou --levels "24,20,16" avec des EndLevel adaptés
• Les EndLevel dans les features ne doivent jamais dépasser le nombre de niveaux - 1. Un EndLevel=7 avec seulement 3 niveaux n'a pas plus d'effet qu'un EndLevel=2
• Si vous changez le nombre de niveaux, réajustez les EndLevel dans les règles de transformation

Exemple complet¶

Configuration 3 niveaux optimisée pour la BD TOPO¶

Règles mpforge (dans garmin-rules.yaml) :

# Autoroutes : visibles à tous les zooms
- match:
    CL_ADMIN: "Autoroute"
  set:
    Type: "0x01"
    EndLevel: "2"    # niveaux 0, 1, 2

# Sentiers : détail uniquement
- match:
    NATURE: "Sentier"
  set:
    Type: "0x16"
    EndLevel: "0"    # niveau 0 uniquement

# Contours maîtres : zoom moyen
- match:
    IMPORTANCE: "1"
  set:
    Type: "0x22"
    EndLevel: "1"    # niveaux 0, 1

Compilation imgforge :

imgforge build tiles/ \
    --levels "24,20,16" \
    --output gmapsupp.img \
    --jobs 8

Multi-Data : coupler niveau ↔ bucket¶

Une feature peut porter plusieurs géométries (Data0= très détaillée, Data2= simplifiée pour zoom moyen, etc.). imgforge sélectionne le bucket approprié au moment du rendu. L'indice n d'un LevelSpec dans generalize-profiles.yaml correspond directement à l'index dans MpHeader.levels :

Contrainte fail-fast : max(n) sur tous les profils doit être < header.levels.len() — sinon imgforge drop silencieusement les buckets hors plage. mpforge valide au load_config et échoue avec un message explicite.

Voir mpforge — profils multi-niveaux et Étape 2 — Profils multi-niveaux.

Estimation de l'impact sur la taille¶

Pour un département montagneux (Isère, 169 tuiles) :