Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion API Adresse- og eiendomssøk/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
### Introduction
API-Adresse- og eiendomssøk is a REST API designed for accurate and rapid searches across multiple data sources in Norway. The service provides updated information from Norkart's synchronized copy of the land register and property register, with a maximum delay of one day.

![Implementation of the api together with a map](images\Sok_Produktbeskrivelse-D8mOVPYT.png) <br clear="left"/>
![Implementation of the api together with a map](./images/Sok_Produktbeskrivelse-D8mOVPYT.png) <br clear="left"/>
Implementation of the Adresse- og eiendomssøk API to enable interactive address and property search with a map.

### Main Functionality
Expand Down
18 changes: 0 additions & 18 deletions API Bakgrunnskart/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,24 +16,6 @@ Welcome to the documentation for Norkart API Bakgrunnskart. This service collect
| ------------- | ------------- | ------------- |
|<img src="images/Standardkart.png" width="300" /> | <img src="images/Gråkart.png" width="300" />| <img src="images/Ortofoto.png" width="300" />|

## Available maps (Tilesets) for TMS

Several types of map are available through the TMS service by replacing the "tileset" parameter in the url. The available maps are listed bellow:

```javascript
options: {
url: '//waapi.webatlas.no/maptiles/tiles/{tileset}/wa_grid/{z}/{x}/{y}.{ext}?APITOKEN={apikey}',
tileset: {
vector: {tileset: 'webatlas-standard-vektor', ext: 'png'},
aerial: {tileset: 'webatlas-orto-newup', ext: 'jpeg'},
hybrid: {tileset: 'webatlas-standard-hybrid', ext: 'jpeg'},
grey: {tileset: 'webatlas-gray-vektor', ext: 'png'},
medium: {tileset: 'webatlas-medium-vektor', ext: 'png'},
lite: {tileset: 'webatlas-lite-vektor', ext: 'png'}
},
}
```

## Authentication / API Key

To use Norkart's map services, you will need an API key. API keys are provided on a business-to-business (B2B) basis. If you are interested in a demo or wish to request an API key, please contact us at [datatjenester@norkart.no](mailto:datatjenester@norkart.no).
Expand Down
121 changes: 121 additions & 0 deletions API Flyfotokart Historisk/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,121 @@
# API Flyfotokart Historisk

Historiske flyfoto over hele Norge

API Flyfotokart Historisk er en kart- og flyfototjeneste som gir tilgang til historiske flyfoto over hele Norge. Tjenesten gir tilgang til verdifulle historiske flyfoto som gir muligheten til å utforske Norges landskap slik det har utviklet seg over tid.

Tjenesten tilbyr et omfattende arkiv av detaljerte historiske kart og flyfoto, inkludert eldre prosjekter. Den oppdateres kontinuerlig med nye historiske ortofotoprosjekter. Sorteringsmetodene sikrer prioritert visning basert på oppløsning og fotodato.

## Bruksområder

Her er noen eksempler på mulig bruk av de forskjellige bakgrunnskartene i tjenester. Alle kartene er lette å integrere i eksisterende webapplikasjoner.

- **Hvordan så byen ut for 20 år siden?**
- Ved å bruke tjenesten kan man finne historiske bilder fra spesifikke år og se hvordan forskjellige byer og områder så ut akkurat da. For eksempel kan man se biltrafikk på Trondheim Torg i tidligere tider.
- **Hvordan har byen forandret seg?**
- Ved å sammenlikne forskjellige historiske flyfoto kan man finne ut hvordan byen har forandret seg, hvordan veier er lagt om, når bygninger ble bygget og mer. Dette kan brukes til markedsføring, historisk forskning og museumsutstillinger.

## Eksempler på historiske flyfoto
Her er to eksempler på historiske flyfoto fra tjenesten:

1. Trondheim Torg på 1960-tallet - Dette flyfotoet viser hvordan Trondheim Torg så ut med aktiv biltrafikk gjennom torget. I dag er området bilfritt og en viktig møteplass i byen.

![Eksempel på historisk flyfoto](./images/flyfoto_eksempel_trondheimTorg-BY-pDpay.png)

1. Byutvikling over tid - Dette bildet viser samme område fotografert med flere års mellomrom. Man kan tydelig se hvordan bebyggelse, veier og grøntområder har endret seg gjennom årene.


![Eksempel på historisk flyfoto](./images/flyfoto_eksempel_forandring-DRfAjapU.png)


## Tjeneste-URL

```
https://waapi.webatlas.no/wms-orto-hist/
```

## WMS-operasjoner

| | |
|----------------------------------|-------------------------------------------------------------------------------------------------------------------------|
| **GetCapabilities** | Henter metadata om tjenesten, inkludert tilgjengelige lag og parametre |
| **GetMap** | Henter et kartbilde for et spesifisert område og innhold |
| **GetLegendGraphic (valgfritt)** | Henter en generert tegnforklaring for et kartlag |

## Eksempel på GetCapabilities-request

