Nationella geodataplattformen
För att använda API:erna för att konsumera datamängderna behöver du utveckla ett eget system eller ha tillgång till ett system (en programvara) samt bli konsument i NGP. Konsument blir du genom att ha ett användarkonto i Geotorget, godkänna användningsvillkoren för NGP och ordna behörighetsnycklar och därefter konfigurera ditt system.
Steg 1 Geotorget
Geotorget är Lantmäteriets e-tjänst för beställning av våra geodataprodukter. Det är också här du som producent eller konsument hanterar behörigheter, användningsvillkor och avtal för NGP.
1a. Konto på Geotorget
Om du inte har ett konto i Geotorget behöver du skapa ett.
Skapa konto på Geotorget för organisation
- Gå till Geotorget, klicka på Logga in.
- Välj ansök om konto och följ stegen för ansökan om organisationskonto.
Det kan ta cirka två arbetsdagar innan du får ditt användarkonto (ansökan granskas av Geodatasupport).
En organisation är till exempel: kommun, myndighet, aktiebolag, ideell förening, trossamfund, ekonomisk förening eller enskild firma.
1b. Ansök i Geotorget om att bli konsument NGP
Gör så här för att ansöka om att bli konsument NGP i Geotorget:
- Logga in i Geotorget.
- Välj Nationella geodataplattformen.
- Under Bli konsument, klicka på Ansök.
- Läs igenom och godkänn användarvillkoren genom att klicka för rutan.
- Skicka in ansökan.
Organisationskunder får två separata mejl med användarnamn respektive lösenord, det vill säga ett systemkonto. Du är nu den som har inloggningsuppgifterna till systemkonto för din organisation.
Efter du skickat in ansökan i Geotorget, så får du behörighet till API:erna och kan gå vidare till steg 2. Som konsument får du tillgång till alla producenters datamängder i NGP.
Om du inte är kontaktperson och fått uppgifter för systemkonto, logga in i Geotorget.
Steg 2 Val av autentisering
Autentisering kan ske med:
- Basic auth.
- OAuth 2.0.
OAuth 2.0 autentisering rekommenderas. Mer om autentisering.
Om basic auth ska användas, gå vidare till steg 3.
API-portalen för autentisering OAuth 2.0
Organisationskunder använder systemkonto för att logga in i API-portalen.
Logga in på API-portalen med inloggningsuppgifter enligt ovan.
Guide – API-portalen (pdf, nytt fönster)
Om organisationen har flera olika system bör olika behörighetsnycklar skapas per system.
Steg 3 Konfigurera ditt system
Nästa steg är att konfigurera ditt system med enligt vald autentiseringsmetod. Följ din systemleverantörs instruktioner för hur du går väga i just ditt system. Som utvecklare sker det genom programmering.
Vid Basic auth konfigureras systemet med uppgifterna för systemkonto.
Vid OAuth 2.0 konfigureras systemet med behörighetsnycklar man erhållit i API-portalen.
Använda API:erna
Om du har ett system från en systemutvecklare så har de använt API:erna för att bygga funktionalitet i deras system. Då behöver du inte veta exakt hur API:erna fungerar. Är du utvecklare så behöver du däremot veta mer om både API:erna och datamängderna.
Behöver du support?
Vår support för NGP är tillgänglig för att svara på frågor och reda ut problem.