Schnittstellen müssen vom Anbieter extra freigeschalten und aktiviert werden. Support, Änderungen und Wartung von Schnittstellen sind nicht im Standard inkludiert. Aufgrund der technischen Begriffe ist der Großteil der Dokumentation in Englisch gehalten.

Anlegen und Deaktivieren von Geofence-Bereichen - Auslaufen mit 31.03.2018

Die folgenden Aufrufe stehen bis auf weiteres zur Verfügung, eine Änderung in naher Zukunft ist aber geplant:

http://uat.sw-management.at/GFS/interfaces/Geocoding.jsp?secid=xml2050182512-3254981481565771034-3279775603942294823

Geofence erstellen

https://uat2.sw-management.at/GFS/ExternalXMLServlet?secid=xml5089085-3532047540225885415-6123629436725404139&operation=gfgeocoding&geofenceName=XLTest2&country=AUT&city=Albersdorf&street=Albersdorf%209&postalcode=8200

Geofences deaktivieren

http://uat.sw-management.at/GFS/ExternalXMLServlet?secid=xml2050182512-3254981481565771034-3279775603942294823&operation=activate_deactivate_geofence&geofenceName=XMLTest2&supop=deactivate

The interface to access that data is a http/xml interface. A simple http call can be used to get the data as an xml. In some cases an excel sheet can be uploaded and the server will fill in the missing data.

The communication is done as follows:

• A http request is sent to the GPS Fleet Server, containing a security id and operation field

• The gps fleet server checks if the client is authenticated and sends back the feedback

The following parameters have to be set at each request:

The Url to be called is the GPS Fleet Server url and /ExternalXMLServer

Example:

 http://gfs2.sw-management.at/GFS/ExternalXMLServlet?secid=xml812089481&operation=lastpos 

Example 2 for a local request

http://192.168.1.45:8008/GFS/ExternalXMLServlet?secid=xml812089481&operation=lastpos 

Please note that there is a test site to generate the request. It can be called by calling “geocoding.jsp”

e.g.  http://gfs2.sw-management.at/interfaces/Geocoding.jsp 

The encoding of the response is UTF-8.

GPS Data Calls 

Lastpos

Get the last positions of the assets:

Open

Result:

Open

GPS Data Export

The gps data export delivers the rawdata. The last is a number that identifies each gps data record uniquely.

IT can be used to load only the records that have not been processed yet.

Open

Result:

Open

Logbook Export 

The logbook export generates the completely finished GFS logbook as an XML export.

Open

Result:

Open

 Geofence Visit Report 

Export the visit reports for geofences:

Open

Result:

Open

 Geofence Activation / Deactivation

Open

Result:

Open

 Geocoding Calls 

The geocoding interface enables it to do

•          Reverse Geocoding – get the address from a given lat/lng

•          Geocoding – get the lat/lng from an address

•          Bulk Reverse Geocoding – do multiple operations in once call

•          Bulk Geocoding – do multiple operations in once call

•          Bulk Reverse Geocoding with geofence creation– do multiple operations in once call and add all items have a certain quality to the system as a geofence

•          Bulk (Reverse) Geocoding with geofence creation– do multiple operations in once call and add all items have a certain quality to the system as a geofence

The geocoding calls also deliver quality information about the calculated address.

Class 

The class returns information about the quality of the response.

If you enter the city name only, the quality will be 5 for high, because the software found it and this is the maximum it can do for you.

If you enter the city and streetname with housenumber and the software returns 5, you have a full hit, of you only have 4 , it might be a smaller spelling problem.

Detail Level 

If you set the house number in street request, 9 is a good result

If you don’t set the house number, the maximum you can achieve is 6.

Score

The score is a combination of detail level and class and can be stored for further information.

Geocoding Address Format

Please note that you can use the country field to make the search operation faster and more precise, but you have to use the official 3 character codes (ISO 2166/MA). For more information consider see http://en.wikipedia.org/wiki/ISO_3166-1_alpha-3