Completely offline C++ based solution kit to extend existing product with E-Mobility features. We are providing mapping, routing and navigation solutions with more than 15 years of E-Bike navigation software experience. Detailed customizable maps, including large list of POIs, optimal route detection, precise turn-by-turn navigation, and much more.

SDK Functions
bool	GTSDKInitEngine (const wchar_t* uniqueID, const wchar_t* sdkKey, const wchar_t* dataPath)
	Inits the map engine. This function has to be called first.

int	GTSDKUpdateMap (const unsigned char *buffer, int bufferSize, int pixelFormat, int width, int height)
	Draws the map to the buffer. It runs only max 50 millisecond at a time. If the draw is not finished it continues next time. Using this behavior it can run in onDraw function, and if returns true you can call postInvalidate() function to continue drawing next time.

int	GTSDKZoomMap (double factor)
	Zooms the map with a factor.

int	GTSDKZoomMapToScreenPosition (double factor, double x, double y)
	Zooms the map with a factor, taking zooming focus the x,y screen coordinates.

void	GTSDKMoveMap (double xOffset, double yOffset)
	Pans the map.

bool	GTSDKStartRoutePlan (double latStart, double lonStart, double latEnd, double lonEnd, int vehicleType, int routeplanMode, int majorRoadWeight, int unpavedRoadWeight, int cycleRoadWeight, int ferriesWeight, bool useOnewayStreetsBothDirections, int bearing)
	Sets up route planner with given parameters.

void	GTSDKScreenToMap (double x, double y, double &lat, double &lon)
	Converts screen coordinate to geo position.

void	GTSDKMapToScreen (double lat, double lon, double &x, double &y)
	Converts geo position to screen coordinate.

bool	GTSDKUpdateRoutePlan (int timeOut, double &progress, int &routeId)
	Runs route planning for a given milliseconds.

int	GTSDKAddressSearchGetCountryCount ()
	Returns the number of countries for address search.

wchar_t*	GTSDKAddressSearchGetCountryName (int idx)
	Returns the name of the country.

void	GTSDKAddressSearchSelectCountry (const wchar_t* name)
	Selects a country for further searching.

wchar_t*	GTSDKAddressSearchFilterCity (const wchar_t* filter, int &count)
	Filters the results of cities.

int	GTSDKAddressSearchGetCityCount (const wchar_t* filter)
	Prepares a result list of cities matching the filter.

wchar_t*	GTSDKAddressSearchGetCityName (int idx)
	Returns a city name in the result list.

void	GTSDKAddressSearchSelectCity (const wchar_t* name)
	Selects a city for further searching.

wchar_t*	GTSDKAddressSearchFilterStreet (const wchar_t* filter, int &count)
	Filters the results of streets.

int	GTSDKAddressSearchGetStreetCount (const wchar_t* filter)
	Prepares a result list of streets matching the filter.

wchar_t*	GTSDKAddressSearchGetStreetName (int idx)
	Returns a city name in the result list.

void	GTSDKAddressSearchSelectStreet (const wchar_t* name)
	Selects a street for further searching.

int	GTSDKAddressSearchGetHouseNumberCount ()
	Returns the housenumber count of selected street.

wchar_t*	GTSDKAddressSearchGetHouseNumber (int houseNumberIdx)
	Returns a house number.

bool	GTSDKAddressSearchGetLatLonForHouseNumberIdx (int houseNumberIdx, double &lat, double &lon)
	Returns the coordinate of selected house number.

wchar_t*	GTSDKPOISearch (double lat, double lon, const wchar_t* filter, int typeFilter, int &poiCount)
	Search POIs near to given coordinate.

wchar_t*	GTSDKGetPOINameByIdx (int idx)
	Returns a POI name in the result list.

wchar_t*	GTSDKGetPOIDetailsByIdx (int idx, int &type, double &lat, double &lon)
	Returns details of a POI.

bool	GTSDKHasEngineNotification ()
	Query the engine if there is a notification.

void	GTSDKGetEngineNotification (int &notificationType, int &notificationInfo)
	Gets the top engine notification.

double	GTSDKStartNavigation (int routeId, int red, int green, int blue, int redOutline, int greenOutline, int blueOutline, int redOutlineBorder, int greenOutlineBorder, int blueOutlineBorder)
	Starts the navigation.

