DéveloppeurGéoplateformeTutorielIndex des tutoriels
Configuration de la diffusion de données vecteur en WMS

Alimentation et diffusion simple vecteur

Modifié le

Téléversement de fichiers vecteur, intégration en base de données, diffusion en WMS et WFS

Configuration de la diffusion de données vecteur en WMS

Configuration de la diffusion #

Contrairement au WFS, une configuration WMS va définir une seule couche finale. Il est possible d’utiliser plusieurs tables, mais seul l’agrégat sera consultable, avec les styles définis.

La création de la configuration WMS va permettre de vérifier de nombreuses informations :

  • nom de couche déjà pris (il doit y avoir unicité sur toutes les configurations WMS Vecteur de la plateforme)
  • table absente de la donnée stockée
  • style ou FTL exploitant des attributs absents de la table utilisée

https://data.geopf.fr/api/datastores/{datastore}/configurations

{
    "type": "WMS-VECTOR",
    "name": "Écorégions et frontières des pays",
    "layer_name": "ecoregions_tutoriel",
    "type_infos": {
        "title": "Mes écorégions",
        "abstract": "Grandes régions naturelles mondiales",
        "keywords": ["Tutoriel", "Données mondiales"],
        "bbox": {
            "west": -175,
            "south": -75,
            "east": 175,
            "north": 85
        },
        "used_data": [
            {
                "relations": [
                    {
                        "name": "pays",
                        "style": "{sld pays}",
                        "ftl": "{ftl pays}"
                    },
                    {
                        "name": "ecoregions",
                        "style": "{sld ecoregions}",
                        "ftl": "{ftl ecoregions}"
                    }
                ],
                "stored_data": "{stored data}"
            }
        ]
    }
}

Description des paramètres en entrée :

  • type : La valeur est contrainte par une liste de valeurs définies à tout moment dans le swagger. WMS-V pour une publication WMS à partir de données vecteur. La définition de cette valeur est sensible à la casse.
  • name : Permet de nommer cette configuration. Cette information n’est lisible que par un autre utilisateur membre de cet entrepôt, pas par l’utilisateur final. Vous êtes donc invité à renseigner ici des informations parlantes pour vous - producteur de donnée. Cette information est modifiable après coup.
  • layer_name : Définit le nom technique par lequel le flux sera rendu disponible au sein du webservice. Cette information est visible de l’utilisateur final.
  • type_infos : L’essentiel des spécificités de la configuration liées à vos données est à retrouver ici :
    • title : C’est le titre en texte libre (accents, espaces, minuscules et majuscules autorisés) de votre service web. Cette information est visible de l’utilisateur final.
    • abstract : Présente une courte description informative en toutes lettres de la couche publiée (ou du lot de couche publié). Cette information est visible de l’utilisateur final.
    • keywords : Il s’agit d’une liste de mots clés, chaque mot ou expression clé étant placée entre doubles quotes, pour permettre à un utilisateur de retrouver plus facilement une donnée. Cette information est visible de l’utilisateur final.
    • bbox : Permet de forcer une bbox lors de la publication. Les valeurs de coordonnées sont systématiquement à renseigner en EPSG:4326.

      L’élément bbox est optionnel, s’il n’est pas mentionné dans la configuration, le système calcule automatiquement l’emprise du service publié à partir de l’emprise de la stored_data renseignée plus bas.

    • used_data : Permet de définir, au sein d’une stored_data placée comme dernier paramètre de l’élément, les couches de données qui seront publiées. Ainsi une offre WMS peut permettre de publier plusieurs couches de données unitaires :
      • relations : Il s’agit de la liste des couches à publier. Pour chacune on retrouve la possibilité de définir 4 éléments :
        • name : C’est le nom technique de la couche tel qu’il est défini dans la stored_data.
        • sld : C’est l’identifiant entrepôt (_id) du fichier de style SLD chargé à l’étape précédente. Cette information est optionnelle. Si un tel fichier n’est mentionné, la couche sera rendue en bleu, style par défaut, sans que l’utilisateur final puisse influer sur le rendu.
        • ftl : C’est l’identifiant entrepôt (_id) du fichier de présentation des attributs FTL chargé à l’étape précédente. Cette information est optionnelle. Si un tel fichier n’est mentionné, l’ensemble des attributs est présenté par l’opération getFeatureInfo du WMS.
      • stored_data : Il s’agit ici de l’identifiant entrepôt de la stored_data qui va être publiée

