Tizen Native API  5.5
Preference

This provides enumerations of Maps API preferences. The Preferences are organized as a key-value table where available Preference keys are following strings: * Place search preferences.

Functions

int maps_preference_create (maps_preference_h *preference)
 Creates a new maps preference handle.
int maps_preference_destroy (maps_preference_h preference)
 Destroys the maps preference handle and releases all its resources.
int maps_preference_clone (const maps_preference_h origin, maps_preference_h *cloned)
 Clones the maps preference handle.
int maps_preference_get_distance_unit (const maps_preference_h preference, maps_distance_unit_e *unit)
 Gets the distance unit.
int maps_preference_get_language (const maps_preference_h preference, char **language)
 Gets the language.
int maps_preference_get_max_results (const maps_preference_h preference, int *max_results)
 Gets the max amount of results.
int maps_preference_get_country_code (const maps_preference_h preference, char **country_code)
 Gets the country code.
int maps_preference_get_route_optimization (const maps_preference_h preference, maps_route_optimization_e *optimization)
 Gets the route optimization.
int maps_preference_get_route_transport_mode (const maps_preference_h preference, maps_route_transport_mode_e *transport_mode)
 Gets the route transport mode.
int maps_preference_get_route_feature_weight (const maps_preference_h preference, maps_route_feature_weight_e *feature_weight)
 Gets the route feature weight.
int maps_preference_get_route_feature (const maps_preference_h preference, maps_route_feature_e *feature)
 Gets the route feature.
int maps_preference_get_route_alternatives_enabled (const maps_preference_h preference, bool *enable)
 Gets the enable status of alternative routes.
int maps_preference_get (const maps_preference_h preference, const char *key, char **value)
 Gets the maps preference value by key.
int maps_preference_foreach_property (const maps_preference_h preference, maps_preference_properties_cb callback, void *user_data)
 Retrieves all maps properties.
int maps_preference_set_distance_unit (maps_preference_h preference, const maps_distance_unit_e unit)
 Sets the maps distance unit.
int maps_preference_set_language (maps_preference_h preference, const char *language)
 Sets the maps language.
int maps_preference_set_max_results (maps_preference_h preference, const int max_results)
 Sets the max amount of results.
int maps_preference_set_country_code (maps_preference_h preference, const char *country_code)
 Sets the maps country code.
int maps_preference_set_route_optimization (maps_preference_h preference, const maps_route_optimization_e optimization)
 Sets the route optimization.
int maps_preference_set_route_transport_mode (maps_preference_h preference, const maps_route_transport_mode_e transport_mode)
 Sets the route transport mode.
int maps_preference_set_route_feature_weight (maps_preference_h preference, const maps_route_feature_weight_e feature_weight)
 Sets the route feature weight.
int maps_preference_set_route_feature (maps_preference_h preference, const maps_route_feature_e feature)
 Sets the route feature.
int maps_preference_set_route_alternatives_enabled (maps_preference_h preference, bool enable)
 Sets the enable status of alternative routes.
int maps_preference_set_property (maps_preference_h preference, const char *key, const char *value)
 Sets the preference value by key.

Typedefs

typedef void * maps_preference_h
 The Maps Preference handle.
typedef enum _maps_distance_unit_e maps_distance_unit_e
 Enumeration for allowed distance units.
typedef enum
_maps_route_optimization_e 
maps_route_optimization_e
 Enumeration for allowed route optimization option.
typedef enum
_maps_route_transport_mode_e 
maps_route_transport_mode_e
 Enumeration for preferable route types.
typedef enum
_maps_route_feature_weight_e 
maps_route_feature_weight_e
 Enumeration for route feature weights.
typedef enum
_maps_route_request_feature_e 
maps_route_feature_e
 Enumeration for route features.
typedef bool(* maps_preference_properties_cb )(int index, int total, char *key, char *value, void *user_data)
 Called when requesting the list of Maps Properties.

Defines

