Versions Compared

Old Version 2

changes.mady.by.user Ann-Sofie Hildebrandt

Saved on

compared with

New Version Current

changes.mady.by.user Ann-Sofie Hildebrandt

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Tilføjet Til toppen links

Anchor
Toppen
Toppen

På denne side beskrives hvordan prædefineret rasterdata udstilles via fildownload.


Table of Contents

Sideinformation

Display Metadata
hidetableheadertrue


Filformater

Til toppen

Datafordeleren udstiller to formater for rasterdata via fildownload; GeoTIFF og ECW. Et rasterdatasæt kan bestå af en eller flere filer i enten GeoTIFF- eller ECW-format. Nedenfor er beskrevet hvordan Datafordeleren bearbejder de rasterdata der modtages fra registrene:

  • GeoTIFF: For de registre der leverer data i GeoTIFF-format, gør følgende sig gældende:
    • Alle datasæt udstilles som den originalt er aflevereret til Datafordeleren af registrene.
    • Følgende datasæt udstilles også som 10x10 tiles (udstilles med samme datasætnavn med ”_10x10” postfixet, f.eks. ”Overflade_10x10”), der er tilpasset Det Danske Kvadratnet (DDKN):
  • ECW: For registre, der leverer data i ECW-format, reorganiseres data ikke af Datafordeleren, og anvendere vil derfor modtage data i dets oprindelige replikerede ECW-format.

Registre distribuerer data i form af tiles i forskellige størrelser for at imødekomme forskellige behov; dimensionerne kan for eksempel være 1x1 km eller 10x10 km. For data replikeret fra de GeoTIFF datasæt der også udstilles som 10x10 tiles, sammensmeltes kopier af de replikerede 1x1 km-tiles systematisk i grupper på op til 100 for at skabe den tilsvarende 10x10 km-tile. Anvendere kan benytte https://earthmaps.dataforsyningen.dk/dfTiles til at finde navnene på de pågældende tiles.

Ud over den tile-baserede tilgang, tilbyder Datafordeleren også muligheden for at hente én samlet GeoTIFF-fil for Skærmkortet, der dækker hele landet. Denne fil giver anvenderne et samlet overblik over al data, hvilket eliminerer behovet for individuelt at hente og administrere hver tile.




Følgende registre udstiller rasterdata på Datafordeleren:

Register

Forkortelse

Skærmkortet

skaermkort

Danmarks Højdemodel

DHM

GeoDanmark Ortofoto

GEODKO

Danmarks Topografiske Kortværk

DTK




Se lister over registrenes datasæt med rasterdata.






Sådan henter du rasterbaserede fildownload

Til toppen

Rasterdata på Datafordeleren tilgås via et REST-API. Dette afsnit beskriver, hvordan rasterdata hentes. REST-API'et indeholder to metoder til at hente rasterdata. REST-API'et kræver at du først har oprettet en API-key eller benytter en af de to andre autentifikationsmetoder.

Anvendere kan enten vælge at hente én prægenereret rasterfil ad gangen med metoden "GetRasterFile", eller flere prægenererede rasterfiler på samme tid ved at kalde metoden “GetRasterMultipleFiles”.

For at se hvilke Raster filer der udstilles, kan "GetAvailableRasterFileDownloads" kaldes. For en oversigt over tilgængelige fildownload, kan "GetAvailableRasterFileDownloadsOverview" kaldes.  




Metode: GetAvailableRasterFileDownloads


Returnerer hvilke rasterbaserede fildownloads der kan hentes og information om disse.


Metode: GetAvailableRasterFileDownloads

URL

https://<env>-api.datafordeler.dk/FileDownloads/GetAvailableRasterFileDownloads?

HTTP-metode

GET

Headere i forespørgsel

Content-Type: application/json

Format

JSON

Returværdier

  • Returnerer HTTP 200:    OK, ved succes.
  • Returnerer HTTP 400:    Bad Request, ved angivelse af forkerte parametre.
  • Returnerer HTTP 404:    Not Found, hvis den angivne ressource ikke kan findes.
  • Returnerer HTTP 500:    Internal Server Error, hvis der er sket en ukendt fejl

Adgang

API-key, OAuth Shared Secret eller OAuth Certifikat.

Dato- og tidsformat

Datoformat følger ISO 8601

Tidszonen er UTC




Parametre

Navn

Type

Beskrivelse

MinX

String

Valgfri parameter, men alle koordinater skal angives hvis brugt. Angiver X-koordinatet for det nederste venstre hjørne af bounding box’en

MinY

String

