addPlaceID:imageURL:data:position:

- (BOOL) addPlaceID:		(NSString *_Nonnull)	placeID
imageURL:		(NSURL *_Nullable)	imageURL
data:		(NSDictionary *_Nullable)	data
position:		(VMEPosition *_Nonnull)	position

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

Returns

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

Note

When using this method, the other properties of the object are initialized to appropriate values:

• size is set to 20.0
• anchorMode is set to VMEPlaceAnchorModeBottomCenter
• altitudeMode is set to VMEPlaceAltitudeModeAbsolute
• displayMode is set to VMEPlaceDisplayModeOverlay
• orientation is set using [VMEPlaceOrientation placeOrientationFacing]
• visibilityRamp is set using [[VMEPlaceVisibilityRamp alloc] init]]

See also

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

Note

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];
 ];

Version

1.1