#define MAPS_PLACE_FILTER_TYPE   "MAPS_PLACE_FILTER_TYPE"
 Definition for the name of the preference indicating place type while searching the place.
#define MAPS_PLACE_FILTER_SORT_BY   "MAPS_PLACE_FILTER_SORT_BY"
 Definition for the name of the preference indicating sorting key while searching the place.
#define MAPS_ROUTE_FREEFORM_ADDR_TO_AVOID   "MAPS_ROUTE_FREEFORM_ADDR_TO_AVOID"
 Definition for the name of the preference indicating free-form address to avoid while computing the route.
#define MAPS_ROUTE_STRUCTED_ADDR_TO_AVOID   "MAPS_ROUTE_STRUCTED_ADDR_TO_AVOID"
 Definition for the name of the preference indicating structured address to avoid while computing the route.
#define MAPS_ROUTE_CIRCLE_AREA_TO_AVOID   "MAPS_ROUTE_CIRCLE_AREA_TO_AVOID"
 Definition for the name of the preference indicating circular geographical area to avoid while computing the route.
#define MAPS_ROUTE_RECT_AREA_TO_AVOID   "MAPS_ROUTE_RECT_AREA_TO_AVOID"
 Definition for the name of the preference indicating rectangular geographical area to avoid while computing the route.
#define MAPS_ROUTE_GEOMETRY_BOUNDING_BOX   "MAPS_ROUTE_GEOMETRY_BOUNDING_BOX"
 Definition for the name of the preference indicating that route should be computed within a specified bounding box.
#define MAPS_ROUTE_GEOMETRY_RETRIEVAL   "MAPS_ROUTE_GEOMETRY_RETRIEVAL"
 Definition for the name of the preference indicating that geometry parameters should be retrieved while route processing.
#define MAPS_ROUTE_INSTRUCTION_GEOMETRY   "MAPS_ROUTE_INSTRUCTION_GEOMETRY"
 Definition for the name of the preference indicating that route should be computed with geometry instructions.
#define MAPS_ROUTE_INSTRUCTION_BOUNDING_BOX   "MAPS_ROUTE_INSTRUCTION_BOUNDING_BOX"
 Definition for the name of the preference indicating that route should be computed with bounding box instructions.
#define MAPS_ROUTE_INSTRUCTION_RETRIEVAL   "MAPS_ROUTE_INSTRUCTION_RETRIEVAL"
 Definition for the name of the preference indicating that route should be computed correspondingly to retrieval instructions.
#define MAPS_ROUTE_REALTIME_TRAFFIC   "MAPS_ROUTE_REALTIME_TRAFFIC"
 Definition for the name of the preference indicating that route should be computed in accordance to real time traffic.

Define Documentation

#define MAPS_PLACE_FILTER_SORT_BY   "MAPS_PLACE_FILTER_SORT_BY"

Definition for the name of the preference indicating sorting key while searching the place.

Since :
2.4
#define MAPS_PLACE_FILTER_TYPE   "MAPS_PLACE_FILTER_TYPE"

Definition for the name of the preference indicating place type while searching the place.

Since :
2.4
#define MAPS_ROUTE_CIRCLE_AREA_TO_AVOID   "MAPS_ROUTE_CIRCLE_AREA_TO_AVOID"

Definition for the name of the preference indicating circular geographical area to avoid while computing the route.

Since :
2.4
#define MAPS_ROUTE_FREEFORM_ADDR_TO_AVOID   "MAPS_ROUTE_FREEFORM_ADDR_TO_AVOID"

Definition for the name of the preference indicating free-form address to avoid while computing the route.

Since :
2.4
#define MAPS_ROUTE_GEOMETRY_BOUNDING_BOX   "MAPS_ROUTE_GEOMETRY_BOUNDING_BOX"

Definition for the name of the preference indicating that route should be computed within a specified bounding box.

Since :
2.4
#define MAPS_ROUTE_GEOMETRY_RETRIEVAL   "MAPS_ROUTE_GEOMETRY_RETRIEVAL"

