Tjänstebaserad direktåtkomst
Tjänstebaserad uppdatering och direktåtkomst för utbyte.
-
Tjänster för att hämta ut byggnadsinformation, Byggnad Direktåtkomst (utbyte).
-
Tjänster för att hämta ut adressinformation, Adress Direktåtkomst (utbyte).
-
Tjänster för att hämta ut bristinformation, Brist Direktåtkomst (utbyte).
-
Tjänster för att skicka in uppdateringar för både adress och byggnad/lägenhet.
Tjänster (API)
Dokumentationslänkar
Notera att endast http://namespace.lantmateriet.se/geodata/exchange/v1/ är den version som används inom Tjänstebaserad Uppdatering!
Tjänster frågor
Adress
Gränssnittsdefinitioner
| Miljö | Typ | Källa |
|---|---|---|
Produktion |
WSDL |
http://namespace.lantmateriet.se/geodata/address/v1/addressService.wsdl |
XML-schema |
http://namespace.lantmateriet.se/geodata/address/v1/addressService.xsd |
|
Verifiering |
WSDL |
http://namespace.lantmateriet.se/geodata/address/v1/addressService-ver.wsdl |
XML-schema |
http://namespace.lantmateriet.se/geodata/address/v1/addressService.xsd |
Sök adress
Sök adress med valfritt koordinatsystem
I de fall ni önskar få geometrin transformerad till annat koordinatsystem än Sweref 99 tm så finns det nu möjlighet att göra detta. Specificera ett attribut till elementet FindAddressRequest som heter coordinateSystem. Se exempel nedan:
Exempel fråga
<?xml version="1.0" encoding="UTF-8"?>
<address:FindAddressRequest xmlns:address="http://namespace.lantmateriet.se/geodata/address/v1"
coordinateSystem="9da0ca64-b01c-f3a9-0a90-c9f6355c3b56">
...
</address:FindAddressRequest>Detta gäller för alla underliggande sökvarianter av adress.
Sök adress utifrån kommunkod och adressområdesnamn
| Element/Attribut | Sökvillkor | Beskrivning |
|---|---|---|
FindAddressRequest |
Hitta adressområde med nedanstående sökbegrepp: |
|
|
Kommunkod (obligatorisk) |
|
|
match |
Adressområdesnamn (obligatorisk) |
-
match - kan anta "EQUALS" eller "STARTS_WITH". Om ingen match anges är "EQUALS" default värde.
Exempel fråga
<?xml version="1.0" encoding="UTF-8"?>
<address:FindAddressRequest xmlns:address="http://namespace.lantmateriet.se/geodata/address/v1">
<address:municipalityKey>0234</address:municipalityKey>
<address:addressAreaAssignedName match="STARTS_WITH">Stor</address:addressAreaAssignedName>
</address:FindAddressRequest>Svarstyp för sökning utifrån kommunkod och adressareanamn
| Element/Attribut | Sökvillkor | Beskrivning |
|---|---|---|
FindExchangeObjectResponse |
Samlar ihop svaret på en sökning |
|
|
Generell behållare för sökningens resultat. Innehåller en grupp av objekt kallad featureMembers |
|
|
Innehåller instanser av en eller flera objekttyper. |
|
|
Kommundel |
|
|
Adressområde |
|
|
Gårdsadressområde |
Exempel svar
<?xml version="1.0" encoding="UTF-8"?>
<address:FindExchangeObjectResponse
xmlns:address="http://namespace.lantmateriet.se/geodata/address/v1"
xmlns:ex="http://namespace.lantmateriet.se/geodata/exchange/v1"
xmlns:gml="http://www.opengis.net/gml/3.2">
<ex:FeatureCollection gml:id="ID_28397063-302a-41c8-be8d-406f4c040121">
<ex:id>42d0ea59-ed3b-4746-87a0-4839f75ee41e</ex:id>
<ex:description />
<ex:extractedAtTime>2011-12-09T10:19:21.946Z</ex:extractedAtTime>
<ex:featureMembers>
<address:PartOfMunicipality gml:id="ID_69a466cb-10d6-44b8-a533-d029f0ba4d62">
<ex:objectId>4d660a3f-5373-4a96-b3f2-5e7c1a67453f</ex:objectId>
<ex:objectVersion>1</ex:objectVersion>
<ex:versionValidFrom>2011-02-03T09:23:53.451Z</ex:versionValidFrom>
<address:assignedName>Solberga</address:assignedName>
<address:objectStatus>Gällande</address:objectStatus>
<address:municipalityKey>0180</address:municipalityKey>
</address:PartOfMunicipality>
<address:AddressArea gml:id="ID_fcece9c0-702c-4ead-bc9b-eacc369e0819">
<ex:objectId>03d021ba-b936-475a-907b-8f7ae261d739</ex:objectId>
<ex:objectVersion>1</ex:objectVersion>
<ex:versionValidFrom>2011-02-03T09:26:10.984Z</ex:versionValidFrom>
<address:assignedName>Kvillskär</address:assignedName>
<address:areaType>Byadressområde</address:areaType>
<address:objectStatus>Gällande</address:objectStatus>
<address:partOfMunicipalityReference>4d660a3f-5373-4a96-b3f2-5e7c1a67453f</address:partOfMunicipalityReference>
</address:AddressArea>
<address:FarmAddressArea gml:id="ID_cb3d9bda-55bc-41a2-9f0f-1d7d0b5037bc">
<ex:objectId>be6ed17f-a7ae-41cf-98be-84b5cc3e8c80</ex:objectId>
<ex:objectVersion>1</ex:objectVersion>
<ex:versionValidFrom>2011-02-03T09:55:00.924Z</ex:versionValidFrom>
<address:assignedName>Hägerum</address:assignedName>
<address:objectStatus>Gällande</address:objectStatus>
<address:addressAreaReference>03d021ba-b936-475a-907b-8f7ae261d739</address:addressAreaReference>
</address:FarmAddressArea>
</ex:featureMembers>
</ex:FeatureCollection>
</address:FindExchangeObjectResponse>Sök samtliga utbytesobjekt inom adressdomänen utifrån givet geografiskt område
| Element/Attribut | Beskrivning |
|---|---|
FindAddressRequest |
Hitta adresser med hjälp av geografisk område: |
|
minN, minE (obligatorisk) |
|
maxN, maxE (obligatorisk) |
Exempel fråga
<?xml version="1.0" encoding="UTF-8"?>
<address:FindAddressRequest
xmlns:address="http://namespace.lantmateriet.se/geodata/address/v1"
xmlns:gml="http://www.opengis.net/gml/3.2">
<address:BBOX>
<gml:lowerCorner>6760000.0 580000.0</gml:lowerCorner>
<gml:upperCorner>6770000.0 590000.0</gml:upperCorner>
</address:BBOX>
</address:FindAddressRequest>Svarstyp för sökning utifrån geografisk område
| Element/Attribut | Beskrivning |
|---|---|
FindExchangeObjectResponse |
Samlar ihop svaret på en sökning |
|
Generell behållare för sökningens resultat. Innehåller en grupp av objekt kallad featureMembers |
|
Innehåller instanser av en eller flera objekttyper. |
|
Kommundel |
|
Adressområde |
|
Gårdsadressområde |
Exempel svar
<?xml version="1.0" encoding="UTF-8"?>
<address:FindExchangeObjectResponse
xmlns:address="http://namespace.lantmateriet.se/geodata/address/v1"
xmlns:ex="http://namespace.lantmateriet.se/geodata/exchange/v1"
xmlns:gml="http://www.opengis.net/gml/3.2"
xmlns:lg="http://namespace.lantmateriet.se/geodata/geometry/v1"
xmlns:lq="http://namespace.lantmateriet.se/geodata/quality/v1">
<ex:FeatureCollection gml:id="ID_28397063-302a-41c8-be8d-406f4c040121">
<ex:id>42d0ea59-ed3b-4746-87a0-4839f75ee41e</ex:id>
<ex:description />
<ex:extractedAtTime>2011-12-09T10:19:21.946Z</ex:extractedAtTime>
<ex:featureMembers>
<address:PartOfMunicipality gml:id="ID_69a466cb-10d6-44b8-a533-d029f0ba4d62">
<ex:objectId>4d660a3f-5373-4a96-b3f2-5e7c1a67453f</ex:objectId>
<ex:objectVersion>1</ex:objectVersion>
<ex:versionValidFrom>2011-02-03T09:23:53.451Z</ex:versionValidFrom>
<address:assignedName>Solberga</address:assignedName>
<address:objectStatus>Gällande</address:objectStatus>
<address:municipalityKey>0180</address:municipalityKey>
</address:PartOfMunicipality>
<address:AddressArea gml:id="ID_fcece9c0-702c-4ead-bc9b-eacc369e0819">
<ex:objectId>03d021ba-b936-475a-907b-8f7ae261d739</ex:objectId>
<ex:objectVersion>1</ex:objectVersion>
<ex:versionValidFrom>2011-02-03T09:26:10.984Z</ex:versionValidFrom>
<address:assignedName>Kvillskär</address:assignedName>
<address:areaType>Byadressområde</address:areaType>
<address:objectStatus>Gällande</address:objectStatus>
<address:partOfMunicipalityReference>4d660a3f-5373-4a96-b3f2-5e7c1a67453f</address:partOfMunicipalityReference>
</address:AddressArea>
<address:FarmAddressArea gml:id="ID_cb3d9bda-55bc-41a2-9f0f-1d7d0b5037bc">
<ex:objectId>be6ed17f-a7ae-41cf-98be-84b5cc3e8c80</ex:objectId>
<ex:objectVersion>1</ex:objectVersion>
<ex:versionValidFrom>2011-02-03T09:55:00.924Z</ex:versionValidFrom>
<address:assignedName>Hägerum</address:assignedName>
<address:objectStatus>Gällande</address:objectStatus>
<address:addressAreaReference>03d021ba-b936-475a-907b-8f7ae261d739</address:addressAreaReference>
</address:FarmAddressArea>
<address:AddressPlace gml:id="ID_381ba817-12b2-4cca-bb2f-68da26be237d">
<ex:objectId>9ac388b2-30f1-4484-8fbe-4e815b6c0392</ex:objectId>
<ex:objectVersion>1</ex:objectVersion>
<ex:versionValidFrom>2011-02-03T10:17:19.699Z</ex:versionValidFrom>
<address:designation>
<address:designationNumber>12</address:designationNumber>
</address:designation>
<address:type>Byadressplats</address:type>
<address:positionKind>Byggnad</address:positionKind>
<address:point gml:id="ID_3ecfc4f9-d24f-41cb-b35e-bb7e29b70f33">
<lg:Point gml:id="ID_8a2ca1e4-f288-4e39-8484-83b86414f932">
<lg:horizontalAccuracy gml:id="ID_49cac9a2-2bde-441b-8e84-db3ffdaf93a1">
<lq:AbsoluteExternalPositionalAccuracy gml:id="ID_6b516f25-cbe9-4cff-9fca-fc252fc13e5d">
<lq:noInformation />
</lq:AbsoluteExternalPositionalAccuracy>
</lg:horizontalAccuracy>
<lg:horizontalCoordinateSystem>9ec23aad-8fd1-b149-0a90-c9f6355c3b56</lg:horizontalCoordinateSystem>
<lg:position>
<gml:Point gml:id="ID_780e7ec7-a4c1-468f-815d-e3ed941eb118">
<gml:pos>7087090.774 692586.102</gml:pos>
</gml:Point>
</lg:position>
</lg:Point>
</address:point>
<address:locationAddressStatus>Gällande</address:locationAddressStatus>
<address:objectStatus>Gällande</address:objectStatus>
<address:postCode>91692</address:postCode>
<address:postTown>Bjurholm</address:postTown>
<address:realPropertyKey>240001006</address:realPropertyKey>
<address:farmAddressAreaReference>be6ed17f-a7ae-41cf-98be-84b5cc3e8c80</address:farmAddressAreaReference>
</address:AddressPlace>
</ex:featureMembers>
</ex:FeatureCollection>
</address:FindExchangeObjectResponse>Sök adressplats
Sök adressplats med valfritt koordinatsystem
I de fall ni önskar få geometrin transformerad till annat koordinatsystem än Sweref 99 tm så finns det nu möjlighet att göra detta. Specificera ett attribut till elementet FindAddressPlaceRequest som heter coordinateSystem. Se exempel nedan:
Exempel fråga
<?xml version="1.0" encoding="UTF-8"?>
<address:FindAddressRequest xmlns:address="http://namespace.lantmateriet.se/geodata/address/v1"
coordinateSystem="9da0ca64-b01c-f3a9-0a90-c9f6355c3b56">
...
</address:FindAddressRequest>Detta gäller för alla underliggande sökvarianter av adressplats.
Sök adressplats utifrån objektidentitet och objektversion
| Element/Attribut | Beskrivning |
|---|---|
FindAddressPlaceRequest |
Hitta adressplatser med nedanstående sökbegrepp: |
|
Hitta specifik adressplats m a p dess objektidentitet (obligatorisk) |
|
Hitta specifik version av adressplats. Ej obligatorisk. Om utelämnad returneras den senaste uppdaterade adressplatsen. |
Exempel fråga
<?xml version="1.0" encoding="UTF-8"?>
<address:FindAddressPlaceRequest
xmlns:address="http://namespace.lantmateriet.se/geodata/address/v1">
<address:objectId>96963210-1524-4c45-bf5c-da6dc3b61afe</address:objectId>
<address:objectVersion>2</address:objectVersion>
</address:FindAddressPlaceRequest>Sök adressplats utifrån objektidentiteter
| Element/Attribut | Beskrivning |
|---|---|
FindAddressPlaceRequest |
Hitta de senast uppdaterade adressplatserna baserat på nedanstående sökbegrepp: |
|
Behållare för objektidentiteter. |
|
Objektidentitet för adressplats. |
Exempel fråga
<?xml version="1.0" encoding="UTF-8"?>
<address:FindAddressPlaceRequest
xmlns:address="http://namespace.lantmateriet.se/geodata/address/v1">
<address:objectIdCollection>
<address:objectId>3cb9d2d0-08b7-4c2f-8d56-dc0958b6d052</address:objectId>
<address:objectId>344b1b94-2219-4fc7-bf1b-3e005d5e98c4</address:objectId>
<address:objectId>1277551c-f160-4536-a850-555865e23a5d</address:objectId>
</address:objectIdCollection>
</address:FindAddressPlaceRequest>Svarstyp
| Element/Attribut | Beskrivning |
|---|---|
FindExchangeObjectResponse |
Samlar ihop svaret på en sökning |
|
Generell behållare för sökningens resultat. Innehåller en grupp av objekt kallad featureMembers |
|
Innehåller instanser av en eller flera objekttyper. |
|
Adressplats. |
Exempel svar
<?xml version="1.0" encoding="UTF-8"?>
<address:FindExchangeObjectResponse
xmlns:address="http://namespace.lantmateriet.se/geodata/address/v1"
xmlns:ex="http://namespace.lantmateriet.se/geodata/exchange/v1"
xmlns:gml="http://www.opengis.net/gml/3.2"
xmlns:lg="http://namespace.lantmateriet.se/geodata/geometry/v1"
xmlns:lq="http://namespace.lantmateriet.se/geodata/quality/v1">
<ex:FeatureCollection gml:id="ID_28397063-302a-41c8-be8d-406f4c040121">
<ex:id>20643504-aaa1-428b-91b2-e2350a0f4d34</ex:id>
<ex:description />
<ex:extractedAtTime>2011-12-09T09:48:30.973Z</ex:extractedAtTime>
<ex:featureMembers>
<address:AddressPlace gml:id="ID_381ba817-12b2-4cca-bb2f-68da26be237d">
<ex:objectId>9ac388b2-30f1-4484-8fbe-4e815b6c0392</ex:objectId>
<ex:objectVersion>1</ex:objectVersion>
<ex:versionValidFrom>2011-02-03T10:17:19.699Z</ex:versionValidFrom>
<address:designation>
<address:designationNumber>12</address:designationNumber>
</address:designation>
<address:type>Byadressplats</address:type>
<address:positionKind>Byggnad</address:positionKind>
<address:point gml:id="ID_3ecfc4f9-d24f-41cb-b35e-bb7e29b70f33">
<lg:Point gml:id="ID_8a2ca1e4-f288-4e39-8484-83b86414f932">
<lg:horizontalAccuracy gml:id="ID_49cac9a2-2bde-441b-8e84-db3ffdaf93a1">
<lq:AbsoluteExternalPositionalAccuracy gml:id="ID_6b516f25-cbe9-4cff-9fca-fc252fc13e5d">
<lq:noInformation />
</lq:AbsoluteExternalPositionalAccuracy>
</lg:horizontalAccuracy>
<lg:horizontalCoordinateSystem>9ec23aad-8fd1-b149-0a90-c9f6355c3b56</lg:horizontalCoordinateSystem>
<lg:position>
<gml:Point gml:id="ID_780e7ec7-a4c1-468f-815d-e3ed941eb118">
<gml:pos>7087090.774 692586.102</gml:pos>
</gml:Point>
</lg:position>
</lg:Point>
</address:point>
<address:locationAddressStatus>Gällande</address:locationAddressStatus>
<address:objectStatus>Gällande</address:objectStatus>
<address:postCode>91692</address:postCode>
<address:postTown>Bjurholm</address:postTown>
<address:realPropertyKey>240001006</address:realPropertyKey>
<address:addressAreaReference>7a0ef18c-ba2a-47c7-b6de-b36fc91d0868</address:addressAreaReference>
</address:AddressPlace>
</ex:featureMembers>
</ex:FeatureCollection>
</address:FindExchangeObjectResponse>Sök adressområde
Sök adressområde utifrån objektidentitet och objektversion
| Element/Attribut | Beskrivning |
|---|---|
FindAddressAreaRequest |
Hitta adressområde med nedanstående sökbegrepp: |
|
Hitta specifik adressområde m a p dess objektidentitet (obligatorisk) |
|
Hitta specifik version av adressområde. Ej obligatorisk. Om utelämnad returneras det senast uppdaterade adressområdet. |
Exempel fråga
<?xml version="1.0" encoding="UTF-8"?>
<address:FindAddressAreaRequest
xmlns:address="http://namespace.lantmateriet.se/geodata/address/v1">
<address:objectId>f8ba3022-33e5-48ee-a7d3-36eb58eb7848</address:objectId>
<address:objectVersion>2</address:objectVersion>
</address:FindAddressAreaRequest>Sök adressområde utifrån objektidentiteter
| Element/Attribut | Beskrivning |
|---|---|
FindAddressAreaRequest |
Hitta de senast uppdaterade adressområderna baserat på nedanstående sökbegrepp: |
|
Behållare för objektidentiteter. |
|
Objektidentitet för adressområde. |
Exempel fråga
<?xml version="1.0" encoding="UTF-8"?>
<address:FindAddressAreaRequest
xmlns:address="http://namespace.lantmateriet.se/geodata/address/v1">
<address:objectIdCollection>
<address:objectId>fb0c5f8f-134b-4108-93f4-5958130899a6</address:objectId>
<address:objectId>65d634e2-b287-4551-b0ba-34d5fcdc67ad</address:objectId>
<address:objectId>77ab496b-934a-404e-9d21-1899571bc47b</address:objectId>
</address:objectIdCollection>
</address:FindAddressAreaRequest>Svarstyp
| Element/Attribut | Beskrivning |
|---|---|
FindExchangeObjectResponse |
Samlar ihop svaret på en sökning |
|
Generell behållare för sökningens resultat. Innehåller en grupp av objekt kallad featureMembers |
|
Innehåller instanser av en eller flera objekttyper. |
|
Adressområde. |
Exempel svar
<?xml version="1.0" encoding="UTF-8"?>
<address:FindExchangeObjectResponse
xmlns:address="http://namespace.lantmateriet.se/geodata/address/v1"
xmlns:ex="http://namespace.lantmateriet.se/geodata/exchange/v1"
xmlns:gml="http://www.opengis.net/gml/3.2">
<ex:FeatureCollection gml:id="ID_28397063-302a-41c8-be8d-406f4c040121">
<ex:id>42d0ea59-ed3b-4746-87a0-4839f75ee41e</ex:id>
<ex:description />
<ex:extractedAtTime>2011-12-09T10:19:21.946Z</ex:extractedAtTime>
<ex:featureMembers>
<address:AddressArea gml:id="ID_fcece9c0-702c-4ead-bc9b-eacc369e0819">
<ex:objectId>03d021ba-b936-475a-907b-8f7ae261d739</ex:objectId>
<ex:objectVersion>1</ex:objectVersion>
<ex:versionValidFrom>2011-02-03T09:26:10.984Z</ex:versionValidFrom>
<address:assignedName>Kvillskär</address:assignedName>
<address:areaType>Byadressområde</address:areaType>
<address:objectStatus>Gällande</address:objectStatus>
<address:partOfMunicipalityReference>1a5a68a8-e745-4ce0-9de3-855554b5faf1</address:partOfMunicipalityReference>
</address:AddressArea>
</ex:featureMembers>
</ex:FeatureCollection>
</address:FindExchangeObjectResponse>Sök gårdsadressområde
Sök gårdsadressområde utifrån objektidentitet och objektversion
| Element/Attribut | Beskrivning |
|---|---|
FindFarmAddressAreaRequest |
Hitta gårdsadressområde med nedanstående sökbegrepp: |
|
Hitta specifik gårdsadressområde m a p dess objektidentitet (obligatorisk) |
|
Hitta specifik version av gårdsadressområde. Ej obligatorisk. Om utelämnad returneras det senast uppdaterade gårdsadressområdet. |
Exempel fråga
<?xml version="1.0" encoding="UTF-8"?>
<address:FindFarmAddressAreaRequest
xmlns:address="http://namespace.lantmateriet.se/geodata/address/v1">
<address:objectId>e96c193e-333c-478c-bb16-0e1131248737</address:objectId>
<address:objectVersion>2</address:objectVersion>
</address:FindFarmAddressAreaRequest>Sök gårdsadressområde utifrån objektidentiteter
| Element/Attribut | Beskrivning |
|---|---|
FindFarmAddressAreaRequest |
Hitta de senast uppdaterade gårdsadressområderna baserat på nedanstående sökbegrepp: |
|
Behållare för objektidentiteter. |
|
Objektidentitet för gårdsadressområde. |
Exempel fråga
<?xml version="1.0" encoding="UTF-8"?>
<address:FindFarmAddressAreaRequest
xmlns:address="http://namespace.lantmateriet.se/geodata/address/v1">
<address:objectIdCollection>
<address:objectId>32531be0-278c-4caf-8329-54d067f5b805</address:objectId>
<address:objectId>25f7f4d2-c68a-4a16-8d2c-5ae1b33193d9</address:objectId>
<address:objectId>9b90bf41-3199-4c73-aa01-844b04482d38</address:objectId>
</address:objectIdCollection>
</address:FindFarmAddressAreaRequest>Svarstyp
| Element/Attribut | Beskrivning |
|---|---|
FindExchangeObjectResponse |
Samlar ihop svaret på en sökning |
|
Generell behållare för sökningens resultat. Innehåller en grupp av objekt kallad featureMembers |
|
Innehåller instanser av en eller flera objekttyper. |
|
Gårdsadressområde. |
Exempel svar
<?xml version="1.0" encoding="UTF-8"?>
<address:FindExchangeObjectResponse
xmlns:address="http://namespace.lantmateriet.se/geodata/address/v1"
xmlns:ex="http://namespace.lantmateriet.se/geodata/exchange/v1"
xmlns:gml="http://www.opengis.net/gml/3.2">
<ex:FeatureCollection gml:id="ID_28397063-302a-41c8-be8d-406f4c040121">
<ex:id>c295aac8-03d9-4beb-bb8a-8ec0a2b9ae93</ex:id>
<ex:description />
<ex:extractedAtTime>2011-12-09T10:26:00.828Z</ex:extractedAtTime>
<ex:featureMembers>
<address:FarmAddressArea gml:id="ID_cb3d9bda-55bc-41a2-9f0f-1d7d0b5037bc">
<ex:objectId>be6ed17f-a7ae-41cf-98be-84b5cc3e8c80</ex:objectId>
<ex:objectVersion>1</ex:objectVersion>
<ex:versionValidFrom>2011-02-03T09:55:00.924Z</ex:versionValidFrom>
<address:assignedName>Hägerum</address:assignedName>
<address:objectStatus>Gällande</address:objectStatus>
<address:addressAreaReference>9289a097-f4f4-4be1-8524-d4bcc6bcb493</address:addressAreaReference>
</address:FarmAddressArea>
</ex:featureMembers>
</ex:FeatureCollection>
</address:FindExchangeObjectResponse>Sök kommundel
Sök kommundel utifrån objektidentitet och objektversion
| Element/Attribut | Beskrivning |
|---|---|
FindPartOfMunicipalityRequest |
Hitta kommundel med nedanstående sökbegrepp: |
|
Hitta specifik kommundel m a p dess objektidentitet (obligatorisk) |
|
Hitta specifik version av kommundel. Ej obligatorisk. Om utelämnad returneras den senast uppdaterade kommundelen. |
Exempel fråga
<?xml version="1.0" encoding="UTF-8"?>
<address:FindPartOfMunicipalityRequest
xmlns:address="http://namespace.lantmateriet.se/geodata/address/v1">
<address:objectId>29a29dc0-6222-41bd-84cf-5766fee535c4</address:objectId>
<address:objectVersion>2</address:objectVersion>
</address:FindPartOfMunicipalityRequest>Sök kommundelar utifrån objektidentiteter
| Element/Attribut | Beskrivning |
|---|---|
FindPartOfMunicipalityRequest |
Hitta de senast uppdaterade kommundelarna baserat på nedanstående sökbegrepp: |
|
Behållare för objektidentiteter. |
|
Objektidentitet för kommundel. |
Exempel fråga
<?xml version="1.0" encoding="UTF-8"?>
<address:FindPartOfMunicipalityRequest
xmlns:address="http://namespace.lantmateriet.se/geodata/address/v1">
<address:objectIdCollection>
<address:objectId>4cbf36bf-e350-42d6-96d4-866970956ea3</address:objectId>
<address:objectId>beeb9ecf-8a03-4bb6-bf62-493220ea8cfa</address:objectId>
<address:objectId>d1b236ce-1c81-4929-aa8e-f90347843b5b</address:objectId>
</address:objectIdCollection>
</address:FindPartOfMunicipalityRequest>Svarstyp
| Element/Attribut | Beskrivning |
|---|---|
FindExchangeObjectResponse |
Samlar ihop svaret på en sökning |
|
Generell behållare för sökningens resultat. Innehåller en grupp av objekt kallad featureMembers |
|
Innehåller instanser av en eller flera objekttyper. |
|
Kommundel. |
Exempel svar
<?xml version="1.0" encoding="UTF-8"?>
<address:FindExchangeObjectResponse
xmlns:address="http://namespace.lantmateriet.se/geodata/address/v1"
xmlns:ex="http://namespace.lantmateriet.se/geodata/exchange/v1"
xmlns:gml="http://www.opengis.net/gml/3.2">
<ex:FeatureCollection gml:id="ID_61be5741-0b55-48d0-aba9-07cf53bd4ae4">
<ex:id>d5fa4dd8-31dd-443b-9cb7-8208bc39a6b2</ex:id>
<ex:description />
<ex:extractedAtTime>2011-12-09T10:38:14.611Z</ex:extractedAtTime>
<ex:featureMembers>
<address:PartOfMunicipality gml:id="ID_69a466cb-10d6-44b8-a533-d029f0ba4d62">
<ex:objectId>4d660a3f-5373-4a96-b3f2-5e7c1a67453f</ex:objectId>
<ex:objectVersion>1</ex:objectVersion>
<ex:versionValidFrom>2011-02-03T09:23:53.451Z</ex:versionValidFrom>
<address:assignedName>Solberga</address:assignedName>
<address:objectStatus>Gällande</address:objectStatus>
<address:municipalityKey>0180</address:municipalityKey>
</address:PartOfMunicipality>
</ex:featureMembers>
</ex:FeatureCollection>
</address:FindExchangeObjectResponse>Sök förändringar för adressobjekt
| Element/Attribut | Beskrivning |
|---|---|
FindChangedObjectsRequest |
Söker, utifrån nedanstående kriterier, fram de förändringar (beståndskontroll) som skett för givet utbytesobjekt. Funktionen returnerar EJ borttagna (DELETE) utbytesobjekt. |
|
Obligatorisk. Ger möjlighet att begränsa utsökningen till antal givna svar. Bör användas tillsammans med orderBy. Möjliggör paging. |
|
Filtrerar sökningen med avseende på: |
|
|
|
|
|
|
|
Ej obligatorisk. Bör användas för att paging skall fungera. Sortering möjlig på |
Exempel fråga
<?xml version="1.0" encoding="UTF-8"?>
<address:FindChangedObjectsRequest
xmlns:address="http://namespace.lantmateriet.se/geodata/address/v1"
xmlns:exq="http://namespace.lantmateriet.se/geodata/exchange/query/exchangeobjectsinformation/v2">
<address:limit firstResult="1" maxResults="10"/>
<address:filter>
<address:validFromFilter>
<exq:fromDate>2013-01-17T20:52:30.597+01:00</exq:fromDate>
<exq:toDate>2013-03-19T20:52:30.597+01:00</exq:toDate>
</address:validFromFilter>
<address:ObjectTypeFilter>AddressPlace</address:ObjectTypeFilter>
<address:MunicipalityKeyFilter>2884,2885</address:MunicipalityKeyFilter>
</address:filter>
<address:orderBy>
<exq:ValidFrom order="descending"/>
</address:orderBy>
</address:FindChangedObjectsRequest>Svarstyp
| Element/Attribut | Beskrivning |
|---|---|
FindChangedObjectsResponse |
Samlar ihop svaret på en sökning |
|
Noll eller flera informationsobjekt om det utbytesobjekt som efterfrågats (adressplats, adressområde, gårdsadressområde eller kommundel). |
Exempel svar
<?xml version="1.0" encoding="UTF-8"?>
<address:FindChangedObjectsResponse
xmlns:address="http://namespace.lantmateriet.se/geodata/address/v1"
xmlns:gml="http://www.opengis.net/gml/3.2"
xmlns:exq="http://namespace.lantmateriet.se/geodata/exchange/query/exchangeobjectsinformation/v2">
<address:ExchangeObjectInformation gml:id="ID_2135df2e-20d1-44c5-998c-5a12029c48ec">
<exq:objectId>1ecd9d4e-7527-409d-8913-9033ac3dc562</exq:objectId>
<exq:objectVersion>1</exq:objectVersion>
<exq:objectStatus>Gällande</exq:objectStatus>
<exq:versionValidFrom>2014-02-03T07:25:40.776Z</exq:versionValidFrom>
</address:ExchangeObjectInformation>
<address:ExchangeObjectInformation gml:id="ID_57e47291-ac18-4f76-91b5-73d2ed403a4a">
<exq:objectId>29802b9f-e36b-4a03-8f39-166e68f44b33</exq:objectId>
<exq:objectVersion>3</exq:objectVersion>
<exq:objectStatus>Gällande</exq:objectStatus>
<exq:versionValidFrom>2014-02-03T07:25:45.224Z</exq:versionValidFrom>
</address:ExchangeObjectInformation>
<address:ExchangeObjectInformation gml:id="ID_e66595c4-3a56-4c12-a5c3-600870155eab">
<exq:objectId>2e89f2f9-1c2c-4320-a7e0-e53ea5cc9489</exq:objectId>
<exq:objectVersion>1</exq:objectVersion>
<exq:objectStatus>Gällande</exq:objectStatus>
<exq:versionValidFrom>2014-02-03T07:25:40.776Z</exq:versionValidFrom>
</address:ExchangeObjectInformation>
<address:ExchangeObjectInformation gml:id="ID_92dbd1a9-325e-4b9a-a8cb-a64cbf65e89e">
<exq:objectId>37cf1ddb-1da7-4248-8a40-f03b5ba39ef5</exq:objectId>
<exq:objectVersion>2</exq:objectVersion>
<exq:objectStatus>Gällande</exq:objectStatus>
<exq:versionValidFrom>2014-02-03T07:25:43.870Z</exq:versionValidFrom>
</address:ExchangeObjectInformation>
</address:FindChangedObjectsResponse>Byggnad
Gränssnittsdefinitioner
| Miljö | Typ | Källa |
|---|---|---|
Produktion |
WSDL |
http://namespace.lantmateriet.se/geodata/building/v1/buildingService.wsdl |
XML-schema |
http://namespace.lantmateriet.se/geodata/building/v1/buildingService.xsd |
|
Verifiering |
WSDL |
http://namespace.lantmateriet.se/geodata/building/v1/buildingService-ver.wsdl |
XML-schema |
http://namespace.lantmateriet.se/geodata/building/v1/buildingService.xsd |
Sök byggnad
Sök byggnad med valfritt koordinatsystem
I de fall ni önskar få geometrin transformerad till annat koordinatsystem än Sweref 99 tm så finns det nu möjlighet att göra detta. Specificera ett attribut till elementet FindBuildingRequest som heter coordinateSystem. Se exempel nedan:
Exempel fråga
<?xml version="1.0" encoding="UTF-8"?>
<building:FindBuildingRequest
xmlns:building="http://namespace.lantmateriet.se/geodata/building/v1"
coordinateSystem="9ec23aad-8fd1-b149-0a90-c9f6355c3b56">
...
</building:FindBuildingRequest>Detta gäller för alla underliggande sökvarianter av byggnad.
Sök byggnad utifrån objektidentitet och eventuell objektversion
| Element/Attribut | Beskrivning |
|---|---|
FindBuildingRequest |
Hitta byggnad med nedanstående sökbegrepp: |
|
Unik objektidentitet. Obligatorisk. |
|
Objektversion på byggnad. Ej obligatorisk. |
Exempel fråga
<?xml version="1.0" encoding="UTF-8"?>
<building:FindBuildingRequest
xmlns:building="http://namespace.lantmateriet.se/geodata/building/v1">
<building:objectId>4746c6de-0491-4ba6-b9d4-5172d6dfef47</building:objectId>
<building:objectVersion>1</building:objectVersion>
</building:FindBuildingRequest>Sök byggnad utifrån objektidentiteter
| Element/Attribut | Beskrivning |
|---|---|
FindBuildingRequest |
Hitta de senast uppdaterade byggnaderna baserat på nedanstående sökbegrepp: |
|
Behållare för objektidentiteter. |
|
Objektidentiteter för byggnad. |
Exempel fråga
<?xml version="1.0" encoding="UTF-8"?>
<building:FindBuildingRequest
xmlns:building="http://namespace.lantmateriet.se/geodata/building/v1">
<building:objectIdCollection>
<building:objectId>000f1d2e-af27-43db-a921-4611add1d026</building:objectId>
<building:objectId>ab5c3101-69a7-4288-90b6-5720849d1037</building:objectId>
<building:objectId>40a355a3-a7b6-477e-8667-a260ea84c8f2</building:objectId>
</building:objectIdCollection>
</building:FindBuildingRequest>Sök byggnader utifrån givet geografiskt område
| Element/Attribut | Beskrivning |
|---|---|
FindBuildingRequest |
Hitta byggnader med hjälp av geografisk område: |
|
minN, minE (obligatorisk) |
|
maxN, maxE (obligatorisk) |
Exempel fråga
<?xml version="1.0" encoding="UTF-8"?>
<building:FindBuildingRequest
xmlns:building="http://namespace.lantmateriet.se/geodata/building/v1"
xmlns:gml="http://www.opengis.net/gml/3.2">
<building:BBOX>
<gml:lowerCorner>6760000.0 580000.0</gml:lowerCorner>
<gml:upperCorner>6770000.0 590000.0</gml:upperCorner>
</building:BBOX>
</building:FindBuildingRequest>Svarstyp utifrån geografiskt område
| Element/Attribut | Beskrivning |
|---|---|
FindExchangeObjectResponse |
Samlar ihop svaret på en sökning |
|
Generell behållare för sökningens resultat. Innehåller en grupp av objekt kallad featureMembers |
|
Innehåller instanser av en eller flera objekttyper. |
|
Noll eller flera byggnader. |
Exempel svar
<?xml version="1.0" encoding="UTF-8"?>
<building:FindExchangeObjectResponse
xsi:schemaLocation="http://namespace.lantmateriet.se/geodata/building/v1/buildingService.xsd"
xmlns:building="http://namespace.lantmateriet.se/geodata/building/v1"
xmlns:ex="http://namespace.lantmateriet.se/geodata/exchange/v1"
xmlns:gml="http://www.opengis.net/gml/3.2"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ex:FeatureCollection gml:id="ID_1">
<ex:id>c0ab5f40-7bd2-11e0-819a-0800200c9a66</ex:id>
<ex:description>Exempelfil</ex:description>
<ex:extractedAtTime>2011-04-17T09:30:47Z</ex:extractedAtTime>
<ex:featureMembers>
<building:Building gml:id="ID_2">
<ex:objectId>0fcba49a-a216-4a65-b119-15f1dabfd72f</ex:objectId>
<ex:objectVersion>1</ex:objectVersion>
<building:houseNumber>2</building:houseNumber>
<building:constructionYear>2001</building:constructionYear>
<building:exemptAddressing />
<building:objectStatus>Gällande</building:objectStatus>
<building:geometry>
<building:positionKind>Fasad</building:positionKind>
<building:surface gml:id="ID_3">
<gml:description>String</gml:description>
<lg:Surface gml:id="ID_4">
<gml:description>String</gml:description>
<lg:horizontalAccuracy gml:id="ID_5">
<gml:description>String</gml:description>
<lq:AbsoluteExternalPositionalAccuracy gml:id="ID_6">
<lq:evaluationMethod>indirekt</lq:evaluationMethod>
<lq:QuantitativeResult>
<lq:statisticMethod>medelfel</lq:statisticMethod>
<lq:value>0.024</lq:value>
<lq:measure>meter</lq:measure>
</lq:QuantitativeResult>
</lq:AbsoluteExternalPositionalAccuracy>
</lg:horizontalAccuracy>
<lg:horizontalCoordinateSystem>9ec23aad-8fd1-b149-0a90-c9f6355c3b56</lg:horizontalCoordinateSystem>
<lg:position>
<gml:Surface gml:id="ID_7">
<gml:patches>
<gml:PolygonPatch>
<gml:exterior>
<gml:LinearRing>
<gml:posList>6791424.282 560864.42 6791425.077 560868.1 6791435.646 560865.84 6791434.861 560862.161 6791424.282 560864.42</gml:posList>
</gml:LinearRing>
</gml:exterior>
</gml:PolygonPatch>
</gml:patches>
</gml:Surface>
</lg:position>
</lg:Surface>
</building:surface>
</building:geometry>
<building:extensionYear>2006</building:extensionYear>
<building:residentialUse>
<building:mainUse />
<building:use>Småhus friliggande</building:use>
</building:residentialUse>
<building:name>
<building:value>The house</building:value>
<building:type>Huvudnamn topografi</building:type>
</building:name>
<building:name>
<building:value>The the house</building:value>
<building:type>Huvudnamn topografi</building:type>
</building:name>
<building:realPropertyReference gml:id="ID_999001">
<building:liesOn>18547216-1cbd-213c-232d-a1239786cdf1</building:liesOn>
</building:realPropertyReference>
</building:Building>
</ex:featureMembers>
</ex:FeatureCollection>
</building:FindExchangeObjectResponse>Sök byggnader utifrån fastighetsreferenser
| Element/Attribut | Beskrivning |
|---|---|
FindBuildingRequest |
Hitta byggnader och externa register ( |
|
Behållare för fastighetsreferenser. |
|
Fastighetsreferens |
Exempel fråga
<?xml version="1.0" encoding="UTF-8"?>
<building:FindBuildingRequest xmlns:building="http://namespace.lantmateriet.se/geodata/building/v1">
<building:realPropertyKeyCollection>
<building:realPropertyKey>6cadb238-5398-bc65-ab92-829acd1344fc</building:realPropertyKey>
<building:realPropertyKey>242c23d8-73c9-a12d-cb93-8fc34d2134f4</building:realPropertyKey>
</building:realPropertyKeyCollection>
</building:FindBuildingRequest>Svarstyp utifrån fastighetsreferenser
| Element/Attribut | Beskrivning |
|---|---|
FindExchangeObjectResponse |
Samlar ihop svaret på en sökning |
|
Generell behållare för sökningens resultat. Innehåller en grupp av objekt kallad featureMembers |
|
Innehåller instanser av en eller flera objekttyper. |
|
Noll eller flera byggnader |
|
Noll eller flera skyddsrum |
Exempel svar
<building:FindExchangeObjectResponse
xsi:schemaLocation="http://namespace.lantmateriet.se/geodata/building/v1 buildingService.xsd"
xmlns:building="http://namespace.lantmateriet.se/geodata/building/v1"
xmlns:ex="http://namespace.lantmateriet.se/geodata/exchange/v1"
xmlns:gml="http://www.opengis.net/gml/3.2"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ex:FeatureCollection gml:id="ID_c0ab5f40-7bd2-11e0-819a-0800200c9a66">
<ex:id>c0ab5f40-7bd2-11e0-819a-0800200c9a66</ex:id>
<ex:description>Exempelfil</ex:description>
<ex:extractedAtTime>2011-04-17T09:30:47Z</ex:extractedAtTime>
<ex:featureMembers>
<building:Building gml:id="ID_0fcba49a-a216-4a65-b119-15f1dabfd72f">
<ex:objectId>0fcba49a-a216-4a65-b119-15f1dabfd72f</ex:objectId>
<ex:objectVersion>1</ex:objectVersion>
<building:houseNumber>2</building:houseNumber>
<building:constructionYear>2001</building:constructionYear>
<building:exemptAddressing />
<building:objectStatus>Gällande</building:objectStatus>
<building:geometry>
<building:positionKind>Fasad</building:positionKind>
<building:surface gml:id="ID_3">
<gml:description>String</gml:description>
<lg:Surface gml:id="ID_4">
<gml:description>String</gml:description>
<lg:horizontalAccuracy gml:id="ID_5">
<gml:description>String</gml:description>
<lq:AbsoluteExternalPositionalAccuracy
gml:id="ID_6">
<lq:evaluationMethod>indirekt</lq:evaluationMethod>
<lq:QuantitativeResult>
<lq:statisticMethod>medelfel</lq:statisticMethod>
<lq:value>0.024</lq:value>
<lq:measure>meter</lq:measure>
</lq:QuantitativeResult>
</lq:AbsoluteExternalPositionalAccuracy>
</lg:horizontalAccuracy>
<lg:horizontalCoordinateSystem>9ec23aad-8fd1-b149-0a90-c9f6355c3b56</lg:horizontalCoordinateSystem>
<lg:position>
<gml:Surface gml:id="ID_7">
<gml:patches>
<gml:PolygonPatch>
<gml:exterior>
<gml:LinearRing>
<gml:posList>6791424.282 560864.42 6791425.077 560868.1 6791435.646 560865.84 6791434.861 560862.161 6791424.282 560864.42</gml:posList>
</gml:LinearRing>
</gml:exterior>
</gml:PolygonPatch>
</gml:patches>
</gml:Surface>
</lg:position>
</lg:Surface>
</building:surface>
</building:geometry>
<building:extensionYear>2006</building:extensionYear>
<building:residentialUse>
<building:mainUse />
<building:use>Småhus friliggande</building:use>
</building:residentialUse>
<building:name>
<building:value>The house</building:value>
<building:type>Huvudnamn topografi</building:type>
</building:name>
<building:realPropertyReference gml:id="ID_909a6a7e-0604-90ec-e040-ed8f66444c3f">
<building:liesOn>909a6a7e-0604-90ec-e040-ed8f66444c3f</building:liesOn>
</building:realPropertyReference>
</building:Building>
<building:MsbShelter gml:id="ID_b22c87c0-c489-11de-8a39-0800200c9a66">
<ex:objectId>b22c87c0-c489-11de-8a39-0800200c9a66</ex:objectId>
<ex:objectVersion>1</ex:objectVersion>
<building:identity>Skyddsrum i hus B2</building:identity>
<building:buildingReference>0fcba49a-a216-4a65-b119-15f1dabfd72f</building:buildingReference>
</building:MsbShelter>
</ex:featureMembers>
</ex:FeatureCollection>
</building:FindExchangeObjectResponse>Sök entré
Sök entré utifrån objektidentitet och objektversion
| Element/Attribut | Beskrivning |
|---|---|
FindEntranceRequest |
Hitta entré med nedanstående sökbegrepp: |
|
Unik objektidentitet för entré. Obligatorisk. |
|
Objektversion på entré. Ej obligatorisk. Om utelämnats returneras den senast uppdaterade entrén. |
Exempel fråga
<?xml version="1.0" encoding="UTF-8"?>
<building:FindEntranceRequest xmlns:building="http://namespace.lantmateriet.se/geodata/building/v1">
<building:objectId>5e2734b6-3475-4025-8618-12de9fefcd84</building:objectId>
<building:objectVersion>1</building:objectVersion>
</building:FindEntranceRequest>Sök entréer utifrån objektidentiteter
| Element/Attribut | Beskrivning |
|---|---|
FindEntranceRequest |
Hitta de senast uppdaterade entréerna baserat på nedanstående sökbegrepp: |
|
Behållare för objektidentiteter. |
|
Objektidentiteter för entré. |
Exempel fråga
<?xml version="1.0" encoding="UTF-8"?>
<building:FindEntranceRequest
xmlns:building="http://namespace.lantmateriet.se/geodata/building/v1">
<building:objectIdCollection>
<building:objectId>dfb2f7f5-a4bd-4394-86ab-c0d10f7f29c5</building:objectId>
<building:objectId>6220a75c-b9a6-4323-b1e3-3b48cc65e0ee</building:objectId>
<building:objectId>56a18cc2-088c-407b-8a6c-9e961bc2c1e3</building:objectId>
</building:objectIdCollection>
</building:FindEntranceRequest>Sök entréer utifrån adressplatsreferens
| Element/Attribut | Beskrivning |
|---|---|
FindEntranceRequest |
Hitta de senast uppdaterade entréerna baserat på nedanstående sökbegrepp: |
|
Behållare för adressplatsreferens. |
|
Referens till unik objektidentitet för adressplats (UUID). |
Exempel fråga
<?xml version="1.0" encoding="UTF-8"?>
<building:FindEntranceRequest
xmlns:building="http://namespace.lantmateriet.se/geodata/building/v1">
<building:addressPlaceReferenceCollection>
<building:addressPlaceReference>dfb2f7f5-a4bd-4394-86ab-c0d10f7f29c5</building:addressPlaceReference>
<building:addressPlaceReference>6220a75c-b9a6-4323-b1e3-3b48cc65e0ee</building:addressPlaceReferenced>
<building:addressPlaceReference>56a18cc2-088c-407b-8a6c-9e961bc2c1e3</building:addressPlaceReference>
</building:addressPlaceReferenceCollection>
</building:FindEntranceRequest>Sök entréer utifrån byggnadsreferens
| Element/Attribut | Beskrivning |
|---|---|
FindEntranceRequest |
Hitta de senast uppdaterade entréerna baserat på nedanstående sökbegrepp: |
|
Behållare för byggnadsreferenser. |
|
Referens till unik objektidentitet för byggnad (UUID). |
Exempel fråga
<?xml version="1.0" encoding="UTF-8"?>
<building:FindEntranceRequest
xmlns:building="http://namespace.lantmateriet.se/geodata/building/v1">
<building:buildingReferenceCollection>
<building:buildingReference>dfb2f7f5-a4bd-4394-86ab-c0d10f7f29c5</building:buildingReference>
<building:buildingReference>6220a75c-b9a6-4323-b1e3-3b48cc65e0ee</building:buildingReferenced>
<building:buildingReference>56a18cc2-088c-407b-8a6c-9e961bc2c1e3</building:buildingReference>
</building:buildingReferenceCollection>
</building:FindEntranceRequest>Svarstyp
| Element/Attribut | Beskrivning |
|---|---|
FindExchangeObjectResponse |
Samlar ihop svaret på en sökning |
|
Generell behållare för sökningens resultat. Innehåller en grupp av objekt kallad featureMembers |
|
Innehåller instanser av en eller flera objekttyper. |
|
Noll eller flera entréer. |
Exempel svar
<?xml version="1.0" encoding="UTF-8"?>
<building:FindExchangeObjectResponse
xsi:schemaLocation="http://namespace.lantmateriet.se/geodata/building/v1 buildingService.xsd"
xmlns:building="http://namespace.lantmateriet.se/geodata/building/v1"
xmlns:ex="http://namespace.lantmateriet.se/geodata/exchange/v1"
xmlns:gml="http://www.opengis.net/gml/3.2"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ex:FeatureCollection gml:id="ID_e97231db-6f14-42f0-99af-401a1f181308">
<ex:id>ada9c97b-de1b-404d-89fd-9916e5e3a6a3</ex:id>
<ex:description />
<ex:extractedAtTime>2011-10-04T12:07:46.571Z</ex:extractedAtTime>
<ex:featureMembers>
<building:Entrance gml:id="ID_ec29b6ab-7368-4065-b636-efd011e09351">
<ex:objectId>875b3e4b-7671-4cfd-b25a-4fb3bf47f19c</ex:objectId>
<ex:objectVersion>1</ex:objectVersion>
<ex:versionValidFrom>2011-01-22T21:21:39.311Z</ex:versionValidFrom>
<building:typeOfEntrance>Bostadsadress med registrerad lägenhet</building:typeOfEntrance>
<building:lift>Uppgift saknas</building:lift>
<building:objectStatus>Gällande</building:objectStatus>
<building:buildingReference>4588bc2e-e9d1-4ac3-9b35-a8bb379e18f0</building:buildingReference>
<building:addressPlaceReference>cc074b09-4a86-47de-b7c0-9691bb6301a7</building:addressPlaceReference>
</building:Entrance>
</ex:featureMembers>
</ex:FeatureCollection>
</building:FindExchangeObjectResponse>Sök lägenhet
Sök lägenhet utifrån objektidentitet och objektversion
| Element/Attribut | Beskrivning |
|---|---|
FindDwellingRequest |
Hitta lägenhet med nedanstående sökbegrepp: |
|
Unik objektidentitet för lägenhet. Obligatorisk. |
|
Objektversion på lägenhet. Ej obligatorisk. Om utelämnats returneras den senast uppdaterade lägenheten. |
Exempel fråga
<?xml version="1.0" encoding="UTF-8"?>
<building:FindDwellingRequest xmlns:building="http://namespace.lantmateriet.se/geodata/building/v1">
<building:objectId>6b1e6b9c-b891-11eb-8529-0242ac130003</building:objectId>
<building:objectVersion>2</building:objectVersion>
</building:FindDwellingRequest>Sök lägenheter utifrån objektidentiteter
| Element/Attribut | Beskrivning |
|---|---|
FindDwellingRequest |
Hitta de senast uppdaterade lägenheterna baserat på nedanstående sökbegrepp: |
|
Behållare för objektidentiteter. |
|
Objektidentiteter för lägenhet. |
Exempel fråga
<?xml version="1.0" encoding="UTF-8"?>
<building:FindDwellingRequest
xmlns:building="http://namespace.lantmateriet.se/geodata/building/v1">
<building:objectIdCollection>
<building:objectId>541d166e-b891-11eb-8529-0242ac130003</building:objectId>
<building:objectId>541d1a7e-b891-11eb-8529-0242ac130003</building:objectId>
<building:objectId>541d1b82-b891-11eb-8529-0242ac130003</building:objectId>
</building:objectIdCollection>
</building:FindDwellingRequest>Sök lägenheter utifrån entréreferens
| Element/Attribut | Beskrivning |
|---|---|
FindDwellingRequest |
Hitta de senast uppdaterade lägenheterna baserat på nedanstående sökbegrepp: |
|
Referens till unik objektidentitet för entré (UUID). |
Exempel fråga
<?xml version="1.0" encoding="UTF-8"?>
<building:FindDwellingRequest
xmlns:building="http://namespace.lantmateriet.se/geodata/building/v1">
<building:entranceReference>3304de8e-b892-11eb-8529-0242ac130003</building:addressPlaceReference>
<building:entranceReference>3304e3ac-b892-11eb-8529-0242ac130003</building:addressPlaceReferenced>
<building:entranceReference>3304e4a6-b892-11eb-8529-0242ac130003</building:addressPlaceReference>
</building:FindDwellingRequest>Svarstyp
| Element/Attribut | Beskrivning |
|---|---|
FindExchangeObjectResponse |
Samlar ihop svaret på en sökning |
|
Generell behållare för sökningens resultat. Innehåller en grupp av objekt kallad featureMembers |
|
Innehåller instanser av en eller flera objekttyper. |
|
Noll eller flera lägenheter. |
Exempel svar
<?xml version="1.0" encoding="UTF-8"?>
<building:FindExchangeObjectResponse
xsi:schemaLocation="http://namespace.lantmateriet.se/geodata/building/v1 buildingService.xsd"
xmlns:building="http://namespace.lantmateriet.se/geodata/building/v1"
xmlns:ex="http://namespace.lantmateriet.se/geodata/exchange/v1"
xmlns:gml="http://www.opengis.net/gml/3.2"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ex:FeatureCollection gml:id="ID_c0ab5f40-7bd2-11e0-819a-0800200c9a66">
<ex:id>c0ab5f40-7bd2-11e0-819a-0800200c9a66</ex:id>
<ex:description>Exempelfil</ex:description>
<ex:extractedAtTime>2011-04-17T09:30:47Z</ex:extractedAtTime>
<ex:featureMembers>
<building:Dwelling gml:id="ID_f30f7e60-7ad0-11e0-819a-0800200c9a66">
<ex:objectId>f30f7e60-7ad0-11e0-819a-0800200c9a66</ex:objectId>
<ex:objectVersion>1</ex:objectVersion>
<building:dwellingNumber>1</building:dwellingNumber>
<building:numberingDate>2009-10-11</building:numberingDate>
<building:notificationOfNumberingDate>2009-10-11</building:notificationOfNumberingDate>
<building:numberOfRooms>5</building:numberOfRooms>
<building:usefulFloorSpace>120</building:usefulFloorSpace>
<building:category>Vanlig bostadslägenhet</building:category>
<building:typeOfKitchen>Kök</building:typeOfKitchen>
<building:collectionMethod>On-lineregistrering</building:collectionMethod>
<building:objectStatus>Gällande</building:objectStatus>
<building:entranceReference>fd0e8b90-7ad0-11e0-819a-0800200c9a66</building:entranceReference>
</building:Dwelling>
</ex:featureMembers>
</ex:FeatureCollection>
</building:FindExchangeObjectResponse>Sök skyddsrum
Sök skyddsrum utifrån objektidentitet och objektversion
| Element/Attribut | Beskrivning |
|---|---|
FindMsbShelterRequest |
Hitta skyddsrum med nedanstående sökbegrepp: |
|
Unik objektidentitet för skyddsrummet. Obligatorisk. |
|
Objektversion på skyddsrummet. Ej obligatorisk. Om utelämnats returneras det senast uppdaterade skyddsrummet. |
Exempel fråga
<?xml version="1.0" encoding="UTF-8"?>
<building:FindMsbShelterRequest xmlns:building="http://namespace.lantmateriet.se/geodata/building/v1">
<building:objectId>14285e00-8096-4f9d-852b-586b95a74114</building:objectId>
<building:objectVersion>3</building:objectVersion>
</building:FindMsbShelterRequest>Sök skyddsrum utifrån objektidentiteter
| Element/Attribut | Beskrivning |
|---|---|
FindMsbShelterRequest |
Hitta de senast uppdaterade skyddsrummen baserat på nedanstående sökbegrepp: |
|
Behållare för objektidentiteter. |
|
Objektidentiteter för skyddsrum. |
Exempel fråga
<?xml version="1.0" encoding="UTF-8"?>
<building:FindMsbShelterRequest xmlns:building="http://namespace.lantmateriet.se/geodata/building/v1">
<building:objectIdCollection>
<building:objectId>da144bc8-b89d-11eb-8529-0242ac130003</building:objectId>
<building:objectId>da144ed4-b89d-11eb-8529-0242ac130003</building:objectId>
<building:objectId>da145230-b89d-11eb-8529-0242ac130003</building:objectId>
</building:objectIdCollection>
</building:FindMsbShelterRequest>Svarstyp
| Element/Attribut | Beskrivning |
|---|---|
FindExchangeObjectResponse |
Samlar ihop svaret på en sökning |
|
Generell behållare för sökningens resultat. Innehåller en grupp av objekt kallad featureMembers |
|
Innehåller instanser av en eller flera objekttyper. |
|
Noll eller flera skyddsrum. |
Exempel svar
<?xml version="1.0" encoding="UTF-8"?>
<building:FindExchangeObjectResponse
xmlns:ex="http://namespace.lantmateriet.se/geodata/exchange/v1"
xmlns:building="http://namespace.lantmateriet.se/geodata/building/v1"
xmlns:gml="http://www.opengis.net/gml/3.2">
<ex:FeatureCollection gml:id="ID_95ef52e0-f5d2-445f-860a-c7457a7fa73d">
<ex:id>95ef52e0-f5d2-445f-860a-c7457a7fa73d</ex:id>
<ex:description />
<ex:extractedAtTime>2011-10-05T05:24:42.860Z</ex:extractedAtTime>
<ex:featureMembers>
<building:MsbShelter gml:id="ID_388b670e-b89e-11eb-8529-0242ac130003">
<ex:objectId>388b670e-b89e-11eb-8529-0242ac130003</ex:objectId>
<ex:objectVersion>1</ex:objectVersion>
<ex:versionValidFrom>2011-01-22T12:39:08.218Z</ex:versionValidFrom>
<building:identity>1206557</building:identity>
<building:buildingReference>33062cf6-b89e-11eb-8529-0242ac130003</building:buildingReference>
</building:MsbShelter>
</ex:featureMembers>
</ex:FeatureCollection>
</building:FindExchangeObjectResponse>Sök förändringar för byggnadsobjekt
| Element/Attribut | Beskrivning |
|---|---|
FindChangedObjectsRequest |
Söker, utifrån nedanstående kriterier, fram de förändringar (beståndskontroll) som skett för givet utbytesobjekt. Funktionen returnerar EJ borttagna (DELETE) utbytesobjekt. |
|
Obligatorisk. Ger möjlighet att begränsa utsökningen till antal givna svar. Bör användas tillsammans med orderBy. Möjliggör paging. |
|
Filtrerar sökningen med avseende på: |
|
|
|
|
|
|
|
Ej obligatorisk. Bör användas för att paging skall fungera. Sortering möjlig på |
Exempel fråga
<?xml version="1.0" encoding="UTF-8"?>
<building:FindChangedObjectsRequest
xmlns:building="http://namespace.lantmateriet.se/geodata/building/v1"
xmlns:exq="http://namespace.lantmateriet.se/geodata/exchange/query/exchangeobjectsinformation/v2">
<building:limit firstResult="1" maxResults="10"/>
<building:filter>
<building:validFromFilter>
<exq:fromDate>2013-01-17T20:52:30.597+01:00</exq:fromDate>
<exq:toDate>2013-03-19T20:52:30.597+01:00</exq:toDate>
</building:validFromFilter>
<building:ObjectTypeFilter>Building</building:ObjectTypeFilter>
<building:MunicipalityKeyFilter>2884</building:MunicipalityKeyFilter>
</building:filter>
<building:orderBy>
<exq:ValidFrom order="descending"/>
</building:orderBy>
</building:FindChangedObjectsRequest>Svarstyp
| Element/Attribut | Beskrivning |
|---|---|
FindChangedObjectsResponse |
Samlar ihop svaret på en sökning |
|
Noll eller flera informationsobjekt om det utbytesobjekt som efterfrågats (byggnad, entré och dwelling). |
Exempel svar
<?xml version="1.0" encoding="UTF-8"?>
<building:FindChangedObjectsResponse
xmlns:building="http://namespace.lantmateriet.se/geodata/building/v1"
xmlns:gml="http://www.opengis.net/gml/3.2"
xmlns:exq="http://namespace.lantmateriet.se/geodata/exchange/query/exchangeobjectsinformation/v2">
<building:ExchangeObjectInformation gml:id="ID_2135df2e-20d1-44c5-998c-5a12029c48ec">
<exq:objectId>1ecd9d4e-7527-409d-8913-9033ac3dc562</exq:objectId>
<exq:objectVersion>1</exq:objectVersion>
<exq:objectStatus>Gällande</exq:objectStatus>
<exq:versionValidFrom>2014-02-03T07:25:40.776Z</exq:versionValidFrom>
</building:ExchangeObjectInformation>
<building:ExchangeObjectInformation gml:id="ID_57e47291-ac18-4f76-91b5-73d2ed403a4a">
<exq:objectId>29802b9f-e36b-4a03-8f39-166e68f44b33</exq:objectId>
<exq:objectVersion>3</exq:objectVersion>
<exq:objectStatus>Gällande</exq:objectStatus>
<exq:versionValidFrom>2014-02-03T07:25:45.224Z</exq:versionValidFrom>
</building:ExchangeObjectInformation>
<building:ExchangeObjectInformation gml:id="ID_e66595c4-3a56-4c12-a5c3-600870155eab">
<exq:objectId>2e89f2f9-1c2c-4320-a7e0-e53ea5cc9489</exq:objectId>
<exq:objectVersion>1</exq:objectVersion>
<exq:objectStatus>Gällande</exq:objectStatus>
<exq:versionValidFrom>2014-02-03T07:25:40.776Z</exq:versionValidFrom>
</address:ExchangeObjectInformation>
<address:ExchangeObjectInformation gml:id="ID_92dbd1a9-325e-4b9a-a8cb-a64cbf65e89e">
<exq:objectId>37cf1ddb-1da7-4248-8a40-f03b5ba39ef5</exq:objectId>
<exq:objectVersion>2</exq:objectVersion>
<exq:objectStatus>Gällande</exq:objectStatus>
<exq:versionValidFrom>2014-02-03T07:25:43.870Z</exq:versionValidFrom>
</building:ExchangeObjectInformation>
</building:FindChangedObjectsResponse>Brist
Gränssnittsdefinitioner
| Miljö | Typ | Källa |
|---|---|---|
Produktion |
WSDL |
http://namespace.lantmateriet.se/geodata/defect/v1/defectService.wsdl |
XML-schema |
http://namespace.lantmateriet.se/geodata/defect/v1/defectService.xsd |
|
Verifiering |
WSDL |
http://namespace.lantmateriet.se/geodata/defect/v1/defectService-ver.wsdl |
XML-schema |
http://namespace.lantmateriet.se/geodata/defect/v1/defectService.xsd |
Sök brist
Bristsökning styrs med hjälp av
-
Limit - För att begränsa antalet träffar i svaret
-
Filter - För att ange urvalskriterier
-
OrderBy - För att ange sorteringsordningen i svaret
Filter går att kombinera med varandra och det går att skapa listor med sökvärden för varje filter. Filter kan också utelämnas vilket innebär att samtliga brister returneras.
Viktigt!
Unvik att kombinera GeographicLocationFilter tillsammans med OrderBy då detta riskerar att leda till långa svarstider och timeout problematik.
| Element/Attribut | Beskrivning |
|---|---|
FindDefectsRequest |
Söker, utifrån nedanstående kriterier, fram de brister som finns i Bristsystemet. |
|
Obligatorisk. Ger möjlighet att begränsa utsökningen till antal givna svar. Bör användas tillsammans med orderBy. Möjliggör paging. |
|
Filtrerar sökningen med avseende på följande icke obligatoriska filtersteg: |
identifieringsdatum ( |
|
objektreferens ( |
|
bristtyp ( |
|
kommunkod ( |
|
fastighetsreferens ( |
|
geometri ( |
|
|
Ej obligatorisk. Sortering kan göras på bristtyp ( |
Ex1: Sortering fastighetsbeteckning i stigande ordning
<OrderBy><RealPropertyDesignation order="ascending" /></OrderBy>Ex2: Sortering bristtyp i fallande ordning:
<OrderBy><DefectTypeId order="descending" /></OrderBy>Exempel fråga
<?xml version="1.0" encoding="UTF-8"?>
<v1:FindDefectsRequest
xmlns:defect="http://namespace.lantmateriet.se/geodata/defect/v1"
xmlns:ns="http://www.opengis.net/gml/3.2">
<!-- Begränsa svaret till ett bestämt antal svar -->
<!-- I kombination med OrderBy kan Limit användas för paging, -->
<!-- dvs man får de nästa 10 följande svaren om man ställer samma fråga igen med firstResult="11" maxResults="10"-->
<defect:Limit firstResult="1" maxResults="10"/>
<!-- 6 olika filter i valfri ordning och kombination-->
<defect:Filter>
<!-- Sök efter brister som identifierats efter ett visst datum. -->
<defect:IdentifiedOnFilter match="LaterThan">2014-09-21T08:20:30.0Z</defect:IdentifiedOnFilter>
<!-- Sök efter brister som innehåller angivna objekt -->
<defect:ObjectReferenceFilter>
<defect:ObjectReference>
<defect:objectType>Byggnad</defect:objectType>
<defect:objectId>8596ae12-679d-4c73-9883-fe15a94d4881</defect:objectId>
</defect:ObjectReference>
<defect:ObjectReference>
<defect:objectType>Adressplats</defect:objectType>
<defect:objectId>7596ae12-679d-4c73-9883-fe15a94d1234</defect:objectId>
</defect:ObjectReference>
</defect:ObjectReferenceFilter>
<!-- Sök efter angivna bristtyper. -->
<defect:DefectTypeFilter>
<defect:defectTypeCode>B001</defect:defectTypeCode>
<defect:defectTypeCode>A006</defect:defectTypeCode>
</defect:DefectTypeFilter>
<!-- Sök efter brister i vissa kommuner. -->
<defect:MunicipalityFilter>
<defect:municipalityKey>2180</defect:municipalityKey>
<defect:municipalityKey>2181</defect:municipalityKey>
</defect:MunicipalityFilter>
<!-- Sök efter brister som direkt eller indirekt är kopplade till vissa fastigheter. -->
<defect:RealPropertyFilter>
<defect:realPropertyKey>db629e1e-b8b4-11eb-8529-0242ac130003</defect:realPropertyKey>
<defect:realPropertyKey>db62a03a-b8b4-11eb-8529-0242ac130003</defect:realPropertyKey>
</defect:RealPropertyFilter>
<!-- Sök efter brister inom ett eller flera angivna områden. -->
<defect:GeographicLocationFilter>
<ns:Polygon ns:id="P1" srsName="EPSG:3006">
<ns:exterior>
<ns:LinearRing>
<ns:posList>
7523100 757200
7523100 757300
7523200 757300
7523200 757200
7523100 757200
</ns:posList>
</ns:LinearRing>
</ns:exterior>
</ns:Polygon>
<ns:Polygon ns:id="P2" srsName="EPSG:3006">
<ns:exterior>
<ns:LinearRing>
<ns:posList>
6967230 568590
6967230 568600
6967240 568600
6967240 568590
6967230 568590
</ns:posList>
</ns:LinearRing>
</ns:exterior>
</ns:Polygon>
</defect:GeographicLocationFilter>
</defect:Filter>
<defect:OrderBy>
<defect:DefectTypeId order="ascending"/>
<!-- Alternativ <defect:RealPropertyDesignation order="descending"/> -->
</defect:OrderBy>
</defect:FindDefectsRequest>Svarstyp
| Element/Attribut | Beskrivning |
|---|---|
FindDefectsResponse |
Samlar ihop svaret på en sökning |
|
Noll eller flera identifierade brister. |
Exempel svar
<?xml version="1.0" encoding="UTF-8"?>
<defect:FindDefectsResponse
xmlns:defect="http://namespace.lantmateriet.se/geodata/defect/v1"
xmlns:gml="http://www.opengis.net/gml/3.2">
<defect:DefectInformation>
<defect:defectTypeId>B009</defect:defectTypeId>
<defect:objectReference>
<defect:objectType>Byggnad</defect:objectType>
<defect:objectId>5c88e4d3-1539-4f69-937c-41662664d74d</defect:objectId>
</defect:objectReference>
<defect:identifiedOn>2013-12-03T12:08:01.886Z</defect:identifiedOn>
<defect:municipalityKey>2584</defect:municipalityKey>
<defect:realPropertyKey>250099987</defect:realPropertyKey>
<defect:realPropertyDesignation>KIRUNA SVAPPAVAARA 12:3</defect:realPropertyDesignation>
<defect:geographicLocation>
<gml:Point gml:id="ID_f6ce4b90-309b-4349-920f-57e137a13ff4">
<gml:pos>7523184.03057005 757220.11378766</gml:pos>
</gml:Point>
</defect:geographicLocation>
</defect:DefectInformation>
<defect:DefectInformation>
<defect:defectTypeId>B001</defect:defectTypeId>
<defect:objectReference>
<defect:objectType>Byggnad</defect:objectType>
<defect:objectId>5c88e4d3-1539-4f69-937c-41662664d74d</defect:objectId>
</defect:objectReference>
<defect:identifiedOn>2011-10-27T12:54:39.226Z</defect:identifiedOn>
<defect:municipalityKey>2584</defect:municipalityKey>
<defect:realPropertyKey>250099987</defect:realPropertyKey>
<defect:realPropertyDesignation>KIRUNA SVAPPAVAARA 12:3</defect:realPropertyDesignation>
<defect:geographicLocation>
<gml:Point gml:id="ID_ca03cc2b-b990-45b4-a7d8-b0928ef80c25">
<gml:pos>7523184.03057005 757220.11378766</gml:pos>
</gml:Point>
</defect:geographicLocation>
</defect:DefectInformation>
</defect:FindDefectsResponse>Tjänster uppdatering
Adress och Byggnad
Gränssnittsdefinitioner
Uppdateringar av utbytesobjekt inom adressdomänen skickas till url beskriven i 'addressService.wsdl' eller 'addressService-ver.wsdl'. Uppdateringar av utbytesobjekt inom byggnadsdomänen skickas till url beskriven i 'buildingService.wsdl' eller 'buildingService-ver.wsdl'.
Båda domänernas uppdateringar följer exakt samma mönster.
Förändringstransaktion
Uppdateringsprocess
De tjänster som används samt exempel-xml visas nedan.
-
Skicka in förändringstransaktion (
ChangeTransaction), steg 1, och erhåll ettjobIdsom svar, steg 3. -
Ställ frågor (
IsJobCompletedRequest) tills uppdateringen är klar, steg 7 och steg 9. -
Då uppdateringen är klar, hämta svaret på uppdateringen (
FindJobResultRequest), steg 10, och ta emot svaret, steg 11.
| Element/Attribut | Beskrivning |
|---|---|
ChangeTransaction |
Håller samman en förändringstransaktion av utbytesobjekt. |
|
Håller samman alla nya utbytesobjekt samt åtgärden
( |
|
Håller samman alla utbytesobjekt som skall förändras. |
|
Håller samman alla utbytesobjekt som skall tas bort. |
|
Samlingsbegrepp för utbytesobjekt (adressplats, byggnad, entré etc). |
|
Åtgärd som beskriver uppdateringens avsikt. |
Exempel uppdatering
<?xml version="1.0" encoding="UTF-8"?>
<ex:ChangeTransaction
xmlns:ex="http://namespace.lantmateriet.se/geodata/exchange/v1"
xmlns:gml32="http://www.opengis.net/gml/3.2"
xmlns:building="http://namespace.lantmateriet.se/geodata/building/v1"
xmlns:lg="http://namespace.lantmateriet.se/geodata/geometry/v1"
xmlns:lq="http://namespace.lantmateriet.se/geodata/quality/v1"
xmlns:xlink="http://www.w3.org/1999/xlink" gml32:id="ID_2e8dc18a-2739-4be8-9c5e-e343b4ad2c68">
<gml32:description>LINA</gml32:description>
<ex:id>27102f00-5233-4030-90a5-7265405f9659</ex:id>
<ex:description>String</ex:description>
<ex:extractedAtTime>2011-11-18T13:02:53.596+01:00</ex:extractedAtTime>
<ex:Add>
<building:BuildingBusinessActivity gml32:id="ID_6c5148d3-f398-4f7f-a9a7-98afd65d794e">
<ex:objectId>34dd0d5c-3faf-48a9-93fe-e561ff52ee23</ex:objectId>
<ex:objectVersion>1</ex:objectVersion>
<ex:responsibleParty>Älvsbyn</ex:responsibleParty>
<ex:executingParty>Älvsbyn</ex:executingParty>
<ex:exchangeObjectReference gml32:remoteSchema="http://namespace.lantmateriet.se/geodata/building/v1#BuildingType" xlink:href="ID_74ca5d79-afda-41ca-a8fe-c838d4cdc7ec"/>
<building:activityType>Ändrad byggnadsinformation</building:activityType>
</building:BuildingBusinessActivity>
</ex:Add>
<ex:Modify>
<building:Building gml32:id="ID_74ca5d79-afda-41ca-a8fe-c838d4cdc7ec">
<ex:objectId>3763decc-204c-433a-87d6-3ec5d3d3c30c</ex:objectId>
<ex:objectVersion>2</ex:objectVersion>
<building:houseNumber>2</building:houseNumber>
<building:constructionYear>2011</building:constructionYear>
<building:objectStatus>Gällande</building:objectStatus>
<building:geometry>
<building:positionKind>Illustrativt läge</building:positionKind>
<building:surface gml32:id="ID_f10b9ee6-c51c-464e-ad80-cb1f5f7b7e26">
<lg:Surface gml32:id="ID_cb6523c4-dbdb-477c-8ef3-de75644a9c36">
<lg:horizontalAccuracy gml32:id="ID_c236fe90-9f91-4bad-bb3d-0fef25163159">
<lq:AbsoluteExternalPositionalAccuracy gml32:id="ID_e8165a2f-c6d0-4659-abea-6ab2fb4db2f9">
<lq:noInformation xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsis="http://www.w3.org/2001/XMLSchema" xsi:type="xsis:string"/>
</lq:AbsoluteExternalPositionalAccuracy>
</lg:horizontalAccuracy>
<lg:horizontalCoordinateSystem>9ec23aad-8fd1-b149-0a90-c9f6355c3b56</lg:horizontalCoordinateSystem>
<lg:position>
<gml32:Surface gml32:id="ID_888c9014-4d2b-440c-b385-e95c21ff3595">
<gml32:patches>
<gml32:PolygonPatch>
<gml32:exterior>
<gml32:LinearRing>
<gml32:posList>7296384.609 771827.031 7296376.81 771829.87 7296385.839 771854.678 7296393.639 771851.839 7296384.609 771827.031</gml32:posList>
</gml32:LinearRing>
</gml32:exterior>
</gml32:PolygonPatch>
</gml32:patches>
</gml32:Surface>
</lg:position>
</lg:Surface>
</building:surface>
</building:geometry>
<building:residentialUse>
<building:use>Småhus friliggande</building:use>
<building:usefulFloorSpace>121</building:usefulFloorSpace>
</building:residentialUse>
<building:realPropertyReference gml32:id="ID_2d445f49-c6c1-4b9d-b88f-2a4e56966cfe">
<building:liesOn>250171923</building:liesOn>
</building:realPropertyReference>
</building:Building>
</ex:Modify>
</ex:ChangeTransaction>Svarstyp
| Element/Attribut | Beskrivning |
|---|---|
RegisterJobResponse |
Kvittens på att uppdateringsjobb startat. |
|
Unikt jobbid ( |
Exempel svar
<mjob:RegisterJobResponse xmlns:mjob="http://namespace.lantmateriet.se/messaging/job/v1">
<mjob:jobId>1d0fe064-b956-11eb-8529-0242ac130003</mjob:jobId>
</mjob:RegisterJobResponse>Jobbstatus
Hämta jobbstats för begärd och pågående förändringstransaktion.
| Element/Attribut | Beskrivning |
|---|---|
IsJobCompletedRequest |
Fråga om uppdateringjobb är klart. |
|
Unikt jobbid ( |
Exempel jobbstatus
<?xml version="1.0" encoding="UTF-8"?>
<mjob:IsJobCompletedRequest xmlns:mjob="http://namespace.lantmateriet.se/messaging/job/v1">
<mjob:jobId>1d0fe064-b956-11eb-8529-0242ac130003</mjob:jobId>
</mjob:IsJobCompletedRequest>Svarstyp
| Element/Attribut | Beskrivning |
|---|---|
IsJobCompletedResponse |
Fråga om uppdateringjobb är klart. |
|
Unikt jobbidentitet ( |
|
Unikt jobbidentitet ( |
|
Unikt jobbidentitet ( |
Exempel svar
<?xml version="1.0" encoding="UTF-8"?>
<mjob:IsJobCompletedResponse xmlns:mjob="http://namespace.lantmateriet.se/messaging/job/v1">
<mjob:COMPLETED />
</mjob:IsJobCompletedResponse>Hämta kvittens
Hämta kvittens med resultat av begärd förändringstransaktion.
| Element/Attribut | Beskrivning |
|---|---|
FindJobResultRequest |
Fråga om kvittens med resultat hur förändringstransaktion ( |
|
Unikt jobbid ( |
Exempel hämta kvittens
<?xml version="1.0" encoding="UTF-8"?>
<mjob:FindJobResultRequest xmlns:mjob="http://namespace.lantmateriet.se/messaging/job/v1">
<mjob:jobId>1d0fe064-b956-11eb-8529-0242ac130003</mjob:jobId>
</mjob:FindJobResultRequest>Svarstyp
OBS!
Se mer i avsnittet om Felhantering för hur förändringstransaktioner som resulterar i fel beteer sig.
| Element/Attribut | Beskrivning |
|---|---|
Result |
Begärd förändringstransaktion ( |
|
Lyckad utförd förändringstransaktion. |
|
Gruppering av ett eller flera abstrakta fel ( |
|
Fel som uppkommit under utförande av förändringstransaktionen. T.ex valideringsfel, attributfel. |
Exempel svar, utförd förändringstransaktion
<?xml version="1.0" encoding="UTF-8"?>
<result:Successful xmlns:result="http://namespace.lantmateriet.se/geodata/result/v1"/>Exempel svar, misslyckad förändringstransaktion med schemavalideringsfel
<?xml version="1.0" encoding="UTF-8"?>
<env:Fault>
<env:Code>
<env:Value>env:Sender</env:Value>
</env:Code>
<env:Reason>
<env:Text xml:lang="en-US">Request failed</env:Text>
</env:Reason>
<env:Detail xmlns:env="http://www.w3.org/2003/05/soap-envelope">
<result:SchemaValidationError xmlns:result="http://namespace.lantmateriet.se/geodata/result/v1">
<result:timestamp>2011-11-08T09:42:56.275Z</result:timestamp>
<result:errorCode>Origo-4001</result:errorCode>
<result:errorMessage>SchemaValidationError Cause: cvc-type.3.1.3: The
value 'INVALID' of element 'address:objectStatus' is not valid.</result:errorMessage>
<result:line>32</result:line>
<result:column>56</result:column>
</result:SchemaValidationError>
<result:SchemaValidationError xmlns:result="http://namespace.lantmateriet.se/geodata/result/v1">
<result:timestamp>2011-11-08T09:42:56.275Z</result:timestamp>
<result:errorCode>Origo-4001</result:errorCode>
<result:errorMessage>SchemaValidationError Cause:
cvc-enumeration-valid: Value 'INVALID' is not facet-valid with
respect to enumeration '[Planerad, Gällande, Gällande under
utredning, Avregistrerad]'. It must be a value from the enumeration.</result:errorMessage>
<result:line>32</result:line>
<result:column>56</result:column>
</result:SchemaValidationError>
</env:Detail>
</env:Fault>Exempel svar, misslyckad med verksamhetsregelfel
<?xml version="1.0" encoding="UTF-8"?>
<env:Fault>
<env:Code>
<env:Value>env:Sender</env:Value>
</env:Code>
<env:Reason>
<env:Text xml:lang="sv-SE">Request failed</env:Text>
</env:Reason>
<env:Detail xmlns:env="http://www.w3.org/2003/05/soap-envelope">
<result:AttributeError xmlns:result="http://namespace.lantmateriet.se/geodata/result/v1">
<result:timestamp xmlns:result="http://namespace.lantmateriet.se/geodata/result/v1">2021-05-20T13:39:40.997Z</result:timestamp>
<result:errorCode xmlns:result="http://namespace.lantmateriet.se/geodata/result/v1">Origo-2001</result:errorCode>
<result:errorMessage xmlns:result="http://namespace.lantmateriet.se/geodata/result/v1">(BAL-3000) Ett utbytesobjekt ska ha en unik objektidentitet 0863cffa-b973-11eb-8529-0242ac130003.</result:errorMessage>
<result:errorObjectId xmlns:result="http://namespace.lantmateriet.se/geodata/result/v1">0863cffa-b973-11eb-8529-0242ac130003</result:errorObjectId>
<result:attributeName xmlns:result="http://namespace.lantmateriet.se/geodata/result/v1">objectId</result:attributeName>
<result:attributeValue xmlns:result="http://namespace.lantmateriet.se/geodata/result/v1">0863cffa-b973-11eb-8529-0242ac130003</result:attributeValue>
</result:AttributeError>
</env:Detail>
</env:Fault>Felhantering
Alla anrop till en tjänst (frågor eller uppdateringar) som av någon orsak går fel kommer att returnera ett svar i form av ett SOAP Fault-meddelande. Exempel på orsaker att anrop till en tjänst misslyckas:
-
felaktigt utformad xml
-
behörighet saknas
-
tekniska problem såsom t.ex tillfälliga driftstörningar
HTTP statuskod HTTP 200 returneras för svar som lyckats. HTTP 500 returneras för svar som misslyckas (SOAP fault).
Felmeddelande
Beskrivning av innehållet i SOAP Fault-meddelandet:
| XML element | Beskrivning | Kommentar |
|---|---|---|
env:Code |
Anger vem som orsakat felet |
env:Sender - tjänsten anropades på fel sätt, ex. saknad SOAP-header |
env:Receiver - fel i GDSBAL, exempelvis misslyckat anrop till extern resurs |
||
env:Reason |
Beskriver varför SOAP Fault skickats |
I dagsläget alltid 'Request failed' |
env:Detail |
Ett eller flera AbstractError-objekt |
Orsak till fel (schemavalideringsfel, regelfel, systemfel eller annat). |
Fel och typer av fel definieras av schemat http://namespace.lantmateriet.se/geodata/result/v1/result.xsd
Interna systemfel kommer vara av typen SystemError medan klientfel kommer vara av typen RequestError eller någon av dom mer specifika feltyperna AttributeError, RuleError, RelationshipError, GeometricError eller SchemaValidationError.
Exempel på svar vid misslyckade anrop
Schemavalideringsfel:
<?xml version="1.0" encoding="UTF-8"?>
<env:Envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope" xmlns:lmm="http://namespace.lantmateriet.se/messaging/headers/v1" xmlns:wsa="http://www.w3.org/2005/08/addressing">
<env:Header>
<wsa:MessageID>urn:uuid:f1c3176c-a0de-480e-92c0-53bed3c54287</wsa:MessageID>
<lmm:timestamp>2024-03-12T07:16:02.865Z</lmm:timestamp>
<wsa:From><wsa:Address>*** FROM ***</wsa:Address></wsa:From>
</env:Header>
<env:Body>
<env:Fault>
<env:Code>
<env:Value>env:Sender</env:Value>
</env:Code>
<env:Reason>
<env:Text xml:lang="sv-SE">Request failed</env:Text>
</env:Reason>
<env:Detail xmlns:env="http://www.w3.org/2003/05/soap-envelope">
<result:SchemaValidationError xmlns:result="http://namespace.lantmateriet.se/geodata/result/v1">
<result:timestamp>2011-06-10T07:16:02.865Z</result:timestamp>
<result:errorCode>Origo-4001</result:errorCode>
<result:errorMessage>SchemaValidationError Cause: cvc-complex-type.2.4.a: Invalid content was found starting with element 'address:positionKind'. One of '{"http://namespace.lantmateriet.se/geodata/address/v1":type}' is expected.</result:errorMessage>
<result:line>13</result:line>
<result:column>28</result:column>
</result:SchemaValidationError>
</env:Detail>
</env:Fault>
</env:Body>
</env:Envelope>Relationsfel:
<?xml version="1.0" encoding="UTF-8"?>
<env:Envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope"
xmlns:lmm="http://namespace.lantmateriet.se/messaging/headers/v1"
xmlns:wsa="http://www.w3.org/2005/08/addressing">
<env:Header>
<wsa:MessageID>urn:uuid:a82b1121-0fff-4857-933d-351c7c2fc5a2</wsa:MessageID>
<lmm:timestamp>2024-03-12T12:03:59.049Z</lmm:timestamp>
<wsa:From>
<wsa:Address>*** FROM ***</wsa:Address>
</wsa:From>
<wsa:RelatesTo>urn:uuid:88dd9bc1-1e51-4519-b975-4ae30afe6905</wsa:RelatesTo>
</env:Header>
<env:Body>
<env:Fault>
<env:Code>
<env:Value>env:Sender</env:Value>
</env:Code>
<env:Reason>
<env:Text xml:lang="en-US">Request failed</env:Text>
</env:Reason>
<env:Detail xmlns="http://www.w3.org/2003/05/soap-envelope" xmlns:env="http://www.w3.org/2003/05/soap-envelope">
<result:RelationshipError xmlns:result="http://namespace.lantmateriet.se/geodata/result/v1">
<result:timestamp xmlns:result="http://namespace.lantmateriet.se/geodata/result/v1">2024-03-08T12:03:59.048Z</result:timestamp>
<result:errorCode xmlns:result="http://namespace.lantmateriet.se/geodata/result/v1">Origo-2015</result:errorCode>
<result:errorMessage xmlns:result="http://namespace.lantmateriet.se/geodata/result/v1">Origo-2015 - (BAL-3009) Objekt f4cc37f7-7865-4488-a8a1-c79f684373c3 tillhör flera verksamhetsåtgärder än ID_362a9c56-d70b-4396-8759-2925b21aca2c (7235e3fb-0b7e-4c60-93f0-dceff1b4144f).</result:errorMessage>
<result:errorObjectId>f4cc37f7-7865-4488-a8a1-c79f684373c3</result:errorObjectId>
<result:relatedObjectId>7235e3fb-0b7e-4c60-93f0-dceff1b4144f</result:relatedObjectId>
</result:RelationshipError>
</env:Detail>
</env:Fault>
</env:Body>
</env:Envelope>Behörighetsfel:
<?xml version="1.0" encoding="UTF-8"?>
<env:Envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope"
xmlns:lmm="http://namespace.lantmateriet.se/messaging/headers/v1"
xmlns:wsa="http://www.w3.org/2005/08/addressing">
<env:Header>
<wsa:MessageID>urn:uuid:a82b1121-0fff-4857-933d-351c7c2fc5a2</wsa:MessageID>
<lmm:timestamp>2024-03-12T13:24:39.016Z</lmm:timestamp>
<wsa:From>
<wsa:Address>*** FROM ***</wsa:Address>
</wsa:From>
<wsa:RelatesTo>urn:uuid:88dd9bc1-1e51-4519-b975-4ae30afe6905</wsa:RelatesTo>
</env:Header>
<env:Body>
<env:Fault>
<env:Code>
<env:Value>env:Sender</env:Value>
</env:Code>
<env:Reason>
<env:Text xml:lang="en-US">Request failed</env:Text>
</env:Reason>
<env:Detail xmlns="http://www.w3.org/2003/05/soap-envelope" xmlns:env="http://www.w3.org/2003/05/soap-envelope">
<result:RequestError xmlns:result="http://namespace.lantmateriet.se/geodata/result/v1">
<result:timestamp xmlns:result="http://namespace.lantmateriet.se/geodata/result/v1">2024-03-08T12:03:59.048Z</result:timestamp>
<result:errorCode xmlns:result="http://namespace.lantmateriet.se/geodata/result/v1">Origo-2034</result:errorCode>
<result:errorMessage xmlns:result="http://namespace.lantmateriet.se/geodata/result/v1">Din användare (user0001) har ej behörighet att fråga/uppdatera objekt i kommunerna med kommunkoder: 2180</result:errorMessage>
</result:RequestError>
</env:Detail>
</env:Fault>
</env:Body>
</env:Envelope>Felkoder
Felkoder Varje felmeddelande från grunddatasystemet skall innehålla en felkod och varje felkod har ett motsvarande felmeddelande. Felkoderna är uppdelade i ett flertal nummerserier:
| Nummerserie | Användningsområde |
|---|---|
2001-2199 |
Generella verksamhetsregler för utbytesobjekt. |
2200-2299 |
Verksamhetsregler och brister specifika för byggnadsdomänen. |
2300-2399 |
Verksamhetsregler och brister specifika för addressdomänen. |
2400-2499 |
Felmeddelanden för frågor. |
2500-2599 |
Verksamhetsregler för entré och lägenhet. |
3001-3999 |
Systemfel |
4001-4999 |
Schemavalideringsfel |
5001-5999 |
Felmeddelanden för SOAP och problem med att mappa xml till java. |
Termer
Adress termer
| Term i IUM | Term i DUM |
|---|---|
Adressplats |
addressPlace |
adressplatsbeteckning |
addressPlaceDesignation |
adressplatstyp |
addressPlaceType |
insamlingsläge |
positionKind |
adressplatspunkt |
addressPlacePoint |
status för belägenhetsadress |
locationAddressStatus |
objektstatus |
objectStatus |
adressplatsnummer |
addressPlaceDesignationNumber |
bokstavstillägg |
addressPlaceDesignationNumberLetter |
adressplats lägestillägg |
staircaseIdentifier |
lägestilläggsnummer |
staircaseIdentifierNumber |
avviker från standarden |
DeviateFromStandard |
postnummer |
postCode |
postort |
postTown |
adressplatsanmärkning |
addressPlaceRemark |
anmärkningstyp |
remarkType |
anmärkningstext |
remarkText |
adressatt anläggning |
addressedConstruction |
kommande relation |
addressedConstructionType |
anmärkningstext |
remarkText |
adressplatsnamn |
addressPlaceName |
populärnamn |
commonName |
ortid |
placeNameId |
entré |
Entrance |
fastighetsnyckel |
RealPropertyKey |
Adressområde |
addressArea |
fastställt namn |
assignedName |
ortid |
placeNameId |
adressområdestyp |
addressAreaType |
objektstatus |
objectStatus |
Gårdsadressområde |
farmAddressArea |
fastställt namn |
assignedName |
ortid |
placeNameId |
objektstatus |
objectStatus |
Kommun |
municipality |
kommunkod |
municipalityKey |
Kommundel |
partOfMunicipality |
fastställt namn |
assignedName |
ortid |
placeNameId |
objektstatus |
objectStatus |
Byggnad termer
| Term i IUM | Term i DUM |
|---|---|
Byggnad |
Building |
husnummer |
houseNumber |
nybyggnadsår |
constructionYear |
undantagenFrånAdressättning |
exemptAddressing |
objektstatus |
objectStatus |
huvudbyggnad |
mainBuilding |
tillbyggnadsår |
extensionYear |
ofri grund |
nonFreeholdProperty |
byggnadservitut |
easementBuilding |
total boarea |
usefulFloorSpace |
byggnadsnamn |
buildingName |
ortid |
placeNameId |
byggnadsanmärkning |
buildingRemark |
fastighetsnyckel |
realPropertyKey |
ligger på (relation) |
liesOn |
tillhör (relation) |
belongsTo |
berörs av (relation) |
affectedBy |
Byggnadsändamål |
use |
huvudändamål |
mainUse |
osäkert ändamål |
uncertainUse |
bostad |
residentialUse |
industri |
industrialUse |
verksamhet |
commercialUse |
samhällsfunktion |
publicUse |
ekonomibyggnad |
agriculturalUse |
komplementbyggnad |
ancillaryBuilding |
övrig byggnad |
otherUse |
Byggnadsdel |
geometry |
insamlingsläge |
positionKind |
byggnadsyta |
buildingSurface |
Verksamhetsåtgärd |
BusinessActivity |
åtgärdsordning |
activityOrder |
åtgärdstyp |
activityType |
ansvarig organisation |
responsibleParty |
utförande organisation |
executingParty |
åtgärdstidpunkt |
timeOfActivity |
referens till verksamhetsärende |
businessCaseReference |
referens till byggnad |
exchangeObjectReference |
Verksamhetsärende |
BusinessCase |
verksamhetsärendebeskrivning |
caseDescription |
objektstatus |
caseState |
verksamhetsärendeyta |
caseSurface |
Bygglovsärende |
buildingPermission |
MSBs skyddsrum (Myndigheten för samhällskydd och beredskap) |
msbShelter |
3D-fastighet |
3D-RealProperty |
Generella termer
| Term i IUM | Term i DUM |
|---|---|
Förändringspaket |
Saknas motsvarighet i XML-schemat. Motsvarar soap-headern i meddelandet. |
Förändringsärende |
Change Transaction |
förändringsidentitet |
id |
förändringsärendebeskrivning |
description |
förändringsärendetidpunkt |
extractedAtTime |
pekare till datautbytesmodell |
anges som attribut till xs:schema enligt XML-standarden |
Nytt |
Add |
Modifierat |
Modify |
Raderat |
Delete |
Utbytesobjekt |
ExchangeObject |
objektidentitet |
objectId |
objektversion |
objectVersion |
versionGiltigFrån |
versionValidFrom |
versionGiltigTill |
versionValidTo |
Lägenhet termer
| Lägenhet | dwelling |
|---|---|
lägenhetsnummer |
dwellingNumber |
beslutsdatum för lägenhetsnummer |
numberingDate |
underrättelsedatum för lägenhetsnummer |
notificationOfNumberDate |
antal rum |
numberOfRooms |
bostadsarea |
usefulFloorSpace |
lägenhetskategori |
dwellingCategory |
kökstyp |
typeOfKitchen |
gemensamt kök |
commonKitchen |
insamlingssätt |
collectionMethod |
objektstatus |
objectStatus |
Entré |
entrance |
entrétyp |
typeOfEntrance |
hiss |
lift |
objektstatus |
objectStatus |
Ägarlägenhetfastighet |
condominum |