addPlaceID:imageURL:data:position:size:anchorMode:altitudeMode:displayMode:orientation:visibilityRamp:

- (BOOL) addPlaceID:		(NSString *_Nonnull)	placeID
imageURL:		(NSURL *_Nullable)	imageURL
data:		(NSDictionary *_Nullable)	data
position:		(VMEPosition *_Nonnull)	position
size:		(VMEPlaceSize *_Nullable)	size
anchorMode:		(VMEPlaceAnchorMode)	anchorMode
altitudeMode:		(VMEPlaceAltitudeMode)	altitudeMode
displayMode:		(VMEPlaceDisplayMode)	displayMode
orientation:		(VMEPlaceOrientation *_Nullable)	orientation
visibilityRamp:		(VMEPlaceVisibilityRamp *_Nullable)	visibilityRamp

Adds a dynamic place to the map.

Parameters

placeID	The ID of the place. If the ID corresponds to an existing dynamic place, then it will be replaced. If the ID corresponds with a static place ID, then this call will fail.
imageURL	A URL that references an image that will be used to represent the place within the map. Secure http (i.e. https) is not currently supported.
data	A data object for populating the place information. For the expected format, please see Place data format.
position	The place's position within the map
size	Controls the place's size
anchorMode	Determines how the place will be anchored to the map.
altitudeMode	Determines how to interpret the altitude attribute of the position parameter.
displayMode	Determines how the place is displayed
orientation	Controls the place's orientation
visibilityRamp	Controls the place's visibility

Returns

YES if the place was successfully added to the map, otherwise NO.

Note

Will only work if called during or after the mapDidLoad: (VMELifeCycleListener-p) method. It will not work if called within the mapDidInitializeEngine: (VMELifeCycleListener-p).

Applies to:

• dynamic places

Example

VMEPosition* lPos = [[VMEPosition alloc] initWithLatitude:45.74131
                                                longitude:4.88216
                                                 altitude:0.0
                                               buildingID:nil
                                                  floorID:nil];
 
NSDictionary *placeData = [NSDictionary dictionaryWithObjectsAndKeys:
                           @"Cat tracker", @"name",
                           @"https://en.wikipedia.org/wiki/Cat", @"description",
                           @"http://www.clipartbest.com/cliparts/aTe/K4e/aTeK4en8c.png", @"icon",
                           @[@"2", @"3", @"99"], @"categories",
                           nil];
 
NSURL* lIconUrl = [NSURL URLWithString:@"http://www.clipartbest.com/cliparts/aTe/K4e/aTeK4en8c.png"];
 
[self.mapView addPlaceID:@"cat_tracker_id"
                imageURL:lIconUrl
                    data:placeData
                position:lPos
                    size:[[VMEPlaceSize alloc] initWithScale:50.0]
              anchorMode:VMEPlaceAnchorModeBottomCenter
            altitudeMode:VMEPlaceAltitudeModeRelative
             displayMode:VMEPlaceDisplayModeOverlay
             orientation:[VMEPlaceOrientation placeOrientationFacing]
          visibilityRamp:[[VMEPlaceVisibilityRamp alloc] init]
 ];

Version

1.1