Byggnad Direkt 1.3 - teknisk beskrivning Dokumentversion 1.2 Gränssnittsdefinition Verifiering WSDL XML-schema http://namespace.lantmateriet.se/distribution/produkter/byggnad/v1/b yggnad-1.3-ver.wsdl http://namespace.lantmateriet.se/distribution/produkter/byggnad/v1/b yggnad-1.3.xsd Produktion WSDL XML-schema http://namespace.lantmateriet.se/distribution/produkter/byggnad/v1/b yggnad-1.3.wsdl http://namespace.lantmateriet.se/distribution/produkter/byggnad/v1/b yggnad-1.3.xsd Frågor och svar Sök Byggnad Frågetyp GetByggnadRequest Hämta Byggnad med nedanstående sökbegrepp. Max 250 ID:n kan skickas in per fråga. objektidentitet Hämta Byggnad med objektidentitet för byggnad, möjligt att ange flera. IncludeData Här anges vad som ska returneras i svaret. IncludeData basinformation Hämta Byggnadsattribut, Byggnadsanmärkning, Byggnadsna mn, Byggnadsändamål, Skyddsrum och Entre. atgard Hämta Verksamhetsatgard.
geometri Hämta Byggnadsdel. berorkrets Hämta Tillhor, LiggerPa och BerorsAv. total Hämta all information. Exempel <GetByggnadRequest xmlns="http://namespace.lantmateriet.se/distribution/produkter/byggnad/v1"> <objektidentitet>12345678-1234-1234-1234-123456789abc</objektidentitet> <IncludeData> <total>true</total> </IncludeData> </GetByggnadRequest> Svar ByggnadResponse Byggnad Behållare för sökningens resultat - ingen, en eller flera sökträffar av typen Byggnad. Byggnad. Byggnad objektidentitet objektstatus Byggnadsattribut Globalt unik identitet (UUID) för varje byggnad. Anger aktuell status för byggnadsobjekt. Information om en byggnad anger grundläggande attribut om byggnaden, som t ex nybyggnadsår och tillhörighet till fastighet.
Byggnadsanmarkning Byggnadsnamn Byggnadsandamal Skyddsrum Entre Verksamhetsatgard Byggnadsdel Tillhor LiggerPa BerorsAv Information om byggnadens anmärkningar. Information om byggnadens namn. Anger vilket ändamål byggnaden används till. En byggnad kan ha flera byggnadsändamål t ex bostad eller industri. Referens till skyddsrum hos Myndigheten för samhällsskydd och beredskap (MSB) när skyddsrum finns. Information om en entré till en byggnad. Information om varför en förändring av byggnad är gjord. Information som beskriver en byggnads byggnadsdelar. Anger vilken fastighet, samfällighet eller gemensamhetsanläggning byggnaden tillhör. Anges endast om byggnaden tillhör annan fastighet, samfällighet eller gemensamhetsanläggning än den ligger på, t.ex. servitutsbyggnad. Tillhör anges i form av en registerenhetsreferens. Anger vilken fastighet, samfällighet eller gemensamhetsanläggning byggnaden ligger på. Ligger på anges i form av en registerenhetsreferens. Anger vilka 3D-utrymmen eller ägarlägenheter som finns i byggnaden. Berörs av anges i form av en registerenhetsreferens. Byggnadsattribut objektversion versiongiltigfran husnummer nybyggnadsar undantagenfranadressattning huvudbyggnad tillbyggnadsar ofrigrund byggnadsservitut Anger versionen på byggnadsobjektet. Tjänsten levererar alltid senaste versionen av byggnadsobjektet. Anger vilken tidpunkt objektversionen skapades. Unikt nummer på byggnad inom den fastighet eller samfällighet som byggnaden ligger på. Årtal när byggnaden uppfördes. Anger att byggnaden inte ska adressättas. Anger att byggnaden är huvudbyggnad i ett större komplex av byggnader. Årtal för senaste tillbyggnad. Anger att byggnaden ligger på Ofri grund, dvs. att byggnaden inte tillhör fastigheten eller samfälligheten som den ligger på. Ägaren till byggnaden överensstämmer inte med fastighetens eller samfällighetens ägare. Anger att det finns ett servitutsavtal som innebär att en byggnad belastar en annan fastighet eller samfällighet än den ligger på. Byggnadsanmarkning anmarkningstyp anmarkningstext Anger vilken typ av anmärkning anmärkningstexten avser. Anmärkningstexten kan avse Adress, Taxering, Ägare och Belägen på oidentifierat område. Text som tillhör anmärkningstypen. I de fall anmärkningstexten avser att byggnaden är Belägen på oidentifierat område anges alltid länoch kommunkod och byggnaden saknar husnummer.
Byggnadsnamn ortid namn namntyp Lantmäteriets ortnamnsidentitet på byggnadens namn. Byggnadensnamnet i klartext. Anger byggnadsnamnets ursprung och typ. Ursprunget och typen anges utifrån hur byggnadsnamnet är insamlat. (Bostad, Verksamhet, Ekonomibyggnad, Komplementbyggnad, Samhällsfunktion, Övrigbyggnad eller Industri ) Byggnadsandamal osakertandamal huvudandamal andamal totalboarea Anger att Byggnadsändamålet och/eller Ändamål är osäkert. Anger att ändamålet är byggnadens huvudändamål när byggnaden har flera ändamål. Detaljerat ändamål för byggnader med byggnadsändamål Bostad, Industri och Samhällsfunktion. Kan vara t ex Bostad - Småhus friliggande, Industri - Värmeverk. Hela boarean för alla ingående lägenheter i en Byggnad. Finns endast för byggnader med Bostad som byggnadsändamål. Skyddsrum identitet Om det finns ett skyddsrum i byggnaden anges en referens i form av identiteten i Myndigheten för samhällsskydd och beredskap (MSB) register. Entre objektstatus hiss entretyp adressid objektidentitetadress Anger aktuell status för entré. Statusen kan vara Planerad, Gällande, Gällande under utredning eller Avregistrerad. Anger om entré har hiss. Anger ändamål för entré, t ex Bostadsadress, Besöksadress och Bostadsadress med registrerad lägenhet. Anger referens till entréns belägenhetsadress i form av dess Riksnyckel. Anger referens till entréns belägenhetsadress i form av dess globalt unika identitet (UUID). Verksamhetsatgard atgardstyp ansvarigorganisation utforandeorganisation Anger vilken typ av förändring som är gjord, t ex Byggnaden färdigbyggd, Ändrad byggnadsinformation, och Ny entré. Anger vilken organisation/enhet/avdelning som ansvarar för en Verksamhetsåtgärd t ex LM_egen regi eller Gävle (kommunnamn i klartext). Anger vilken organisation/enhet/avdelning som har registrerat informationen om Verksamhetsåtgärd t ex LM_egen regi eller Gävle (kommunnamn i klartext).
atgardstidpunkt Anger tidpunkt för när beslutet om en Verksamhetsåtgärd togs eller registrerades vid hos utförande organisation. Byggnadsdel insamlingslage Byggnadsyta Anger hur läget på byggnadsytan har valts. Kan vara Takkant, Fasad, Illustrativt läge eller Ospecificerad. Byggnadens geometriska yta. Koordinaterna anges i plan och höjd. Byggnadsyta LagesnoggrannhetPlan LagesnoggrannhetHojd koordinatsystemplan koordinatsystemhojd Yta Se tabell Lägesnoggrannhet plan nedan Se tabell Lägesnoggrannhet höjd nedan Anger koordinatsystem för Objektgeometrins plankoordinater. Anger koordinatsystem för Objektgeometrins höjdkoordinater. Anger byggnadens geometriska yta. Koordinaterna anges i plan och höjd med x,y,z, där x,y anger koordinater i plan och z anger ett höjdvärde. En del byggnader har odefinierad höjd, i de fallen sätts ett defaultvärde som är 0,001. LagesnoggrannhetPlan utvarderingsmetod ingeninformation Resultat Anger metod som används för att bestämma kvalitén hos en byggnadsdel. Kan vara Indirekt mätmetod eller Okänd. Anger att uppgift för lägesnoggrannhet saknas. Se tabell Resultat Plan nedan LagesnoggrannhetHojd utvarderingsmetod ingeninformation Resultat Anger metod som används för att bestämma kvalitén hos en byggnadsdel. Kan vara Indirekt mätmetod eller Okänd. Anger att uppgift för lägesnoggrannhet saknas. Se tabell Resultat Höjd nedan ResultatPlan statistiskmetod varde vardeenhet Anger vilken statistisk metod som har använts för att bestämma värdet. Är alltid medelfel. Anger kvantitativt värde erhållet vid kvalitetsutvärdering. Anger i vilken enhet datakvaliteten rapporteras. Är alltid meter. ResultatHojd statistiskmetod varde vardeenhet Anger vilken statistisk metod som har använts för att bestämma värdet. Är alltid medelfel. Anger kvantitativt värde erhållet vid kvalitetsutvärdering. Anger i vilken enhet datakvaliteten rapporteras. Är alltid meter. Registerenhetsreferens
objektidentitet fastighetsnyckel beteckning typ Globalt unik identitet (UUID) för varje fastighet eller samfällighet. En unik kod som består av max 9 tecken och identifierar registerenhet i Fastighetsregistret. Beteckning på fastighet, samfällighet eller gemensamhetsanläggning bestående av kommun, trakt, block och enhet, t ex Gävle Berga 1:10. Anger om registerenhet är en Fastighet, Samfällighet eller Gemensamhetsanläggning. Exempel <app:byggnadresponse xmlns:app="http://namespace.lantmateriet.se/distribution/produkter/byggnad/v1" xmlns:gml="http://www.opengis.net/gml/3.2" gml:id="response"> <gml:boundedby> <gml:envelope srsname="epsg:3006"> <gml:lowercorner>6636689.87 646017.696</gml:lowerCorner> <gml:uppercorner>6636738.701 646035.121</gml:upperCorner> </gml:envelope> </gml:boundedby> <app:byggnadmember> <app:byggnad gml:id="id_123456789"> <gml:boundedby> <gml:envelope srsname="epsg:3006"> <gml:lowercorner>6636689.87 646017.696</gml:lowerCorner> <gml:uppercorner>6636738.701 646035.121</gml:upperCorner> </gml:envelope> </gml:boundedby> <app:objektidentitet>12345678-1234-1234-1234-123456789abc</app:objektidentitet> <app:objektstatus>gällande</app:objektstatus> <app:byggnadsattribut> <app:objektversion>1</app:objektversion> <app:versiongiltigfran>2010-10-10t00:00:00.0</app:versiongiltigfran> <app:husnummer>2</app:husnummer> <app:nybyggnadsar>1632</app:nybyggnadsar> <app:tillbyggnadsar>1789</app:tillbyggnadsar> </app:byggnadsattribut> <app:bostad> <app:andamal>flerfamiljshus</app:andamal> </app:bostad> <app:skyddsrum> <app:identitet>1234567</app:identitet> </app:skyddsrum> <app:entre> <app:objektstatus>gällande</app:objektstatus> <app:hiss>uppgift saknas</app:hiss> <app:entretyp>bostadsadress med registrerad lägenhet</app:entretyp> <app:adressid>11223344556</app:adressid> <app:adressuuid>12345678-1234-1234-1234-123456789abc</app:adressuuid> </app:entre> <app:entre> <app:objektstatus>gällande</app:objektstatus>
lägenhet</app:entretyp> <app:hiss>uppgift saknas</app:hiss> <app:entretyp>bostadsadress med registrerad <app:adressid>11223344556</app:adressid> <app:adressuuid>12345678-1234-1234-1234-123456789abc</app:adressuuid> </app:entre> <app:verksamhetsatgard> <app:atgardstyp>migrerat objekt</app:atgardstyp> <app:ansvarigorganisation>lantmäteriet</app:ansvarigorganisation> </app:verksamhetsatgard> <app:byggnadsdel> <app:insamlingslage>takkant</app:insamlingslage> <app:byggnadsyta> <app:lagesnoggrannhetplan> <app:utvarderingsmetod>okänd</app:utvarderingsmetod> <app:resultat> <app:statistiskmetod>medelfel</app:statistiskmetod> <app:varde>0.576</app:varde> <app:vardeenhet>meter</app:vardeenhet> </app:resultat> </app:lagesnoggrannhetplan> <app:lagesnoggrannhethojd> <app:utvarderingsmetod>okänd</app:utvarderingsmetod> <app:resultat> <app:statistiskmetod>medelfel</app:statistiskmetod> <app:varde>0.744</app:varde> <app:vardeenhet>meter</app:vardeenhet> </app:resultat> </app:lagesnoggrannhethojd> <app:koordinatsystemplan>sweref 99 TM</app:koordinatsystemPlan> <app:koordinatsystemhojd>rh 2000</app:koordinatsystemHojd> <app:yta> <gml:polygon gml:id="gm_3" srsdimension="3" srsname="epsg:3006"> <gml:exterior> <gml:linearring> <gml:poslist>7100656.588 667645.484 286.331 7100653.225 667649.848 286.331 7100660.334 667655.326 286.331 7100663.697 667650.962 286.331 7100656.588 667645.484 286.331</gml:posList> </gml:linearring> </gml:exterior> </gml:polygon> </app:yta> </app:byggnadsyta> </app:byggnadsdel> <app:liggerpa> <app:registerenhetsreferens> <app:objektidentitet>12345678-1234-1234-1234-1234-123456789abc</app:objektidentitet> <app:fastighetsnyckel>123456789</app:fastighetsnyckel> <app:beteckning>kommun TRAKT 1:1</app:beteckning> <app:typ>fastighet</app:typ> </app:registerenhetsreferens> </app:liggerpa> </app:byggnad>
</app:byggnadmember> </app:byggnadresponse> Hitta byggnad FindByggnadRequest Sök efter Byggnad med något av nedanstående sökbegrepp. ByggnadRegisterenhetFilter Sök Byggnad för en fastighet. ByggnadGeometryFilter Sök Byggnad inom givna geometrier. ByggnadRegisterenhetFilter fastighetsnyckel Hitta Byggnad för fastighet, fastighet identifieras med fastighetsnyckel. objektidentitet Hitta Byggnad för fastighet, fastighet identifieras med UUID. Exempel <FindByggnadRequest xmlns="http://namespace.lantmateriet.se/distribution/products/byggnad/v1"> <ByggnadRegisterenhetFilter> <fastighetsnyckel>123456789</fastighetsnyckel> </ByggnadRegisterenhetFilter> </FindByggnadRequest> ByggnadGeometryFilter Geometry Hitta Byggnad med geometri som angiven geometri träffar. buffer Område runt den angivna geometrin som ska ingå i sökträffen. Geometry Hitta Byggnad som berörs av angiven geometri. Geometrin ska följa Lantmäteriets GML 3.2.1-profil för tillhandahållande med referenssystemet (attributet srsname) 3006.
gml:point gml:linestring gml:polygon gml:multipoint gml:multicurve gml:multisurface Koordinat angiven i Sweref 99 TM (enligt ordningen northing, easting). Koordinater angivna i Sweref 99 TM (enligt ordningen northing, easting). Koordinater angivna i Sweref 99 TM (enligt ordningen northing, easting). Koordinater angivna i Sweref 99 TM (enligt ordningen northing, easting). Koordinater angivna i Sweref 99 TM (enligt ordningen northing, easting). Koordinater angivna i Sweref 99 TM (enligt ordningen northing, easting). Geometrier får inte innehålla mer än totalt 1 000 koordinatpar. Den största längd en linje får ha är 100 000 meter och geometrins maxarea är 1 000 000 m 2. Maximal total omkrets är 200 000 meter. Exempel <FindByggnadRequest xmlns="http://namespace.lantmateriet.se/distribution/products/byggnad/v1" xmlns:gml="http://www.opengis.net/gml"> <ByggnadGeometryFilter> <gml:point srsname="epsg:3006"> <gml:pos>6361026.0 609376.7</gml:pos> </gml:point> <buffer>0</buffer> </ByggnadGeometryFilter> </FindByggnadRequest> Svar ByggnadsreferensResponse Byggnadereferens Behållare för sökningens resultat - ingen, en eller flera sökträffar av typen Byggnadsreferens. Referens till Byggnad. Byggnadreferens objektidentitet Universalt unik identitet. Stabilt nyckelbegrepp som ej är informationsbärande.
Exempel <app:byggnadsreferensresponse xmlns:app="http://namespace.lantmateriet.se/distribution/produkter/byggnad/v1" xmlns:gml="http://www.opengis.net/gml/3.2"> <app:byggnadsreferens> <app:objektidentitet>12345678-1234-1234-1234-123456789abc</app:objektidentitet> </app:byggnadsreferens> <app:byggnadsreferens> <app:objektidentitet>12345678-4321-4321-4321-123456789abc</app:objektidentitet> </app:byggnadsreferens> </app:byggnadsreferensresponse> Höjd De flesta byggnader har höjdvärden i byggnadsgeometrin men en del har odefinierad höjd. Tjänsten levererar alltid höjdvärden och i de fall som höjden är odefinirerad sätts ett defaultvärde som är 0,001. Exempel. <app:yta> <gml:polygon gml:id="gm_3" srsdimension="3" srsname="epsg:3006"> <gml:exterior> <gml:linearring> <gml:poslist>7100656.588 667645.484 0.001 7100653.225 667649.848 0.001 7100660.334 667655.326 0.001 7100663.697 667650.962 0.001 7100656.588 667645.484 0.001</gml:posList> </gml:linearring> </gml:exterior> </gml:polygon> </app:yta>. Begränsningar Följande begränsningar gäller för varje fråga: GetByggnadRequest Begränsning Antal objektidentitet-id:n. Maxvärde 250 st FindByggnadRequest Begränsning Maxvärde
Antal punkter i en MultiPoint. 1 000 st Antal brytpunkter i en LineString eller MultiCurve. 1 000 st Antal brytpunkter i en Polygon eller MultiSurface. 1 000 st Längd på en LineString eller sammanlagd längd på en MultiCur ve. 100 000 m Area för en Polygon eller sammanlagd area för en MultiSurface. 1 000 000 m 2 Omkrets på en Polygon eller sammanlagd omkrets på en MultiSu rface. 200 000 m Enumerationer & koder Vissa fält som i databasen innehåller koder tolkas och översätts till "riktiga" värden. Följande översättningar är definierade: Fältet objektstatus i Byggnad 1 Planerad 2 Gällande 3 Gällande under utredning 4 Avregistrerad Fältet anmärkningstyp i Byggnadsanmarkning 06 Adress 07 Taxering 08 Ägare 09 Belägen på oidentifierat område Fältet namntyp i Byggnadsnamn 1 Huvudnamn topografi 2 Övrigt nanm topografi 3 Alternativnamn 4 Alternativ byggnadsbeteckning Fältet objektstatus i Entre 1 Gällande 3 Avregistrerad 4 Planerad
Fältet hiss i Entre 1 Ja 2 Nej 9 Uppgift saknas Fältet entretyp i Entre 1 Bostadsadress 2 Bostadsadress med registrerad lägenhet 3 Butiksadress 4 Besöksadress 5 Leveransadress 9 Uppgift saknas Fältet atgardstyp i Verksamhetsatgard 100 Migrerat objekt 200 Godkänt bygglov 201 Ny färdigbyggd byggnad 202 Befintlig byggnad 203 Byggnaden färdigbyggd 204 Ändrad byggnadsinformation 205 Riven, nedbrunnen byggnad 206 Felregistrerad byggnad Fältet insamlingslage i Byggnadsdel 0 Ospecificerad 1 Fasad 3 Takkant 4 Illustrativt läge Fältet utvarderingsmetod i Lagesnoggrannhet 0 Okänd
1 Indirekt Fältet ingeninformation i Lagesnoggrannhet J Ja Fältet statistiskmetod i Resultat Har alltid värdet Medelfel Fältet statistiskmetod i Resultat Har alltid värdet Medelfel Fältet statistiskmetod i Resultat Har alltid värdet Medelfel Fältet vardeenhet i Resultat Har alltid värdet Meter Fältet typ i Registerenhetsreferens 01A 01B 01C Fastighet Samfällighet Gemensamhetsanläggning Fältet andamal i Bostad 100 Ospecificerad 101 Småhus friliggande 102 Småhus kedjehus 103 Småhus radhus 104 Flerfamiljehus 105 Småhus med flera lägenheter Fältet andamal i Industri
200 Ospecificerad 201 Industrihotell 202 Kemisk industri 203 Livsmedelsindustri 204 Metall eller maskinindustri 205 Textilindustri 206 Trävaruindustri 207 Annan tillverkningsindustri 208 Övrig industribyggnad 209 Gasturbinanläggning 210 Kondenskraftverk 211 Kärnkraftverk 212 Vattenkraftverk 213 Vindkraftverk 214 Värmeverk Fältet andamal i Samhallsfunktion 400 Ospecificerad 401 Badhus 402 Brandstation 403 Busstation 404 Distributionsbyggnad 405 Djursjukhus 406 Försvarsbyggnad 407 Vårdcentral 408 Högskola 409 Ishall 410 Järnvägsstation 411 Kommunhus 412 Kriminalvårdsanstalt 413 Kulturbyggnad 414 Polisstation 415 Reningsverk
416 Ridhus 417 Samfund 418 Sjukhus 419 Skola 420 Sporthall 421 Universitet 422 Vattenverk 423 Multiarena