Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Opdateret DLS-version - ingen ændring på REST fra 1.17 til 1.26

Anchor
Toppen
Toppen



Siden beskriver de 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å Datafordeler.dk

Få en introduktion til Webservice på Datafordeleren (REST), 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 på Selvbetjeningen (REST).


Table of Contents








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.



Url-struktur for REST services <endpoint>/register/service/version/servicetype/metode? 
Eksempelhttps://services.datafordeler.dk/DAGIM/DAGI/1/REST/DAGI?x=724786&y=6176332&username=xxx&password=yyy






Generelt for DAGI webservices

FormatXML/JSON
DLS version1.1726
Sikkerhedszone0 – Indeholder ikke fortrolige eller følsomme data
AdgangsniveauKendt bruger – der skal oprettes en webbruger og tjenestebruger med brugernavn og adgangskode 
AdgangsbegrænsningIngen adgangsbegrænsning
PagingAnvender 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 kan angives enten ved +HH:MM (2019-07-05T07:50:14.687580+01:00) eller ved at benytte Z (2019-07-05T07:50:14.687580Z)





REST - DAGI

Anvendt udstillingsmodelDAGImulti
SLASe registrets tilgængelighed på Datafordeler.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).


Inputparametre

NavnTypeBeskrivelseTekstversionUUID fra udstillingsmodel
pointStringUTM32 etrs89 geometripunkt defineret som indholdet i parentes  fx point=(724786 6176332)

Kommuneinddeling.geometri
Sogneinddeling.geometri
Postnummerinddeling.geometri
Afstemningsområde.geometri
Retskreds.geometri
Politikreds.geometri
Opstillingskreds.geometri
Regionsindeling.geometri
Danmark.geometri
Landsdel.geometri
Storkreds.geometri
Valglandsdel.geometri
Supplerendebynavn.geometri
Menighedsrådsafstemningsområde.geometri

EAID_25AE826A_41DD_40a6_9AF4_3D347B1DA89F

.


EAID_27F43710_17B9_4bb0_9D3A_FBB9151641B7
EAID_B2A1A022_22C1_47f3_89CB_DA180694F9C0

.


EAID_27F43710_17B9_4bb0_9D3A_FBB9151641B7
EAID_69F75074_3639_4e58_9DDD_0A406A8C4CE9

.


EAID_27F43710_17B9_4bb0_9D3A_FBB9151641B7
EAID_38545A1D_2A85_4020_A332_A0195A41310C

.


EAID_27F43710_17B9_4bb0_9D3A_FBB9151641B7
EAID_CB891B9E_1E6B_42de_8606_69C654EBD502

.


EAID_27F43710_17B9_4bb0_9D3A_FBB9151641B7
EAID_65DDC19B_C90A_4c4a_8F5E_6A1713935315

.


EAID_27F43710_17B9_4bb0_9D3A_FBB9151641B7
EAID_CBF72A8E_8E85_4912_B1D8_FBA7C550525F

.


EAID_27F43710_17B9_4bb0_9D3A_FBB9151641B7
EAID_5534B4C2_1EC6_476f_B790_21629F6B170E

.


EAID_27F43710_17B9_4bb0_9D3A_FBB9151641B7
EAID_4D778A13_4A20_48a5_A8BA_EF13DC9E2B7D

.


EAID_27F43710_17B9_4bb0_9D3A_FBB9151641B7
EAID_C802AB6B_35F5_4ccd_8607_7EF1E7ABFEC8

.


EAID_27F43710_17B9_4bb0_9D3A_FBB9151641B7
EAID_6F0AF423_DE97_44fc_BEE5_9641CEF5A36B

.


EAID_27F43710_17B9_4bb0_9D3A_FBB9151641B7
EAID_B20242CF_7C31_40f3_93BF_1E65E6C4C8AF

.


EAID_27F43710_17B9_4bb0_9D3A_FBB9151641B7
EAID_85C63003_25C1_450b_9700_AF2A274248EB

.


EAID_27F43710_17B9_4bb0_9D3A_FBB9151641B7
EAID_29CD703F_24CC_4479_B620_1F3D544702AD

.


EAID_27F43710_17B9_4bb0_9D3A_FBB9151641B7


Outputparametre

MetodeSkema
Den inkluderede fil ”dagi.”DAGI_1.17_dagi.json” indeholder output som JSON-schema  

dagi.json 

Skema - filudtræk og webservices (DAGI)