Android Intents
TMM supports several Android intents you can use to configure and control the program.
An intent may trigger TMM to show user interface, or it may do a configuration action in the background.
An intent may return information to the calling program, or it may simply perform the requested action without any return.
Android Intents
Section titled “Android Intents”CORRECTIONSOURCESETTINGS — Open the Configuration page
Remarks
Section titled “Remarks”com.trimble.tmm.CORRECTIONSOURCESETTINGSThe CORRECTIONSOURCESETTINGS intent is used to display the correction source settings page in TMM.
Inputs
Section titled “Inputs”None
Outputs
Section titled “Outputs”None
EBUBBLECALIBRATION — Open the Tilt calibration page
Remarks
Section titled “Remarks”com.trimble.tmm.EBUBBLECALIBRATIONThe EBUBBLECALIBRATION intent is used to display the eBubble tilt calibration page in TMM.
Inputs
Section titled “Inputs”None
Outputs
Section titled “Outputs”None
GNSS_STATUS — Open the GNSS Status page
Remarks
Section titled “Remarks”com.trimble.tmm.GNSS_STATUSThe GNSS_STATUS intent is used to display the GNSS Status page in TMM.
Inputs
Section titled “Inputs”None
Outputs
Section titled “Outputs”None
HERE — Open the Point Measurement page
Remarks
Section titled “Remarks”com.trimble.tmm.HEREThe HERE intent is used to display the Point Measurement page in TMM.
Inputs
Section titled “Inputs”- distanceUnit (string): The unit of distance measurement, ‘MD’=meters, ‘FD’=feet.
- name (string): Point name
- comment (string): Point comment
- antennaHeight (double): The height of the antenna.
Outputs
Section titled “Outputs”- accountName (string): (Optional) Account name
- accountTID (string): (Optional) Account TID
- name (string): Point name
- comment (string): Comment
- latitude (double): Latitude (degrees)
- longitude (double): Longitude (degrees)
- height (double): Height (distanceUnit)
- elevation (double): Elevation (distanceUnit)
- heightAtGround (double): Height at ground (distanceUnit)
- antennaHeight (double): Antenna height (distanceUnit)
- horizontalPrecision (double): Horizontal precision (degrees)
- verticalPrecision (double): Vertical precision (degrees)
- sampleCount (int): Number of observations in average
- EPSGCode (string): (Optional) EPSG code
IMUBIASCALIBRATION — Open the IMU calibration page
Remarks
Section titled “Remarks”com.trimble.tmm.IMUBIASCALIBRATIONThe IMUBIASCALIBRATION intent is used to display the IMU Bias calibration page in TMM.
Inputs
Section titled “Inputs”None
Outputs
Section titled “Outputs”None
LOGIN — Client application login
Remarks
Section titled “Remarks”com.trimble.tmm.LOGINThe LOGIN intent downloads licenses for the user and client application, and sends the login information back to the caller.
Inputs
Section titled “Inputs”- applicationID (string): The application ID.
Outputs
Section titled “Outputs”Returns an intent containing the login information.
- accountName (string): The name of the logged-in user.
- accountJWT (string): The ID token of the logged-in user.
- accountAT (string): The access token of the logged-in user.
- refreshToken (string): The refresh token of the logged-in user.
- tpsdkVersion (string): The version of the Trimble Precision SDK.
ONDEMAND — Open to the On Demand page
Remarks
Section titled “Remarks”com.trimble.tmm.ONDEMANDThe ONDEMAND intent is used to open the On-Demand licensing page in TMM if a user is signed in.
Inputs
Section titled “Inputs”None
Outputs
Section titled “Outputs”Returns an intent containing the On-Demand claim and remaining time.
- currentClaim (string): The current On-Demand claim selected by the user.
- claimCountdown (string): The remaining time for the current On-Demand claim.
OPENANTENNAHEIGHT — Open the Antenna Height page
Remarks
Section titled “Remarks”com.trimble.tmm.OPENANTENNAHEIGHTThe OPENANTENNAHEIGHT intent is used to open the Antenna Height page in TMM.
Inputs
Section titled “Inputs”None
Outputs
Section titled “Outputs”None
OPENLASEROFFSET — Opens the Laser Offset Activity.
Remarks
Section titled “Remarks”com.trimble.tmm.OPENLASEROFFSETThe OPENLASEROFFSET intent opens the Laser Offset data collection workflow in TMM.
Inputs
Section titled “Inputs”None
Outputs
Section titled “Outputs”Returns an intent containing the Laser Offset result (same format as iOS callback URL). On cancel, Result.Canceled with no extras.
- referenceContext (string): addVertex
- geometry (string): Comma-separated
"{latitude},{longitude}"or"{latitude},{longitude},{elevation}"(elevation omitted if not available). - useLocationProfile (string): true
- useAntennaHeight (string): false
- featureAttributes (string): URL encoded JSON object. Compatible with ESRI GNSS / offset metadata fields.
OPEN_TO_CONFIGURATION — Open the Configuration page
Remarks
Section titled “Remarks”com.trimble.tmm.OPEN_TO_CONFIGURATIONThe OPEN_TO_CONFIGURATION intent is used to display the Configuration page in TMM.
Inputs
Section titled “Inputs”None
Outputs
Section titled “Outputs”None
OPEN_TO_LOGIN — Open the login page
Remarks
Section titled “Remarks”com.trimble.tmm.OPEN_TO_LOGINThe OPEN_TO_LOGIN intent is used to start the login process in TMM.
Inputs
Section titled “Inputs”- applicationID (string): The application ID.
Outputs
Section titled “Outputs”Returns an intent containing the user’s account information and the Trimble Precision SDK version.
- accountName (string): The name of the logged-in user.
- accountTID (string): The TID of the logged-in user.
- accountJWT (string): The ID token of the logged-in user.
- accountAT (string): The access token of the logged-in user.
- tpsdkVersion (string): The version of the Trimble Precision SDK.
POLEBIASADJUSTMENT — Open the Pole bias adjustment page
Remarks
Section titled “Remarks”com.trimble.tmm.POLEBIASADJUSTMENTThe POLEBIASADJUSTMENT intent is used to display the Pole Bias Adjustment page in TMM.
Inputs
Section titled “Inputs”None
Outputs
Section titled “Outputs”None
PseudoSecureSocketServerPort — Query the list of TMM server ports
Remarks
Section titled “Remarks”com.trimble.tmm.PseudoSecureSocketServerPortThe PseudoSecureSocketServerPort intent is used to start the pseudo-secure socket server port activity in TMM.
Inputs
Section titled “Inputs”- applicationID (string): The application ID.
Outputs
Section titled “Outputs”Returns an intent containing the registration result and port information.
- port (integer): The port number for the secure socket server.
- apiPort (Int): The insecure port number for the REST API
- apiSecurePort (Int): The secure port number for the REST API
- locationPort (Int): The insecure port for the V1 WebSocket
- locationSecurePort (Int): The secure port for the V1 WebSocket
- locationV2Port (Int): The insecure port for the V2 WebSocket
- locationV2SecurePort (Int): The secure port for the V2 WebSocket
RECEIVERSELECTION — Open the receiver selection page
Remarks
Section titled “Remarks”com.trimble.tmm.RECEIVERSELECTIONThe RECEIVERSELECTION intent is used to start the receiver selection process in TMM.
Inputs
Section titled “Inputs”None
Outputs
Section titled “Outputs”None
RefreshUserToken — Refresh the user token
Remarks
Section titled “Remarks”com.trimble.tmm.RefreshUserTokenThe RefreshUserToken intent is used to refresh the user token in TMM.
Inputs
Section titled “Inputs”- applicationID (string): The application ID.
Outputs
Section titled “Outputs”Returns an intent containing information about the token refresh process or any errors that occurred.
- info (string): “Success” is returned when the process is successful. “RecentlyRefreshed” is returned if token refresh is not needed
- error (string): “No user logged in” if a user has not been correctly logged.
REGISTER — Register client application
Remarks
Section titled “Remarks”com.trimble.tmm.REGISTERThe REGISTER intent is used to register your application with TMM. This allows you to use the REST API.
Inputs
Section titled “Inputs”- applicationID (string): The application ID.
Outputs
Section titled “Outputs”Returns an intent containing the registration result and port information.
- registrationResult (string): The result of the registration process. This could be “OK”, “NoNetwork”, “Unauthorized”, “TooManyRequests” (rate limited; treat like HTTP 429), or “Error”.
- registrationRetryAfterSeconds (integer): Optional. When registrationResult is “TooManyRequests”, suggested seconds to wait before retrying.
- apiPort (Int): The insecure port number for the REST API
- apiSecurePort (Int): The secure port number for the REST API
- locationPort (Int): The insecure port for the V1 WebSocket
- locationSecurePort (Int): The secure port for the V1 WebSocket
- locationV2Port (Int): The insecure port for the V2 WebSocket
- locationV2SecurePort (Int): The secure port for the V2 WebSocket
SKYPLOT — Open the Skyplot page
Remarks
Section titled “Remarks”com.trimble.tmm.SKYPLOTThe SKYPLOT intent is used to display the Skyplot page in TMM.
Inputs
Section titled “Inputs”None
Outputs
Section titled “Outputs”None
SocketServerPort — Query the list of TMM server ports
Remarks
Section titled “Remarks”com.trimble.tmm.SocketServerPortThe SocketServerPort intent is used to start the socket server port activity in TMM.
Inputs
Section titled “Inputs”- applicationID (string): The application ID.
Outputs
Section titled “Outputs”Returns an intent containing the registration result and port information.
- port (integer): The port number for the socket server.
- apiPort (Int): The insecure port number for the REST API
- apiSecurePort (Int): The secure port number for the REST API
- locationPort (Int): The insecure port for the V1 WebSocket
- locationSecurePort (Int): The secure port for the V1 WebSocket
- locationV2Port (Int): The insecure port for the V2 WebSocket
- locationV2SecurePort (Int): The secure port for the V2 WebSocket
STATUS — Query TMM account status information
Remarks
Section titled “Remarks”com.trimble.tmm.STATUSThe STATUS intent is used to query the current user status information.
Inputs
Section titled “Inputs”- applicationID (string): The application ID.
Outputs
Section titled “Outputs”Returns an intent containing the status information.
- accountName (string): The name of the logged-in user.
- accountTID (string): The TID of the logged-in user.
- accountJWT (string): The ID token of the logged-in user.
- accountAT (string): The access token of the logged-in user.
- accountRefreshRecommended (boolean): Indicates whether a refresh is recommended.
- subscriptionPrecision (double): The precision limit of the subscription.
- badPrecisionThreshold (double): The bad precision threshold of the subscription.
- goodPrecisionThreshold (double): The good precision threshold of the subscription.
- subscriptionName (string): The name of the subscription in use.
- subscriptionExpiration (string): The expiration date of the subscription in use.
- distanceUnit (string): The distance unit in use.
- componentInstallationNeeded (boolean): Indicates whether the Catalyst Service needs to be installed.
- deviceHardwareSupport (integer): The level of device hardware support.