3.1.0 (03-03-2014) MapViewerControl = This interface offers functions to control the MapViewer GetVersion = This method returns the API version implemented by the server application version = struct(major,minor,micro,date) major = when the major changes, then backward compatibility with previous releases is not granted minor = when the minor changes, then backward compatibility with previous releases is granted, but something changed in the implementation of the API (e.g. new methods may have been added) micro = when the micro changes, then backward compatibility with previous releases is granted (bug fixes or documentation modifications) date = release date (e.g. 21-06-2011) CreateMapViewInstance = This method creates a new map instance Note: when a map instance is created, it is set to 'not visible' by default sessionHandle = Session handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value mapViewSize = struct(horizontalSize,verticalSize) of the map instance in pixels. horizontalSize = horizontal size of the map instance in pixels verticalSize = vertical size of the map instance in pixels mapViewType = enum(INVALID,MAIN_MAP,SPLIT_SCREEN, ... ) Note: to be used in case that a specific position of the map instance with respect to the display viewport is required For example, if the instance 1 is of type MAIN_MAP and the instance 2 is of type SPLIT_SCREEN, the offset of the map instances with respect to the display viewport could be (0;0) and (hres/2;0) respectively mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value This error is generated if no more map view instance handles are available ReleaseMapViewInstance = This method releases (i.e. destroys) a given map instance. Only invisible map instances can be released sessionHandle = Session handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value This error is generated if an application tries to delete a map view instance handle that is not available GetMapViewType = This method returns the map type of a map instance as it was set using CreateMapViewInstance mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value mapViewType = enum(INVALID,MAIN_MAP,SPLIT_SCREEN, ... ) GetSupportedMapViewTypes = This method retrieves the supported map view types mapViewTypeList = array[mapViewType] mapViewType = enum(INVALID,MAIN_MAP,SPLIT_SCREEN, ... ) SetTargetPoint = This method sets the position of the point the camera is aimed at Note: the target point is typically visualized in the center of the screen sessionHandle = Session handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value targetPoint = (lat,lon,alt) lat = latitude in format %3.6f. Range[-90:+90] lon = longitude in format %3.6f. Range[-180:+180] alt = altitude to the ground in meters GetTargetPoint = This method retrieves the target point position Note: if the FollowCar mode is active, the this method will return the current vehicle position mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value targetPoint = (lat,lon,alt) lat = latitude in format %3.6f. Range[-90:+90] lon = longitude in format %3.6f. Range[-180:+180] alt = altitude to the ground in meters SetFollowCarMode = This method sets the FollowCar mode Note: if the FollowCar is activated, the current car position is interpreted as target point position sessionHandle = Session handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value followCarMode = flag. If true, the current car position is interpreted as position of the point the camera must look at GetFollowCarMode = This method returns the current FollowCar-mode mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value followCarMode = flag. If true, the current car position is interpreted as position of the point the camera must look at FollowCarModeChanged = This signal is emitted when the follow-car-mode changes mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value followCarMode = flag. If true, the current car position is interpreted as position of the point the camera must look at SetCameraPosition = This method sets the coordinates of the point at which the camera must be positioned Note: the camera heading will be automatically set in such a way, that the camera is aimed at the view point sessionHandle = Session handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value position = (lat,lon,alt) lat = latitude in format %3.6f. Range[-90:+90] lon = longitude in format %3.6f. Range[-180:+180] alt = altitude to the ground in meters GetCameraPosition = This method returns the coordinates of the point at which the camera is positioned mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value position = (lat,lon,alt) lat = latitude in format %3.6f. Range[-90:+90] lon = longitude in format %3.6f. Range[-180:+180] alt = altitude to the ground in meters CameraPositionChanged = This signal is emitted when the position of the camera changes mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value targetPoint = (lat,lon,alt) lat = latitude in format %3.6f. Range[-90:+90] lon = longitude in format %3.6f. Range[-180:+180] alt = altitude to the ground in meters SetCameraHeadingAngle = This method sets the map view heading angle Note: the camera position will be automatically set in such a way, that it looks at the currently selected target point sessionHandle = Session handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value heading = heading angle in degrees. Range [0:360] The angle in degrees between projection on the ground plane of the line through the center of the screen and the top-centre of the screen, and the North direction 0 degrees means that the map view is oriented such that North is at the top of the screen Degrees are measured clockwise such that 90 degrees correspond to the East direction SetCameraHeadingToTarget = This method sets the camera heading in such a way, that the camera always looks at a given target Note: the camera position will be automatically set in such a way, that it aims at the current view point sessionHandle = Session handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value target = struct(lat,lon) lat = latitude of the point towards which the map vertical axis must be aligned in format %3.6f. Range[-90:+90] lon = longitude of the point towards which the map vertical axis must be aligned in format %3.6f. Range[-180:+180] SetCameraHeadingTrackUp = This method sets the camera heading in such a way, that the camera always looks in the direction in which the car is moving sessionHandle = Session handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value GetCameraHeading = This method returns the current camera heading mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value headingType = enum(INVALID,CONSTANT_ANGLE,TRACK_UP,TOWARDS_TARGET, ... ) headingAngle = heading angle in degrees measured from the North axis clockwise. Range[0:360] Note: meaningful only if heading != TOWARDS_TARGET, otherwise it is just a dummy value and must be set to 0 headingTarget = struct(lat,lon) lat = latitude of the point towards which the map vertical axis must be aligned in format %3.6f. Range[-90:+90] lon = longitude of the point towards which the map vertical axis must be aligned in format %3.6f. Range[-180:+180] Note: meaningful only if heading = TOWARDS_TARGET, otherwise it is just a dummy value and must be set to (0,0) CameraHeadingAngleChanged = This signal is emitted when the heading angle of the camera changes mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value headingType = enum(INVALID,CONSTANT_ANGLE,TRACK_UP,TOWARDS_TARGET, ... ) headingAngle = heading angle in degrees. Range [0:360] The angle in degrees between projection on the ground plane of the line through the center of the screen and the top-centre of the screen, and the North direction 0 degrees means that the map view is oriented such that North is at the top of the screen Degrees are measured clockwise such that 90 degrees correspond to the East direction SetCameraTiltAngle = This method sets the camera tilt angle sessionHandle = Session handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value tilt = tilt angle in degrees. Range [-180:180] Example: 0 = down (straight down to the ground plane), 90 = front (parrallel to the ground plane), 180 = top (straight up to the sky) Negative angles [0:-180] result in an upside down view GetCameraTiltAngle = This method returns the camera tilt angle mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value tilt = tilt angle in degrees. Range [-180:180] Example: 0 = down (straight down to the ground plane), 90 = front (parrallel to the ground plane), 180 = top (straight up to the sky) Negative angles [0:-180] result in an upside down view CameraTiltAngleChanged = This signal is emitted when the camera tilt angle changes mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value tilt = tilt angle in degrees. Range [-180:180] Example: 0 = down (straight down to the ground plane), 90 = front (parrallel to the ground plane), 180 = top (straight up to the sky) Negative angles [0:-180] result in an upside down view Optional SetCameraRollAngle = This method sets the camera roll angle sessionHandle = Session handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value roll = roll angle in degrees. Range [-180:180] Optional GetCameraRollAngle = This method returns the camera roll angle mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value roll = roll angle in degrees. Range [-180:180] SetCameraDistanceFromTargetPoint = This method sets the mode and the camera distance from the target point Note: this method can be used to zoom in and out sessionHandle = Session handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value distance = distance from the view point in meters GetCameraDistanceFromTargetPoint = This method gets the mode and the camera distance from the target point mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value distance = distance from the view point in meters CameraDistanceFromTargetPointChanged = This signal is emitted when the camera distance from the target point changes mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value distance = distance from the view point in meters SetMapViewScaleMode = This method sets the scaling mode. sessionHandle = Session handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value scaleMode = enum(AUTOMATIC,MANUAL,HYBRID) scaleMode = AUTOMATIC, adjusts the camera distance automatically (e.g. depending on the speed) scaleMode = MANUAL, the camera distance is specified by the argument 'distance' scaleMode = HYBRID, e.g. AUTOMATIC depending on the proximity to the target, MANUAL otherwise GetMapViewScaleMode = This method gets the scaling mode. mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value scaleMode = enum(AUTOMATIC,MANUAL,HYBRID) scaleMode = AUTOMATIC, adjusts the camera distance automatically (e.g. depending on the speed) scaleMode = MANUAL, the camera distance is specified by the argument 'distance' scaleMode = HYBRID, e.g. AUTOMATIC depending on the proximity to the target, MANUAL otherwise GetSupportedMapViewScaleModes = This method gets the supported scaling modes. mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value scaleModeList = array[scaleMode] scaleMode = enum(AUTOMATIC,MANUAL,HYBRID) scaleMode = AUTOMATIC, adjusts the camera distance automatically (e.g. depending on the speed) scaleMode = MANUAL, the camera distance is specified by the argument 'distance' scaleMode = HYBRID, e.g. AUTOMATIC depending on the proximity to the target, MANUAL otherwise MapViewScaleChanged = This signal is emitted when the mapview scale changes mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value scaleID = scale identifier. Range[0:255] isMinMax = enum(INVALID,MIN,MAX,MID, ... ) MIN = scale ID minimal value MID = scale ID intermediate value MAX = scale ID maximal value MapViewScaleByMetersPerPixelChanged = This signal is emitted when the mapview scale ByMetersPerPixel changes mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value metersPerPixel = meters per pixel SetCameraHeight = This method sets the camera height Note: this method is a subset of SetCameraPosition sessionHandle = Session handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value height = height from the ground in meters GetCameraHeight = This method gets the camera height Note: this method is a subset of GetCameraPosition mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value height = height from the ground in meters SetMapViewPerspective = This method sets the map perspective sessionHandle = Session handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value perspective = enum(INVALID,2D,3D, ... ) GetMapViewPerspective = This method returns the current map perspective mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value perspective = enum(INVALID,2D,3D, ... ) MapViewPerspectiveChanged = This signal is emitted when the map perspective chnages mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value perspective = enum(INVALID,2D,3D, ... ) GetSupportedMapViewPerspectives = This method retrieves the supported mapview perspectives perspectiveList = array[perspective] perspective = enum(INVALID,2D,3D, ... ) SetMapViewObjectVisibility = This method specifies the type of objects to show on the map. sessionHandle = Session handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value objectVisibilityList = array[objectVisibility] objectVisibility = dictionary[key,value] key = enum[BUILDINGS,TERRAIN, ...] value = value of type 'b'; if true the objects are shown else they are not shown GetMapViewObjectVisibility = This method gets the type of objects shown on the map. mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value objectVisibilityList = array[objectVisibility] objectVisibility = dictionary[key,value] key = enum[BUILDINGS,TERRAIN, ...] value = value of type 'b'; if true the objects are shown else they are not shown MapViewObjectVisibilityChanged = This signal is emitted when the type of objects shown on the map changes mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value objectVisibilityList = array[objectVisibility] objectVisibility = dictionary[key,value] key = enum[BUILDINGS,TERRAIN, ...] value = value of type 'b'; if true the objects are shown else they are not shown GetSupportedMapViewObjectVisibilities = This method gets the supported object visibilities. mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value objectVisibilityList = array[objectVisibility] objectVisibility = enum[BUILDINGS,TERRAIN, ...] GetScaleList = This method returns a list of supported map scales Note: a mapscale consists of an unique ID, a ScaleValue, a ScaleUnit and a number of MillimetesPerPixel mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value scaleList = array[struct(scaleId,scaleValue,scaleUnit,millimetersPerPixel)] scaleId = scale identifier. Range [0:255] scaleValue = scale value. It can assume values like 100, 200, 1000, ... scaleUnit = unit of measurement. It is an enum(INVALID,METER,KM,MILE,YARD,FOOT, ... ) millimetersPerPixel = number indicating the number of millimeters per pixel Example: ((1,100,METER,1000),(2,200,METER,1000),(3,500,METER,1000), ... ) SetMapViewScale = This method sets the map scale by specifying a ScaleID sessionHandle = Session handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value scaleID = scale identifier. Range[0:255] SetMapViewScaleByDelta = This method sets the map scale by specifying a delta value with respect to the currently set ScaleID sessionHandle = Session handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value scaleDelta = This parameter can have either positive or negative values. '0' means no change. Positive values indicate larger scales SetMapViewScaleByMetersPerPixel = This method sets the map scale by specifying the number of meters that a pixel represents sessionHandle = Session handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value metersPerPixel = meters per pixel GetMapViewScale = This method returns the currently used map scale mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value scaleID = scale identifier. Range[0:255] isMinMax = enum(INVALID,MIN,MAX,MID, ... ) MIN = scale ID minimal value MID = scale ID intermediate value MAX = scale ID maximal value SetMapViewBoundingBox = This method sets the map bounding box sessionHandle = Session handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value boundingBox = struct(top-left-corner,bottom-right-corner) top-left-corner = struct(lat,lon) bottom-right-corner = struct(lat,lon) lat = latitude in format %3.6f. Range[-90:+90] lon = longitude in format %3.6f. Range[-180:+180] GetMapViewBoundingBox = This method returns the bounding box of a given map instance mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value boundingBox = struct(top-left-corner,bottom-right-corner) top-left-corner = struct(lat,lon) bottom-right-corner = struct(lat,lon) lat = latitude in format %3.6f. Range[-90:+90] lon = longitude in format %3.6f. Range[-180:+180] MapViewBoundingBoxChanged = This signal is emitted when the bounding box of a map instance changes mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value boundingBox = struct(top-left-corner,bottom-right-corner) top-left-corner = struct(lat,lon) bottom-right-corner = struct(lat,lon) lat = latitude in format %3.6f. Range[-90:+90] lon = longitude in format %3.6f. Range[-180:+180] SetMapViewSaveArea = This methods defines the area that the HMI guarantees not to cover with other windows or user interface elements sessionHandle = Session handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value boundingBox = struct(rect-left,rect-right,rect-top,rect-bottom) rect-left = covered area on the left. Range [0:1] rect-right = covered area on the right. Range [0:1] rect-top = covered area on top. Range [0:1] rect-bottom = covered area at the bottom. Range [0:1] Note: 0.0 means there is no covered area (offset) from that side When all four parameters are 0 then the save area is equal to the viewport area (being the default) SetMapViewSaveArea = This methods defines the area that the HMI guarantees not to cover with other windows or user interface elements mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value boundingBox = struct(rect-left,rect-right,rect-top,rect-bottom) rect-left = covered area on the left. Range [0:1] rect-right = covered area on the right. Range [0:1] rect-top = covered area on top. Range [0:1] rect-bottom = covered area at the bottom. Range [0:1] Note: 0.0 means there is no covered area (offset) from that side When all four parameters are 0 then the save area is equal to the viewport area (being the default) MapViewSaveAreaChanged = This signal is emitted when the area that the HMI guarantees not to cover with other windows or user interface elements chnages mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value boundingBox = struct(rect-left,rect-right,rect-top,rect-bottom) rect-left = covered area on the left. Range [0:1] rect-right = covered area on the right. Range [0:1] rect-top = covered area on top. Range [0:1] rect-bottom = covered area at the bottom. Range [0:1] Note: 0.0 means there is no covered area (offset) from that side When all four parameters are 0 then the save area is equal to the viewport area (being the default) SetMapViewPan = This method pans a given map instance sessionHandle = Session handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value panningAction = enum(PAN_START,PAN_TO,PAN_END) PAN_START, start panning the map at the specified screen coordinate identified by the arguments 'x' and 'y' PAN_TO, pan the map to the specified screen coordinate identified by the arguments 'x' and 'y'; it has no effect before PAN_START or after PAN_END PAN_END, pan the map to the specified screen coordinate identified by the arguments 'x' and 'y' and end panning; it has no effect before PAN_START pixelCoordinates = struct(x,y) x = x-coordinate (x=0 indicates the first left pixel of the map view) y = y-coordinate (y=0 indicates the first top pixel of the map view) GetMapViewPan This method is meant for debugging purposes mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value valueToReturn = enum(PAN_START,PAN_TO,PAN_END) pixelCoordinates = struct(x,y) x = x-coordinate (x=0 indicates the first left pixel of the map view) y = y-coordinate (y=0 indicates the first top pixel of the map view) MapViewRotateBegin = MapViewRotateBegin = Begin a rotation gesture. sessionHandle (of type Handle) = sessionHandle = Session handle. lineComment to be defined mapViewInstanceHandle (of type Handle) = mapViewInstanceHandle = Map instance handle. lineComment to be defined anchorPoint (of type Pixel) = anchorPoint = Specifies coordinates in pixels on the screen where the gesture is anchored. Pixel struct[x, y] = struct generated for DBus argument SetMapViewPan_pixelCoordinates 0: Pixel.x ('q') = Description missing 1: Pixel.y ('q') = Description missing MapViewRotateUpdate = MapViewRotateUpdate = Provide an update for the rotation gesture. sessionHandle (of type Handle) = sessionHandle = Session handle. lineComment to be defined mapViewInstanceHandle (of type Handle) = mapViewInstanceHandle = Map instance handle. lineComment to be defined anchorPoint (of type Pixel) = anchorPoint = Specifies coordinates in pixels on the screen where the gesture is anchored. Pixel struct[x, y] = struct generated for DBus argument SetMapViewPan_pixelCoordinates 0: Pixel.x ('q') = Description missing 1: Pixel.y ('q') = Description missing rotationAngle = rotationAngle = The rotation angle in degrees. Range [-179: 180]. Positive (negative) value should result in clockwise (counterclockwise) rotation. MapViewRotateEnd = MapViewRotateEnd = End the rotation gesture. sessionHandle (of type Handle) = sessionHandle = Session handle. lineComment to be defined mapViewInstanceHandle (of type Handle) = mapViewInstanceHandle = Map instance handle. lineComment to be defined velocity = velocity = The remaining velocity of rotation, in degrees per second. MapViewPinchBegin = MapViewPinchBegin = Begin a pinch gesture. sessionHandle (of type Handle) = sessionHandle = Session handle. lineComment to be defined mapViewInstanceHandle (of type Handle) = mapViewInstanceHandle = Map instance handle. lineComment to be defined anchorPoint (of type Pixel) = anchorPoint = Specifies coordinates in pixels on the screen where the gesture is anchored. Pixel struct[x, y] = struct generated for DBus argument SetMapViewPan_pixelCoordinates 0: Pixel.x ('q') = Description missing 1: Pixel.y ('q') = Description missing MapViewPinchUpdate = MapViewPinchUpdate = Provide an update for the pinch gesture. sessionHandle (of type Handle) = sessionHandle = Session handle. lineComment to be defined mapViewInstanceHandle (of type Handle) = mapViewInstanceHandle = Map instance handle. lineComment to be defined anchorPoint (of type Pixel) = anchorPoint = Specifies coordinates in pixels on the screen where the gesture is anchored. Pixel struct[x, y] = struct generated for DBus argument SetMapViewPan_pixelCoordinates 0: Pixel.x ('q') = Description missing 1: Pixel.y ('q') = Description missing scaleFactor = scaleFactor = Scale factor relative to the scale during mapViewPinchBegin call MapViewPinchEnd = MapViewPinchEnd = End the pinch gesture. sessionHandle (of type Handle) = sessionHandle = Session handle. lineComment to be defined mapViewInstanceHandle (of type Handle) = mapViewInstanceHandle = Map instance handle. lineComment to be defined velocity = velocity = The remaining velocity of scale, in scale factor per second. MapViewTiltBegin = MapViewTiltBegin = Begin a tilt gesture. sessionHandle (of type Handle) = sessionHandle = Session handle. lineComment to be defined mapViewInstanceHandle (of type Handle) = mapViewInstanceHandle = Map instance handle. lineComment to be defined anchorPoint (of type Pixel) = anchorPoint = Specifies coordinates in pixels on the screen where the gesture is started. Pixel struct[x, y] = struct generated for DBus argument SetMapViewPan_pixelCoordinates 0: Pixel.x ('q') = Description missing 1: Pixel.y ('q') = Description missing MapViewTiltUpdate = MapViewTiltUpdate = Provide an update for the tilt gesture. sessionHandle (of type Handle) = sessionHandle = Session handle. lineComment to be defined mapViewInstanceHandle (of type Handle) = mapViewInstanceHandle = Map instance handle. lineComment to be defined translation = scale = Current translation on y axis, in pixels from origin coordinates passed in mapViewTiltBegin. MapViewTiltEnd = MapViewTiltEnd = End the tilt gesture. sessionHandle (of type Handle) = sessionHandle = Session handle. lineComment to be defined mapViewInstanceHandle (of type Handle) = mapViewInstanceHandle = Map instance handle. lineComment to be defined velocity = velocity = The remaining velocity on the y axis, in pixels per second. SetMapViewRotation = This method rotates the map sessionHandle = Session handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value rotationAngle = rotation angle in degrees measured from the North axis clockwise. Range[0:360] rotationAnglePerSecond = partial rotation for each second The value can be set implement a smooth rotation If rotationAnglePerSecond = rotationAngle it means that the rotation must be instantaneous GetMapViewRotation = This method is particularly interesting for debugging purposes mapViewInstanceHandle (of type Handle) = mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value lineComment to be defined rotationAngle = rotationAngle = rotation angle in degrees measured from the North axis clockwise if possitive or counter clockwise if negative. Range[-179:180]. rotationAnglePerSecond = rotationAnglePerSecond = partial rotation angle per second SetMapViewVisibilityMode = This method sets the current visibility mode sessionHandle = Session handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value visibilityMode = enum(INVALID,VISIBLE,INVISIBLE,FROZEN, ... ) GetMapViewVisibilityMode = This method returns the current visibility mode mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value visibilityMode = enum(INVALID,VISIBLE,INVISIBLE,FROZEN, ... ) GetSupportedMapViewVisibilityModes = This method retrieves the supported mapview visibility modes visibilityModeList = array[visibilityMode] visibilityMode = enum(INVALID,VISIBLE,INVISIBLE,FROZEN, ... ) MapViewVisibilityChanged = This signal is emitted when the MapView visibility changes mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value visibilityMode = enum(INVALID,VISIBLE,INVISIBLE,FROZEN, ... ) SetMapViewPerformanceLevel = This method sets the perfomance level of a given map instance Note: it can be used to set the MapView in application specific performance mode (e.g. low CPU-usage or low memory-usage) sessionHandle = Session handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value performanceLevel = enum(INVALID,LEVEL1,LEVEL2,LEVEL3,LEVEL4,LEVEL5, ... ) Note: performance levels are application specific GetMapViewPerformanceLevel = This method returns the perfomance level of a given map instance mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value performanceLevel = enum(INVALID,LEVEL1,LEVEL2,LEVEL3,LEVEL4,LEVEL5, ... ) MapViewPerformanceLevelChanged = This signal is emitted when the perfomance level of a map instance changes mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value performanceLevel = enum(INVALID,LEVEL1,LEVEL2,LEVEL3,LEVEL4,LEVEL5, ... ) GetSupportedMapViewPerformanceLevels = This method retrieves the supported perfomance levels performanceLevelList = array[performanceLevel] performanceLevel = enum(INVALID,LEVEL1,LEVEL2,LEVEL3,LEVEL4,LEVEL5, ... ) DisplayRoute = This method visualizes one of the calculated routes sessionHandle = Session handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value routeHandle = Route handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value highlighted = flag. TRUE means highligted,FALSE means not highlighted Note: the highlighted route must be visualized on top of the other routes HideRoute = This method hides one of the visible routes sessionHandle = Session handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value routeHandle = Route handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value Note: the routeHandle has to be one of the visible routes GetDisplayedRoutes = This method returns a list of displayed routes mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value displayedRoutes = array[struct(routeHandle,highlighted)] routeHandle = Route handle of a displayed route. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value highlighted = flag. TRUE means highlighted,FALSE means not highlighted DisplayedRoutes = This signal is emitted when the list of displayed routes change mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value displayedRoutes = array[struct(routeHandle,highlighted)] routeHandle = Route handle of a displayed route. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value highlighted = flag. TRUE means highlighted,FALSE means not highlighted GetPoiCategoriesVisible = Get the set of POI categories displayed on the map. mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value poiCategoryIds = array[poiCategoryId] poiCategoryId = a POI category as defined in the 'GENIVI POIService API'. SetPoiCategoriesVisible = Add POI categories to the set of POI categories displayed on the map. Any specified category that until now was displayed with scale limits is now displayed without limits. sessionHandle = Session handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value poiCategoryIds = array[poiCategoryId] poiCategoryId = a POI category as defined in the 'GENIVI POIService API'. SetPoiCategoriesVisible = Add POI categories to the set of POI categories displayed on the map, where the POI's are only displayed in a specific range of scales. Any specified category that until now was displayed without scale limits is now displayed with limits. sessionHandle = Session handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value poiCategoryIds = array[poiCategoryId] poiCategoryId = a POI category as defined in the 'GENIVI POIService API'. minScaleID = minimun scale on which the POI categories are displayed maxScaleID = maximum scale on which the POI categories are displayed SetPoiCategoriesNotVisible = Remove POI categories from the set of POI categories displayed on the map. sessionHandle = Session handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value poiCategoryIds = array[poiCategoryId] poiCategoryId = a POI category as defined in the 'GENIVI POIService API'. PoiCategoriesVisibilityChanged = This signal is emitted when the visibility of POI categories on a map instance changes mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value poiCategoryIds = array[poiCategoryVisibility] poiCategoryVisibility = struct{poiCategoryId,visible,minScaleID,maxScaleID} poiCategoryId = a POI category as defined in the 'GENIVI POIService API'. visible = flag. TRUE means that the POI categories are visible minScaleID = minimun scale on which the POI categories are displayed maxScaleID = maximum scale on which the POI categories are displayed SetTrafficIncidentsVisibility = Set the visibility of Traffic Incidents on the map. sessionHandle = Session handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value visible = If true, Traffic Incidents are shown on the map, else they are not shown. SetMapViewTheme = This method configures the theme of a given map view instance sessionHandle = Session handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value mapViewTheme = enum(INVALID,THEME_1,THEME_2,THEME_3, ... ) Note: Themes are implementation specific. Example: THEME_1 = day color, THEME_2 = night color GetMapViewTheme = This method returns the current theme of a given map view instance mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value mapViewTheme = enum(INVALID,THEME_1,THEME_2,THEME_3, ... ) Note: Themes are implementation specific. Example: THEME_1 = day color, THEME_2 = night color MapViewThemeChanged = This signal is emitted when the theme of a map view instance changes mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value mapViewTheme = enum(INVALID,THEME_1,THEME_2,THEME_3, ... ) Note: Themes are implementation specific. Example: THEME_1 = day color, THEME_2 = night color GetSupportedMapViewThemes = This method retrieves the supported mapview themes mapViewThemeList = array[mapViewTheme] mapViewTheme = enum(INVALID,THEME_1,THEME_2,THEME_3, ... ) Note: Themes are implementation specific. Example: THEME_1 = day color, THEME_2 = night color ConvertPixelCoordsToGeoCoords = This method converts pixel coordinates to geographical coordinates sessionHandle = Session handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value pixelCoordinates = array[struct(x,y)] x = x-coordinate (x=0 indicates the first left pixel of the map view) y = y-coordinate (y=0 indicates the first top pixel of the map view) geoCoordinates = array[struct(lat,lon)] lat = latitude in format %3.6f. Range[-90:+90] lon = longitude in format %3.6f. Range[-180:+180] ConvertGeoCoordsToPixelCoords = This method converts geographical coordinates into pixel coordinates sessionHandle = Session handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value geoCoordinates = array[struct(lat,lon)] lat = latitude in format %3.6f. Range[-90:+90] lon = longitude in format %3.6f. Range[-180:+180] pixelCoordinates = array[struct(x,y)] x = x-coordinate (x=0 indicates the first left pixel of the map view) y = y-coordinate (y=0 indicates the first top pixel of the map view) DisplayCustomElements = This method visualizes a set of custom elements on the map sessionHandle = Session handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value customElements = array[struct(name,iconUri,coordinate,anchorPoint)] name = name of the custom element iconUri = uri to the icon of the custome element coordinate = struct(lat,lon) lat = latitude in format %3.6f. Range[-90:+90]. Example: 48.053250 lon = longitude in format %3.6f. Range[-180:+180]. Example: 8.321000 anchorPoint=struct(anchorX,anchorY) anchorPoint defines which point on the icon is used as the reference for associating the icon to the map coordinate (0,0) is the center of the icon (-1,-1) is the top left corner of the icon (1,1) is the bottom right corner of the icon anchorX = anchor x value anchorY = anchor y value customElementHandles = handles to the custom elements displayed on the map. The order of the handles is the same as the order of custom elements specified in the argument 'customElements'. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value HideCustomElements = This method hides a set of custom elements which were visualized by DisplayCustomElements sessionHandle = Session handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value customElementHandles = Custom element handles. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value GetDisplayedCustomElements = This method retrieves the visualized custom elements on the map mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value customElements = array[customElement] customElement = tuple[customElementHandle,struct(name,iconUri,coordinate,anchorPoint)] customElementHandle = Custom element handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value name = name of the custom element iconUri = uri to the icon of the custome element coordinate = struct(lat,lon) lat = latitude in format %3.6f. Range[-90:+90]. Example: 48.053250 lon = longitude in format %3.6f. Range[-180:+180]. Example: 8.321000 anchorPoint=struct(anchorX,anchorY) anchorPoint defines which point on the icon is used as the reference for associating the icon to the map coordinate (0,0) is the center of the icon (-1,-1) is the top left corner of the icon (1,1) is the bottom right corner of the icon anchorX = anchor x value anchorY = anchor y value SelectElementsOnMap = This method selects elements on the map view which are at the position specified by user input mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value pixelCoordinates = struct(x,y) x = x-coordinate of the position on the map view specified by user input (x=0 indicates the first left pixel of the map view) y = y-coordinate of the position on the map view specified by user input (y=0 indicates the first top pixel of the map view) selectableTypes = array[selectableType] selectableType = enum(INVALID,CUSTOM_ELEMENT,CURRENT_POSITION,WAYPOINT,POI,TRAFFIC_INCIDENT,ROUTE,GEOCOORDINATES) Note: The order of priority by which the elements are selected is implementation dependent maxNumberOfSelectedElements = maximum number of selected elements to return. If 0, all possible elements which can be selected will be returned selectedElements = array[selectableType,struct(lat,lon),value] selectableType = enum(INVALID,CUSTOM_ELEMENT,CURRENT_POSITION,WAYPOINT,POI,TRAFFIC_INCIDENT,ROUTE,GEOCOORDINATES) lat = latitude of the selected element in format %3.6f. Range[-90:+90] lon = longitude of the selected element in format %3.6f. Range[-180:+180] selectableType = CUSTOM_ELEMENT, value = value of type '(uss(nn))' that expresses the extra data for a custom element Note: the extra data for a custom element is expressed as a struct(customElementHandle,name,iconUri,struct(anchorX,anchorY)) selectableType = CURRENT_POSITION, value = null selectableType = WAYPOINT, value = value of type '(uq)' that expresses the extra data for a waypoint Note: the extra data for a waypoint is expressed as a struct(routeHandle,waypointIndex) where waypointIndex is the index of the waypoint on the route (the first waypoint is index 0) selectableType = POI, value = value of type 'u' that expresses a POI handle selectableType = TRAFFIC_INCIDENT, value = value of type 'i' that expresses a traffic incident identifier selectableType = ROUTE, value = value of type 'u' that expresses a route handle selectableType = GEOCOORDINATES, value = null MapViewRotated = This signal is emitted when the rotation is achieved This signal is meant for debugging purposes mapViewInstanceHandle = Map instance handle. Range[0x0:0x7fffffff]. 0x0 is reserved as an invalid handle value