Exporteer output

Wanneer de pipeline van een Data Studio-project draait, produceert het een output — het resultaat van de lagen en verwerkingsstappen, gevormd voor download als een dataset of bestand.

Hoe output wordt gevormd

Output maakt deel uit van de werkruimteconfiguratie van het project, ingesteld via PUT .../projects/:projectId. Het output-object controleert het formaat en welke velden zijn opgenomen:

Veld	Type	Beschrijving
format	string	csv, json, of geojson.
includeCoordinates	boolean	Of geografische coördinaten in het resultaat moeten worden opgenomen.
fields	object	Veldmapping — welke bronvelden moeten worden opgenomen en hoe ze in de output moeten worden genoemd.

Voorbeeld

Configureer een project om GeoJSON met coördinaten en een hernoemd veld te exporteren. Alleen het outputgedeelte wordt getoond:

curl -X PUT \
  -H "Authorization: Bearer eyJhbGci..." \
  -H "Content-Type: application/json" \
  -d '{
    "pipeline": {
      "version": 1,
      "layers": [],
      "transformers": [],
      "output": {
        "format": "geojson",
        "includeCoordinates": true,
        "fields": {
          "mappings": [
            { "sourceField": "name", "outputField": "venue_name", "include": true },
            { "sourceField": "stars", "outputField": "rating", "include": true }
          ]
        }
      }
    }
  }' \
  "https://api.topolab.nl/v1/organization/8f0c2e1a-4b6d-4c2a-9e3f-1a2b3c4d5e6f/data-studio/projects/c1d2e3f4-a5b6-4c7d-8e9f-0a1b2c3d4e5f"

De reactie is het bijgewerkte project met de opgeslagen outputconfiguratie.

Het resultaat ophalen

Zodra een pipeline draait (zie Run een pipeline), retourneert execute een gegenereerde-resultaatidentificator. Download dat resultaat, gevormd door de output-configuratie hierboven:

curl -L \
  -H "Authorization: Bearer eyJhbGci..." \
  "https://api.topolab.nl/v1/organization/{organizationId}/data-studio/generated/{generatedId}/download" \
  -o studio-output.geojson

Ophalen is gebonden aan een Data Studio-permissie en kan credits verbruiken afhankelijk van de grootte — zie Rate-limieten & credits.

Authenticatie

Een Bearer JWT (zie Authenticatie), organisatie lidmaatschap, de data-studio add-on, en de DATA_STUDIO_CREATE permissie om de outputconfiguratie te bewerken.

Volgende

• Run een pipeline — produceer het resultaat dat je exporteert.
• Maak een project aan — de PUT-body die outputinstellingen bevat.
• Wil je Data Studio inschakelen? Neem contact met ons op.