Definition for the name of the preference indicating that geometry parameters should be retrieved while route processing.

Since :
2.4
#define MAPS_ROUTE_INSTRUCTION_BOUNDING_BOX   "MAPS_ROUTE_INSTRUCTION_BOUNDING_BOX"

Definition for the name of the preference indicating that route should be computed with bounding box instructions.

Since :
2.4
#define MAPS_ROUTE_INSTRUCTION_GEOMETRY   "MAPS_ROUTE_INSTRUCTION_GEOMETRY"

Definition for the name of the preference indicating that route should be computed with geometry instructions.

Since :
2.4
#define MAPS_ROUTE_INSTRUCTION_RETRIEVAL   "MAPS_ROUTE_INSTRUCTION_RETRIEVAL"

Definition for the name of the preference indicating that route should be computed correspondingly to retrieval instructions.

Since :
2.4
#define MAPS_ROUTE_REALTIME_TRAFFIC   "MAPS_ROUTE_REALTIME_TRAFFIC"

Definition for the name of the preference indicating that route should be computed in accordance to real time traffic.

Since :
2.4
Remarks:
To enable realtime traffic, set the value to "true". Otherwise, set it to "false".
#define MAPS_ROUTE_RECT_AREA_TO_AVOID   "MAPS_ROUTE_RECT_AREA_TO_AVOID"

Definition for the name of the preference indicating rectangular geographical area to avoid while computing the route.

Since :
2.4
Remarks:
The values are consist of top-left and bottom-right geo-coordinates, and comma or semicolon are used to delimit each value.
Format : {top-left latitude};{top-left longitude};{bottom-right latitude};{bottom-right longitude}
Example : "37.125;127.0572;37.37.102;127.0672"
#define MAPS_ROUTE_STRUCTED_ADDR_TO_AVOID   "MAPS_ROUTE_STRUCTED_ADDR_TO_AVOID"

Definition for the name of the preference indicating structured address to avoid while computing the route.

Since :
2.4

Typedef Documentation

Enumeration for allowed distance units.

This enumeration represents allowed distance units used in Maps Services.

Since :
2.4
See also:
maps_preference_h
typedef void* maps_preference_h

The Maps Preference handle.

The Maps Preference handle can be obtained via call of maps_preference_create().
To release the handle use maps_preference_destroy().
To clone the handle use maps_preference_clone().

Since :
2.4
See also:
maps_preference_create()
maps_preference_destroy()
maps_preference_clone()
typedef bool(* maps_preference_properties_cb)(int index, int total, char *key, char *value, void *user_data)

Called when requesting the list of Maps Properties.

This callback is invoked while iterating through the list of Maps Properties.

Since :
2.4
Remarks:
key and value must be released using free() and corresponding release method for property value correspondingly.
Parameters:
[in]indexThe current index of property
[in]totalThe total amount of properties
[in]keyThe key of property
[in]valueThe value of property
[in]user_dataThe user data passed from maps_preference_foreach_property()
Returns:
true to continue with the next iteration of the loop,
false to break out of the loop
Precondition:
maps_preference_foreach_property() will invoke this callback.
See also:
maps_preference_foreach_property()

Enumeration for route features.

This enumeration represents allowed route features used in Route Service.

Since :
2.4
See also:
_maps_distance_unit_e
_maps_route_transport_mode_e
_maps_route_feature_weight_e

Enumeration for route feature weights.

This enumeration represents allowed route feature weights used in Route Service.

Since :
2.4
See also:
_maps_distance_unit_e
_maps_route_transport_mode_e
_maps_route_request_feature_e

Enumeration for allowed route optimization option.

This enumeration represents allowed route optimization option used in Route Service.

Since :
2.4
See also:
_maps_route_transport_mode_e
_maps_route_feature_weight_e
_maps_route_request_feature_e

Enumeration for preferable route types.

This enumeration represents allowed route types used in Route Service.

