camera_set_geolocation()

Set or clear the geolocation data for photo metadata.

Synopsis:

#include <camera/camera_api.h>

camera_error_t camera_set_geolocation(camera_handle_t handle,                 
                                      double latitude,                 
                                      double longitude,                 
                                      double altitude,                 
                                      bool valid)

Since:

BlackBerry 10.0.0

Arguments:

handle: The handle returned by a call to the camera_open() function.

latitude: The desired latitude in degrees.

longitude: The desired longitude in degrees.

altitude: The desired altitude in meters.

valid: A flag that sets or clears the geolocation data. Set to true to set the data, set to false to clear the data.

Library:

libcamapi (For the qcc command, use the -l camapi option to link against this library)

Description:

Use this function to add or remove geolocation metadata to your images. The geolocation metadata will persist until you close the camera.

Returns:

CAMERA_EOK when the function successfully completes, otherwise another camera_error_t value that provides the reason that the call failed.