Les métadonnées permettent de décrire les données diffusées sur la plateforme : la source, la date et la méthode d'acquisition... Ces fichiers au format XML peuvent se référencer les uns les autres à l'aide d'un identifiant unique au sein de la plateforme : le file identifier. Deux "niveaux" de métadonnées sont gérées par l'utilisateur de l'entrepôt : la métadonnée de lot (dataset) et la métadonnée de produit (serie). Les métadonnées de services sont assumées par le gestionnaire de la plateforme.

Téléversement d'une nouvelle métadonnée #

Le fichier de métadonnée :

• doit être un fichier XML valide
• doit avoir son file identifier défini au xpath : gmd:MD_Metadata / gmd:fileIdentifier / gco:CharacterString : si celui ci est déjà pris sur la plateforme, une erreur sera remontée
• peut avoir son niveau défini au xpath : md:MD_Metadata / gmd:hierarchyLevel / gmd:MD_ScopeCode (valeur dataset ou series). S'il n'est pas défini, la métadonnée sera considérée comme étant de lot.

Exemple :

• métadonnée de lot
• métadonnée de produit

📄 <metadonnee_lot.xml>

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

{
    "type": "ISOAP",
    "open_data": false,
    "level": "DATASET",
    "file_identifier": "IGNF_RGEALTIr_2-0_ASC_5M_LAMB93_IGN69_D074.xml",
    "tags": {},
    "endpoints": [],
    "_id": "{metadata}"
}

Notez que :

• Pour que la métadonnée soit intégrée dans le catalogue INSPIRE, il suffit de l’indiquer dans l’attribut type (type = INSPIRE). Elle sera alors moissonnée par le Géocatalogue.
• Pour que la métadonnée soit moissonnée par le site data.gouv.fr, il suffit de l’indiquer dans l’attribut open_data (open_data = true).

À ce stade, elle n'est accessible que par l'API Entrepôt, aux membres de la communauté, via son identifiant. L’étape suivante est la publication d'une métadonnée .

Modification d'une métadonnée #

Il est possible de modifier le fichier XML correspondant à une métadonnée. Le file identifier ne doit pas changer, et si la métadonnée est déjà publiée, la modification est reportée au niveau des catalogues.

📄 <metadonnee_lot.xml>

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

{
    "type": "ISOAP",
    "level": "DATASET",
    "file_identifier": "IGNF_RGEALTIr_2-0_ASC_5M_LAMB93_IGN69_D074.xml",
    "endpoints": [],
    "_id": "{metadata}"
}

Modification des attributs d'une métadonnée #

Il est possible de modifier les attributs (type et open_data) d’une métadonnée déjà existante.

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

{
    "type": "INSPIRE",
    "open_data": true
}

{
    "type": "INSPIRE",
    "open_data": true,
    "level": "DATASET",
    "file_identifier": "IGNF_RGEALTIr_2-0_ASC_5M_LAMB93_IGN69_D074.xml",
    "tags": {},
    "endpoints": [],
    "_id": "{metadata}"
}

La métadonnée doit être republiée par la suite afin de répercuter les modifications au niveau des services de catalogage.