API'et udstiller Danmarks sogne samt tilhørende funktionalitet.
Søg efter sogne. Returnerer de sogne der opfylder kriteriet.
GET https://api.dataforsyningen.dk/sogne| Navn | Beskrivelse |
|---|---|
kode | Sognets kode. 4 cifre. (Flerværdisøgning mulig). |
navn | Sognets navn. Der er forskel på store og små bogstaver. (Flerværdisøgning mulig). |
q | Søgetekst. Der søges i kode og navn. Alle ord i søgeteksten skal matche. Wildcard * er tilladt i slutningen af hvert ord. Der returneres højst 1000 resultater ved anvendelse af parameteren. |
autocomplete | Udfør søgning som autocomplete-søgning. |
x | Reverse geocoding. Find sognet for det angivne koordinat. Der benyttes det koordinatsystem, som er angivet i srid-parameteren (Default WGS84). |
y | Reverse geocoding. Find sognet for det angivne koordinat.' + 'Der benyttes det koordinatsystem, som er angivet i srid-parameteren (Default WGS84). |
nærmeste | Hvis denne parameter angives, sammen med x og y parametrene findes sognet der ligger nærmest det angivne punkt. |
callback | Output leveres i JSONP format. Se Dataformater. |
format | Output leveres i andet format end JSON. Se Dataformater. |
noformat | Parameteren angiver, at whitespaceformatering skal udelades |
ndjson | Output leveres i Newline Delimited JSON |
side | Angiver hvilken siden som skal leveres. Se Paginering. |
per_side | Antal resultater per side. Se Paginering. |
struktur | Struktur parameteren angiver om der ønskes en flad eller en nestet svarstruktur. Default er nestet for JSON, og flad for GeoJSON. |
srid | Angiver SRID for det koordinatsystem, som geospatiale parametre er angivet i. Default er 4326 (WGS84 / Geografiske koordinater). For ETRS89 / UTM zone 32 Nord anvender du 25832 |
cirkel | Find de sogne, som overlapper den cirkel angivet af koordinatet (x,y) og radius r. Som koordinatsystem kan anvendes ETRS89/UTM32 eller WGS84/geografisk. Radius angives i meter. cirkel={x},{y},{r}. |
polygon | Find de sogne, som overlapper det angivne polygon. Polygonet specificeres som et array af koordinater på samme måde som koordinaterne specificeres i GeoJSON's polygon. Bemærk at polygoner skal være lukkede, dvs. at første og sidste koordinat skal være identisk. Som koordinatsystem kan anvendes (ETRS89/UTM32 eller) WGS84/geografisk. Dette angives vha. srid parameteren, se ovenover. Eksempel: polygon=[[[10.3,55.3],[10.4,55.3],[10.4,55.31],[10.4,55.31],[10.3,55.3]]]. |
Find alle de sogne som starter med grøn
https://api.dataforsyningen.dk/sogne?q=grøn*
Returner alle sogne
https://api.dataforsyningen.dk/sogne
Modtag sogn med kode.
GET https://api.dataforsyningen.dk/sogne/{kode}| Navn | Beskrivelse |
|---|---|
kode | Sognets kode. 4 cifre. |
struktur | Struktur parameteren angiver om der ønskes en flad eller en nestet svarstruktur. Default er nestet for JSON, og flad for GeoJSON. |
callback | Output leveres i JSONP format. Se Dataformater. |
format | Output leveres i andet format end JSON. Se Dataformater. |
noformat | Parameteren angiver, at whitespaceformatering skal udelades |
ndjson | Output leveres i Newline Delimited JSON |
Returner oplysninger om Grøndal sogn
https://api.dataforsyningen.dk/sogne/7060
Returnerer oplysninger om Grøndal sogn i GeoJSON format
https://api.dataforsyningen.dk/sogne/7060?format=geojson
Autocomplete på sogne. Der kan anvendes de samme parametre som ved søgning, men bemærk at q parameteren fortolkes anderledes. Læs mere under autocomplete.
GET https://api.dataforsyningen.dk/sogne/autocomplete| Navn | Beskrivelse |
|---|---|
kode | Sognets kode. 4 cifre. (Flerværdisøgning mulig). |
navn | Sognets navn. Der er forskel på store og små bogstaver. (Flerværdisøgning mulig). |
q | Se beskrivelse under autocomplete |
autocomplete | Udfør søgning som autocomplete-søgning. |
callback | Output leveres i JSONP format. Se Dataformater. |
format | Output leveres i andet format end JSON. Se Dataformater. |
noformat | Parameteren angiver, at whitespaceformatering skal udelades |
ndjson | Output leveres i Newline Delimited JSON |
side | Angiver hvilken siden som skal leveres. Se Paginering. |
per_side | Antal resultater per side. Se Paginering. |
Find alle de sogne som starter med grøn
https://api.dataforsyningen.dk/sogne/autocomplete?q=grøn
Modtag sognet for det angivne koordinat.
GET https://api.dataforsyningen.dk/sogne/reverse| Navn | Beskrivelse |
|---|---|
x | X koordinat. (Hvis ETRS89/UTM32 anvendes angives øst-værdien.) Hvis WGS84/geografisk anvendes angives bredde-værdien. |
y | Y koordinat. (Hvis ETRS89/UTM32 anvendes angives nord-værdien.) Hvis WGS84/geografisk anvendes angives længde-værdien. |
srid | Angiver SRID for det koordinatsystem, som geospatiale parametre er angivet i. Default er 4326 (WGS84 / Geografiske koordinater). For ETRS89 / UTM zone 32 Nord anvender du 25832 |
callback | Output leveres i JSONP format. Se Dataformater. |
format | Output leveres i andet format end JSON. Se Dataformater. |
noformat | Parameteren angiver, at whitespaceformatering skal udelades |
ndjson | Output leveres i Newline Delimited JSON |
struktur | Struktur parameteren angiver om der ønskes en flad eller en nestet svarstruktur. Default er nestet for JSON, og flad for GeoJSON. |
Returner sognet for punktet angivet af WGS84/geografisk koordinatet (12.5851471984198, 55.6832383751223)
https://api.dataforsyningen.dk/sogne/reverse?x=12.5851471984198&y=55.6832383751223
Returner sognet for punktet angivet af ETRS89/UTM32 koordinatet (725369.59, 6176652.55)
https://api.dataforsyningen.dk/sogne/reverse?x=725369.59&y=6176652.55&srid=25832
| Navn | Type | Optionelt | Beskrivelse | ||||
|---|---|---|---|---|---|---|---|
| href | string | nej | sognets unikke URL. | ||||
| ændret | string | nej | Tidspunkt for seneste ændring registreret i DAWA. Opdateres ikke hvis ændringen kun vedrører geometrien (se felterne geo_ændret og geo_version). | ||||
| geo_ændret | string | nej | Tidspunkt for seneste ændring af geometrien registreret i DAWA. | ||||
| geo_version | integer | nej | Versionsangivelse for geometrien. Inkrementeres hver gang geometrien ændrer sig i DAWA. | ||||
| bbox | array | ja | Geometriens bounding box, dvs. det mindste rectangel som indeholder geometrien. Består af et array af 4 tal. De første to tal er koordinaterne for bounding boxens sydvestlige hjørne, og to sidste tal er koordinaterne for bounding boxens nordøstlige hjørne. Anvend srid parameteren til at angive det ønskede koordinatsystem. | ||||
| item | number | nej | |||||
| visueltcenter | array | ja | Geometriens visuelle center. Kan eksempelvis anvendes til placering af labels. | ||||
| item | number | nej | |||||
| dagi_id | string | ja | Unik ID | ||||
| kode | string | nej | Sognets myndighedskode. Er unik for hvert sogn. 4 cifre. | ||||
| navn | string | nej | Sognets navn | ||||