void	GTSDKStopNavigation ()
	Stops the navigation.

wchar_t*	GTSDKGetTurnInfo ()
	Returns the info of the next turn in XML format.

void	GTSDKUpdateGPSData (float direction, double lat, double lon, float alt, float speed, int year, int month, int day, int hour, int minute, int second)
	updates engine with a new gps position and data

void	GTSDKSetFollowMode (bool followMode)
	Sets the follow mode to track the gps cursor.

void	GTSDKAddRouteToMap (int routeId, int red, int green, int blue, int redOutline, int greenOutline, int blueOutline, int redOutlineBorder, int greenOutlineBorder, int blueOutlineBorder)
	Adds a route to the map to display.

void	GTSDKRemoveRouteFromMap (int routeId)
	Removes a route from the map.

void	GTSDKDeleteRoute (int routeId)
	Deletes a route.

void	GTSDKSetMapColor (int type, int red, int green, int blue, int redOutline, int greenOutline, int blueOutline)
	Sets the color of a map feature.

void	GTSDKInitEBike (int vendorId, int bikeId, double batteryCapacity, double batteryVoltage, double bikeWeight, int minAssistLevel, int maxAssistLevel, int currentAssistLevel, double currentBatteryLevel)
	Inits E-Bike data.

void	GTSDKUpdateEBikeData (int type, double value)
	Update E-Bike actual data.

void	GTSDKDisplayRangeOnMap (bool display, int red1, int green1, int blue1, int red2, int green2, int blue2, int red3, int green3, int blue3, int redOutline, int greenOutline, int blueOutline)
	Display range patch on map range stripes ( 50-75%, 75-90%, 90-100% )

void	GTSDKSetRangeCenter (double lat, double lon)
	Sets the range dislpay center to a map position, and recalculates it.

void	GTSDKSetMapCenter (double lat, double lon)
	Sets the map center to a position.

void	GTSDKSetZoomLevel (double zoomLevel)
	Sets the actual zoom level ( levels are from 1 to 15 )

double	GTSDKGetZoomLevel ()
	Gets the actual zoom level ( levels are from 1 to 15 )

Member Typedef Documentation

wchar_t* GTSDKAddressSearchFilterCity (const wchar_t* filter, int &count)

Filters the results of cities.

Parameters

filter	Sets the filter of the cities
count	Out parameter count of the results.

Returns: String of the next characters you can enter.

wchar_t* GTSDKAddressSearchFilterStreet (const wchar_t* filter, int &count)

Filters the results of streets.

Parameters

filter	Sets the filter of the streets
count	Out parameter count of the results.

Returns: wchar_t* List of the next characters you can enter.

int GTSDKAddressSearchGetCityCount (const wchar_t* filter)

Prepares a result list of cities matching the filter.

Parameters

filter Sets the filter of the cities

Returns: Size of the city result list

wchar_t* GTSDKAddressSearchGetCityName (int idx)

Returns a city name in the result list.

Parameters

idx	Index of the city name

Returns: Name of the city

int GTSDKAddressSearchGetCountryCount ()

Returns the number of countries for address search.

Returns: Number of countries for address search.

wchar_t* GTSDKAddressSearchGetCountryName (int idx)

Returns the name of the country.

Parameters

idx	Index of the country

Returns: Name of the country

wchar_t* GTSDKAddressSearchGetHouseNumber (int houseNumberIdx)

Returns a house number.

Parameters

houseNumberIdx Index of the housenumber in the list. This list contains a Street Center too.

Returns: House number as a wchar_t*.

int GTSDKAddressSearchGetHouseNumberCount ()

Returns the housenumber count of selected street.

Returns: The count of housenumbers.

bool GTSDKAddressSearchGetLatLonForHouseNumberIdx (int houseNumberIdx, double &lat, double &lon)

Returns the coordinate of selected house number.

Parameters

houseNumberIdx	Index of the housenumber in the list
lat	out parameter latitude of the geo position of house number of the street.
lon	out parameter longitude of the geo position of house number of the street.

Returns: House number as a wchar_t*.

int GTSDKAddressSearchGetStreetCount (const wchar_t* filter)

Prepares a result list of streets matching the filter.

Parameters

filter Sets the filter of the streets

Returns: Size of the street result list

