Vue d'ensemble des couches de référence
Les couches de référence donnent du contexte à vos données : des limites issues d'un fichier, de l'imagerie d'un serveur de tuiles, une couche d'ArcGIS ou d'un service WMS, un style de tuiles vectorielles, des noms de lieux ou la limite entre le jour et la nuit. Elles sont dessinées telles qu'elles sont publiées et ne proviennent pas de votre modèle de données.

Couches de référence et couches de données
Une carte Icon Map Slicer se compose d'un fond de carte, de couches de données et de couches de référence.
| Couches de données | Couches de référence | |
|---|---|---|
| D'où vient le contenu | Les lignes de votre rapport, via les puits de champs | Un fichier, un lien ou un service que vous indiquez à la carte |
| Ce que fait une ligne | Une ligne dessine un élément | Aucune ligne n'est nécessaire. Une couche de référence se dessine sans aucun champ |
| Clic et sélection | Sélectionne la ligne et filtre la page de rapport | Pas de sélection au clic. Les polygones d'une couche de fichier peuvent sélectionner les données qu'ils contiennent, voir ci-dessous. Le survol peut afficher une info-bulle |
| Style piloté par les données | Mise en forme conditionnelle (fx) sur la plupart des paramètres | Style fixe, ou style selon une propriété contenue dans le fichier ou le service |
Une couche de référence n'est pas jointe à vos données, mais vos données peuvent tout de même la contrôler. Plusieurs paramètres acceptent la mise en forme conditionnelle (fx) : une mesure ou un segment peut donc décider de ce qui est dessiné :
- Visible, sur les couches de fichier, raster et WMS, affiche ou masque la couche.
- Valeur de filtre, sur une couche de fichier, ne conserve que les entités dont la propriété correspond à vos données. Consultez Fichiers et flux.
- Valeur de filtre, sur la couche Tuiles vectorielles, fait de même pour un style de tuiles vectorielles. Consultez Tuiles vectorielles sur le fond de carte.
- Filtre CQL (facultatif), sur une couche WMS, filtre le service.
- Le lien lui-même peut provenir d'une mesure sur la plupart des types de couche.
Les couches ArcGIS ont aussi Visible, et Clause SQL WHERE filtre une couche d'entités ArcGIS.
Si vous voulez des formes colorées par vos données et qui filtrent la page de rapport quand on clique dessus, utilisez plutôt une couche de données : Formes depuis des fichiers, Tuiles vectorielles ou Couches du catalogue Icon Map.
Les couches d'entités ArcGIS peuvent aussi être liées à vos données : consultez Couches ArcGIS liées aux données.
Sélectionner des données avec un fichier de limites
Les polygones d'une couche de fichier peuvent servir de zones de sélection. Activez Utiliser les polygones pour la sélection pour la couche : un clic sur l'un de ses polygones sélectionne alors tous les éléments de données qu'il contient, ce qui filtre la page de rapport. Consultez Fichiers et flux et Sélectionner tout ce qui se trouve dans une forme.
Types de couche de référence
La carte Couches de référence comporte un groupe pour chaque type. Chaque groupe a son propre commutateur dans son en-tête.
| Type | Groupe dans le volet Format | Ce qu'elle dessine | Combien |
|---|---|---|---|
| Fichiers et flux | GeoJSON / Shape / KML | Des points, des lignes et des polygones issus d'un lien ou d'un fichier chargé | 5 |
| Tuiles raster | Tuiles raster | De l'imagerie ou une carte tuilée issue d'un modèle de tuiles ou d'un Cloud Optimized GeoTIFF | 5 |
| WMS | OGC WMS | Des images de carte issues d'un Web Map Service | 5 |
| Tuiles vectorielles | Tuiles vectorielles | Les couches d'un style MapLibre, fusionnées sur le fond de carte | 1 |
| Catalogue Icon Map | Carte Catalogue | Des limites et des lieux prêts à l'emploi | 20, partagés avec les couches de catalogue liées aux données |
| Jour et nuit | Terminateur jour-nuit | Un ombrage sur la partie du monde plongée dans l'obscurité | 1 |
| Étiquettes de carte | Étiquettes de la carte | Des noms de lieux dessinés au-dessus de vos données | 1 |
Les couches de fichier lisent aussi les liens KMZ, CSV et WFS, et les couches raster lisent aussi les services WMTS.
| Type | Groupe dans le volet Format | Ce qu'elle dessine | Combien |
|---|---|---|---|
| ArcGIS | Couche ArcGIS - Paramétrage | Une couche d'entités, un service de carte, d'imagerie ou de tuiles vectorielles, ou une carte web entière | 5 |
Les couches de fichier peuvent aussi porter leurs propres étiquettes de texte. Consultez Étiquettes des couches de référence.
Ajouter une couche de référence
Le moyen le plus rapide est le Gestionnaire de couches.
- Dans le volet Format, ouvrez la carte Gestionnaire de couches et activez Ouvrir le Gestionnaire de couches.
- Sélectionnez Ajouter une couche, puis Couche de référence.
- Choisissez une vignette : Fichiers et flux, Tuiles et imagerie, WMS, ArcGIS, Catalogue Icon Map, Étiquettes de carte ou Jour et nuit. Chaque vignette indique combien de couches de ce type sont utilisées.
- Suivez les étapes. Pour un lien, sélectionnez Vérifier pour que le lien soit lu et décrit avant l'ajout de la couche.
- Sélectionnez Ajouter à la carte, puis Appliquer les modifications.

