DRIVE SDK
GPS NAVIGATION 
version 8.3 build 47035

Installation & first steps

Inroduction

The integration of navigation into your solution works on the system that the Sygic FLEET is running as a standalone application and the SDK provides interprocess communication with your main application.

Note: Please, make sure that you have purchased proper license for SDK product.

Installing the DRIVE application

  1. Obtain the download link for proper version of Drive from Sygic
  2. Obtain the download link for the map of required region and licenses for it
  3. Copy the downloaded application and map to the SD card and activate the license on the target device.

Installing the SDK

  1. Obtain the download link for Drive SDK from Sygic
  2. Unpack the SDK on your computer.
  3. The SDK contains:
    • Examples sample applications written in C# and C++
    • Include folder containing header file needed for development in C++
    • LIBs folder containing libraries needed for development in .NET and C++
    • Driver_DLLs folder containing dll files compiled for all supported platforms. \API-mem folder contains version for memory communication and \CFI-file folder contains version for direct communication with cfi (commnad interface)
  4. Copy ApplicationAPI.dll and sdkdriver.dll files from Driver-DLLs folder compiled for your platform to your application folder on the mobile device.

Integrating the SDK into application

C#/VB.NET in Visual Studio .NET2003/2005/2008/2010

  1. As first it is necessary to add reference to the Fleet SDK. Open the References in Solution Explorer and choose Add Reference… In the Add Reference window browse to the location of ApplicationAPI.NET.dll in the appropriate directory.
  2. Include the following line into your source code:
    using ApplicationAPI;
  3. Create a handling function, that will handle the events raised by the navigation application, like:
    public static void NavHandler(int nEventID, IntPtr strData)
    { //handle events here
    }
  4. Assign an event handler to the navigation application:
    public ApplicationAPI.CApplicationAPI.ApplicationHandler AppHnd = new CApplicationAPI.ApplicationHandler(NavHandler);
  5. Select a place in your application’s run, where the navigation will start. Ideally it is during the start up of the application. Call the following function like this:
    CApplicationAPI.InitApi("\\Storage Card\\Drive\\WindowsMobile\\Drive.exe", AppHnd, 0, 0, 240, 320);
    Make sure that your path is correct. Also select the appropriate resolution size. You may also run the application not full screen, allowing access to your underlying forms in parts of the screen.
  6. When the Init of the navigation is finished, put the application to background until it is needed. Call the following API function:
    BringApplicationToBackground(out Error, iTimeout);
  7. Add a shut down of the navigation somewhere at the end of your application:
    ApplicationAPI.CApplicationAPI.EndApplication(out Error, iTimeout);
    ApplicationAPI.CApplicationAPI.CloseApi();
  8. See the example projects in the SDK.

C++ in eMbedded Visual C++ 4.0

  1. As first, copy the appropriate ApplicationAPI.lib from the Fleet SDK to your project directory.
  2. Copy the file ApplicationAPI.h to your project directory.
  3. Add this include line:
    #include "ApplicationAPI.h"
  4. Create a handling function, that will handle the events raised by the navigation application, like:
    void __cdecl AppHnd(int nEvent, void* pData)
    { //Handle events here  
    }
  5. Select a place in your application’s run, where the navigation will start. Ideally it is during the start up of the application. Call the following function like this:
    CApplicationAPI::InitApi( _T("\\Storage Card\\Drive\\WindowsMobile\\Drive.exe"), AppHnd, 0, 0, 240, 320);
    Make sure that your path is correct. Also select the appropriate resolution size. You may also run the application not on full screen, allowing access to your underlying forms in parts of the screen.
  6. When the Init of the navigation is finished, put the application to background until it is needed. Call the following API function:
    CApplicationAPI::BringApplicationToBackground(&err, iTimeout);
  7. Add a shut down of the navigation somewhere at the end of your application:
    CApplicationAPI::EndApplication( &err, iTimeout);
    CApplicationAPI::CloseApi();
  8. See the example projects in the SDK.

C++ in Visual Studio 2005/2008/2010

  1. Copy the files api.cpp, api.h and api_def.h from Include\vs2005_2008\ directory to your project directory.
  2. Add these include lines:
    #include "api.h"
    #include "api_def.h"
  3. Continue the same way as in the section of eMbedded Visual C++ 4.0 at step 4).

Modifying the truck attributes in SDK

If you have purchased version of Drive with Truck Attributes, you have to configure them with your application.

  1. Make an instance of the SChangeOption class and modify the parameters of your truck in it.
  2. Call this function
    ApplicationAPI.CApplicationAPI.ChangeApplicationOption(out Error, ref MyChangeOption, iTimeout);

Example applications

The SDK contains four example project, that demonstrate the usage of the SDK in C# and C++. To build the applications, follow the steps mentioned above.

Execution of DRIVE application in command line

It is possible to define Drive resolution and position on screen, when running from command line:
Drive.exe -r640x480 -p100x50
-r640x480 defines Drive resolution to 640 x 480 pixels
-p100x50 defines Drive position to 100 pixels from screen left border and 50 pixels from screen top border

 


FIRST STEPS

Follow installation step-by-step procedure to install Drive and SDK.

FUNCTIONS HOW-TO AND FAQ

See how to achieve the most common funcitonality

SETTINGS CUSTOMIZATION

How to modify settings.ini.

MENU CUSTOMIZATION

How to modify menu.ini file.

IMAGE FORMATS

How to convert images to format supported by Drive

OTHER FORMATS

Specifications of other formats SYGIC FLEET navigation

TROUBLESHOOTING

Go through the most common issues, or contact our support team.

ApplicationAPI

Documentation to ApplicationAPI

                    Copyright 2012, Sygic a.s.   All rights reserved.