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.

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:

 Image Modified

Result:

Image Modified

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.

Image Modified

Result:

Image Modified

Logbook Export 

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

Image Modified

Result:

Image Modified

 Geofence Visit Report 

Export the visit reports for geofences:

 Image Modified

Result:

Image Modified

...

...

Geofence Activation / Deactivation

...

Result:

Image Added

...

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:

...

Name	Required	Comment	Example
gupdate	Yes	set it to 1 if you also want the geofences to be updated, if it exists already. Set the value to 0, if you don’t want it to be updated.	1 or 0
geofenceName	Yes	Name of the geofence to be created or updated. Please note that are rules for the geofence name for certain but mandatory reasons.   Allowed characters are: Space,-,+,(,),@,0..9, a..z,A..Z   All other invalid characters will be replaced with: -	Customer Mäier
gmindetail	yes	Set the minimum quality of the address: (See 28.5.2 ). If the quality is too low, the geofence will not be created	9
gminclass	yes	Set the minimum quality of the address: (See 28.5.1 ). If the quality is too low, the geofence will not be created	4
gsizemeter	yes	Set the size of geofence around the center point	50
geofenceAssetID	No	If you set the id, the geofeonce is assigned to the asset only. If the value is null the geofence is assigned to all.   Please note that this value is not updated in the case of an existing geofence.
geofenceTypeID	yes	Select they type of the geofence.   By default the following types are available:   0             Standard                               1             Customer                              2             Standard-Symbol 3             Standard-no-map 4             Standard-no-map-no list   Type 0 uses a rectangle to display the geofence   Type 1 uses a rectangle to display the geofence. It could be used later one to filter based on the type.   Type 2 can be used to display a container symbol on the map instead of the rectangle.   Type 3 is not displayed on the map, because large amount of Geofences (more than 1000) will make the map display very slow.   Type 4 is not displayed in the map and not shown in the rules list view because many geofence records will make the loading too slow.

 

...

 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.

Image Added

Result in the case of an insert

 Image Added

Result in the case of an update

 Image Added

Result in the case of not found

...

Image Added

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

 Image Added

Result:

...

Image Added

Result if e.g. updates took place

 Image Added

.