Börja med adressen, inte matrikkelnummeret
Skicka in en adresstext i Norge eller Sverige och få matrikkelnummer, postnummer och koordinat tillbaka i samma svar, klart för kartlagret eller nästa uppslag.
Nøkkelen virker i dag på Leietaker-API og dagens Data API; Placepoint API godtar samme nøkkel når det lanseres.
Prøv med et ekte bygg: Oslo S, Jernbanetorget 1
- Provnyckel med GitHub på under en minut
- Ett GET-anrop
- Norge och Sverige
- Data från Kartverket och Lantmäteriet
- Koordinat i svaret
ℹ️ Slutpunkten svarar när Placepoint API har lanserats. Kontraktet nedan är slutgiltigt, Hyresgäst-API svarar redan.
Från adress till matrikkelnummer
Anropet svarar på en fråga: vilken fastighet hör den här adressen till? Banker, mäklare och byggherrar har ofta en adress från ett formulär, ett avtal eller en förfrågan, och behöver matrikkelnummeret för att slå upp resten: fastighet, byggnad, ägare och transaktioner.
Adressen kan vara norsk eller svensk. Landet avgör vilket register svaret kommer från, Kartverkets adressregister eller Lantmäteriet via Combify. Svaret innehåller koordinat i samma anrop, så att ett system kan gå direkt vidare till kartlagret utan ett nytt uppslag.
Tål variation i stavningen
Ett manuellt uppslag kräver ofta exakt träff. Anropet matchar på adresstext och returnerar bästa träff först, så att en liten skillnad i stavning inte ger noll träffar.Koordinat i samma svar
Ingen separat geokodningstjänst att slå upp mot efteråt. Koordinaten följer med i samma anrop som matrikkelnummeret.Delvis adress ger flera träffar
En ofullständig adresstext ger flera kandidater i samma svar i stället för ett felmeddelande, så att ett system kan låta användaren välja rätt träff.
Fält som faktiskt säger något
Ett GET-anrop med adresstexten ger träfflistan nedan, med matrikkelnummer och koordinat på varje träff.
/addresses/{country}/{address}curl -X GET "https://data.placepoint.no/addresses/NO/Karl%20Johans%20gate%201%2C%20Oslo" \
-H "Authorization: Bearer $TOKEN"
svar · 200
{
"items": [
{
"text": "Karl Johans gate 1, 0154 Oslo",
"streetName": "Karl Johans gate",
"houseNumber": "1",
"postalCode": "0154",
"postalPlace": "Oslo",
"country": "NO",
"cadastreId": "0301-207-419-0-0",
"location": {
"lat": 59.9111,
"lon": 10.7528
}
}
]
}
Svaret ger cadastreId direkt, matrikkelnummeret i Norge och en slug för fastighetsbeteckning i Sverige, klart att användas i de andra slutpunkterna utan omräkning.
Tre steg till första svaret
Logga in med GitHub
Ett klick, under en minut, inget betalkort. Nyckeln kommer tillbaka till den här sidan.Anropa slutpunkten
Byt ut$TOKENi curl-anropet ovan mot din nyckel, och skicka adresstexten som parameter.Använd svaret
cadastreIdi svaret går direkt in i fastighetsuppslaget, eller skicka koordinaten vidare till kartlagret.
Data och källor
Norska adresser kommer från Kartverkets adressregister och uppdateras löpande. Svenska adresser kommer från Lantmäteriet via Combify och uppdateras löpande.
Se även
Frågor och svar
Hur färska är uppgifterna?
Vad täcker ni?
cadastreId.Fungerar det i Sverige?
Vilket matrikkelnummer får jag tillbaka?
cadastreId har redan rätt form: matrikkelnummer i Norge, slug för fastighetsbeteckning i Sverige. Ingen omräkning behövs innan du anropar de andra slutpunkterna.