dm_geocom_api_request_get_simple_coordinates Subroutine

public pure subroutine dm_geocom_api_request_get_simple_coordinates(request, wait_time, inc_mode)

Request of TMC_GetSimpleCoord procedure. Creates request for returning cartesian coordinates.

The API function returns the cartesian coordinates if a valid distance is set. The argument wait_time sets the maximum time to wait for a valid distance. Without a valid distance, the coordinates are set to 0.0, and an error is returned. The coordinate calculation requires inclination results. The argument inc_mode sets the inclination measurement mode (GEOCOM_TMC_INCLINE_PRG).

The instrument returns the following responses:

  • grc – GeoCOM return code.
  • east – Easting [m].
  • north – Northing [m].
  • height – Orthometric height [m].
Property Values
Instruments TPS1100, TPS1200, TM30/TS30, TS16
ASCII request %R1Q,2116:<wait_time>,<inc_mode>
ASCII response %R1P,0,0:<grc>,<east>,<north>,<height>

Arguments

Type IntentOptional 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).

Calls

proc~~dm_geocom_api_request_get_simple_coordinates~~CallsGraph proc~dm_geocom_api_request_get_simple_coordinates dm_geocom_api_request_get_simple_coordinates proc~dm_geocom_api_request dm_geocom_api_request proc~dm_geocom_api_request_get_simple_coordinates->proc~dm_geocom_api_request