dm_geocom_api_request_get_coordinate Subroutine

public pure subroutine dm_geocom_api_request_get_coordinate(request, wait_time, inc_mode)

Request of TMC_GetCoordinate procedure. Creates request for getting the coordinates of a measured point.

This function conducts an angle and, in dependence of the selected inc_mode, an inclination measurement, and then calculates the coordinates of the measured point with the last distance.

The argument wait_time specifies the delay to wait for the distance measurement to finish. Single and tracking measurements are supported. The quality of the result is returned in the GeoCOM return code.

The instrument returns the following responses:

• grc – GeoCOM return code.
• east – E coordinate [m].
• north – N coordinate [m]
• height – H coordinate [m].
• ctime – Timestamp of distance measurement [msec].
• eastc – E coordinate (continuously) [m].
• northc – N coordinate (continuously) [m].
• heightc – H coordinate (continuously) [m].
• ctimec – Timestamp of continuous measurement [msec].

Property	Values
Instruments	TPS1100, TPS1200, TM30/TS30, TS16
ASCII request	%R1Q,2082:<wait_time>,<inc_mode>
ASCII response	%R1P,0,0:<grc>,<east>,<north>,<height>,<ctime>,<eastc>,<northc>,<heightc>,<ctimec>

Arguments

Type	Intent	Optional	Attributes		Name
type(request_type),	intent(out)			::	request	Prepared request.
integer,	intent(in)			::	wait_time	Delay to wait for the distance measurement to finish [msec].
integer,	intent(in)			::	inc_mode	Inclination measurement mode (GEOCOM_TMC_INCLINE_PRG).