Valgfri parameter, men alle koordinater skal angives hvis brugt. Angiver Y-koordinatet for det nederste venstre hjørne af bounding box’en

MaxX

String

Valgfri parameter, men alle koordinater skal angives hvis brugt. Angiver X-koordinatet for det øverste højre hjørne af bounding box’en

MaxY

String

Valgfri parameter, men alle koordinater skal angives hvis brugt. Angiver Y-koordinatet for det øverste højre hjørne af bounding box’en

Register

String

Valgfri parameter. Specificerer hvilket register filerne skal hentes fra.

Følgende registre kan angives:

  • skaermkort
  • DHM
  • GeoDKO
  • DTK

DataSetName

String

Valgfri parameter. Specificerer hvilket datasæt filerne skal hentes fra. Se tilgængelige datasæt.

Version

Int

Valgfri parameter. Specificerer hvilken datamodelversion filerne skal hentes fra.

DataDeliveryNumber

Int

Valgfrit parameter. Angiver hvilken dataleverance filerne skal hentes fra. Hvis parameteret ikke angives, hentes filerne fra den nyeste dataleverance givet resten af parametrene.

Pagenumber

Int

Valgfri parameter. Specificerer hvilken side med svar der skal blive returneret.

GenerationTime

DateTime

Valgfri parameter. Tid for hvornår filen er blevet genereret.

FileFormat

String

Valgfri parameter. Filformat, enten:

  • tif
  • ecw 




Returværdier

Metoden returnerer metadata om fildownload, der følger strukturen beskrevet i tabel nedenfor. Der er ikke nogen sortering defineret, så resultater optræder i tilfældig rækkefølge.

Felt

Beskrivelse

PaginationMetadata

CurrentPage

Angiver den nuværende side der vises.

PageSize

Angiver antal fildownloads der vises på nuværende side.

TotalCount

Angiver totale fildownloads der findes fra din query.

TotalPages

Angiver totale sider der findes fra din query.

AvailableFileDownloads

Filename

Navnet på filen som kan downloades.

RegisterName

Angiver hvilket register data i filen tilhører.

Version

Angiver underlæggende version af filens data.

GenerationTime

Angiver tidspunktet for hvornår filen blev genereret.

FileFormat

Angiver filformat for filen.

FileSizeInBytes

Angiver filstørrelse på filen og kan bruges til at hurtigt at sammenligne filstørrelsen.

ID

Angiver det ID der kan bruges for at identificere en fil.

DataSetName

Angiver hvilket datasæt filerne skal hentes fra. Se tilgængelige datasæt.

DataDeliveryNumber

Angiver hvilken dataleverance filen er fra.

BoundingBox

Angiver bounding box for filen. Består af MinX, MaxX, MinY og MaxY.




Eksempel på brug af metoden

Se tilgængelige fildownloads for version 1:

https://api.datafordeler.dk/FileDownloads/v1.0/GetAvailableRasterFileDownloads?Version=1&apiKey=xxxx




Metode: GetAvailableRasterFileDownloadsOverview

Til toppen

Metoden returnerer en oversigt for tilgængelige rasterbaserede fildownloads, med information om antal filer per register, datasæt osv. Denne info kan bruges for at definere parametre til GetAvailableRasterFileDownloads-metode.


Metode: GetAvailableRasterFileDownloadsOverview

URL

https://<env>-api.datafordeler.dk/FileDownloads/GetAvailableRasterFileDownloadsOverview?

HTTP-metode

GET

Headere i forespørgsel

Content-Type: application/json

Format

JSON

Returværdier

  • Returnerer HTTP 200:    OK, ved succes.
  • Returnerer HTTP 400:    Bad Request, ved angivelse af forkerte parametre.
  • Returnerer HTTP 404:    Not Found, hvis den angivne ressource ikke kan findes.
  • Returnerer HTTP 500:    Internal Server Error, hvis der er sket en ukendt fejl

Adgang

API-key, OAuth Shared Secret eller OAuth Certifikat.

Dato- og tidsformat

Datoformat følger ISO 8601

Tidszonen er UTC




Parametre

Tillader ikke nogen parametre.




Returværdier

Metoden returnerer en oversigt for tilgængelige fildownloads, der følger strukturen beskrevet i tabel nedenfor. Der er ikke nogen sortering defineret, så resultater optræder i tilfældig rækkefølge. 


Felt

Beskrivelse

RegisterName

Angiver hvilket register data i filen tilhører.

Version

Angiver underlæggende version af filens data.

RecordCount

Angiver antallet filer fra det relateret registre, version, datasæt, dataleverance og filformat.