wchar_t* GTSDKAddressSearchGetStreetName (int idx)

Returns a city name in the result list.

Parameters

idx	Index of the city name

Returns: Name of the city

void GTSDKAddressSearchSelectCity (const wchar_t* name)

Selects a city for further searching.

Parameters

name	Name of the city

Returns: Void.

void GTSDKAddressSearchSelectCountry (const wchar_t* name)

Selects a country for further searching.

Parameters

name	Name of the country

Returns: Void.

void GTSDKAddressSearchSelectStreet (const wchar_t* name)

Selects a street for further searching.

Parameters

name	Name of the street

Returns: Void.

void GTSDKAddRouteToMap (int routeId, int red, int green, int blue, int redOutline, int greenOutline, int blueOutline, int redOutlineBorder, int greenOutlineBorder, int blueOutlineBorder)

Adds a route to the map to display.

Parameters

routeId	id of the route
red	red channel of the inner color of the route
green	green channel of the inner color of the route
blue	blue channel of the inner color of the route
redOutline	red channel of the outline color of the route
greenOutline	green channel of the outline color of the route
blueOutline	blue channel of the outline color of the route
redOutlineBorder	red channel of the outlineborder color of the route
greenOutlineBorder	green channel of the outlineborder color of the route
blueOutlineBorder	blue channel of the outlineborder color of the route

Returns: void

void GTSDKDeleteRoute (int routeId)

Deletes a route.

Parameters

routeId id of the route to delete

Returns: void

void GTSDKDisplayRangeOnMap (bool display, int red1, int green1, int blue1, int red2, int green2, int blue2, int red3, int green3, int blue3, int redOutline, int greenOutline, int blueOutline)

Display range patch on map range stripes ( 50-75%, 75-90%, 90-100% )

Parameters

display	to display or not the range on map
red1	red channel of the inner color of the range stripe 1
green1	green channel of the inner color of the range stripe 1
blue1	blue channel of the inner color of the the range stripe 1
red2	red channel of the inner color of the range stripe 2
green2	green channel of the inner color of the range stripe 2
blue2	blue channel of the inner color of the the range stripe 2
red3	red channel of the inner color of the range stripe 3
green3	green channel of the inner color of the range stripe 3
blue3	blue channel of the inner color of the the range stripe 3
redOutline	red channel of the inner color of the range outline
greenOutline	green channel of the inner color of the range outline
blueOutline	blue channel of the inner color of the the range outline

Returns: void

void GTSDKGetEngineNotification (int &notificationType, int &notificationInfo)

Gets the top engine notification.

Parameters

notificationType	out parameter type of the notification. See EngineNotificationType.
notificationInfo	out parameter longitude of the geo position of house number of the street.

Returns: void

wchar_t* GTSDKGetPOIDetailsByIdx (int idx, int &type, double &lat, double &lon)

Returns details of a POI.

Parameters

idx	Index of the POI
type	out parameter type of POI.
lat	out parameter latitude of the geo position of house number of the street.
lon	out parameter longitude of the geo position of house number of the street.

Returns: Description XML of the POI

wchar_t* GTSDKGetPOINameByIdx (int idx)

Returns a POI name in the result list.

Parameters

idx	Index of the POI

Returns: Name of the POI

wchar_t* GTSDKGetTurnInfo ()

Returns the info of the next turn in XML format.

Returns: wchar_t* info of the next turn in XML format

double GTSDKGetZoomLevel ()

Gets the actual zoom level ( levels are from 1 to 15 )

Returns: actual zoom level

bool GTSDKHasEngineNotification ()

Query the engine if there is a notification.

Returns: bool true if there is a notification.

void GTSDKInitEBike (int vendorId, int bikeId, double batteryCapacity, double batteryVoltage, double bikeWeight, int minAssistLevel, int maxAssistLevel, int currentAssistLevel, double currentBatteryLevel)

Inits E-Bike data.

Parameters

vendorId	id of the manufacturer
bikeId	id if the E-Bike
batteryCapacity	in Ah
batteryVoltage	in V
bikeWeight	in kg
minAssistLevel	minimum assist level
maxAssistLevel	maximum assist level
currentAssistLevel	current Assist Level
currentBatteryLevel	current SOC

Returns: void

