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:

Result:

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.

Result:

Logbook Export 

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

Result:

 Geofence Visit Report 

Export the visit reports for geofences:

Result:

 Geofence Activation / Deactivation

Result:

 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 

Data Availability

The availability of data depends on the configuration of your account and asset configuration. Some products are licensed with your assets, some on the account.

Currently the geocoding data is available for: Europe

Currently the reverse - geocoding data is available for: Europe, Middle East

 (Reverse-) Geocoding Parameters

The following parameter are available:

•           country

•           city

•           postalcode

•           street

•         lat

•          lng

If at least the city and street is set, the software will try to calculate the lat and lng in the result, otherwhise if the lat/lng is set, it will try to get the address. If the city and steet and lat/lng is not set it will raise an error.

(Reverse-) Geocoding Parameters with Geofence Creation!

Additionally to the address fields the following parameters are used:

 http GFS (Reverse-) Geocoding Call 

The following http call is calculating the address for a give lat/lng or calculates the lat/lng based on the address.

Result:

http GFS (Reverse-) Geocoding Call & Geofence Update/Creation 

The following call is doing the(reverse-) geocoding operation and creates / updates a geofence with the given name.

Result in the case of an insert

Result in the case of an update

Result in the case of not found

Geofence Creation / Updates & GFS Geocoding Web Call with XML for multiple addresses 

Result:

Result if e.g. updates took place

.