FileFormat

Angiver filformat for filen.

DataSetName

Angiver hvilket datasæt filerne skal hentes fra. Se tilgængelige datasæt.

DataDeliveryNumber

Angiver hvilken dataleverance filen er fra.




Eksempel på brug af metoden

Se tilgængelige fildownloads:

https://api.datafordeler.dk/FileDownloads/v1.0/GetAvailableRasterFileDownloadsOverview




Metode: GetRasterFile

Til toppen

I dette afsnit beskrives metoden “GetRasterFile” som returnerer én rasterfil ad gangen.


Metode: GetRasterFile

URL

https://<env>-api.datafordeler.dk/FileDownloads/GetRasterFile

http-metode

GET

Headere i forespørgsel

Content-Type: application/json

Format

ZIP (der indeholder GeoTIFF eller ECW-fil) alt efter hvilket format datasæt replikeres i

Returværdier

  • Returnerer HTTP 200:   OK, ved succes.
  • Returnerer HTTP 400:   Bad Request, ved angivelse af forkerte parametre.
  • Returnerer HTTP 404:   Not Found, hvis den angivne ressource ikke kan findes eller hvis brugeren ikke har adgang til de pågældende filer.
  • Returnerer HTTP 500:   Internal Server Error, hvis der er sket en ukendt fejl.

Adgang

API-key, OAuth Shared Secret eller OAuth Certifikat.

Dato- og tidsformat

Datoformat følger ISO 8601

Tidszonen er UTC




Parametre

Bemærk, at parametret ”FileName” ikke er robust overfor hvis flere filer deler samme navn. I dette tilfælde vil en tilfældig af filerne med navnet der matcher returneres. I disse tilfælde vil ”Id” være mere robust, da det er unikt per fil.

Navn

Type

Beskrivelse

FileName

String

Angiver det filnavn for den fil der skal hentes.

Id

String

Angiver det ID for den fil der skal hentes. ID fremfindes ved kald til GetAvailableRasterFileDownloads.




Returværdier

Denne metode returnerer en GeoTIFF eller ECW fil ved HTTP 200 - OK.




Eksempler på brug af metoden

Hent en rasterfil med filnavn, respektive id:

https://api.datafordeler.dk/FileDownloads/GetRasterFile?FileName=DSM_10km_604_68.tif&apiKey=xxxx

https://api.datafordeler.dk/FileDownloads/GetRasterFile?Id=000003e7-5634-43cf-8dc8-06d5a5d0a710&apiKey=xxxx




Metode: GetRasterMultipleFiles

Til toppen

I dette afsnit beskrives metoden “GetRasterMultipleFiles” som returnerer én eller flere rasterfiler ad gangen. Metoden tager derimod to sæt af koordinater som udgør en såkaldt bounding box.

En bounding box er en rektangulær, geografisk afgrænsning, som angiver hvilke tiles der returneres til anvenderen. Bounding box’en er defineret ved koordinaterne: minX, minY, maxX og maxY, som alle skal være inden for EPSG-25832 grænserne.

Nedenfor er vist et eksempel på en bounding box for koordinaterne minX: 721148, minY: 6175495, maxX: 722618 og maxY: 6176355:





Metode: GetRasterMultipleFiles

URL

https://<env>-api.datafordeler.dk/FileDownloads/GetRasterMultipleFiles

http-metode

GET

Headere i forespørgsel

Content-Type: application/json

Format

ZIP (der indeholder GeoTIFF eller ECW filer)

Returværdier

  • Returnerer HTTP 200:  OK, ved succes.
  • Returnerer HTTP 400:  Bad Request, ved angivelse af forkerte parametre.
  • Returnerer HTTP 404:  Not Found, hvis den angivne ressource ikke kan findes eller hvis brugeren ikke har adgang til de pågældende filer.
  • Returnerer HTTP 413:  Payload er for stort, hvis summen af størrelsen på de efterspurgte filer overstiger den predefinerede øvre grænsen.
  • Returnerer HTTP 500:  Internal Server Error, hvis der er sket en ukendt fejl.

Adgang

API-key, OAuth Shared Secret eller OAuth Certifikat.

Dato- og tidsformat

Datoformat følger ISO 8601
Tidszonen er UTC


Parametre

Navn

Type

Beskrivelse

MinX

String

Angiver X-koordinatet for det nederste venstre hjørne af bounding box’en

MinY

String

Angiver Y-koordinatet for det nederste venstre hjørne af bounding box’en

MaxX

String

Angiver X-koordinatet for det øverste højre hjørne af bounding box’en

MaxY