bool GTSDKInitEngine (const wchar_t* uniqueID, const wchar_t* sdkKey, const wchar_t* dataPath)

Inits the map engine. This function has to be called first.

Parameters

uniqueID	Device unique ID.
sdkKey	The license key you can use the SDK with.
dataPath	Path of the mapengine resource and map files.

Returns: true if engine init was successful, false if something went wrong

void GTSDKMapToScreen (double lat, double lon, double &x, double &y)

Converts geo position to screen coordinate.

Parameters

lat	Latitude of the geo position
lon	Longitude of the geo position
x	Out parameter X pixel coordinate of point.
y	Out parameter Y pixel coordinate of point.

Returns: void.

void GTSDKMoveMap (double xOffset, double yOffset)

Pans the map.

Parameters

xOffset	Pixel x offset of panning.
yOffset	Pixel y offset of panning.

Returns: void.

wchar_t* GTSDKPOISearch (double lat, double lon, const wchar_t* filter, int typeFilter, int &poiCount)

Search POIs near to given coordinate.

Parameters

lat	Latitude of the geo position
lon	Longitude of the geo position
filter	Filter for results.
typeFilter	Type filter of results. Set -1 to search for all. To filter to specific types set this to a POICategory.
poiCount	Out parameter count of the results.

Returns: House number as a wchar_t*.

void GTSDKRemoveRouteFromMap (int routeId)

Removes a route from the map.

Parameters

routeId id of the route

Returns: void

void GTSDKScreenToMap (double x, double y, double &lat, double &lon)

Converts screen coordinate to geo position.

Parameters

x	X pixel coordinate of point
y	Y pixel coordinate of point
lat	out parameter latitude of the geo position.
lon	out parameter longitude of the geo position.

Returns: void.

void GTSDKSetFollowMode (bool followMode)

Sets the follow mode to track the gps cursor.

Parameters

direction	current direction of vehicle ( north 0 degrees, west 90 degrees etc. )
lat	of gps coordinate
lon	of gps coordinate
alt	gps altitude
speed	gps speed
year	of gps timestamp
month	of gps timestamp
day	of gps timestamp
hour	of gps timestamp
minute	of gps timestamp
second	of gps timestamp

Returns: void

void GTSDKSetMapCenter (double lat, double lon)

Sets the map center to a position.

Parameters

display	to display or not the range on map
lat	Latitude of the geo position
lon	Longitude of the geo position

Returns: void

void GTSDKSetMapColor (int type, int red, int green, int blue, int redOutline, int greenOutline, int blueOutline)

Sets the color of a map feature.

Parameters

type	of the map feature. See MapColorType.
red	red channel of the inner color of the map feature
green	green channel of the inner color of the map feature
blue	blue channel of the inner color of the map feature
redOutline	red channel of the outline color of the map feature
greenOutline	green channel of the outline color of the map feature
blueOutline	blue channel of the outline color of the map feature

Returns: void

void GTSDKSetRangeCenter (double lat, double lon)

Sets the range dislpay center to a map position, and recalculates it.

Parameters

display	to display or not the range on map
lat	Latitude of the geo position
lon	Longitude of the geo position

Returns: void

void GTSDKSetZoomLevel (double zoomLevel)

Sets the actual zoom level ( levels are from 1 to 15 )

Parameters

zoomLevel

Returns: void

double* GTSDKStartNavigation (int routeId, int red, int green, int blue, int redOutline, int greenOutline, int blueOutline, int redOutlineBorder, int greenOutlineBorder, int blueOutlineBorder)

Starts the navigation.

Parameters

routeId	id of the route the navigation will start on
red	red channel of the inner color of the navigation route
green	green channel of the inner color of the navigation route
blue	blue channel of the inner color of the navigation route
redOutline	red channel of the outline color of the navigation route
greenOutline	green channel of the outline color of the navigation route
blueOutline	blue channel of the outline color of the navigation route
redOutlineBorder	red channel of the outlineborder color of the navigation route
greenOutlineBorder	green channel of the outlineborder color of the navigation route
blueOutlineBorder	blue channel of the outlineborder color of the navigation route

Returns: void

bool GTSDKStartRoutePlan (double latStart, double lonStart, double latEnd, double lonEnd, int vehicleType, int routeplanMode, int majorRoadWeight, int unpavedRoadWeight, int cycleRoadWeight, int ferriesWeight, bool useOnewayStreetsBothDirections, int bearing)

