[3.0][common_appcontrol] Add comments about APP_CONTROL_DATA_LOCATION in Map part...

Change-Id: I5e9c858f85eb1a8e054ba3995e0e21022490ad16
Signed-off-by: chanywa <cbible.kim@samsung.com>

diff --git a/org.tizen.guides/html/native/app_management/common_appcontrol_n.htm b/org.tizen.guides/html/native/app_management/common_appcontrol_n.htm
index 316a209..5bb91b4 100644 (file)
--- a/org.tizen.guides/html/native/app_management/common_appcontrol_n.htm
+++ b/org.tizen.guides/html/native/app_management/common_appcontrol_n.htm
@@ -1463,8 +1463,8 @@ show_maps_operation(void)
    <p>Show the map at the location of a given keyword (address or POI). For example: <span style="font-family: Courier New,Courier,monospace">geo:0,0?q=Eiffel%20Tower</span></p>
    <p>All strings passed in the <span style="font-family: Courier New,Courier,monospace">geo:</span> URI must be encoded.</p>
    <p>If only <span style="font-family: Courier New,Courier,monospace">geo:</span> is used, it filters out all but map applications in the system, and the location to be shown depends on the application scenario and configuration.</p>
-       
-       
+
+
 <h4>Extra Input</h4>
        <table>
                <tbody>
@@ -1475,8 +1475,8 @@ show_maps_operation(void)
                        </tr>
                        <tr>
                                <td><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_DATA_TYPE</span></td>
-                               <td>The type of items to be delivered. Available values are <span style="font-family: Courier New,Courier,monospace">address</span> (default), <span style="font-family: Courier New,Courier,monospace">image</span>, <span style="font-family: Courier New,Courier,monospace">poi</span>, or <span style="font-family: Courier New,Courier,monospace">all</span>. This key must be passed as a string.</td>
-                               <td>This key is optional. <strong>The poi value is not supported in Tizen 2.4.</strong></td>
+                               <td>The type of items to be delivered. Available values are <span style="font-family: Courier New,Courier,monospace">address</span> (default), <span style="font-family: Courier New,Courier,monospace">image</span>, <span style="font-family: Courier New,Courier,monospace">poi</span>, <span style="font-family: Courier New,Courier,monospace">geocode</span>, or <span style="font-family: Courier New,Courier,monospace">all</span>. This key must be passed as a string.</td>
+                               <td>This key is optional. <strong>The poi value is not supported in Tizen 2.4.</strong> <strong>The geocode value is supported since Tizen 3.0.</strong></td>
                        </tr>
                </tbody>
        </table>
@@ -1498,15 +1498,20 @@ show_maps_operation(void)
                                <td><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_DATA_NAME</span></td>
                                <td>The name of the selected location. This key must be passed as a string.</td>
                                <td><strong>This key is not supported in Tizen 2.4.</strong></td>
-                       </tr>
+                       </tr>
+                       <tr>
+                               <td><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_DATA_LOCATION</span></td>
+                               <td>The geo-coordinates of the selected location. This key must be passed as a string.</td>
+                               <td><strong>This key is supported since Tizen 3.0.</strong></td>
+                       </tr>
                        <tr>
                                <td><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_DATA_PATH</span></td>
                                <td>The file path of the image showing the selected location. This key must be passed as a string.</td>
                                <td></td>
-                       </tr>                   
+                       </tr>
                </tbody>
-       </table>        
-       
+       </table>
+
 <h4>Example Code</h4>
 <pre class="prettyprint">
 #include &lt;app_control.h&gt;
@@ -1528,7 +1533,7 @@ pick_location_operation(void)
 
 &nbsp;&nbsp;&nbsp;&nbsp;app_control_set_operation(service, APP_CONTROL_OPERATION_PICK);
 &nbsp;&nbsp;&nbsp;&nbsp;app_control_set_uri(service, &quot;geo:0,0?q=Eiffel Tower&quot;);
-&nbsp;&nbsp;&nbsp;&nbsp;app_control_add_extra_data(service, APP_CONTROL_DATA_TYPE, &quot;poi&quot;);
+&nbsp;&nbsp;&nbsp;&nbsp;app_control_add_extra_data(service, APP_CONTROL_DATA_TYPE, &quot;all&quot;);
 &nbsp;&nbsp;&nbsp;&nbsp;app_control_set_launch_mode(service, APP_CONTROL_LAUNCH_MODE_GROUP);
 
 &nbsp;&nbsp;&nbsp;&nbsp;app_control_send_launch_request(service, pick_reply_cb, NULL);
@@ -1541,16 +1546,24 @@ void
 pick_reply_cb(app_control_h request, app_control_h reply, app_control_result_e result, void *user_data)
 {
 &nbsp;&nbsp;&nbsp;&nbsp;char *address = NULL;
+&nbsp;&nbsp;&nbsp;&nbsp;char *name = NULL;
+&nbsp;&nbsp;&nbsp;&nbsp;char *geocode = NULL;
 &nbsp;&nbsp;&nbsp;&nbsp;char *path = NULL;
 
 &nbsp;&nbsp;&nbsp;&nbsp;if (result == APP_CONTROL_RESULT_SUCCEEDED) {
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;app_control_get_extra_data(reply, APP_CONTROL_DATA_SELECTED, &amp;address);
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;app_control_get_extra_data(reply, APP_CONTROL_DATA_NAME, &amp;name);
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;app_control_get_extra_data(reply, APP_CONTROL_DATA_LOCATION, &amp;geocode);
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;app_control_get_extra_data(reply, APP_CONTROL_DATA_PATH, &amp;path);
 
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;dlog_print(DLOG_INFO, LOG_TAG, &quot;Selected address: %s&quot;, address);
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;dlog_print(DLOG_INFO, LOG_TAG, &quot;Selected name: %s&quot;, name);
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;dlog_print(DLOG_INFO, LOG_TAG, &quot;Selected location: %s&quot;, geocode);
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;dlog_print(DLOG_INFO, LOG_TAG, &quot;Map image path: %s&quot;, path);
 
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;free(address);
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;free(name);
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;free(geocode);
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;free(path);
 &nbsp;&nbsp;&nbsp;&nbsp;}
 }
@@ -2474,4 +2487,4 @@ var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga
 </script>
 
 </body>
-</html>        
\ No newline at end of file
+</html>