Tuiles raster, WMTS et WMS
Les couches raster dessinent des images de carte par-dessus le fond de carte : de l'imagerie aérienne, un plan numérisé, un modèle d'inondation, un service de carte publié. Utilisez une couche raster pour un modèle de tuiles, un service WMTS ou un Cloud Optimized GeoTIFF, et une couche WMS pour un Web Map Service. Vous pouvez en avoir jusqu'à cinq de chaque type.
Laquelle utiliser
| Vous avez | Utilisez | À quoi cela ressemble |
|---|---|---|
| Un modèle de tuiles | Couche raster | https://tile.example.com/{z}/{x}/{y}.png |
| Un service WMTS | Couche raster | Le lien GetCapabilities du service |
| Un fichier GeoTIFF sur un serveur web | Couche raster, avec GeoTIFF optimisé pour le cloud (COG) activé | Un lien se terminant par .tif ou .tiff |
| Un service WMS | Couche WMS | https://example.com/geoserver/wms |
Tous les liens doivent commencer par https://.
Ajouter une couche raster
- 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, puis la vignette Tuiles et imagerie.
- Collez un modèle de tuiles, un lien GetCapabilities WMTS ou un lien GeoTIFF, et sélectionnez Vérifier.
- Lisez le résultat. Un modèle de tuiles est testé en chargeant une tuile. Un lien WMTS indique la couche qui sera dessinée. Un lien GeoTIFF est reconnu à son extension de fichier.
- Réglez la transparence sous Style et options, sélectionnez Ajouter à la carte, puis Appliquer les modifications.
Pour certains serveurs de tuiles, la vérification ne peut pas lire la tuile de test alors que la carte peut dessiner la couche. L'assistant le signale et vous laisse ajouter la couche quand même.
Pour faire de même dans le volet Format :
- Ouvrez Couches de référence > Sélection de couche et activez Couche raster / WMTS.
- Dans Raster / WMTS - Configuration, collez le lien dans Modèle de tuiles ou lien WMTS.
- Pour un lien GeoTIFF, activez GeoTIFF optimisé pour le cloud (COG).
Services WMTS
Collez le lien GetCapabilities du service. La carte lit les capacités et dessine les tuiles du service dans le schéma de tuiles Web Mercator (GoogleMapsCompatible, EPSG:3857). Une note sous le lien nomme la couche dessinée.
Une couche WMTS qui n'est pas publiée en Web Mercator ne peut pas être dessinée. La carte vous le signale le cas échéant.
Serveurs qui bloquent Power BI
Si la vérification signale « Ce serveur n'autorise pas Power BI à le lire », cochez Le lire via le proxy CORS Icon Map (seulement pour des serveurs de confiance). Dans le volet Format, il s'agit du commutateur Utiliser le proxy si nécessaire, qui apparaît une fois que la carte a constaté que le serveur bloque Power BI. Le serveur est toujours essayé directement en premier. Consultez Clés API, authentification et proxy.
Davantage de couches raster
Réglez Nombre de couches supplémentaires (0 à 4). Un groupe Couche raster supplémentaire apparaît avec les mêmes paramètres. Choisissez la couche supplémentaire qu'il affiche dans Appliquer les paramètres à.
Paramètres raster
Volet Format > Couches de référence > Raster / WMTS - Configuration
| Paramètre | Rôle | Valeur par défaut |
|---|---|---|
| Modèle de tuiles ou lien WMTS | Un modèle de tuiles {z}/{x}/{y}, ou un lien de service WMTS. Accepte la mise en forme conditionnelle (fx) |
Vide |
| Utiliser le proxy si nécessaire | Lit les tuiles via le proxy Icon Map quand leur serveur bloque Power BI. Affiché une fois qu'un blocage a été constaté | Désactivé |
| Paramètre | Rôle | Valeur par défaut |
|---|---|---|
| Taille des tuiles | La taille des tuiles du serveur en pixels, de 256 à 4096 | 256 |
| GeoTIFF optimisé pour le cloud (COG) | À activer quand le lien est un fichier GeoTIFF | Désactivé |
| Transparence | 0 est opaque, 100 est invisible | 20 pour la première couche, 0 pour les couches supplémentaires |
| Zoom min | La couche est masquée quand la carte est dézoomée au-delà de ce niveau | 0 |
| Zoom max | La couche est masquée quand la carte est zoomée au-delà de ce niveau | 22 pour la première couche, 24 pour les couches supplémentaires |
| Visible | Affiche ou masque la couche. Accepte la mise en forme conditionnelle (fx) | Oui |
| Z-Index | Ordre de dessin, de 0 à 1000. Une valeur plus élevée est plus près de l'observateur | 354 pour la première couche, 344 pour les couches supplémentaires |
| Nombre de couches supplémentaires | Le nombre de couches raster supplémentaires de la carte, de 0 à 4 | 0 |
Ajouter une couche WMS
Un serveur WMS dessine des images de carte à la demande. Le serveur doit utiliser une adresse https:// et doit pouvoir servir la couche en Web Mercator (EPSG:3857).
- Dans le Gestionnaire de couches, sélectionnez Ajouter une couche, puis Couche de référence, puis la vignette WMS.
- Collez l'adresse du service WMS et sélectionnez Vérifier. L'assistant lit le service et indique combien de couches il propose.
- Sous Détails, choisissez la Couche à dessiner. La liste peut inclure la couche de groupe du service ainsi que ses couches individuelles.
- Sélectionnez Ajouter à la carte, puis Appliquer les modifications.
L'authentification, les filtres, les styles, les paramètres personnalisés et le proxy se règlent dans le volet Format. Si le service en a besoin, configurez-le dans le volet Format comme décrit ci-dessous.
Pour ajouter une couche WMS dans le volet Format :
- Dans le volet Format, ouvrez Couches de référence > Sélection de couche et activez Couche WMS.
- Dans WMS - Configuration, collez l'adresse du service dans URL du serveur WMS. L'adresse simple et son lien GetCapabilities fonctionnent tous deux.
- Si le service nécessite une connexion, réglez Type d'authentification et renseignez ses champs. Consultez Authentification WMS.
- Choisissez la couche dans Couche. La liste est lue depuis le service.
- Choisissez le Format d'image. Utilisez un format qui prend en charge la transparence, comme image/png, sauf si la couche est destinée à recouvrir le fond de carte.
Tant que Configuration manuelle est désactivé, la carte demande au serveur WMS sa liste de couches pendant que vous modifiez le rapport. Une fois que la couche fonctionne, activez Configuration manuelle. La couche et le format que vous avez choisis sont conservés sous forme de texte et les requêtes supplémentaires cessent.
Si la liste des couches ne peut pas être lue
Si le volet affiche « Unable to read layers from WMS server. », la carte n'a pas pu lire les capacités du service. Vérifiez d'abord l'adresse et l'authentification. Ensuite :
- Si le serveur n'autorise pas Power BI à le lire (CORS), activez Utiliser le proxy CORS. Les requêtes passent alors par le proxy Icon Map, qui nécessite une clé de licence Icon Map et peut consommer des crédits d'utilisation supplémentaires. Le proxy n'est pas utilisé quand Environnement isolé est activé. Consultez Clés API, authentification et proxy.
- Si le serveur dessine des cartes mais ne publie pas ses capacités, activez Configuration manuelle et saisissez vous-même le nom de la Couche et le Format (par exemple
image/png).
Filtrer une couche WMS
- Filtre CQL (facultatif) envoie un filtre CQL avec chaque requête, pour les serveurs qui le prennent en charge, comme GeoServer. Il accepte la mise en forme conditionnelle (fx) : une mesure peut donc filtrer la couche selon la sélection actuelle.
- Nom du paramètre personnalisé (facultatif) et Valeur du paramètre personnalisé (facultatif) ajoutent un paramètre de votre choix à chaque requête. La valeur accepte la mise en forme conditionnelle (fx).
- Pour un service ArcGIS, réglez Type d'authentification sur ArcGIS. Filtre de requête (facultatif pour les sources d'images) et Filtre LayerDefs (facultatif) remplacent alors le filtre CQL.
Davantage de couches WMS
Réglez Nombre de couches supplémentaires (0 à 4). Un groupe Couche WMS supplémentaire apparaît. Choisissez la couche supplémentaire qu'il affiche dans Appliquer les paramètres à.
Les couches supplémentaires se configurent toujours à la main : saisissez le nom de la Couche et le Format sous forme de texte. Pour trouver les noms, configurez le service comme première couche WMS et lisez-les dans sa liste Couche.
Authentification WMS
Réglez Type d'authentification sur chaque couche WMS.
| Type d'authentification | À utiliser pour | Champs |
|---|---|---|
| Aucun | Les services publics | |
| ArcGIS | Les services WMS hébergés dans ArcGIS. Vos informations d'identification ArcGIS sont ajoutées à chaque requête. Configurez-les d'abord : consultez Se connecter à ArcGIS | Filtre de requête (facultatif pour les sources d'images), Filtre LayerDefs (facultatif) |
| Basique (nom d'utilisateur et mot de passe) | Les serveurs qui utilisent l'authentification de base | Nom d'utilisateur, Mot de passe |
| Jeton / clé API dans l'URL | Les serveurs qui acceptent une clé comme paramètre de l'adresse | Nom de la propriété d'authentification (ex. apikey ou token), Valeur de la propriété d'authentification |
| Jeton / clé API dans l'en-tête | Les serveurs qui acceptent une clé comme en-tête de requête | Nom de la propriété d'authentification (ex. apikey ou token), Valeur de la propriété d'authentification |
| OAuth 2.0 | Les serveurs qui délivrent un jeton pour un ID client et un secret | URL OAuth2, ID client OAuth2, Secret client OAuth2, Étendue OAuth2 (facultatif), Nom de l'en-tête supplémentaire (ex. apikey ou token), Valeur de l'en-tête supplémentaire |
Pour une clé dans l'URL, retirez la clé de l'adresse. Si l'adresse d'exemple du service est https://example.com/wms?request=GetCapabilities&apikey=abc123, saisissez l'adresse sans &apikey=abc123 dans URL du serveur WMS, apikey comme nom de propriété et abc123 comme valeur de propriété.
Les mots de passe et les secrets client sont stockés chiffrés dans le rapport et sont affichés sous forme de points une fois saisis.
OAuth 2.0 récupère le jeton via le proxy Icon Map : une clé de licence Icon Map est donc nécessaire.
Des informations d'identification enregistrées dans un rapport sont utilisées pour toute personne qui ouvre le rapport. Utilisez un compte ou une clé qui n'a accès qu'à ce que le rapport doit afficher.
Paramètres WMS
Volet Format > Couches de référence > WMS - Configuration
| Paramètre | Rôle | Valeur par défaut |
|---|---|---|
| URL du serveur WMS | L'adresse du service WMS. Accepte la mise en forme conditionnelle (fx) quand Configuration manuelle est activé | Vide |
| Utiliser le proxy CORS | Envoie les requêtes de la couche via le proxy Icon Map, pour les serveurs qui n'autorisent pas Power BI à les lire | Désactivé |
| Type d'authentification | Comment la carte se connecte au serveur. Voir le tableau ci-dessus | Aucun |
| Filtre CQL (facultatif) | Un filtre CQL envoyé avec chaque requête. Accepte la mise en forme conditionnelle (fx). Non affiché pour l'authentification ArcGIS | Vide |
| Nom du paramètre personnalisé (facultatif), Valeur du paramètre personnalisé (facultatif) | Un paramètre de requête supplémentaire. La valeur accepte la mise en forme conditionnelle (fx) | Vide |
| Configuration manuelle | Activé : vous saisissez la couche, le format et le style. Désactivé : la couche et le format sont choisis dans des listes lues depuis le serveur | Désactivé |
| Couche | La couche à dessiner. En mode manuel, elle accepte la mise en forme conditionnelle (fx) | Vide |
| Format | Le format d'image : image/png, image/jpeg, image/svg+xml ou image/vnd.jpeg-png, quand le serveur les propose | image/png |
| Style (facultatif) | Un style nommé que le serveur propose pour la couche. Accepte la mise en forme conditionnelle (fx). Sur la première couche, il est affiché quand Configuration manuelle est activé | Vide |
| Transparence | 0 est opaque, 100 est invisible | 10 pour la première couche, 0 pour les couches supplémentaires |
| Zoom minimal | La couche est masquée quand la carte est dézoomée au-delà de ce niveau | 0 |
| Zoom maximal | La couche est masquée quand la carte est zoomée au-delà de ce niveau | 24 |
| Z-Index | Ordre de dessin, de 0 à 1000. Une valeur plus élevée est plus près de l'observateur | 255 pour la première couche, 344 pour les couches supplémentaires |
| Visible | Affiche ou masque la couche. Accepte la mise en forme conditionnelle (fx) | Oui |
| Nombre de couches supplémentaires | Le nombre de couches WMS supplémentaires de la carte, de 0 à 4 | 0 |
Légendes WMS
Nouveau dans la version 1.1.0.11
Chaque couche WMS peut afficher l'image de légende que son serveur publie. Activez la légende dans la carte Légende, puis utilisez Couche WMS {n} dans la légende et Titre - Couche WMS {n} sous Libellés de la légende pour inclure et nommer chaque couche. Une image de légende est affichée pour les couches dont le Type d'authentification est réglé sur Aucun ou Jeton / clé API dans l'URL. Consultez Légende.
Dans le Gestionnaire de couches
Sélectionnez une couche raster ou WMS dans le Gestionnaire de couches pour modifier ses principaux paramètres.
| Couche | Paramètres |
|---|---|
| Tuiles et imagerie | Modèle de tuiles ou lien WMTS, Cloud Optimized GeoTIFF, Taille des tuiles, Visible, Transparence, Visible au zoom |
| WMS | Adresse du service WMS, Couche, Format d'image, Visible, Transparence, Visible au zoom |
Remplacer le lien ou le fichier remplace la source et conserve la place et le style de la couche. Pour une couche WMS, c'est aussi le moyen de choisir une autre couche dans la liste du service.
Conseils et limites
- Les couches WMS sont demandées en Web Mercator (EPSG:3857). Un serveur qui ne peut pas servir cette projection ne peut pas être dessiné.
- La version WMS est tirée d'un paramètre
version=dans l'adresse que vous collez. En son absence, la version 1.1.1 est utilisée. - Les paramètres d'une adresse WMS collée qui ne font pas partie de la requête standard, comme un nom de carte ou d'espace de travail, sont conservés et envoyés avec chaque requête.
- Les couches raster et WMS sont des images. Elles n'ont pas d'info-bulles et ne peuvent pas être sélectionnées.
Voir aussi
- Vue d'ensemble des couches de référence
- Couches ArcGIS
- Autres fournisseurs de fonds de carte - utilisez plutôt un serveur de tuiles ou un service WMS comme fond de carte
- Clés API, authentification et proxy