String

Angiver Y-koordinatet for det øverste højre hjørne af bounding box’en

Register

String

Specificerer hvilket register filerne skal hentes fra.

Følgende registre kan angives:

  • skaermkort
  • DHM
  • GeoDKO
  • DTK

DataSetName

String

Specificerer hvilket datasæt filerne skal hentes fra. Se tilgængelige datasæt.

Version

Int

Specificerer hvilken datamodelversion filerne skal hentes fra.

DataDeliveryNumber

Int

Valgfri parameter. Angiver hvilken dataleverance filerne skal hentes fra. Hvis parameteren ikke angives, hentes filerne fra den nyeste dataleverance givet resten af parametrene.

Returværdier

Denne metode returnerer altid en eller flere filer ved HTTP 200 - OK.

Eksempler på brug af metoden

Hent flere rasterfiler fra Danmarks Højdemodel samtidig:

https://api.datafordeler.dk/FileDownloads/GetRasterMultipleFiles?minx=650000&miny=6070000&maxx=690000&maxy=6130000&register=dhm&version=1&datasetname=overflade&apiKey=xxxx

Kaldet returnerer filen dhm_overflade_650000_6070000-690000_6130000.zip. 




Metode: GetRasterMultipleSize

Til toppen

Når en anvender ønsker at kende størrelsen på de prægenerede rasterfiler inden de hentes via fildownload, kan metoden GetRasterMultipleSize, som beskrives i dette afsnit, benyttes.




Metode: GetRasterMultipleSize

URL

https://<env>-api.datafordeler.dk/FileDownloads/GetRasterMultipleSize

http-metode

GET

Headere i forespørgsel

Content-Type: application/json

Format

JSON

Returværdier

  • ReturnererHTTP 200:  OK, ved succes.
  • Returnerer HTTP 400:  Bad Request, ved angivelse af forkerte parametre.
  • Returnerer HTTP 404:  Not Found, hvis den angivne ressource ikke kan findes eller hvis brugeren ikke har adgang til de pågældende filer.
  • Returnerer HTTP 500:  Internal Server Error, hvis der er sket en ukendt fejl.

Adgang

API-key, OAuth Shared Secret eller OAuth Certifikat.

Dato- og tidsformat

Datoformat følger ISO 8601
Tidszonen er UTC

 

Parametre

Navn

Type

Beskrivelse

MinX

String

Angiver X-koordinatet for det nederste venstre hjørne af bounding box’en

MinY

String

Angiver Y-koordinatet for det nederste venstre hjørne af bounding box’en

MaxX

String

Angiver X-koordinatet for det øverste højre hjørne af bounding box’en

MaxY

String

Angiver Y-koordinatet for det øverste højre hjørne af bounding box’en

Register

String

Specificerer hvilket register filerne skal hentes fra.

Følgende registre kan angives:

  • skaermkort
  • DHM
  • GeoDKO
  • DTK

DataSetName

String

Specificerer hvilket datasæt filerne skal hentes fra. Se tilgængelige datasæt.

Version

Int

Specificerer hvilken datamodelversion filerne skal hentes fra.

DataDeliveryNumber

Int

Valgfri parameter. Angiver hvilken dataleverance filerne skal hentes fra. Hvis parameteren ikke angives, hentes filerne fra den nyeste dataleverance givet resten af parametrene.

Returværdier

Denne metode returnerer altid en tekststreng med størrelsen på ZIP-filen og den øvre grænse for størrelse på filerne i Gigabytes.

Eksempler på brug af metoden

Hent en specifik rasterfil fra Danmarks Højdemodel:

https://api.datafordeler.dk/FileDownloads/GetRasterMultipleSize?minx=650000&miny=6070000&maxx=690000&maxy=6130000®ister=dhm&version=1&datasetname=overflade&apiKey=placeholderNoegle

Kaldet returnerer tekststrengen “39.2 GB / 45.0 GB”.




Skærmkort fildownload

Til toppen

Hvis man har brug for at hente Skærmkort rasterdata i alle zoomniveauer (f.eks. 1x1, 5x5 og 10x10 km) kan endepunkter for Skærmkort kaldes. Dette eliminerer behovet for at hente og administrere hver tile individuelt, ved at kalde GetRasterMultipleFiles for hvert zoomniveau. Enten kan alt Skærmkort data hentes, ved at kalde GetAllSkaermkortFiles, eller en bounding box kan angives som parameter ved at kalde GetSkaermkortFiles.

Læs mere om bounding box i afsnittet Metode: GetRasterMultipleFiles.




Metode: GetSkaermkortFiles 


