GTU-10 Telematics Tracking API Overview
Transcript of 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