TMM WebSockets
Trimble Mobile Manager uses local WebSocket servers to stream real-time data to client applications. There are two WebSocket servers available:
The WebSocket servers run locally on the device with the following possible addresses:
ws://tmm-api-local.fieldsystems.trimble.com:<port>- internet connection is required to resolve hostname to 127.0.0.1.ws://localhost:<port>ws://127.0.0.1:<port>
WebSocket V1 (Deprecated)
Section titled “WebSocket V1 (Deprecated)”WebSocket V1 is the original WebSocket interface. It is now deprecated in favor of the more robust WebSocket V2 interface, but is still supported for backward compatibility. We recommend using WebSocket V2 for all new integrations.
The WebSocket V1 interface:
- Supported for backward compatibility.
- Supports a single channel which sends location data in the LocationV1 format.
- Available on Android, iOS and Windows platforms.
- Open availability (no Application ID required).
| Channel | Address | Frequency | Description |
|---|---|---|---|
| Root | / | 1 Hz | Stream of LocationV1 messages |
WebSocket V2
Section titled “WebSocket V2”The WebSocket V2 interface is the latest WebSocket interface which sends robust location data, and application event data on separate channels.
The WebSocket V2 interface:
- Recommended for new integrations.
- Supports multiple channels for different types of data, such as location and application events.
- Available on Android, iOS and Windows platforms.
- Requires a valid TMM Application ID to unlock.
| Channel | Address | Frequency | Description |
|---|---|---|---|
| Root | / | 1-10 Hz | Stream of LocationV2 messages |
| LocationV2 | /locationV2 | 1-10 Hz | Stream of LocationV2 messages |
| Event | /events | As needed | Stream of application event messages |