GTU-10 Telematics Tracking API Overview

GTU-10 Telematics Tracking API Overview

2

High Level Description

The Garmin Telematics Tracking solution consists of:– The GTU-10 product, an integrated cellular and GPS receiver delivered in a

small, light weight, water proof form factor.

– Data connectivity via the nation’s largest GSM carrier.

– Garmin hosted infrastructure for data collection, storage and delivery.

– APIs designed to facilitate ease of application development and use.

– Supporting documentation including SDK, programmer’s guide, reference applications and devices.

Mobile

Network

Customer

ApplicationsGarmin

GTU-10

Garmin

Telematics API

3

Overview:Small, lightweight and waterproof. Uses high-sensitivity GPS. Operates on a GSM wireless connection with U.S. national coverage. Includes a built-in rechargeable Li-ion battery or can be powered externally.Supports geofences and alerts upon entry/exit. Customizable device settings, including battery and power loss alerts. Accessible track history.

GTU-10 Specifications

Physical & PerformanceUnit dimensions, WxHxD: 1.34" x 3.07" x 0.79" (3.4 x 7.8 x 2.0 cm)Weight: 1.71 oz (48.5 g)Battery: rechargeable lithium ionBattery life: 1 day to 1 month (depending on operation mode chosen) or optional external power.Waterproof: yes (IPX7)High-sensitivity receiver: yesInterface: USB 2.0 full speed

GTU-10

4

Coverage / Usage AreaData connectivity provided via nationwide 2G GPRS network.

Coverage area map:

Please refer to: http://www.wireless.att.com/coverageviewer/ for the latest information.

5

GTU 10 Telematics Tracking API 1.0

Table of ContentsRevision HistoryIntroductionAuthentication

Example Token RequestSending Service Requests

GET_DEVICE_LISTGET_LAST_KNOWN_POSITIONGET_DB_TRACKLOGWAKE_UPGET_DEVICE_CONFIGURATIONSET_DEVICE_CONFIGURATIONADD_MULTIPLE_GEOFENCESUPDATE_MULTIPLE_GEOFENCESDELETE_MULTIPLE_GEOFENCESACTIVATE_SIMSET_AUTO_RENEWABLEGET_NOTIFICATION_URLCombined RequestsExample HTTP Request Packet

Interpreting Service ResponsesError Messages

Appendix A: Message GrammarAppendix B: HTTP Status CodesAppendix C: Alert NotificationsAppendix D: GTU-10 Communication and ServiceAppendix E: Excessive Data Use

1

2

3

4

Authentication

Requests

Responses

Reference

6

Development SupportGarmin provides a comprehensive support package to

simplify application development and accelerate deployment. The package includes:

API Specification

Programmer’s guide

Reference Apps / SDK

Reference devices

Technical Support

Customer

Applications

7

• Step-by-step guide to API implementation.

• Illustrated descriptions of system and communication functions.

• Background on GTU-10 operation and use cases.

• Detailed description of SDK and example applications.

• FAQ’s based on general topics, configurations, and alerts.

Programmer’s Guide

8

SDK / Reference App

9

SDK / Reference App Features

• Source code for example applications:– A web application written in JavaScript.– A standalone Java application.– A notification listener written as a Java Servlet.– An example request proxy written as a Java Servlet.

• Device Configuration– Login to your account – View registered devices.– Assign a nick name to a device.– Retrieve service plan information.– Configure power mode and alerts.

• Location & Tracking– Display track history on a map.– Request current location of a device.

10

SDK / Reference App Features(continued)

• Geofences

– Add up to 10 geofences per device.

– Create a library of pre-defined geofences

– Edit your custom geofences by clicking points on a map.

– Configure entry and exit alerts for each geofence.

11

SDK / Reference App Features(continued)

• Activation and Expiration– Activate devices registered to your account (billing cycle begins).– Retrieve the start date and expiration date for service

subscriptions.– Enable and disable the auto renewal of a subscription.

• Mapping and Test Functions– Find a location by address.– Find location given a latitude and longitude.– View alert notification history.– Test your notification listener using a form to generate example

alerts.– Clear the map of track point markers and/or geofences.

12

Alerts and Notifications

• Alerts are generated by the GTU-10 when various events happen. Notifications are posted to your URL and include time, location, speed, heading and battery level.

• Alert types include: – FENCE_ENTRY – Sent when a device enters a geofence.– FENCE_EXIT – Indicates the device has left a geofence.– LOW_BATTERY - Device has a low battery.– POWER_OFF - Device has been powered off.– EXTERNAL_POWER_LOST - External power has been removed.– LOCATION_PING - In response to a request to locate the device.– AUTHENTICATION – Sent every 24 hours when the device

automatically reports in to the system.

13

Reference Devices

Note that ONLY Commercial GTU-10 units can be accessed through the Web API.

• Consumer GTU-10 (Part number 010-00887-10) – A consumer device can be purchased through a number avenues such as a consumer electronics retailer. These devices are intended for personal use. The consumer must register the device online at myGarmin.com in order to activate the device and begin using it for tracking. A consumer device cannot be accessed via the GTU Web API.

• Commercial GTU-10 (Part number 010-00887-20) – Only commercial devices can be accessed via the GTU Web API. Commercial devices cannot be accessed via myGarmin.com. These devices must be registered to a commercial account that is created by contacting Garmin. Commercial devices are pre-registered to this commercial account prior to being shipped from Garmin to the commercial licensee.

14

Getting Started

Execute legal instruments

NDA

Telematics Tracking API License Agreement

Schedule initial phone session

Overview of development environment

Quick start guide to developing apps

Technical support team introduction

Take delivery of development materials and GTU-10 reference device.

15

For more information

• For technical support and questions about the Garmin GTU 10 Telematics Tracking API please contact your Garmin representative or use the following link:

www.garmin.com/solutions/gtu/contact.jsp

Thank You