Since :
2.4
See also:
_maps_distance_unit_e
_maps_route_feature_weight_e
_maps_route_request_feature_e

Enumeration Type Documentation

Enumeration for allowed distance units.

This enumeration represents allowed distance units used in Maps Services.

Since :
2.4
See also:
maps_preference_h
Enumerator:
MAPS_DISTANCE_UNIT_M 

for Meter

MAPS_DISTANCE_UNIT_KM 

for Kilometer

MAPS_DISTANCE_UNIT_FT 

for Foot

MAPS_DISTANCE_UNIT_YD 

for Yard

Enumeration for route feature weights.

This enumeration represents allowed route feature weights used in Route Service.

Since :
2.4
See also:
_maps_distance_unit_e
_maps_route_transport_mode_e
_maps_route_request_feature_e
Enumerator:
MAPS_ROUTE_FEATURE_WEIGHT_NORMAL 

Indicates normal weighting.

MAPS_ROUTE_FEATURE_WEIGHT_PREFER 

Indicates that a feature is preferred.

MAPS_ROUTE_FEATURE_WEIGHT_AVOID 

Indicates that a feature is to be avoided.

MAPS_ROUTE_FEATURE_WEIGHT_SOFTEXCLUDE 

Indicates that soft-exclude applies to the feature.

MAPS_ROUTE_FEATURE_WEIGHT_STRICTEXCLUDE 

Indicates that the feature is to be strictly excluded.

Enumeration for allowed route optimization option.

This enumeration represents allowed route optimization option used in Route Service.

Since :
2.4
See also:
_maps_route_transport_mode_e
_maps_route_feature_weight_e
_maps_route_request_feature_e
Enumerator:
MAPS_ROUTE_TYPE_FASTEST 

Indicates the fastest route

MAPS_ROUTE_TYPE_SHORTEST 

Indicates the shortest route (car mode only)

MAPS_ROUTE_TYPE_ECONOMIC 

Indicates the most economic route (car mode only)

MAPS_ROUTE_TYPE_SCENIC 

Indicates the most scenic route

MAPS_ROUTE_TYPE_FASTESTNOW 

Indicates the most fastest route now

MAPS_ROUTE_TYPE_DIRECTDRIVE 

Indicates direct drive

Enumeration for route features.

This enumeration represents allowed route features used in Route Service.

Since :
2.4
See also:
_maps_distance_unit_e
_maps_route_transport_mode_e
_maps_route_feature_weight_e
Enumerator:
MAPS_ROUTE_FEATURE_NO 

Indicates no route features (are selected).

MAPS_ROUTE_FEATURE_TOLL 

Indicates toll roads (toll gates/booths).

MAPS_ROUTE_FEATURE_MOTORWAY 

Indicates motorway.

MAPS_ROUTE_FEATURE_BOATFERRY 

Indicates a boat ferry.

MAPS_ROUTE_FEATURE_RAILFERRY 

Indicates rail (train) ferry.

MAPS_ROUTE_FEATURE_PUBLICTTRANSIT 

Indicates public transport.

MAPS_ROUTE_FEATURE_TUNNEL 

Indicates tunnel.

MAPS_ROUTE_FEATURE_DIRTROAD 

Indicates dirt road.

MAPS_ROUTE_FEATURE_PARKS 

Indicates park.

MAPS_ROUTE_FEATURE_HOVLANE 

Indicates a high-occupancy vehicle lane.

MAPS_ROUTE_FEATURE_STAIRS 

Indicates stairs.

Enumeration for preferable route types.

This enumeration represents allowed route types used in Route Service.

Since :
2.4
See also:
_maps_distance_unit_e
_maps_route_feature_weight_e
_maps_route_request_feature_e
Enumerator:
MAPS_ROUTE_TRANSPORT_MODE_CAR 

Indicates that the route is to be traveled by car.

MAPS_ROUTE_TRANSPORT_MODE_PEDESTRIAN 