Når du som anvender ønsker at hente Skærmkort data indenfor en bounding box, kan GetSkaermkortFiles benyttes.


Metode: GetSkaermkortFiles

URL

https://<env>-api.datafordeler.dk/FileDownloads/GetSkaermkortFiles

http-metode

GET

Headere i forespørgsel

Content-Type: application/json

Format

ZIP (der indeholder GeoTIFF filer)

Returværdier

  • Returnerer HTTP 200:   OK, ved succes.
  • Returnerer HTTP 400:   Bad Request, ved angivelse af forkerte parametre.
  • Returnerer HTTP 404:   Not Found, hvis den angivne ressource ikke kan findes eller hvis brugeren ikke har adgang til de pågældende filer.
  • Returnerer HTTP 413:   Payload er for stort, hvis summen af størrelsen på de efterspurgte filer overstiger den predefinerede øvre grænsen.
  • Returnerer HTTP 500:   Internal Server Error, hvis der er sket en ukendt fejl.

Adgang

API-key, OAuth Shared Secret eller OAuth Certifikat.

Dato- og tidsformat

Datoformat følger ISO 8601

Tidszonen er UTC




Parametre

Navn

Type

Beskrivelse

MinX

String

Angiver X-koordinatet for det nederste venstre hjørne af bounding box’en

MinY

String

Angiver Y-koordinatet for det nederste venstre hjørne af bounding box’en

MaxX

String

Angiver X-koordinatet for det øverste højre hjørne af bounding box’en

MaxY

String

Angiver Y-koordinatet for det øverste højre hjørne af bounding box’en

DataSet

String

Specificerer hvilket datasæt filerne skal hentes fra. Se tilgængelige datasæt.

Version

Int

Specificerer hvilken datamodelversion filerne skal hentes fra.

DataDeliveryNumber

Int

Valgfrit parameter. Angiver hvilken dataleverance filerne skal hentes fra. Hvis parameteret ikke angives, hentes filerne fra den nyeste dataleverance givet resten af parametrene.




Returværdier

Denne metode returnerer altid en ZIP-fil, med en eller flere GEoTIFF filer i, ved HTTP 200 - OK.




Eksempel på brug af metoden

Hent Skærmkort data der er indenfor bounding box:

https://api.datafordeler.dk/FileDownloads/GetSkaermkortFiles?minX=500000&minY=6150000&maxX=550000&maxY=6200000&version=1&datasetname=daempet

Kaldet returnerer filen SKAERMKORT_daempet_500000_6150000-550000_6200000.zip.




Metode: GetAllSkaermkortFiles


Når du som anvender ønsker at hente alt Skærmkort data, der dækker hele landet, kan GetAllSkaermkortFiles benyttes.

Til toppen

Metode: GetAllSkaermkortFiles

URL

https://<env>-api.datafordeler.dk/FileDownloads/GetAllSkaermkortFiles

http-metode

GET

Headere i forespørgsel

Content-Type: application/json

Format

ZIP (der indeholder GeoTIFF filer)

Returværdier

  • Returnerer HTTP 200:   OK, ved succes.
  • Returnerer HTTP 400:   Bad Request, ved angivelse af forkerte parametre.
  • Returnerer HTTP 404:   Not Found, hvis den angivne ressource ikke kan findes eller hvis brugeren ikke har adgang til de pågældende filer.
  • Returnerer HTTP 413:   Payload er for stort, hvis summen af størrelsen på de efterspurgte filer overstiger den predefinerede øvre grænsen.
  • Returnerer HTTP 500:   Internal Server Error, hvis der er sket en ukendt fejl.

Adgang

API-key, OAuth Shared Secret eller OAuth Certifikat.

Dato- og tidsformat

Datoformat følger ISO 8601

Tidszonen er UTC




Parametre

Navn

Type

Beskrivelse

Version

String

Angiver hvilken version der skal hentes skærmkort data for. Der er pt. kun version ”1” der udstilles.

DataDeliveryNumber

Int

Valgfrit parameter. Angiver hvilken dataleverance filerne skal hentes fra. Hvis parameteret ikke angives, hentes filerne fra den nyeste dataleverance givet resten af parametrene.




Returværdier

Denne metode returnerer altid en ZIP-fil, med flere GeoTIFF filer i, ved HTTP 200 - OK.




Eksempel på brug af metoden

Hent all Skærmkort data for version 1:

https://api.datafordeler.dk/FileDownloads/GetAllSkaermkortFiles?version=1

Kaldet returnerer filen SKAERMKORT.zip.



Til toppen