An Experiment in the Analytics Lab Add-In

App Release: January 2020Last document update: June 2022

API Explorer

An Experiment in Analytics Lab

What is the API Explorer?

API Explorer is an application that hosts numerous application programming interfaces (APIs) for a range of use cases. As a platform that is both part of and working in conjunction with Analytics Lab, it allows users to access pre-formulated codes for use cases like: intelligent zones, collision detection, service centers, rest stops, etc. The API Explorer application is one of the many available tools through Analytics Lab, now native in MyGeotab.

Why do you need it?

Coding from scratch can be troublesome and time-consuming, incorporating the API Explorer app helps users explore Geotab’s catalog of Beta APIs providing insight into what is being built, along with the types of data requests that are made.

The app’s user interface provides an easy and quick way to run APIs using their endpoints (provided as URL), along with request parameters, in the backend. In doing so, the API Explorer app provides essential endpoints through the URL for any users who are interested in referencing or customizing the pre-formulated codes for their specific use cases.

How does it work?

The API Explorer app leverages Geotab’s telematics data and is driven by intelligent data analytics. This app provides a user-friendly platform to send and receive data responses via a range of available APIs. The app runs the URL (API endpoints) in the backend, then the UI efficiently and accurately displays all the results the API calls. This application also provides the URL for any user who is interested in sending and receiving responses, using our APIs, on their respective systems.

How to Use the API Explorer App

Follow the steps below to explore through the Analytics API Explorer application and make data requests.

1	Navigate to Analytics Lab available under Dashboard & Analytics section in the MyGeotab navigation bar. ✱ NOTE: You must have Administrator security clearance to use the Analytics API Explorer App.
2	On clicking the Try It icon on the catalog page, the landing page of the app will appear.
3	Select a sample API from the catalog of APIs under API Request Input. ✱ NOTE: The available APIs are still in Beta, and may change or disappear without notice.
4	A description of what type of data the API tracks or extracts generates with an available URL to run the API on your system. Or, instead of running the API through URL (endpoints), you can change the Request parameters, then click Send Request. ✱ NOTE: Each API includes the default values for the Request parameters. Users can customize the values based on their use case.
5	Once the request is successfully submitted, the results appear in the Response output panel.

API Documentation

There are 11 APIs in the Analytic API Explorer application. To learn more about each API, select from the following:

1. Get Area of Operations [NEW]
2. Get Safety Benchmarks
3. Get Service Events
4. Get New Zones
5. Update Zoning Configuration
6. Get Collision Events
7. Get Contextual Risk
8. Get Contextual Risk Benchmarks
9. Get Average Speeds
10. Get Nearby Rest Areas
11. Get Nearby Fuel Stations
12. Get OSM Ids
13. Get Fuel Benchmarking Info [Experiment Deprecated]

Get involved!

Come, be a part of our Analytics Lab Community group. This is an open platform where you can ask questions, learn more about Geotab data solutions like API Explorer, find out what’s coming next, and also connect with our Data team and fellow Analytics Lab Add-In users.

See what’s happening in the Analytics Lab Community, and join the group today.

There are even more ways to connect. As we continue to improve our application, your feedback is valued. Send us your feedback or questions by clicking Leave Feedback and completing our experiment feedback form.

Version Tracker