Sets up route planner with given parameters.

Parameters

buffer	Byte buffer where the map will be copied to
latStart	latitude of start point
lonStart	longitude of start point
latEnd	latitude of end point
lonEnd	longitude of end point
vehicleType	Vehicle type like VEHICLETYPE_BICYCLE, VEHICLETYPE_MTB, VEHICLETYPE_SPEED, VEHICLETYPE_PEDESTRIAN
routeplanMode	Route plan mode like ROUTEPLANMODE_SUGGESTED, ROUTEPLANMODE_EASIEST, ROUTEPLANMODE_SHORTEST
majorRoadWeight	Major road weight like ROADTYPEWEIGHT_TRYTOAVOID, ROADTYPEWEIGHT_ALLOW, ROADTYPEWEIGHT_PREFER
unpavedRoadWeight	Unpaved road weight like ROADTYPEWEIGHT_TRYTOAVOID, ROADTYPEWEIGHT_ALLOW, ROADTYPEWEIGHT_PREFER
cycleRoadWeight	Cycle road weight like ROADTYPEWEIGHT_TRYTOAVOID, ROADTYPEWEIGHT_ALLOW, ROADTYPEWEIGHT_PREFER
ferriesWeight	Ferries weight like ROADTYPEWEIGHT_TRYTOAVOID, ROADTYPEWEIGHT_ALLOW, ROADTYPEWEIGHT_PREFER
useOnewayStreetsBothDirections	If true route planner will ignore one way restriction in low level road classes
bearing	The angle of the user from north. If this is not zero route planner will plan a route using your direction and tries to plan route straight.

Returns: true if parameters are ok false if there was an error

void GTSDKStopNavigation ()

Stops the navigation.

Returns: void

void GTSDKUpdateEBikeData (int type, double value)

Update E-Bike actual data.

Parameters

type	of the map feature. See EBikeDataType.
value	of the given data.

Returns: void

void GTSDKUpdateGPSData (float direction, double lat, double lon, float alt, float speed, int year, int month, int day, int hour, int minute, int second)

updates engine with a new gps position and data

Parameters

direction	current direction of vehicle ( north 0 degrees, west 90 degrees etc. )
lat	of gps coordinate
lon	of gps coordinate
alt	gps altitude
speed	gps speed
year	of gps timestamp
month	of gps timestamp
day	of gps timestamp
hour	of gps timestamp
minute	of gps timestamp
second	of gps timestamp

Returns: void

int GTSDKUpdateMap (const unsigned char *buffer, int bufferSize, int pixelFormat, int width, int height)

Draws the map to the buffer. It runs only max 50 millisecond at a time. If the draw is not finished it continues next time. Using this behavior it can run in onDraw function, and if returns true you can call postInvalidate() function to continue drawing next time.

Parameters

buffer	byte buffer wher the map will be copied to
bufferSize	size of the buffer
pixelFormat	PIXELFORMAT_RGB565 = 0, PIXELFORMAT_RGB888 = 1
width	Pixel width of the map
height	Pixel height of the map

Returns: true if more draw time needed.

bool GTSDKUpdateRoutePlan (int timeOut, double &progress, int &routeId)

Runs route planning for a given milliseconds.

Parameters

timeOut	Running time in milliseconds. If timeout occurs it pauses route planning and continues next updateRoutePlan call.
progress	Out parameter percent of route planning progress.
routeId	Id of the planned route. If planning is not finished or failed, result is -1

Returns: true if route planning still has to run.

int GTSDKZoomMap (double factor)

Zooms the map with a factor.

Parameters

factor The factor of zooming, e.g. 2 is zoom out one level and 0.5 is zoom in one level.

Returns: true if zoom limit is reached.

int GTSDKZoomMapToScreenPosition (double factor, double x, double y)

Zooms the map with a factor, taking zooming focus the x,y screen coordinates.

Parameters

factor	The factor of zooming, e.g. 2 is zoom out one level and 0.5 is zoom in one level.
x	X screen position of zooming focus point.
y	Y screen position of zooming focus point.

Returns: true if zoom limit is reached.

E-Mobility SDK

SDK Functions

Member Typedef Documentation

Taichung Bike Week 2024 - Here we go!