Une configuration WMS-VECTOR donnera une unique couche. Même si elle utilise plusieurs tables, ces dernières ne seront pas consultables individuellement en WMS. Si c’est votre besoin, faites une configuration (et donc une couche) par table.

Dans le cas où vous souhaitez bien déclarer plusieurs tables dans votre WMS, pensez à régler correctement l’ordre des couches dans l’élément JSON used_data.relations : la première couche lisible sera au-dessus, la dernière tout en dessous.

Envoi sur les services de diffusion #

Comme pour le WFS, seule la création d’une offre sur un point d’accès (publication) permet d’envoyer les informations de configuration aux serveurs de diffusion.

Consultation des points de diffusion disponibles #

https://data.geopf.fr/api/datastores/{datastore}

[
    {
        "name": "Service de diffusion WFS principal",
        "technical_name": "gpf-geoserver-wfs",
        "type": "WFS",
        "urls": [
            {
                "type": "WFS",
                "url": "https://data.geopf.fr/wfs/geoserver/ows"
            }
        ],
        "_id": "ae012611-13eb-4a18-8d04-9b7604a031cc",
        "open": true,
        "metadata_fi": "gpf-geoserver-wfs"
    },
    {
        "name": "Service de diffusion WMTS/TMS principal",
        "technical_name": "gpf-rok4-server-wmts-tms",
        "type": "WMTS-TMS",
        "urls": [
            {
                "type": "WMTS",
                "url": "https://data.geopf.fr/wmts"
            },
            {
                "type": "TMS",
                "url": "https://data.geopf.fr/tms/"
            }
        ],
        "_id": "ae032611-13eb-4a18-8d04-9b7604a031cc",
        "open": true,
        "metadata_fi": "gpf-rok4-server-wmts-tms"
    },
    {
        "name": "Service de diffusion WMS Raster principal",
        "technical_name": "gpf-rok4-server-wms-r",
        "type": "WMS-RASTER",
        "urls": [
            {
                "type": "WMS",
                "url": "https://data.geopf.fr/wms-r/wms"
            }
        ],
        "_id": "ae042611-13eb-4a18-8d04-9b7604a031cc",
        "open": true,
        "metadata_fi": "gpf-rok4-server-wms-r"
    },
    {
        "name": "Service de diffusion WMS Vecteur principal",
        "technical_name": "gpf-geoserver-wms-v",
        "type": "WMS-VECTOR",
        "urls": [
            {
                "type": "WMS",
                "url": "https://data.geopf.fr/wms-v/geoserver/ows"
            }
        ],
        "_id": "ae022611-13eb-4a18-8d04-9b7604a031cc",
        "open": true,
        "metadata_fi": "gpf-geoserver-wms-v"
    },
    {
        "name": "Service de Téléchargement principal",
        "technical_name": "gpf-download",
        "type": "DOWNLOAD",
        "urls": [
            {
                "type": "DOWNLOAD",
                "url": "https://data.geopf.fr/telechargement/"
            }
        ],
        "_id": "ae052611-13eb-4a18-8d04-9b7604a031cc",
        "open": true,
        "metadata_fi": "gpf-download"
    },
    {
        "name": "Service de diffusion CSW",
        "technical_name": "gpf-geonetwork",
        "type": "METADATA",
        "urls": [
            {
                "type": "METADATA",
                "url": "https://data.geopf.fr/csw"
            }
        ],
        "_id": "ae062611-13eb-4a18-8d04-9b7604a031cc",
        "open": true,
        "metadata_fi": "gpf-geonetwork"
    },
    {
        "name": "Service de téléchargement private",
        "technical_name": "gpf-download-private",
        "type": "DOWNLOAD",
        "urls": [
            {
                "type": "DOWNLOAD",
                "url": "https://data.geopf.fr/private/telechargement/"
            }
        ],
        "_id": "b5bf7ab2-8998-4829-8c80-cd2ec02e6e58",
        "open": false,
        "metadata_fi": "gpf-download-private"
    },
    {
        "name": "Service de diffusion WFS privé",
        "technical_name": "gpf-geoserver-wfs-private",
        "type": "WFS",
        "urls": [
            {
                "type": "WFS",
                "url": "https://data.geopf.fr/private/wfs/"
            }
        ],
        "_id": "d02feec9-1169-403f-bfc3-7ba6d6015ed4",
        "open": false,
        "metadata_fi": "gpf-geoserver-wfs-private"
    },
    {
        "name": "Service de diffusion WMS Vecteur privé",
        "technical_name": "gpf-geoserver-wms-v-private",
        "type": "WMS-VECTOR",
        "urls": [
            {
                "type": "WMS",
                "url": "https://data.geopf.fr/private/wms-v/"
            }
        ],
        "_id": "519c8bb1-9b7f-414a-9850-1a73dfd467ed",
        "open": false,
        "metadata_fi": "gpf-geoserver-wms-v-private"
    },
    {
        "name": "Service de diffusion WMS Raster privé",
        "technical_name": "gpf-rok4-server-wms-r-private",
        "type": "WMS-RASTER",
        "urls": [
            {
                "type": "WMS",
                "url": "https://data.geopf.fr/private/wms-r/"
            }
        ],
        "_id": "66866100-48eb-4340-bbc9-f5c7d9707928",
        "open": false,
        "metadata_fi": "gpf-rok4-server-wms-r-private"
    },
    {
        "name": "Service de diffusion WMTS/TMS privé",
        "technical_name": "gpf-rok4-server-wmts-tms-private",
        "type": "WMTS-TMS",
        "urls": [
            {
                "type": "TMS",
                "url": "https://data.geopf.fr/private/tms/"
            },
            {
                "type": "WMTS",
                "url": "https://data.geopf.fr/private/wmts/"
            }
        ],
        "_id": "7e0a92d1-8213-4ce0-8903-eb4c305a1849",
        "open": false,
        "metadata_fi": "gpf-rok4-server-wmts-tms-private"
    }
]

