Skip to content

README.md

Latest commit

 

History

History
58 lines (44 loc) · 1.94 KB

README.md

File metadata and controls

58 lines (44 loc) · 1.94 KB
Raw

Java SDK Samples

Common Geotab API usage examples in Java.

Setup

git clone https://github.com/Geotab/sdk-java-samples.git
cd sdk-java-samples
mvn compile

Run

mvn exec:java -Dapp=<name>

Credentials are resolved in priority order:

  1. System properties — -Dserver=my.geotab.com -Ddatabase=G560 -Dusername=user@mail.com -Dpassword=secret
  2. Environment variables — GEOTAB_SERVER, GEOTAB_DATABASE, GEOTAB_USER, GEOTAB_PASSWORD
  3. Interactive prompts — entered at the terminal when a required value is missing

The password is never echoed or stored. No credential files are written to disk.

Example — environment variables (recommended for CI/CD)

export GEOTAB_SERVER=my.geotab.com
export GEOTAB_DATABASE=G560
export GEOTAB_USER=user@mail.com
export GEOTAB_PASSWORD=secret
mvn exec:java -Dapp=getCount

Example — system properties

mvn exec:java -Dapp=getCount \
  -Dserver=my.geotab.com \
  -Ddatabase=G560 \
  -Dusername=user@mail.com \
  -Dpassword=secret

Examples

App Description
getCount Count of entities (User, Zone, Device…)
getLogs GPS logs for a vehicle over a date range
sendTextMessage Send text messages to/from a GO device
importGroups Import groups from a CSV file
importDevices Import devices from a CSV file
importUsers Import users from a CSV file
dataFeed GPS, Status and Fault data feed to CSV
maintenance Maintenance work orders and requests