S
ERVICEL
EVELA
GREEMENT(R
EVERSE) G
EOCODERIntroduction
This Service Level agreement covers the Geocoder and Reverse Geocoder Services that are integrated by GIM into ESA’s Service Support Environment.
The Geocoder service allows you to place your address information on a map. It translates place names, postal codes, street names and house numbers to coordinates. You can provide single addresses or batch files and you can select the output coordinate reference system.
The Reverse Geocoder Service allows you to convert your co-ordinate information into addresses. It translates X,Y (or latitudes, longitude) pairs into the corresponding place names, postal codes, streetnames and house numbers. You can provide single coordinate pairs or batch files and you can select the input coordinate reference system
You pay per geocoded or reverse geocoded item whereby the cost per item decreases in function of the number of addresses. Our service will first provide you with a quotation based upon the number of items that you do wish to geocode or reverse geocode.
The formats of the batch files are explained at the end of this document.
Helpdesk
The exchange between the customer and the service provider is made by e-mail or fax: Contact:
Help Desk
E-mail: [email protected] Fax: +32 16 40 69 39
The helpdesk service will answer the customer after maximum 2 working days; the helpdesk service is opened between 9.00 and 17.00 (GMT +01:00), from Monday to Friday.
Scope of Service – Service elements
The service is currently available for Belgium and the Netherlands but its geographical scope can be extended upon request.
Note that the service is also available as an OGC OpenLS web service that you can directly interrogate from within your software.
Warranty and Quality of the Product
The service provider warrants that the services will be performed in a professional and workmanlike manner consistent with industry standards reasonably applicable to such services.
The service is normally continuously available except when network or server maintenance activities are being performed or due to circumstances beyond GIM’s control.
The service is only monitored during working hours. When service fails during non-working hours, it will be restarted at the first coming working day.
GIM shall take commercially reasonable efforts to make this service available on the SSE portal. However, GIM is not responsible for any damages or losses related to any system errors or interruptions affecting SSE or the service and the processing. SSE or the service may be unavailable unexpectedly as a result of circumstances beyond GIM's, control.
Processing & Delivery Time
The geocoder and reverse geocoder service will deliver their products within hours of ordering. Exact delivery time is depending on the number of addresses that one wants to geocode in one batch.
Any period for delivery of performance is an estimate only and GIM shall not be liable for any damage resulting from any failure to deliver or perform by such dates howsoever caused.
The output data are made available on the FTP site. Via the SSE portal the user receives the address of the FTP site. The time that the product remains available to the user is indicated on the SSE portal. After this period the product is removed from the FTP site.
Price & Payment Conditions
Cost per item to (reverse) geocode is a function of the number of addresses to process in one batch. An invoice will be submitted after geocoding has been performed. Payment is by bank transfer. GIM’s standard commercial terms and conditions do apply and are available upon request.
Complaints
No complaints relative to the quality of the distribution service will be accepted unless made in writing by facsimile or registered mail received within thirthy (30) days after delivery.
Force Majeure
GIM shall not be liable for any failure to perform its obligations arising from circumstances outside its control including (without limitation) war, riots, explosions, abnormal weather conditions, fire, flood, strikes, lock out, Government action, delay by suppliers, accidents and shortage of materials, labour or manufacturing facilities.
Arbitration
These Conditions and any Contract between the Customer and GIM shall be governed by Belgian Law. The parties agree to submit to the jurisdiction of the Belgian Courts.
Termination
If the Customer defaults in or commits any breach of any of its obligations to GIM, GIM shall have the right forthwith to terminate the Contract in whole or in part. Such termination shall not prejudice or restrict the rights or remedies of GIM.
GIM does not assume any liability deemed to have been caused directly or indirectly by any content on the SSE Web site.
Disclaimer of Liability
With respect to documents or data available on this web site, neither GIM nor any of its employees, makes any warranty, explicit or implied, including the warranties of fitness for a particular purpose, or assumes any legal liability or responsibility for the accuracy, completeness, or usefulness of any information or process disclosed.
Disclaimer of Endorsement:
Reference herein to any specific commercial products, process, or service by trade name, trademark, manufacturer, or otherwise, does not necessarily constitute or imply its endorsement, recommendation, or favour by GIM.
Trademarks
All brand names and Product names are trademarks or registered trademarks or Service marks of their respective owners.
Supported Formats
Both the geocoding and reverse geocoding services accept two file types as input. Both files need to be provided on an accessible ftp site.
1
G
EOCODING-CSV
The CSV File format need to be a comma delimited file with the following columns: Column Explanation
1 STREET_NAME The name of the street. Our geocoder performs a fuzzy search meaning that the streetname does not need to match perfectly the name within our database. However the closer you match the official spelling, the higher the success rate will be.
2 HOUSE_NUMBER The house number – preferably without indication of the bus or etage
3 PLACE_NAME The name of the place (commune, subcommune)
4 POSTAL_CODE The 4 digit postal code for Belgium , 6 digit postal code for the Netherlands
Other columns may be present but will be ignored. The columns referenced in the table can appear in any order.
2
G
eocoding
- O
PENLS
The OpenLS format is an XML format based upon the OpenGeoSpatial OpenLS consortiums format that is used for encoding the address information, the root element is however proprietary to our implementation.
An example with 2 addresses is given below:
<?xml version="1.0" encoding="UTF-8"?>
<GeocodeRequest xmlns="http://www.opengis.net/xls" xmlns:gml="http://www.opengis.net/gml" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Address addressee="String" countryCode="public"> <StreetAddress>
<Building number="5"/> <Street>Interleuvenlaan</Street> </StreetAddress> <Place type="Municipality">Heverlee</Place> <PostalCode>3001</PostalCode> </Address>
<Address addressee="String" countryCode="public"> <StreetAddress> <Building number="129"/> <Street>Leuvensesteenweg</Street> </StreetAddress> <Place type="Municipality">Boutersem</Place> <PostalCode>3370</PostalCode> </GeocodeRequest>
3
R
EVERSE GEOCODING– CSV
The reverse geocoding csv file format is quite simple, it just needs to contain 2 columns X_COORDINATE and Y_COORDINATE. Other columns can be included but will be ignored. Note that for WGS84 geographical co-ordinate systems X corresponds to longitude and Y to latitude.
4
R
EVERSE GEOCODING– O
PENLS
The reverse geocoding OpenLS based format is as is given below:
<ReverseGeocodeRequest xmlns="http://www.opengis.net/xls" xmlns:gml="http://www.opengis.net/gml"> <Position>
<gml:Point gml:id="point1" srsName="EPSG:31300">
<gml:pos srsName="EPSG:31300" dimension="2">159117.97 198563.28</gml:pos> </gml:Point>
</Position> <Position>
<gml:Point gml:id="point2" srsName="EPSG:31300">
<gml:pos srsName="EPSG:31300" dimension="2">159244.24 198860.99</gml:pos> </gml:Point>
</Position> </ReverseGeocodeRequest>