Punktskydata tilbydes via Datafordeleren, som prædefinerede filer og udstilles via fildownload.


Sideinformation


Filformater


Datafordeleren udstiller to formater for punktskydata via fildownload: LAZ- og LAS-format. 

Det eneste register der udstiller punktskydata på Datafordeleren er Danmarks Højdemodel (DHM).

En komplet liste over DHMs datasæt med punktskydata kan findes i Bilag 4 på Transitionsguide (fildownload).






Sådan henter du punktskydata via fildownload


Punktskydata på Datafordeleren tilgås via et REST-API. Dette afsnit beskriver, hvordan punktskydata hentes. REST-API'et indeholder to metoder til at hente punktskydata som kan kaldes. 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 punktskyfil ad gangen eller flere prægenererede punktskyfiler på samme tid ved at kalde metoden “GetPointCloudMultipleFiles”. For at se hvilke punktsky filer der udstilles, kan GetAvailablePointCloudFileDownloads kaldes.

For en oversigt over tilgængelige fildownload, kan GetAvailablePointCloudFileDownloadsOverview kaldes. 




Metode: GetAvailablePointCloudFileDownloads


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


Metode: GetAvailableRasterFileDownloads

URL

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

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:

  • DHM

DataSetName

String

Valgfri parameter. Specificerer hvilket datasæt filerne skal hentes fra. Se Bilag 4 på Transitionsguide (fildownload) for en samlet liste over 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 Bilag 4 på Transitionsguide (fildownload) for en samlet liste over 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/GetAvailablePointCloudFileDownloads?Version=1&apiKey=xxxx




Metode: GetAvailablePointCloudFileDownloadsOverview


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


Metode: GetAvailablePointCloudFileDownloadsOverview

URL

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

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 til tilgængelige 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

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 Bilag 4 på Transitionsguide (fildownload) for en samlet liste over tilgængelige datasæt.

DataDeliveryNumber

Angiver hvilken dataleverance filen er fra.




Eksempler på brug af metoden

Se tilgængelige fildownloads:

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




Metode: GetPointCloudFile


I dette afsnit beskrives metoden “GetPointCloudFile” som returnerer én punktskyfil ad gangen.


Metode: GetPointCloudFile

URL

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

http-metode

GET

Headere i forespørgsel

Content-Type: application/json

Format

LAS eller LAZ-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 GetAvailablePointCloudFileDownloads.




Returværdier

Denne metode returnerer en LAS eller LAZ fil ved HTTP 200 - OK.




Eksempler på brug af metoden

Hent en punktskyfil med filnavn, respektive id:

https://api.datafordeler.dk/FileDownloads/GetPointCloudFile?FileName=punktsky_1km_6049_684.las&apiKey=xxxx

https://api.datafordeler.dk/FileDownloads/GetPointCloudFile?Id=0000ab3a-0bc2-48f5-9f51-a07027d2ce37&apiKey=xxxx




Metode: GetPointCloudMultipleFiles


I dette afsnit beskrives metoden “GetPointCloudMultipleFiles” som kan returnere én eller flere punktskyfiler ad gangen. Ligesom “GetRasterMultipleFiles” tager ”GetPointCloudMultipleFiles” også en bounding box som parameter. Læs mere om bounding box.




Metode: GetPointCloudMultipleFiles

URL

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

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 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:

  • DHM

DataSetName

String

Specificerer hvilket datasæt filerne skal hentes fra. Se Bilag 4 på Transitionsguide (fildownload) for en samlet liste over 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 1 ZIP, med en eller flere filer i, ved HTTP 200 - OK.

Eksempler på brug af metoden

Hent flere punktskyfiler fra Danmarks Højdemodel:

https://api.datafordeler.dk/FileDownloads/GetPointCloudMultipleFiles?minx=710000&miny=6070000&maxx=750000&maxy=6190000&register=dhm&version=1&datasetname=punktsky2015&apiKey=placeholderNoegle

Kaldet returnerer filen dhm_overflade_710000_6070000-750000_6190000.zip.




Metode: GetPointCloudMultipleSize


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




Metode: GetPointCloudMultipleSize

URL

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

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 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:

  • DHM

DataSetName

String

Specificerer hvilket datasæt filerne skal hentes fra. Se Bilag 4 på Transitionsguide (fildownload) for en samlet liste over 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 flere punktskyfiler fra Danmarks Højdemodel samtidig:

https://api.datafordeler.dk/FileDownloads/GetPointCloudMultipleSize?minx=710000&miny=6070000&maxx=750000&maxy=6190000&register=dhm&version=1&datasetname=punktsky2015&apiKey=placeholderNoegle

Kaldet returnerer tekststrengen “24.9 GB / 45.0 GB”.