Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
| Anchor | ||||
|---|---|---|---|---|
|
| Note |
|---|
Bemærk at DAGI data i REST på Webbruger/tjenestebruger fremover ikke bliver opdateret, når der er ændringer i DAGI. |
Excerpt Include REST på Datafordeleren (udfases 15. januar 2027) REST på Datafordeleren (udfases 15. januar 2027) nopanel true
Siden beskriver de REST tjenester, der udstilles på Datafordeleren fra Danmarks Administrative Geografiske Inddeling (DAGI)
Dokumentation for REST for er samlet på denne side. Dokumentation for WFS er formidlet i Dataoversigt på Datafordelerdatafordeler.dk
Få en introduktion til Webservice REST på Datafordeleren (RESTudfases 15. januar 2027), hvis du har brug for en introduktion til og vejledning i, hvordan man kan anvende webservices, som udstilles på Datafordeleren.
Få en guide til helt konkrete anvisninger til at bruge en webservice fra Datafordeleren i Guide til webservice REST på Selvbetjeningen (RESTudfases 15. januar 2027).
| Table of Contents |
|---|
Sideinformation
| Display Metadata | ||
|---|---|---|
|
Url opbygning for REST
Url for de enkelte services er opbygget af et endpoint efterfulgt af registernavn, servicenavn, versionen af servicen, servicetype (REST eller WFS etc.) samt metodenavn for services. Efter ”?” tilføjes parametre i kaldet, der kan indeholde generelle kaldeparametre for REST services og metodespecifikke parametre.
Endpointet indeholder værtsnavnet, med et præfiks for miljøet hvis det ikke er produktionsmiljøet der tilgås. Hvis der er tale om fortrolige eller følsomme data, følger S5 - se miljøbeskrivelser.
Læs mere om sammensætning af url'er på siden REST på Datafordeleren (udfases 15. januar 2027) eller se eksempler på, at parametre bliver tilføjet til url'er på Datafordeleren - eksempler på anvendelse af bitemporalitet eller User stories (REST) (udfases 15. januar 2027).
| Url-struktur for REST services | <endpoint>/register/service/version/servicetype/metode? |
|---|---|
| Eksempel på url med brugernavn/adgangskode | https://services.datafordeler.dk/DAGIM/DAGI/1/RESTrest/DAGI?x=724786xxxxxx&y=6176332yyyyyy&username=xxx&password=yyy |
| Eksempel på url med certifikat | https://certservices.datafordeler.dk//DAGIM/DAGI/1/rest/DAGI?x=xxxxxx&y=yyyyyy |
Generelt for DAGI webservices
| Registernavn i Selvbetjeningen | DAGIM |
|---|---|
| Format | XML/JSON |
| DLS version | 1.1729 |
| Sikkerhedszone | 0 – Indeholder ikke fortrolige eller følsomme data |
| Adgangsniveau | Kendt bruger – der skal oprettes en webbruger og tjenestebruger med brugernavn og adgangskode |
| Adgangsbegrænsning | Ingen adgangsbegrænsning |
| Paging | Anvender paging. Default paging-størrelse: 20 |
| Dato- og tidsformat | Datoformat følger ISO 8601 Date and time format. Alle datoer skrives med andre ord i formatet yyyy-mm-ddTHH:MM:SS.ssssss, hvor tidsangivelsen kan udelades. UTC Tidszonen kan angives enten ved +HH:MM (2019-02-05T07:50:14.687580+01:00 (for normaltid/vintertid)), (2019-07-05T07:50:14.687580+0102:00 (for sommertid)) eller ved at benytte Z (2019-07-05T07:50:14.687580Z). |
REST - DAGI
| Anvendt udstillingsmodel | DAGImulti |
|---|---|
| SLA | Se registrets tilgængelighed på Datafordelerdatafordeler.dk |
Metodeoversigt
Metodenavn | SLA kategorier | Tværgående tjeneste |
|---|---|---|
DAGI | Kompleks | Nej |
SLA kategorier i produktion- maksimal svartid i sekunder:
- Simpel: 0.09
- Normal: 1.0
- Kompleks: 2.5
Metode - DAGI
Beskrivelse
Servicen skal finde de nærmeste DAGI temaer for et givet punkt. På land vil det være de DAGI temaer punktet ligger i (svarende til WITHIN). På vand vil det være de nærmeste DAGI temaer i en lige linje ind til land (dog ikke Supplerende Bynavn, der kun søger WITHIN). Der skal søges i multigeometrier (DAGI_multi) og i referenceskala. Der skal kun søges blandt gældende objekter (ikke historiske og ikke fremtidige).
Eksempel på url med brugernavn/adgangskode
| https://services.datafordeler.dk/DAGIM/DAGI/1/rest/DAGI?x=xxxxxx&y=yyyyyy&username=xxx&password=yyy |
Eksempel på url med certifikat
| https://certservices.datafordeler.dk//DAGIM/DAGI/1/rest/DAGI?x=xxxxxx&y=yyyyyy |
Inputparametre
| Navn | Type | Beskrivelse | Tekstversion | UUID fra udstillingsmodel |
|---|---|---|---|---|
| point | String | UTM32 etrs89 geometripunkt defineret som indholdet i parentes fx point=(724786 6176332) | Kommuneinddeling.geometri | EAID_25AE826A_41DD_40a6_9AF4_3D347B1DA89F .
|
Outputparametre
| Metode | Skema |
|---|---|
| Den inkluderede fil ”dagi”DAGI_1.28_dagi.json” indeholder output som JSON-schema dagi.json | Skema - filudtræk og webservices (DAGI) (udfases 15. januar 2027) |