4 * Copyright (c) 2010-2011 Samsung Electronics Co., Ltd. All rights reserved.
6 * Contact: Youngae Kang <youngae.kang@samsung.com>, Yunhan Kim <yhan.kim@samsung.com>,
7 * Genie Kim <daejins.kim@samsung.com>, Minjune Kim <sena06.kim@samsung.com>
9 * Licensed under the Apache License, Version 2.0 (the "License");
10 * you may not use this file except in compliance with the License.
11 * You may obtain a copy of the License at
13 * http://www.apache.org/licenses/LICENSE-2.0
15 * Unless required by applicable law or agreed to in writing, software
16 * distributed under the License is distributed on an "AS IS" BASIS,
17 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
18 * See the License for the specific language governing permissions and
19 * limitations under the License.
22 #ifndef __LOCATION_LANDMARK_H__
23 #define __LOCATION_LANDMARK_H__
25 #include <location-map-types.h>
30 * @file location-landmark.h
31 * @brief This file contains the internal definitions and structures related to Landmark.
35 * @addtogroup LocationMapServicePOI
37 * @defgroup LocationMapServiceLandmark Location Landmark
38 * @brief This provides structure, enumeration and APIs for Landmark
39 * @addtogroup LocationMapServiceLandmark
44 * @brief Create a new Landmark
46 LocationLandmark *location_landmark_new (void);
49 * @brief Copy the given Landmark
51 LocationLandmark *location_landmark_copy (const LocationLandmark *landmark);
54 * @brief Free the given Landmark
56 void location_landmark_free (LocationLandmark *landmark);
59 * @brief Get the ID of the given landmark
61 guint location_landmark_get_id (const LocationLandmark *landmark);
64 * @brief Get the name of the given landmark
66 gchar *location_landmark_get_name (const LocationLandmark *landmark);
68 * @brief Get the position in the given landmark
70 LocationPosition *location_landmark_get_position (const LocationLandmark *landmark);
72 * @brief Get the address of the given landmark
74 LocationAddress *location_landmark_get_address (const LocationLandmark *landmark);
76 * @brief Get the description of the given landmark
78 gchar *location_landmark_get_description (const LocationLandmark *landmark);
80 * @brief Get the timestamp of the given landmark
82 guint location_landmark_get_timestamp (const LocationLandmark *landmark);
84 * @brief Get the priority of the given landmark
86 guint location_landmark_get_priority (const LocationLandmark *landmark);
88 * @brief Get the bounding box of the given landmark
90 LocationBoundary *location_landmark_get_bounding_box (const LocationLandmark *landmark);
92 * @brief Get the author of the given landmark
94 gchar *location_landmark_get_author (const LocationLandmark *landmark);
96 * @brief Get the list of urls of the given landmark
98 GList *location_landmark_get_url (const LocationLandmark *landmark);
100 * @brief Get the categories of the given landmark
102 GList *location_landmark_get_category (const LocationLandmark *landmark);
104 * @brief Get the phone number of the given landmark
106 gchar *location_landmark_get_phone_number (const LocationLandmark *landmark);
108 * @brief Get the property keys of the given landmark
110 GList *location_landmark_get_property_key (const LocationLandmark *landmark);
113 * @brief Get the property data of the given landmark
115 gconstpointer location_landmark_get_property (const LocationLandmark *landmark, gconstpointer key);
118 * @brief Create a new #LocationLandmarkUrl
120 LocationLandmarkUrl * location_landmark_url_new (void);
123 * @brief Free a #LocationLandmarkUrl
125 void location_landmark_url_free (LocationLandmarkUrl *url);
128 * @brief Copy a #LocationLandmarkUrl
130 LocationLandmarkUrl *location_landmark_url_copy (const LocationLandmarkUrl *url);
133 * @brief Get the url path of the given #LocationLandmarkUrl
135 gchar *location_landmark_url_get_url_path (const LocationLandmarkUrl *url);
137 * @brief Get the url's description of the given #LocationLandmarkUrl
139 gchar *location_landmark_url_get_description (const LocationLandmarkUrl *url);