Indicates that the route is for a pedestrian.

MAPS_ROUTE_TRANSPORT_MODE_BICYCLE 

Indicates that the route is for a cyclist.

MAPS_ROUTE_TRANSPORT_MODE_PUBLICTRANSIT 

Indicates that the route is to be traveled using public transport.

MAPS_ROUTE_TRANSPORT_MODE_TRUCK 

Indicates that the route is for a truck.


Function Documentation

int maps_preference_clone ( const maps_preference_h  origin,
maps_preference_h cloned 
)

Clones the maps preference handle.

This function clones the maps preference handle origin and all its resources.

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

Creates a new maps preference handle.

This function creates a new maps preference handle and allocates all needed resources.

Since :
2.4
Remarks:
preference must be released using maps_preference_destroy().
preference may be cloned using maps_preference_clone().
Parameters:
[out]preferenceA newly created preference handle
Returns:
0 on success, otherwise a negative error value
Return values:
MAPS_ERROR_NONESuccessful
MAPS_ERROR_INVALID_PARAMETERInvalid parameter
MAPS_ERROR_OUT_OF_MEMORYOut of memory
MAPS_ERROR_NOT_SUPPORTEDNot supported
See also:
maps_preference_destroy()
maps_preference_clone()

Destroys the maps preference handle and releases all its resources.

This function destroys the maps preference handle and releases all its resources.

Since :
2.4
Parameters:
[in]preferenceThe preference handle
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_preference_clone()
int maps_preference_foreach_property ( const maps_preference_h  preference,
maps_preference_properties_cb  callback,
void *  user_data 
)

Retrieves all maps properties.

This function retrieves all maps properties.

Since :
2.4
Remarks:
The properties will be delivered via maps_preference_properties_cb().
Parameters:
[in]preferenceThe preference handle
[in]callbackThe callback function to invoke
[in]user_dataThe user data to be passed to the callback function
Returns:
0 on success, otherwise a negative error value
Return values:
MAPS_ERROR_NONESuccessful
MAPS_ERROR_INVALID_PARAMETERInvalid parameter
MAPS_ERROR_NOT_FOUNDResult not found
MAPS_ERROR_NOT_SUPPORTEDNot supported
Postcondition:
This function invokes maps_preference_properties_cb() repeatedly to retrieve each property.
See also:
maps_preference_properties_cb()
int maps_preference_get ( const maps_preference_h  preference,
const char *  key,
char **  value 
)

Gets the maps preference value by key.

This function gets the maps preference value by key.

Since :
2.4
Remarks:
value must be released using free().
Parameters:
[in]preferenceThe preference handle
[in]keyThe preference key
[out]valueThe preference value
Returns:
0 on success, otherwise a negative error value
Return values:
MAPS_ERROR_NONESuccessful
MAPS_ERROR_INVALID_PARAMETERInvalid parameter
MAPS_ERROR_NOT_SUPPORTEDNot supported
int maps_preference_get_country_code ( const maps_preference_h  preference,
char **  country_code 
)

Gets the country code.

This function gets the country code.

Since :
2.4
Remarks:
country_code must be released using free().
Parameters:
[in]preferenceThe preference handle
[out]country_codeThe country code
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 distance unit.

This function gets the maps distance unit.

Since :
2.4
Parameters:
[in]preferenceThe preference handle
[out]unitThe distance unit
Returns:
0 on success, otherwise a negative error value
Return values:
MAPS_ERROR_NONESuccessful
MAPS_ERROR_INVALID_PARAMETERInvalid parameter
MAPS_ERROR_NOT_SUPPORTEDNot supported
int maps_preference_get_language ( const maps_preference_h  preference,
char **  language 
)

Gets the language.

This function gets the maps language.

