Byggnad Direkt v1.3 - teknisk beskrivning Dokumentversion 1.3 Gränssnittsdefinition Verifiering WSDL XML-schema http://namespace.lantmateriet.se/distribution/produkter/byggnad/v1/byggnad-1.3-ver.wsdl http://namespace.lantmateriet.se/distribution/produkter/byggnad/v1/byggnad-1.3.xsd Produktion WSDL XML-schema http://namespace.lantmateriet.se/distribution/produkter/byggnad/v1/byggnad-1.3.wsdl http://namespace.lantmateriet.se/distribution/produkter/byggnad/v1/byggnad-1.3.xsd Frågor och svar Hämta 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, Byggnadsnamn, 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 Universalt unik identitet. Stabilt nyckelbegrepp som ej är informationsbärande. Anger aktuell status för byggnadsobjekt. Samlad 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 Samlad information om byggnadens anmärkningar. Samlad information om byggnadens namn. Samlad information om byggnadens ändamål. Referens till skyddsrum hos Myndigheten för samhällsskydd och beredskap (MSB) när skyddsrum finns. Sammanhållen information om en entré till en byggnad. Samlad information om varför en förändring av byggnad är gjord. Samlad 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 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. undantagenfranadressattning huvudbyggnad tillbyggnadsar ofrigrund byggnadsservitut 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än- och 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 Anger att Byggnadsändamålet och/eller Ändamål är osäkert.
huvudandamal Anger att ändamålet är byggnadens huvudändamål när byggnaden har flera ändamål. andamal 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. totalboarea 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 atgardstidpunkt 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). 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 Lägesnoggrannhet i plan i förhållande till övergripande koordinatsystem. Lägesnoggrannhet i höjd i förhållande till övergripande koordinatsystem. Anger koordinatsystem för Objektgeometrins plankoordinater. Anger koordinatsystem för Objektgeometrins höjdkoordinater. 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. Lagesnoggrannhet 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. Uppgifter som har erhållits vid en kvalitetsutvärdering av planinformation. Resultat
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 värdetyp för rapportering av datakvalitet. Är alltid meter. Registerenhetsreferens objektidentitet fastighetsnyckel beteckning typ Universalt unik identifierare för fastighet i fastighetsregistret i form av UUID. Unik identifierare för fastighet i fastighetsregistret även kallad FNR. 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 <?xml version="1.0" encoding="utf-8"?> <app:byggnadresponse gml:id="response" xmlns:app="http://namespace.lantmateriet.se/distribution/produkter/byggnad/v1" xmlns:gml="http://www.opengis.net/gml/3.2" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance"> <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_0"> <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>2011-01-01t00:06:40.0</app:versiongiltigfran> <app:husnummer>2</app:husnummer> <app:nybyggnadsar>2000</app:nybyggnadsar> <app:undantagenfranadressattning>true</app:undantagenfranadressattning> <app:huvudbyggnad>true</app:huvudbyggnad> <app:tillbyggnadsar>2002</app:tillbyggnadsar> <app:ofrigrund>true</app:ofrigrund> <app:byggnadsservitut>true</app:byggnadsservitut> </app:byggnadsattribut> <app:byggnadsanmarkning> <app:anmarkningstyp>adress</app:anmarkningstyp> <app:anmarkningstext>stora villan</app:anmarkningstext> </app:byggnadsanmarkning> <app:byggnadsanmarkning> <app:anmarkningstyp>taxering</app:anmarkningstyp> <app:anmarkningstext>tidigare taxerat som småhus-värde mindre än 50 tkr</app:anmarkningstext> </app:byggnadsanmarkning>
<app:byggnadsnamn> <app:ortid>id1</app:ortid> <app:namn>fina huset</app:namn> <app:namntyp>alternativnamn</app:namntyp> </app:byggnadsnamn> <app:bostad> <app:osakertandamal>false</app:osakertandamal> <app:huvudandamal>false</app:huvudandamal> <app:andamal>småhus kedjehus</app:andamal> <app:totalboarea>3</app:totalboarea> </app:bostad> <app:industri> <app:andamal>kärnkraftverk</app:andamal> </app:industri> <app:samhallsfunktion> <app:huvudandamal>true</app:huvudandamal> <app:andamal>vårdcentral</app:andamal> </app:samhallsfunktion> <app:ovrigbyggnad> <app:osakertandamal>false</app:osakertandamal> <app:huvudandamal>false</app:huvudandamal> </app:ovrigbyggnad> <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>butiksadress</app:entretyp> <app:adressid>11223344556</app:adressid> <app:objektidentitetadress>12345678-cafe-cafe-cafe-123456789abc</app:objektidentitetad ress> </app:entre> <app:entre> <app:objektstatus>gällande under utredning</app:objektstatus> <app:hiss>nej</app:hiss> <app:entretyp>bostadsadress med registrerad lägenhet</app:entretyp> <app:adressid>10000000123</app:adressid> <app:objektidentitetadress>11111111-2222-3333-4444-555555555555</app:objektidentitetad ress> </app:entre> <app:verksamhetsatgard> <app:atgardstyp>riven, nedbrunnen byggnad</app:atgardstyp> <app:ansvarigorganisation>lantmäteriet</app:ansvarigorganisation> <app:utforandeorganisation>lm</app:utforandeorganisation> <app:atgardstidpunkt>2010-12-31t22:13:20.0</app:atgardstidpunkt> </app:verksamhetsatgard> <app:byggnadsdel> <app:insamlingslage>fasad</app:insamlingslage> <app:byggnadsyta> <app:lagesnoggrannhetplan> <app:utvarderingsmetod>okänd</app:utvarderingsmetod> <app:resultat> <app:statistiskmetod>medelfel</app:statistiskmetod> <app:varde>1.1</app:varde> <app:vardeenhet>meter</app:vardeenhet> </app:resultat> </app:lagesnoggrannhetplan> <app:lagesnoggrannhethojd>
<app:utvarderingsmetod>indirekt mätmetod</app:utvarderingsmetod> <app:ingeninformation>ja</app:ingeninformation> <app:resultat> <app:statistiskmetod>medelfel</app:statistiskmetod> <app:varde>0.1</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_1" 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:tillhor> <app:registerenhetsreferens> <app:objektidentitet>d12f034d-b9a7-4634-bd26-1cbce2ff352b</app:objektidentitet> <app:fastighetsnyckel>987654321</app:fastighetsnyckel> <app:beteckning>kommun TRAKT 1:1</app:beteckning> <app:typ>fastighet</app:typ> </app:registerenhetsreferens> </app:tillhor> <app:liggerpa> <app:registerenhetsreferens> <app:objektidentitet>d12f034d-b9a7-4634-bd26-1cbce2ff358b</app:objektidentitet> <app:fastighetsnyckel>123456789</app:fastighetsnyckel> <app:beteckning>kommun TRAKT 2:684</app:beteckning> <app:typ>fastighet</app:typ> </app:registerenhetsreferens> </app:liggerpa> <app:berorsav> <app:registerenhetsreferens> <app:objektidentitet>d12f034d-b9a7-4634-bd26-1cbce2ff829d</app:objektidentitet> <app:fastighetsnyckel>010203040</app:fastighetsnyckel> <app:beteckning>stockholm SLOTTET 3:687</app:beteckning> <app:typ>fastighet</app:typ> </app:registerenhetsreferens> <app:registerenhetsreferens> <app:objektidentitet>d12f034d-b9a7-4634-bd26-1cbce2ff829b</app:objektidentitet> <app:fastighetsnyckel>102030405</app:fastighetsnyckel> <app:beteckning>stockholm SLOTTET 2</app:beteckning> <app:typ>fastighet</app:typ> </app:registerenhetsreferens> </app:berorsav> </app:byggnad>
</app:byggnadmember> </app:byggnadresponse> Hitta byggnad FindByggnadRequest Hitta Byggnad med något av nedanstående sökbegrepp. ByggnadRegisterenhetFilter Hitta Byggnad för en fastighet. ByggnadGeometryFilter Hitta 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>6461026.0 608376.7</gml:pos> </gml:point> <buffer>0</buffer> </ByggnadGeometryFilter> </FindByggnadRequest> Svar ByggnadsreferensResponse Behållare för sökningens resultat - ingen, en eller flera sökträffar av typen Byggnadsreferens. Byggnadereferens 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> Versioner Version av SOAP: 1.2 GML-version: 3.2.1 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 odefinierad 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 Antal punkter i en MultiPoint. Maxvärde 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 MultiCurve. 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 MultiSurface. 200 000 m