Cette étape est l’étape clé pour décider si le flux que vous vous apprêtez à publier va être publié en open data ou au contraire seulement aux utilisateurs accrédités. Dans l’écosystème Géoplateforme on appelle ce dernier mode, le mode privé.

Si vous souhaitez publier en open data, vous allez chercher, dans la réponse ci-dessus, un endpoint du type de la configuration créée (pour le tutoriel, WMS) dont l’élément open est à true.

Si vous souhaitez publier en mode privé, vous allez chercher, dans la réponse ci-dessus, un endpoint du type de la configuration créée (pour le tutoriel, WMS) dont l’élément open est à false.

Le tutoriel est déroulé en mode open data. Pour accéder à une donnée publiée en privé, référez vous au tutoriel sur le contrôle des accès.


Publication #

https://data.geopf.fr/api/datastores/{datastore}/configurations/{configuration wms}/offerings

{
    "endpoint": "ae022611-13eb-4a18-8d04-9b7604a031cc",
    "open": true
}

L’exemple ci-dessus présente une publication en mode open data.

Si vous choisissez de publier en mode privé, le corps de requête sera :

{
    "endpoint": "519c8bb1-9b7f-414a-9850-1a73dfd467ed",
    "open": false
}

Pour accéder à une donnée publiée en privé, référez vous au tutoriel sur le contrôle des accès


On peut vérifier la présence de notre couche ecoregions_tutoriel dans le GetCapabilities du service.

Gestion des styles pour la diffusion WMS de données vecteur

Configuration de la diffusion de données vecteur en TMS

Paramètres d'affichage

Choisissez un thème pour personnaliser l’apparence du site.