This API exposes all Open Data of a provider, as RDF/XML using the DCAT-AP CH v1 (eCH-0200) profile.
It can be used for harvesting by another catalog (e.g. opendata.swiss).

Access

Every viageo provider gets a unique entrypoint, ending with a dedicated slug.
URL : https://viageo.ch/api/catalog/dcat-ch/unique-slug
Example : https://viageo.ch/api/catalog/dcat-ch/asit

Authentication

This service is not authenticated, and exposes only public Open Data.

Exceptions

In case something gets wrong, a non-200 status code will be returned.

Output

All geodata, flagged as Open Data will be exposed in the service, serialized as XML/RDF using the recommendations of opendata.swiss handbook.
To be exposed, a geodata must :

  • Be Open Data
  • Be public (visibility in catalog)
  • Have at least one public distribution method (online map, geoservice, download or order)
  • Be free

<?xml version="1.0" encoding="UTF-8"?>
<rdf:RDF xmlns:dcat="http://www.w3.org/ns/dcat#" xmlns:dct="http://purl.org/dc/terms/" xmlns:foaf="http://xmlns.com/foaf/0.1/" xmlns:xsd="http://www.w3.org/2001/XMLSchema#" xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#" xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xmlns:vcard="http://www.w3.org/2006/vcard/ns#" xmlns:schema="http://schema.org/" xmlns:hydra="http://www.w3.org/ns/hydra/core#" xmlns:locn="http://www.w3.org/ns/locn#">
  <dcat:Catalog rdf:about="https://viageo.ch/fournisseur/demo-provider#catalog">
    <dcat:dataset>
      <dcat:Dataset rdf:about="https://viageo.ch/md/4e143119-fefc-4a96-b78f-a0e01abfd1c7">
        <dct:identifier>4e143119-fefc-4a96-b78f-a0e01abfd1c7@demo-provider</dct:identifier>
        <dct:title xml:lang="fr">Carte d'ensoleillement</dct:title>
        <dct:publisher>
          <foaf:Organization rdf:about="https://viageo.ch/fournisseur/demo-provider">
            <foaf:name>ASIT VD</foaf:name>
          </foaf:Organization>
        </dct:publisher>
        <dcat:contactPoint>
          <vcard:Individual>
            <vcard:fn>John Doe, Gestionnaire de la donnée</vcard:fn>
            <vcard:hasEmail rdf:resource="mailto:test-collaborateur-1@demo-provider.tld"/>
          </vcard:Individual>
        </dcat:contactPoint>
        <dcat:contactPoint>
          <vcard:Individual>
            <vcard:fn>John Doe, Responsable de diffusion</vcard:fn>
            <vcard:hasEmail rdf:resource="mailto:test-collaborateur-1@demo-provider.tld"/>
          </vcard:Individual>
        </dcat:contactPoint>
        <dct:description xml:lang="fr">Carte issue des relevés de l'ensoleillement reçu par les terrasses au boulevard de Grancy.
    Mots-clé: cadastre, soleil, relevé, thermique.</dct:description>
        <dcat:landingPage rdf:resource="https://viageo.ch/md/4e143119-fefc-4a96-b78f-a0e01abfd1c7"/>
        <dct:spatial/>
        <dct:language>fr</dct:language>
        <schema:image schema:URL="https://viageo.ch/uploads/resource_images/thumb_641c0effe897c.png"/>
        <dcat:theme rdf:resource="http://dcat-ap.ch/vocabulary/themes/geography"/>
        <dcat:theme rdf:resource="http://dcat-ap.ch/vocabulary/themes/territory"/>
        <dct:accrualPeriodicity rdf:resource="http://publications.europa.eu/resource/authority/frequency/CONT"/>
        <dct:issued rdf:datatype="http://www.w3.org/2001/XMLSchema#dateTime">2023-03-23T00:00:00</dct:issued>
        <dcat:distribution>
          <dcat:Distribution rdf:about="https://viageo.ch/md/4e143119-fefc-4a96-b78f-a0e01abfd1c7?format=PDF#orderAction">
            <dct:language>fr</dct:language>
            <dct:title xml:lang="fr">Carte d'ensoleillement (PDF)</dct:title>
            <dct:description xml:lang="fr">Commander sur viageo.ch</dct:description>
            <dcat:accessURL rdf:resource="https://viageo.ch/md/4e143119-fefc-4a96-b78f-a0e01abfd1c7#orderAction"/>
            <dct:format>PDF</dct:format>
            <dct:issued rdf:datatype="http://www.w3.org/2001/XMLSchema#dateTime">2023-03-23T00:00:00</dct:issued>
            <dct:rights>NonCommercialAllowed-CommercialAllowed-ReferenceRequired</dct:rights>
            <dct:license>Creative Commons Attribution 4.0 International (CC BY 4.0)</dct:license>
          </dcat:Distribution>
        </dcat:distribution>
        <dcat:distribution>
          <dcat:Distribution rdf:about="https://viageo.ch/md/4e143119-fefc-4a96-b78f-a0e01abfd1c7?format=PDF#downloadAction">
            <dct:language>fr</dct:language>
            <dct:title xml:lang="fr">Carte d'ensoleillement (DXF)</dct:title>
            <dct:description xml:lang="fr">Télécharger sur viageo.ch</dct:description>
            <dcat:accessURL rdf:resource="https://viageo.ch/md/4e143119-fefc-4a96-b78f-a0e01abfd1c7#downloadAction"/>
            <dcat:downloadURL rdf:resource="https://viageo.ch/md/4e143119-fefc-4a96-b78f-a0e01abfd1c7#downloadAction"/>
            <dct:format>DXF</dct:format>
            <dct:issued rdf:datatype="http://www.w3.org/2001/XMLSchema#dateTime">2023-03-23T00:00:00</dct:issued>
            <dct:rights>NonCommercialAllowed-CommercialWithPermission-ReferenceRequired</dct:rights>
            <dct:license>License : Open Data Commons Open Database License (ODbL) https://opendatacommons.org/licenses/odbl/</dct:license>
          </dcat:Distribution>
        </dcat:distribution>
      </dcat:Dataset>
    </dcat:dataset>
  </dcat:Catalog>
</rdf:RDF>

Pagination

Output is paginated using Hydra Vocabulary.

Query parameters
page optional, integer, 1 by default Page size is 10 

<hydra:PagedCollection rdf:about="https://viageo.ch/api/catalog/dcat-ch/unique-slug?page=3">
    <hydra:lastPage>https://viageo.ch/api/catalog/dcat-ch/unique-slug?page=4</hydra:lastPage>
    <hydra:itemsPerPage rdf:datatype="http://www.w3.org/2001/XMLSchema#integer">1000</hydra:itemsPerPage>
    <hydra:totalItems rdf:datatype="http://www.w3.org/2001/XMLSchema#integer">3479</hydra:totalItems>
    <hydra:firstPage>https://viageo.ch/api/catalog/dcat-ch/unique-slug?page=1</hydra:firstPage>
    <hydra:previousPage>https://viageo.ch/api/catalog/dcat-ch/unique-slug?page=2</hydra:previousPage>
</hydra:PagedCollection>