- ONLINE TRANSFORMATIE
- Web formulier
- Lambert7208 module
- Web service
- Wat is een web service?
- Lb7208WS
- Waarvoor Lb7208WS gebruiken?
- Wanneer Lb7208WS gebruiken?
- Hoe Lb7208WS gebruiken?
een bericht
via de ngi
website.
SOAP web service Lb7208WS
Via deze URL kan u het WSDL bestand downloaden:
Startend vanaf dit WSDL bestand kan u uw applicatie opbouwen in de gewenste programmeertaal en voor het gewenste platform.
De term "web services" is ontstaan uit het idee om diensten aan te bieden over het Internet, onafhankelijk van de onderliggende technologie. Deze diensten moeten het voor bedrijven eenvoudiger maken om hun informatiesystemen te integreren met die van hun zakenpartners.
Op dit ogenblik bieden web services een mechanisme om gegevens uit te wisselen tussen toepassingen, onafhankelijk van de taal waarin ze geschreven zijn, hun platform en de plaats waar ze hun bevinden.
De kracht van web services ligt in standaarden die deze taalonafhankelijkheid bewerkstelligen. De web service standaarden werden door een aantal grote bedrijven ontwikkeld (waaronder IBM en Microsoft) en worden door standaardisatie-organisaties zoals W3C en Oasis ondersteund.
Door het volgen van standaarden lijken web services op lego-blokken. Ze hoeven slechts eenmaal ontwikkeld te worden en kunnen daarna eindeloos hergebruikt en samengesteld worden. (bron: smals.be)
Lb7208WS is meer bepaald een SOAP web service waarbij SOAP een protocol is voor het uitwisselen van XML gebaseerde berichten over computer netwerken, meestal gebruik makend van HTTP. De XML structuur waaraan die berichten moeten voldoen om te kunnen communiceren met de web service wordt beschreven in een WSDL bestand dat specifiek is voor de aangeboden service.
Meer informatie over web services en aanverwante topics?
Web services: http://www.w3.org/2002/ws/
Web services test tool: http://www.soapui.org/
SOAP: http://www.w3.org/2000/xp/Group/
WSDL: http://www.w3.org/2002/ws/desc/
Geo Tools: http://geotools.codehaus.org/
Tutorials: http://www.w3schools.com/
Lb7208WS is een SOAP web service die door het NGI gratis ter beschikking wordt gesteld aan de bedrijven en het grote publiek voor de conversie van coördinatenparen en bestanden van Lambert 1972 naar Lambert 2008 en vice versa.
(mogelijke bestandstypes: txt, csv of shape)
Wanneer u of uw bedrijf regelmatig bestanden of coördinatenparen moet converteren van het ene projectiesysteem naar het andere en u wilt dit automatiseren of integreren in een bestaande applicatie, dan kan u overwegen om onze web service te gebruiken om dit proces te ondersteunen.
Indien u sporadisch een bestand of coördinatenpaar wilt converteren, kan u beter onze webapplicatie 'Lambert7208 transformatie module' gebruiken.
Op deze pagina kan u het WSDL bestand downloaden:
Startend vanaf dit WSDL bestand kan u uw applicatie opbouwen in de gewenste programmeertaal en voor het gewenste platform.
Hieronder volgt nog een kort overzicht van de mogelijkheden van de Lb7208WS web service, beschreven in het wsdl bestand:
Onderdelen van een aanvraag
naar de web service
- XCoordinate bevat de numerieke waarde van de x coördinaat die geconverteerd moet worden.
- YCoordinate bevat de numerieke waarde van de y coördinaat die geconverteerd moet worden.
- TargetProjectionSystem bevat de waarde Lambert2008 of Lambert1972 om het projectiesysteem aan te duiden waarnaar de invoercoördinaten moeten omgezet worden.
> voorbeeld
Zorg er wel voor dat de invoercoördinaten in het juiste projectiesysteem staan, tegenovergesteld aan hetgene dat vermeld staat in TargetProjectionSystem.
Onderdelen van het antwoord
van de web service
- XCoordinate bevat de numerieke waarde van de x coördinaat die geconverteerd is.
- YCoordinate bevat de numerieke waarde van de y coördinaat die geconverteerd is.
- OutputProjectionSystem bevat de waarde Lambert2008 of Lambert1972 om het projectiesysteem van de resultaatcoördinaten aan te duiden.
> voorbeeld
Onderdelen van een aanvraag
naar de web service
- FileUrl bevat de URL van het invoerbestand op uw server dat geconverteerd moet worden door onze web service. Uw invoerbestand kan door onze web service gedownload worden via het FTP of HTTP protocol.
- Het Authentication gedeelte is optioneel: u moet het enkel toevoegen wanneer u een gebruikersnaam (Username) en paswoord (Password) hebt ingesteld om toegang te krijgen tot het bestand dat vermeld staat in het veld FileUrl.
- Username en Password zijn de gebruikersnaam en paswoord die u ingesteld hebt om toegang te krijgen tot het bestand dat vermeld staat in het veld FileUrl.
- TargetProjectionSystem bevat de waarde Lambert2008 of Lambert1972 om het projectiesysteem aan te duiden waarnaar het invoerbestand moet geconverteerd worden.
> voorbeeld
Zorg er wel voor dat het invoerbestand in het juiste projectiesysteem staat, tegenovergesteld aan hetgene dat vermeld staat in TargetProjectionSystem.
U kunt de volgende soorten bestanden doorsturen: txt, csv en Esri shapefile bestanden. Een shape bestand mag als zip, tar, of tar.gz doorgestuurd worden.
In een txt of csv bestand mogen één of meerdere coördinatenparen per regel staan, gescheiden door een spatie, tab of komma.
X2, Y2, ... , Xn-1, Xn-1,
Xn, Xn
Als u in het bestand een id per coördinatenpaar doorzendt, moet elk id met coördinatenpaar op een aparte regel staan.
id1, X1, Y1
id2, X2, Y2
...
idn-1, Xn-1, Yn-1
idn, Xn, Yn
Onderdelen van het antwoord
van de web service
FileUrl bevat de URL van het geconverteerde bestand dat op onze server staat; dit gaat altijd een HTTP server zijn. Het Authentication gedeelte is optioneel: we voegen dit gedeelte enkel toe wanneer we een gebruikersnaam (Username) en paswoord (Password) hebben ingesteld om toegang te krijgen tot het resultaatbestand dat vermeld staat in het veld FileUrl. In normale omstandigheden gebruiken we deze tag niet.
Username en Password zijn de gebruikersnaam en paswoord die wij ingesteld hebben om toegang te krijgen tot het resultaatbestand dat vermeld staat in het veld FileUrl.
OutputProjectionSystem bevat de waarde Lambert2008 of Lambert1972 om het projectiesysteem aan te duiden van het resultaatbestand.
> voorbeeld
<soapenv:Body>
<Lb7208CoordRequest xmlns="http://www.ngi.be/ws/Lb7208/types">
<InputCoordinates>
<XCoordinate>150000.15</XCoordinate>
<YCoordinate>160000.16</YCoordinate>
</InputCoordinates>
<TargetProjectionSystem>Lambert2008</TargetProjectionSystem>
</Lb7208CoordRequest>
</soapenv:Body>
<soapenv:Body>
<Lb7208CoordResponse xmlns="http://www.ngi.be/ws/Lb7208/types">
<OutputCoordinates>
<XCoordinate>650001.076</XCoordinate>
<YCoordinate>660000.731</YCoordinate>
</OutputCoordinates>
<OutputProjectionSystem>Lambert2008</OutputProjectionSystem>
</Lb7208CoordResponse>
</soapenv:Body>
<soapenv:Body>
<Lb7208FileRequest xmlns="http://www.ngi.be/ws/Lb7208/types">
<InputFile>
<FileUrl>ftp://your_company.be/path/yourfilename.zip</FileUrl>
<!--Optional-->
<Authentication>
<Username>client_username</Username>
<Password>client_password</Password>
</Authentication>
</InputFile>
<TargetProjectionSystem>Lambert2008</TargetProjectionSystem>
</Lb7208FileRequest>
</soapenv:Body>
<soapenv:Body>
<Lb7208FileResponse xmlns="http://www.ngi.be/ws/Lb7208/types">
<OutputFile>
<FileUrl>http://www.ngi.be/path/yourfilename.zip</FileUrl>
<!--Optional-->
<Authentication>
<Username>ngi_username</Username>
<Password>ngi_password</Password>
</Authentication>
</OutputFile>
<OutputProjectionSystem>Lambert2008</OutputProjectionSystem>
</Lb7208FileResponse>
</soapenv:Body>
>
Download