Since :
2.4
Remarks:
language must be released using free().
Parameters:
[in]preferenceThe preference handle
[out]languageThe language
Returns:
0 on success, otherwise a negative error value
Return values:
MAPS_ERROR_NONESuccessful
MAPS_ERROR_INVALID_PARAMETERInvalid parameter
MAPS_ERROR_NOT_SUPPORTEDNot supported
int maps_preference_get_max_results ( const maps_preference_h  preference,
int *  max_results 
)

Gets the max amount of results.

This function gets the max amount of results.

Since :
2.4
Parameters:
[in]preferenceThe preference handle
[out]max_resultsThe max amount of results
Returns:
0 on success, otherwise a negative error value
Return values:
MAPS_ERROR_NONESuccessful
MAPS_ERROR_INVALID_PARAMETERInvalid parameter
MAPS_ERROR_NOT_SUPPORTEDNot supported
int maps_preference_get_route_alternatives_enabled ( const maps_preference_h  preference,
bool *  enable 
)

Gets the enable status of alternative routes.

This function retrieves the enable status of alternative route.

Since :
3.0
Parameters:
[in]preferenceThe preference handle
[out]enableThe enable status
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 route feature.

This function gets the route feature.

Since :
2.4
Parameters:
[in]preferenceThe preference handle
[out]featureThe feature
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 route feature weight.

This function gets the route feature weight.

Since :
2.4
Parameters:
[in]preferenceThe preference handle
[out]feature_weightThe feature weight
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 route optimization.

This function gets the route optimization.

Since :
2.4
Parameters:
[in]preferenceThe preference handle
[out]optimizationThe route optimization
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 route transport mode.

This function gets the route transport mode.

Since :
2.4
Parameters:
[in]preferenceThe preference handle
[out]transport_modeThe transport mode
Returns:
0 on success, otherwise a negative error value
Return values:
MAPS_ERROR_NONESuccessful
MAPS_ERROR_INVALID_PARAMETERInvalid parameter
MAPS_ERROR_NOT_SUPPORTEDNot supported
int maps_preference_set_country_code ( maps_preference_h  preference,
const char *  country_code 
)

Sets the maps country code.

This function sets the maps country code.

Since :
2.4
Parameters:
[in]preferenceThe preference handle
[in]country_codeThe maps country code
Returns:
0 on success, otherwise a negative error value
Return values:
MAPS_ERROR_NONESuccessful
MAPS_ERROR_INVALID_PARAMETERInvalid parameter
MAPS_ERROR_NOT_SUPPORTEDNot supported
Precondition:
preference is created using maps_preference_create().
See also:
maps_preference_create()
maps_preference_get_country_code()

Sets the maps distance unit.

This function sets the maps distance unit.

Since :
2.4
Parameters:
[in]preferenceThe preference handle
[in]unitThe distance unit
Returns:
0 on success, otherwise a negative error value
Return values:
MAPS_ERROR_NONESuccessful
MAPS_ERROR_INVALID_PARAMETERInvalid parameter
MAPS_ERROR_NOT_SUPPORTEDNot supported
Precondition:
preference is created using maps_preference_create().
See also:
maps_preference_create()
maps_preference_get_distance_unit()
int maps_preference_set_language ( maps_preference_h  preference,
const char *  language 
)

Sets the maps language.

This function sets the maps language.

Since :
2.4
Parameters:
[in]preferenceThe preference handle
[in]languageThe maps language. A language is specified as an ISO 3166 alpha-2 two letter country-code followed by ISO 639-1 for the two-letter language code. Each language tag is composed of one or more "subtags" separated by hyphens (-). Each subtag is composed of basic Latin letters or digits only. For example, "ko-KR" for Korean, "en-US" for American English.
Returns:
0 on success, otherwise a negative error value
Return values:
MAPS_ERROR_NONESuccessful
MAPS_ERROR_INVALID_PARAMETERInvalid parameter
MAPS_ERROR_NOT_SUPPORTEDNot supported
Precondition:
preference is created using maps_preference_create().
See also:
maps_preference_create()
maps_preference_get_language()
int maps_preference_set_max_results ( maps_preference_h  preference,
const int  max_results 
)