```
GET https://waapi.webatlas.no/wms-orto-hist/?REQUEST=GetCapabilities&SERVICE=WMS&api_key={{API_KEY}}
```

## Eksempel på GetMap-request

```
https://waapi.webatlas.no/wms-orto-hist/?SERVICE=WMS&REQUEST=GetMap&VERSION=1.1.1&LAYERS=wms-orto-hist:historisk&FORMAT=image/png&TRANSPARENT=true&HEIGHT=256&WIDTH=256&SRS=EPSG:3857&BBOX=640007.2378317807,8171118.323685342,640083.6748600659,8171194.760713628&api_key={{API_KEY}}
```

## Bruk i QGIS

For å bruke WMS i QGIS, lim inn URL med din Norkart API-nøkkel på slutten av URL-en. Husk å huke av for "Ignore GetMap/GetTile/GetLegendGraphic".

![QGIS-konfigurasjon](./images/qgis_config.png)

## Bruk i Leaflet.js
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Antar at det er testa at disse eksemplene under faktisk fungerer? 😄


```javascript
var map = L.map('map').setView([63.43, 10.39], 13);
L.tileLayer.wms("https://waapi.webatlas.no/wms-orto-hist/", {
layers: 'wms-orto-hist:historisk',
format: 'image/png',
transparent: true,
attribution: '&copy; Norkart',
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For attribution bør datascience-teamet finne ut av hva som blir riktig å sette, i alle fall kvalitetsikre at det som blir med her er riktig.

Slik at dersom kunder bruker dette som utgangspunkt, så blir det rett.

api_key: '{{API_KEY}}'
}).addTo(map);
```

## Bruk i Mapbox GL JS

```javascript
map.addSource('wms', {
'type': 'raster',
'tiles': [
'https://waapi.webatlas.no/wms-orto-hist/?SERVICE=WMS&REQUEST=GetMap&VERSION=1.1.1&LAYERS=wms-orto-hist:historisk&FORMAT=image/png&TRANSPARENT=true&BBOX={bbox-epsg-3857}&SRS=EPSG:3857&WIDTH=256&HEIGHT=256&api_key={{API_KEY}}'
],
'tileSize': 256
});
map.addLayer({
'id': 'wms-layer',
'type': 'raster',
'source': 'wms',
'paint': {}
});
```

## Bruk i OpenLayers

```javascript
var wmsSource = new ol.source.TileWMS({
url: 'https://waapi.webatlas.no/wms-orto-hist/',
params: {'LAYERS': 'wms-orto-hist:historisk', 'TILED': true, 'api_key': '{{API_KEY}}'},
serverType: 'geoserver'
});
var wmsLayer = new ol.layer.Tile({
source: wmsSource
});
var map = new ol.Map({
target: 'map',
layers: [wmsLayer],
view: new ol.View({
center: ol.proj.fromLonLat([10.39, 63.43]),
zoom: 13
})
});
```

