Tizen Native API

This provides APIs related to Place Media information, used in Place Discovery and Search.

Functions

int maps_place_media_destroy (maps_place_media_h media)
 Destroys the place media handle and releases all its resources.
int maps_place_media_clone (const maps_place_media_h origin, maps_place_media_h *cloned)
 Clones the place media handle.
int maps_place_media_get_attribution (const maps_place_media_h media, char **attribution)
 Gets the place media attribution.
int maps_place_media_get_supplier (const maps_place_media_h media, maps_place_link_object_h *supplier)
 Gets the place media supplier link.
int maps_place_media_get_via (const maps_place_media_h media, maps_place_link_object_h *via)
 Gets the place media "via" link.

Typedefs

typedef void * maps_place_media_h
 The Place Media handle.

Typedef Documentation

typedef void* maps_place_media_h

The Place Media handle.

The handle of Place Media instance.

Remarks:
To release the handle use maps_place_media_destroy().
To clone the handle use maps_place_media_clone().
Since :
2.3.2
See also:
maps_place_media_destroy()
maps_place_media_clone()

Function Documentation

int maps_place_media_clone ( const maps_place_media_h  origin,
maps_place_media_h cloned 
)

Clones the place media handle.

This function clones the place media handle origin and all its resources.

Since :
2.3.2
Remarks:
cloned must be released using maps_place_media_destroy().
Parameters:
[in]originThe original place media handle
[out]clonedA cloned place media handle
Returns:
0 on success, otherwise a negative error value
Return values:
MAPS_ERROR_NONESuccessful
MAPS_ERROR_OUT_OF_MEMORYOut of memory
MAPS_ERROR_INVALID_PARAMETERInvalid parameter
MAPS_ERROR_NOT_SUPPORTEDNot supported
See also:
maps_place_media_destroy()

Destroys the place media handle and releases all its resources.

This function destroys the place media handle and releases all its resources.

Since :
2.3.2
Parameters:
[in]mediaThe place media handle to destroy
Returns:
0 on success, otherwise a negative error value
Return values:
MAPS_ERROR_NONESuccessful
MAPS_ERROR_INVALID_PARAMETERInvalid parameter
MAPS_ERROR_NOT_SUPPORTEDNot supported
See also:
maps_place_media_clone()
int maps_place_media_get_attribution ( const maps_place_media_h  media,
char **  attribution 
)

Gets the place media attribution.

This function gets the place media attribution.

Since :
2.3.2
Remarks:
attribution must be released using free().
Parameters:
[in]mediaThe handle of place media
[out]attributionThe place media attribution
Returns:
0 on success, otherwise a negative error value
Return values:
MAPS_ERROR_NONESuccessful
MAPS_ERROR_INVALID_PARAMETERInvalid parameter
MAPS_ERROR_NOT_SUPPORTEDNot supported

Gets the place media supplier link.

This function gets the place media supplier link.

Since :
2.3.2
Remarks:
supplier must be released using maps_place_link_object_destroy().
Parameters:
[in]mediaThe handle of place media
[out]supplierThe place media supplier link
Returns:
0 on success, otherwise a negative error value
Return values:
MAPS_ERROR_NONESuccessful
MAPS_ERROR_INVALID_PARAMETERInvalid parameter
MAPS_ERROR_NOT_SUPPORTEDNot supported
See also:
maps_place_link_object_h

Gets the place media "via" link.

This function gets the place media "via" link.

Since :
2.3.2
Remarks:
via must be released using maps_place_link_object_destroy().
Parameters:
[in]mediaThe handle of place media
[out]viaThe place media via link
Returns:
0 on success, otherwise a negative error value
Return values:
MAPS_ERROR_NONESuccessful
MAPS_ERROR_INVALID_PARAMETERInvalid parameter
MAPS_ERROR_NOT_SUPPORTEDNot supported
See also:
maps_place_link_object_h