Sets the max amount of results.

This function sets the max amount of results.

Since :
2.4
Parameters:
[in]preferenceThe preference handle
[in]max_resultsThe max amount of results
Returns:
0 on success, otherwise a negative error value
Return values:
MAPS_ERROR_NONESuccessful
MAPS_ERROR_INVALID_PARAMETERInvalid parameter
MAPS_ERROR_NOT_SUPPORTEDNot supported
Precondition:
preference is created using maps_preference_create().
See also:
maps_preference_create()
maps_preference_get_max_results()
int maps_preference_set_property ( maps_preference_h  preference,
const char *  key,
const char *  value 
)

Sets the preference value by key.

This function sets the preference value assigned with a specified key.

Since :
2.4
Parameters:
[in]preferenceThe preference handle
[in]keyThe key
[in]valueThe value
Returns:
0 on success, otherwise a negative error value
Return values:
MAPS_ERROR_NONESuccessful
MAPS_ERROR_INVALID_PARAMETERInvalid parameter
MAPS_ERROR_NOT_SUPPORTEDNot supported
Precondition:
preference is created using maps_preference_create().
See also:
maps_preference_create()
maps_preference_get_property()
maps_preference_foreach_property()

Sets the enable status of alternative routes.

This function sets the alternative routes status.

Since :
3.0
Parameters:
[in]preferenceThe preference handle
[in]enableThe value to set
Returns:
0 on success, otherwise a negative error value
Return values:
MAPS_ERROR_NONESuccessful
MAPS_ERROR_INVALID_PARAMETERInvalid parameter
MAPS_ERROR_NOT_SUPPORTEDNot supported
Precondition:
preference is created using maps_preference_create().
See also:
maps_preference_create()
maps_preference_get_route_alternatives_enabled()

Sets the route feature.

This function sets the route feature.

Since :
2.4
Parameters:
[in]preferenceThe preference handle
[in]featureThe route feature
Returns:
0 on success, otherwise a negative error value
Return values:
MAPS_ERROR_NONESuccessful
MAPS_ERROR_INVALID_PARAMETERInvalid parameter
MAPS_ERROR_NOT_SUPPORTEDNot supported
Precondition:
preference is created using maps_preference_create().
See also:
maps_preference_create()
maps_preference_get_route_feature()

Sets the route feature weight.

This function sets the route feature weight.

Since :
2.4
Parameters:
[in]preferenceThe preference handle
[in]feature_weightThe route feature weight
Returns:
0 on success, otherwise a negative error value
Return values:
MAPS_ERROR_NONESuccessful
MAPS_ERROR_INVALID_PARAMETERInvalid parameter
MAPS_ERROR_NOT_SUPPORTEDNot supported
Precondition:
preference is created using maps_preference_create().
See also:
maps_preference_create()
maps_preference_get_route_feature_weight()

Sets the route optimization.

This function sets the route optimization.

Since :
2.4
Parameters:
[in]preferenceThe preference handle
[in]optimizationThe route optimization
Returns:
0 on success, otherwise a negative error value
Return values:
MAPS_ERROR_NONESuccessful
MAPS_ERROR_INVALID_PARAMETERInvalid parameter
MAPS_ERROR_NOT_SUPPORTEDNot supported
Precondition:
preference is created using maps_preference_create().
See also:
maps_preference_create()
maps_preference_get_route_optimization()

Sets the route transport mode.

This function sets the route transport mode.

Since :
2.4
Parameters:
[in]preferenceThe preference handle
[in]transport_modeThe route transport mode
Returns:
0 on success, otherwise a negative error value
Return values:
MAPS_ERROR_NONESuccessful
MAPS_ERROR_INVALID_PARAMETERInvalid parameter
MAPS_ERROR_NOT_SUPPORTEDNot supported
Precondition:
preference is created using maps_preference_create().
See also:
maps_preference_create()
maps_preference_get_route_optimization()