Printable version
This Page
All Pages
PDF (0.2MB)

[Index]

Install
SDK

Samples
VB.NET
C#
ASP.NET VB
ASP.NET C#

Studio
Create maps

Distribution
Copy

Getting started with VB.NET and GpsTools .NET

Examples The best and easiest way to get started is to take a look at the examples.

The samples, DLLs and CAB files can be found in the .NET Framework\Samples directory.
You can open that directory from the program start menu:
Start -> Program -> Franson GpsTools SDK -> .NET Framework -> Samples

Sample 1 - SerialPort
Reads data from the serial port and parses NMEA 0183 data (standard GPS protocol). Presents position as latitude, longitude, UTM coordinates, (or other supported national coordinate system). Displays speed and satellite information.
Depends on GpsToolsNET.dll

Sample 2 - SimpleMap
Demonstrates the new raster map functionality. Connects a GPS to a map. Draws and handles graphical objects on a map, zoom and rotation and much more. Handles mouse events. And more...
Create your own MapLibs using GpsTools Studio.
Depends on GpsToolsNET.dll, GpsViewNET.dll

Sample 3 - Layers
Draw objects on several of layers and how to manage layers.
Depends on GpsToolsNET.dll, GpsViewNET.dll

Sample 4 - MultiMap
Switch between different raster maps. Use and define blank maps.
Depends on GpsToolsNET.dll, GpsViewNET.dll

Sample 5 - Grid
Samples for coordinate conversion in both directions between latitude/longitude and national grids. E.g. UTM, British Grid, Irish Grid, Swiss Grid and Swedish Grid. List of supported grids
Depends on GpsToolsNET.dll

Sample 6 - ShapeDrawer
Draws polygons, polylines and multipoint.
Depends on GpsToolsNET.dll, GpsViewNET.dll, GpsShapeNET.dll

Sample 7 - ShapeFileViewer
Load and display ESRI shapefiles.
Depends on GpsToolsNET.dll, GpsViewNET.dll, GpsShapeNET.dll

A License key is necessary to use GpsTools. During development the key found here can be used. To distribute the component as part of your application you need to purchase a license. The License.LicenseKey property must be set to a valid license key by your application or else the component will refuse to work properly.

Emulator. GpsTools can be run in the Pocket PC emulator of you have a GPS to connect to the desktop PC. Read more here about how to set up the emulators serial port.

Steps to set up project
You always need to make a reference to GpsToolsNET.dll
. To use the raster map feature you also need to make a reference to GpsViewNET.dll and add GpsViewNET.dll to the Toolbox to be able to draw the map control to the form during design time.
For polygon, polylines and ESRI shapefiles a reference to GpsShapeNET.dll is necessary.

1. Open a sample project.

2. Right click on "References" and select "Add reference..."

A dialog opens:


3. Click "Browse..."

4. Go up two directories.



5. Select the DLLs you need to reference. Select all if you feel unsure. You can remove them later when you understand which you do need, and which you don't need. Then click open.

6. Click "OK" in the "Add reference" dialog".

7. Find the row which says License.LicenseKey = "...", replace that key with the one you requested from us.

8. Run your sample!

NOTE! Due to an error in VS.NET 2002 you need to set the "Copy Local" property to false for the referenced DLL:s or else VS.NET 2002 will issue an error when trying to display the form. This bug is fixed in VS.NET 2003.

Index

A few things about the GPS. Remember that a GPS works poorly indoors. Sometimes it is possible to get a fix near a window, but usually not. The GPS must be configured to transmitt NMEA data.

Index

100% managed code
© 2010 Franson Technology AB, All rights reserved, Contact | | Affiliate | Login