La procédure complète figure dans Ajouter une couche.
La couche Tuiles vectorielles ne figure pas dans le sélecteur. Ajoutez-la dans le volet Format.
Toutes les couches de référence peuvent aussi être configurées dans le volet Format, et certains paramètres ne se trouvent que là : la mise en forme conditionnelle (fx), les filtres, l'authentification WMS et les valeurs de Z-Index. Ouvrez Volet Format > Couches de référence et activez le groupe du type voulu. Ses paramètres apparaissent en dessous, ainsi qu'un groupe de configuration par couche pour les fichiers.
Quelques paramètres ne se trouvent que dans le Gestionnaire de couches : le type d'entité WFS, l'intervalle d'actualisation d'un lien de fichier et le proxy des couches de fichier et raster. Le volet Format n'a pas de commutateur pour eux.
Plusieurs couches d'un même type
Les couches de fichier, WMS et raster disposent chacune de cinq emplacements. Le volet Format affiche les paramètres d'un emplacement à la fois.
- Fichiers : réglez Nombre de couches (1 à 5), puis choisissez la couche à modifier dans Appliquer les paramètres à.
- Couches WMS et raster : la première couche se règle dans le groupe lui-même. Réglez Nombre de couches supplémentaires (0 à 4), puis choisissez la couche supplémentaire à modifier dans Appliquer les paramètres à.
Les couches ArcGIS fonctionnent comme les fichiers : Nombre de couches et Appliquer les paramètres à se trouvent dans Couche ArcGIS - Paramétrage.
Ordre de dessin
Chaque couche de la carte, de référence ou de données, a un Z-Index (Z-Index dans le volet Format). Une couche dont le Z-Index est plus élevé est dessinée plus près de l'observateur. Les couches de référence et les couches de données partagent une même échelle : une couche de référence peut donc se trouver sous vos données, entre deux couches de données ou au-dessus de tout.
| Couche | Z-Index par défaut |
|---|---|
| Terminateur jour-nuit | 450 |
| Étiquettes de carte | 440 |
| Étiquettes d'une couche de fichier | 370 |
| Couches de fichier | 365 |
| Tuiles vectorielles | 355 |
| Couche raster 1 | 354 |
| Couches raster et WMS supplémentaires | 344 |
| Couche WMS 1 | 255 |
Les couches ArcGIS sont à 345 par défaut.
À titre de comparaison, les cercles sont à 405 par défaut, les images à 410 et les étiquettes de données à 950. Les valeurs par défaut placent l'imagerie et les limites sous vos données et les noms de lieux au-dessus.
Pour changer l'ordre, modifiez le Z-Index d'une couche dans son groupe du volet Format. Les valeurs vont de 0 à 1000.
Dans le Gestionnaire de couches, vous n'avez pas besoin des nombres. La liste affiche toutes les couches activées, la plus haute en premier. Faites glisser une ligne, ou utilisez Monter et Descendre, et les valeurs de Z-Index sont réécrites pour vous. Consultez Modifier, réordonner et retirer des couches.
Plage de zoom et visibilité
Les couches de fichier, raster et WMS, ainsi que les étiquettes de carte, ont chacune un zoom minimal et un zoom maximal. En dehors de cette plage, la couche n'est pas dessinée. Utilisez cette possibilité pour n'afficher des limites détaillées que lorsque le lecteur a zoomé.
Les couches de fichier, raster et WMS ont un paramètre Visible qui accepte la mise en forme conditionnelle (fx). Renvoyez « Yes » ou « No » depuis une mesure pour n'afficher une couche que pour un choix de segment ou un signet.
Les couches ArcGIS ont aussi les deux.
Légende
Les couches de fichier apparaissent dans la légende et dans le contrôle des couches, sous leur titre, leur nom de fichier ou « Couche de référence n ». Activez les entrées et nommez-les sous Volet Format > Légende > Libellés de la légende, avec Couche de référence {n} dans la légende et Titre - Couche de référence {n}.
Les couches de référence ArcGIS apparaissent aussi, chacune avec sa propre légende ArcGIS, nommées avec Couche ArcGIS {n} dans la légende et Titre - Couche ArcGIS {n}. Consultez Légende.
Les couches de référence WMS, raster et de tuiles vectorielles n'ont pas d'entrée dans la légende.
Conseils et limites
- Un clic sur une entité de référence ne la sélectionne pas et ne filtre pas la page de rapport. L'exception est une couche de fichier pour laquelle Utiliser les polygones pour la sélection est activé : elle sélectionne les données situées dans le polygone sur lequel vous cliquez.
- Les liens doivent commencer par
https://. - Une couche lue depuis un lien est lue par le navigateur de la personne qui consulte le rapport. Le serveur doit autoriser les requêtes provenant de Power BI (CORS).
- Les fichiers chargés sont stockés dans le rapport : ils fonctionnent donc partout où le rapport fonctionne.
Serveurs qui bloquent Power BI
Certains serveurs n'autorisent pas un visuel Power BI à les lire.
Le proxy Icon Map peut récupérer certaines couches pour le compte de la carte. Il nécessite une clé de licence Icon Map, et les requêtes passant par le proxy peuvent consommer des crédits d'utilisation supplémentaires. Il n'est pas utilisé quand Environnement isolé est activé ou que votre licence l'exclut, et le Gestionnaire de couches masque alors sa case à cocher et son commutateur de proxy.
| Couche | Comment utiliser le proxy |
|---|---|
| Fichiers et flux | Dans le Gestionnaire de couches. Quand la vérification du lien signale que le serveur n'autorise pas Power BI à le lire, cochez Le lire via le proxy CORS Icon Map (seulement pour des serveurs de confiance). Plus tard, modifiez Utiliser le proxy si nécessaire dans l'éditeur de la couche |
| Tuiles raster et WMTS | La même case à cocher et le même commutateur, dans le Gestionnaire de couches |
| ArcGIS | Utiliser le proxy si nécessaire sur la carte Authentification ArcGIS |
| WMS, tuiles vectorielles | Pas de proxy. Le serveur doit autoriser Power BI |
Chaque serveur est d'abord essayé directement, et seul un serveur qui bloque Power BI est lu via le proxy. Pour savoir ce que le proxy envoie, consultez Connexion ArcGIS et proxy.