C++ SDK

◆ ShowCoordinatesOnMap()

static int CApplicationAPI::ShowCoordinatesOnMap ( LpError  lpError,
LONGPOSITION  cpLocation,
LONG  lZoom,
BOOL  bShowApplication,
DWORD  dwMaxTime = DEFAULT_MAX_TIME 
)
static

The function shows taken location on BrowseMap.

Parameters
lpErrorAdditional error information returned from Drive.
cpLocationLocation which will be shown on BrowseMap.
lZoomDistance (in meters) which will be shown between left and right border of the BrowseMap. Range of this parameter should be between 256 and 1000000.
dwMaxTimeMaximum time (in milliseconds) function can take. If dwMaxTime=0 function execution is not time limited.
bShowApplicationFlag determining whether Drive should be brought to foreground automatically.
true - Drive will be brought to foreground.
false - Drive will stay in background.
Returns
1 if successful, other value otherwise.

Point with taken location will be shown in the middle of BrowseMap.

BrowseMap is map shown on after clicking Browse Map menu button. BrowseMap allows browse the loaded maps and change zoom.

See Coordinates conversion section in TROUBLESHOOTING page.

Possible error codes returned from Drive are:

  • 0 - Function not succeeded.
  • 1 - Function succeeded.
  • 2 - Drive not succeeded.
  • 3 - Function reached timeout.