diff --git "a/API Adresse- og eiendomss\303\270k/README.md" "b/API Adresse- og eiendomss\303\270k/README.md" index f886167..c1c84cb 100644 --- "a/API Adresse- og eiendomss\303\270k/README.md" +++ "b/API Adresse- og eiendomss\303\270k/README.md" @@ -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)
+![Implementation of the api together with a map](./images/Sok_Produktbeskrivelse-D8mOVPYT.png)
Implementation of the Adresse- og eiendomssøk API to enable interactive address and property search with a map. ### Main Functionality diff --git a/API Bakgrunnskart/README.md b/API Bakgrunnskart/README.md index 8baa8b9..68269b6 100644 --- a/API Bakgrunnskart/README.md +++ b/API Bakgrunnskart/README.md @@ -16,24 +16,6 @@ Welcome to the documentation for Norkart API Bakgrunnskart. This service collect | ------------- | ------------- | ------------- | | | | | -## 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). diff --git a/API Flyfotokart Historisk/README.md b/API Flyfotokart Historisk/README.md new file mode 100644 index 0000000..a08cbeb --- /dev/null +++ b/API Flyfotokart Historisk/README.md @@ -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 + +```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: '© Norkart', + 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). \ No newline at end of file diff --git a/API Flyfotokart Historisk/images/flyfoto_eksempel_forandring-DRfAjapU.png b/API Flyfotokart Historisk/images/flyfoto_eksempel_forandring-DRfAjapU.png new file mode 100644 index 0000000..96198a4 Binary files /dev/null and b/API Flyfotokart Historisk/images/flyfoto_eksempel_forandring-DRfAjapU.png differ diff --git a/API Flyfotokart Historisk/images/flyfoto_eksempel_trondheimTorg-BY-pDpay.png b/API Flyfotokart Historisk/images/flyfoto_eksempel_trondheimTorg-BY-pDpay.png new file mode 100644 index 0000000..a0eb36d Binary files /dev/null and b/API Flyfotokart Historisk/images/flyfoto_eksempel_trondheimTorg-BY-pDpay.png differ diff --git "a/API Takgeometri og solinnstr\303\245ling/README.md" "b/API Takgeometri og solinnstr\303\245ling/README.md" index 8b792b2..a84ff22 100644 --- "a/API Takgeometri og solinnstr\303\245ling/README.md" +++ "b/API Takgeometri og solinnstr\303\245ling/README.md" @@ -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**: diff --git a/Articles/TMS/README.md b/Articles/TMS/README.md index 965c57d..70a1f14 100644 --- a/Articles/TMS/README.md +++ b/Articles/TMS/README.md @@ -28,6 +28,10 @@ options: { } ``` +## API Key + +To access the API, request your key [here](https://www.norkart.no/datatjenester). + ## Integration Guides ### QGIS diff --git a/Articles/WMS/README.md b/Articles/WMS/README.md index dbe9d3c..bbf59eb 100644 --- a/Articles/WMS/README.md +++ b/Articles/WMS/README.md @@ -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: diff --git a/Articles/matrikkel-ID/README.md b/Articles/matrikkel-ID/README.md new file mode 100644 index 0000000..ceaa9a7 --- /dev/null +++ b/Articles/matrikkel-ID/README.md @@ -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` diff --git a/README.md b/README.md index f76b625..de32ea9 100644 --- a/README.md +++ b/README.md @@ -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 @@ -11,6 +11,7 @@ Explore our [code examples and tutorials]() to see We provide detailed documentation for the following APIs: * [API Bakgrunnskart]() +* [API Flyfotokart historisk]() * [API Adresse- og eiendomssøk]() * [API Eiendomsdata]() * [API Datavarehus]() @@ -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/). \ No newline at end of file +To request API access, visit [Norkart Data and Analysis](https://www.norkart.no/datatjenester). \ No newline at end of file diff --git a/code and tutorials/cesium-and-leaflet-example/README.md b/code and tutorials/cesium-and-leaflet-example/README.md index 5cde244..5d527ec 100644 --- a/code and tutorials/cesium-and-leaflet-example/README.md +++ b/code and tutorials/cesium-and-leaflet-example/README.md @@ -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. diff --git a/code and tutorials/getting started - maptiles in leaflet.js/Kart-Flyfoto/mFlyfoto.js b/code and tutorials/getting started - maptiles in leaflet.js/Kart-Flyfoto/mFlyfoto.js index d52314f..96e7d7e 100644 --- a/code and tutorials/getting started - maptiles in leaflet.js/Kart-Flyfoto/mFlyfoto.js +++ b/code and tutorials/getting started - maptiles in leaflet.js/Kart-Flyfoto/mFlyfoto.js @@ -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({ diff --git a/code and tutorials/getting started - maptiles in leaflet.js/README.md b/code and tutorials/getting started - maptiles in leaflet.js/README.md index 3d5b161..eb597e3 100644 --- a/code and tutorials/getting started - maptiles in leaflet.js/README.md +++ b/code and tutorials/getting started - maptiles in leaflet.js/README.md @@ -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. diff --git a/code and tutorials/getting started - maptiles in mapbox.gl/README.md b/code and tutorials/getting started - maptiles in mapbox.gl/README.md index 2d4cc43..773fa5f 100644 --- a/code and tutorials/getting started - maptiles in mapbox.gl/README.md +++ b/code and tutorials/getting started - maptiles in mapbox.gl/README.md @@ -24,4 +24,4 @@ style: { ### Api Key -Request API access [here](https://www.norkart.no/dataoganalyse/). \ No newline at end of file +Request API access [here](https://www.norkart.no/datatjenester). \ No newline at end of file diff --git a/code and tutorials/reactleaflet_fritekstsok_maptiles_matrikkelkart_example/README.md b/code and tutorials/reactleaflet_fritekstsok_maptiles_matrikkelkart_example/README.md index 3f7744e..32a1a61 100644 --- a/code and tutorials/reactleaflet_fritekstsok_maptiles_matrikkelkart_example/README.md +++ b/code and tutorials/reactleaflet_fritekstsok_maptiles_matrikkelkart_example/README.md @@ -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. diff --git a/code and tutorials/reactleaflet_fritekstsok_maptiles_matrikkelkart_example/src/components/ApiKeyPage.tsx b/code and tutorials/reactleaflet_fritekstsok_maptiles_matrikkelkart_example/src/components/ApiKeyPage.tsx index e846aa4..10ed037 100644 --- a/code and tutorials/reactleaflet_fritekstsok_maptiles_matrikkelkart_example/src/components/ApiKeyPage.tsx +++ b/code and tutorials/reactleaflet_fritekstsok_maptiles_matrikkelkart_example/src/components/ApiKeyPage.tsx @@ -86,7 +86,7 @@ export const ApiKeyPage = () => { You can get a free API key to try it out at -