The Java SDK tools provide an easy way to integrate MyGeotab into Java software. All of the communication to Geotab's services is accomplished over HTTPS with data serialized in JSON format. The Java library provided will automatically handle the JSON serialization and deserialization into MyGeotab objects.
Maven dependency

The maven dependency available in maven repo is an SDK library for accessing MyGeotab customer databases. It is a convenient "wrapper" around Geotab's HTTP/JSON API to allow developers focus on writing code instead of moving data over the wire. It includes tools to assist authenticating against Geotab's servers, automatically serializing/deserializing JSON, and providing definitions for Checkmate object classes.

Quick start in API Clients

API class

Step 1: Initialize & authentication

An instance of API can be constructed to be used in the code. For the most basic use case, all the data that is needed is user credentials and a database name:

At this point there has not been any communication with Geotab's servers. In order to make calls to Geotab's API, an authentication call must be made:

When the call is made to Geotab's servers to authenticate, a token is returned for security. Behind the scenes, the Authenticate call makes a JSON-RPC request to Geotab's "Authenticate"method. The resulting security token and server information are stored in order to make further calls to the API. If the authenticate() call is not made explicit, then it will be made implicit, behind the scene, before the first api call().

For more information regarding authentication, please review the Authentication documentation.

Step 2: Making calls

When authenticated, calls are made to the API by invoking the call() method of the API class.

The example below illustrates how to make a generic call to get all devices in the system.

In the example below it is shown how to delete a device using the generic "Remove" method. Notice that it is not required to send all of the device's information to remove it, the device's id is sufficient:

The call() parameters are:

  • request represents the request details, and it's an instance of AuthenticatedRequest
  • response represents the response and it's an instance of BaseResponse;BaseResponse holds the actual result type to be deserialized and returned by the call() method

The API class automatically handles databases that are moved to different servers in the federation and expired tokens (token are typically valid for 2 weeks) by automatically re-authenticating and continuing.

Example code

The following is a simple console app that will search Device by serial number:

Next steps
Once you have a basic understanding of how the Java SDK works works, we recommend reviewing the examples that we have created here.