## Ressurser
- [WMS i Leaflet](https://leafletjs.com/examples/wms/wms.html)
- [WMS i Mapbox](https://docs.mapbox.com/mapbox-gl-js/example/wms/)
- [Geoserver WMS-dokumentasjon](https://docs.geoserver.org/stable/en/user/services/wms/reference.html)

## Kontakt og tilgang
For kontakt og tilgang til API-nøkkel, se [Norkart Datatjenester](https://www.norkart.no/datatjenester).
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion API Takgeometri og solinnstråling/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ For a more detailed view or when you expect the user might have typos or slight

**Request**:
\```http
GET https://takflater.api.norkart.no/takflater/punkt?Y=59.908&X=10.767&api_key={{YOUR_API_KEY}}
GET https://waapi-takflater.api.norkart.no/takflater/punkt?Y=59.908&X=10.767&api_key={{YOUR_API_KEY}}
\```

**Response**:
Expand Down
4 changes: 4 additions & 0 deletions Articles/TMS/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,10 @@ options: {
}
```

## API Key

To access the API, request your key [here](https://www.norkart.no/datatjenester).

## Integration Guides

### QGIS
Expand Down
2 changes: 1 addition & 1 deletion Articles/WMS/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ WMS requests can perform (among others) the following operations [[1]](#1):
| **GetLegendGraphic (optional)** | Retrieves a generated legend for a map |

## Example calls
Examples are shown for wms-takhelning. If you want to test this out yourself you will need an Api key. Test the examples by replacing '{{API_KEY}}' with your own api key. Request API access [here](https://www.norkart.no/dataoganalyse/).
Examples are shown for wms-takhelning. If you want to test this out yourself you will need an Api key. Test the examples by replacing '{{API_KEY}}' with your own api key. Request API access [here](https://www.norkart.no/datatjenester).

## GetCapabilities:

Expand Down
23 changes: 23 additions & 0 deletions Articles/matrikkel-ID/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
# Matrikkelidentifikator

The matrikkelidentifikator is a 20-digit string, constructed in the following manner

`KKKKGGGGGBBBBFFFFSSS`

Where:
* KKKK is kommune(municipality)-number padded with zeroes to be 4 characters wide
* GGGGG is gårdsnummer, padded with zeroes to be 5 characters wide
* BBBB is brukssnummer, padded with zeroes to be 4 characters wide
* FFFF is festenummer, padded with zeroes to be 4 characters wide. This is optional, and set to 0000 if not present
* SSS is seksjonsnummer, padded with zeroes to be 3 characters wide. This is optional, and set to 000 if not present

## Example

We have an eiendom:
* kommune: 0301
* gårdsnummer: 31
* bruksnummer: 472
* festenummer: null
* seksjonsnummer: null

This becomes: `03010003104720000000`
5 changes: 3 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Norkart API Documentation

Welcome to the Norkart API documentation. This repository contains developer documentation, examples, and tutorials for some of our public API offerings. For product listings, API keys, contact, and support, visit [Norkart Data and Analysis](https://www.norkart.no/dataoganalyse/).
Welcome to the Norkart API documentation. This repository contains developer documentation, examples, and tutorials for some of our public API offerings. For product listings, API keys, contact, and support, visit [Norkart Datatjenester](https://www.norkart.no/datatjenester).

## Available Documentation

Expand All @@ -11,6 +11,7 @@ Explore our [code examples and tutorials](<code and tutorials/README.md>) to see
We provide detailed documentation for the following APIs:

* [API Bakgrunnskart](<API Bakgrunnskart/README.md>)
* [API Flyfotokart historisk](<API Flyfotokart Historisk/README.md>)
* [API Adresse- og eiendomssøk](<API Adresse- og eiendomssøk/README.md>)
* [API Eiendomsdata](<API Eiendomsdata/README.md>)
* [API Datavarehus](<API Datavarehus/README.md>)
Expand All @@ -34,4 +35,4 @@ https://fritekstsok.api.norkart.no/suggest/matrikkel/adresse?Query=Oslovei&api_k
Check out our [Norkart API Demo](https://mango-flower-0fd4d4b03.azurestaticapps.net/) to see a minimalistic map application that uses API Bakgrunnskart, API Adresse- og eiendomssøk, and API Eiendomsdata.

## Request API Access
To request API access, visit [Norkart Data and Analysis](https://www.norkart.no/dataoganalyse/).
To request API access, visit [Norkart Data and Analysis](https://www.norkart.no/datatjenester).
2 changes: 1 addition & 1 deletion code and tutorials/cesium-and-leaflet-example/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ This example uses the following of Norkart's services:
- Norkart WMS-Orto(imagery provider for cesium)

### How to get keys?
- Request API access [here](https://www.norkart.no/dataoganalyse/).
- Request API access [here](https://www.norkart.no/datatjenester).

## Built With
- Typescript - Language.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
//Initiating Leaflet map and set the view to coordinates (in WGS84 / EPSG:3857) and zoom level 13
var map = L.map('mapid').setView([58.14615, 7.99573], 13);

var apiKey = '07C4A129-9D26-4B3D-9BC8-B22E4B6E509E'; //DO NOT USE THIS KEY: DEMO ONLY. Request API access here: https://www.norkart.no/dataoganalyse/.
var apiKey = ''; // Request API access here: https://www.norkart.no/datatjenester.

var baseLayers = {
'Kart': L.tileLayer.webatlas({
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -129,7 +129,7 @@ var map = L.map('mapid').setView([58.14615, 7.99573], 13);
We then define a variable and instantiate with API key. (As shown below)

```
var apiKey = '07C4A129-9D26-4B3D-9BC8-B22E4B6E509E'; //DO NOT USE THIS KEY: DEMO ONLY. Request API access [here](https://www.norkart.no/dataoganalyse/).
var apiKey = '07C4A129-9D26-4B3D-9BC8-B22E4B6E509E'; //DO NOT USE THIS KEY: DEMO ONLY. Request API access [here](https://www.norkart.no/datatjenester).
```

#### 4.3 Define different type of views on map displaying.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -24,4 +24,4 @@ style: {

### Api Key

Request API access [here](https://www.norkart.no/dataoganalyse/).
Request API access [here](https://www.norkart.no/datatjenester).
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ This is a demo of Norkart's maptiles, search and 'matrikkelkart' APIs. In this s
- Change between norkart's various maptiles.

## API Key
In order to see the demo or use these APIs in your own projects, you will first need an API key. Request API access [here](https://www.norkart.no/dataoganalyse/).
In order to see the demo or use these APIs in your own projects, you will first need an API key. Request API access [here](https://www.norkart.no/datatjenester).

## Built With
- Typescript - Language.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -86,7 +86,7 @@ export const ApiKeyPage = () => {
You can get a free API key to try it out at
</Typography>

<Button color='primary' onClick={() => openInNewTab("https://www.norkart.no/dataoganalyse/apikart")}>
<Button color='primary' onClick={() => openInNewTab("https://www.norkart.no/datatjenester")}>
norkart.no
</Button>

Expand Down