The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 1 | page.title=Reference of Available Intents |
Scott Main | 6afeb0e | 2013-04-16 21:05:51 -0700 | [diff] [blame] | 2 | excludeFromSuggestions=true |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 3 | @jd:body |
| 4 | |
| 5 | <p>This document describes the default applications and settings that Google provides |
| 6 | in their standard Android implementation. </p> |
| 7 | <h3>Intents handled by Google Android applications<a name="googleintents" id="googleintents"></a></h3> |
| 8 | <p> Android ships with Activities that handle the following Intent URI/Action pairs. </p> |
| 9 | <table width="100%" border="1"> |
| 10 | <tr> |
| 11 | <th scope="col">Scheme</th> |
| 12 | <th scope="col">Action<br /> |
| 13 | android.intent.action.<em>value</em></th> |
| 14 | <th scope="col">Description</th> |
| 15 | </tr> |
| 16 | <tr> |
| 17 | <td>http://<em>web_address</em><br /> |
| 18 | https://<em>web_address</em></td> |
| 19 | <td>VIEW</td> |
| 20 | <td>Open a browser window to the URL specified. </td> |
| 21 | </tr> |
| 22 | <tr> |
| 23 | <td>"" (empty string) <br /> |
| 24 | http://<em>web_address</em><br /> |
| 25 | https://<em>web_address</em></td> |
| 26 | <td>WEB_SEARCH</td> |
| 27 | <td>Opens the file at the location on the device in the browser. </td> |
| 28 | </tr> |
| 29 | <tr> |
| 30 | <td height="103">tel: <em>phone_number</em></td> |
| 31 | <td>CALL</td> |
| 32 | <td><p>Calls the entered phone number. Valid telephone numbers as defined |
| 33 | in <a href="http://tools.ietf.org/html/rfc3966">the IETF RFC 3966</a> are |
| 34 | accepted. Valid examples include the following:</p> |
| 35 | <ul> |
| 36 | <li>tel:2125551212 </li> |
| 37 | <li>tel: |
| 38 | (212) 555 1212</li> |
| 39 | </ul> |
| 40 | <p>The dialer is good at normalizing some kinds of schemes: for example |
| 41 | telephone numbers, so the schema described isn't strictly required |
| 42 | in the {@link android.net.Uri#parse(java.lang.String) |
| 43 | Uri(URI string)} factory. However, if you have not tried a |
| 44 | schema or are unsure whether it can be handled, use the {@link |
| 45 | android.net.Uri#fromParts(java.lang.String, java.lang.String, |
| 46 | java.lang.String) Uri.fromParts(scheme, ssp, fragment)} factory |
| 47 | instead.</p> |
| 48 | <p><strong><em>Note:</em></strong> This requires your |
| 49 | application to request the following permission in your manifest: <code><uses-permission |
| 50 | id="android.permission.CALL_PHONE" /></code></p></td> |
| 51 | </tr> |
| 52 | <tr> |
| 53 | <td><p>tel:<em>phone_number</em><br /> |
| 54 | voicemail:</p> </td> |
| 55 | <td>DIAL</td> |
| 56 | <td><p>Dials (but does not actually initiate the call) the number given |
| 57 | (or the stored voicemail on the phone). Telephone number normalization |
| 58 | described for CALL applies to DIAL as well. </p> </td> |
| 59 | </tr> |
| 60 | <tr> |
| 61 | <td>geo:<em>latitude</em>,<em>longitude</em><br /> |
| 62 | geo:<em>latitude</em>,<em>longitude</em>?z=<em>zoom</em><br /> |
| 63 | geo:0,0?q=<em>my+street+address</em><br /> |
| 64 | geo:0,0?q=<em>business+near+city</em><br /> |
| 65 | </td> |
| 66 | <td>VIEW</td> |
| 67 | <td>Opens the Maps application to the given location or query. The Geo URI scheme |
| 68 | (not fully supported) is <a href="http://tools.ietf.org/html/draft-mayrhofer-geo-uri-00">currently under |
| 69 | development</a>.<p> |
| 70 | The <em>z</em> field specifies the zoom level. A zoom level of 1 shows the whole Earth, centered at the |
| 71 | given <em>lat</em>,<em>lng</em>. A zoom level of 2 shows a quarter of the Earth, and so on. The highest |
| 72 | zoom level is 23. A larger zoom level will be clamped to 23. |
| 73 | </td> |
| 74 | </tr> |
| 75 | <tr> |
| 76 | <td>google.streetview:cbll=<em>lat</em>,<em>lng</em>&cbp=1,<em>yaw</em>,,<em>pitch</em>,<em>zoom</em>&mz=<em>mapZoom</em> |
| 77 | </td> |
| 78 | <td>VIEW</td> |
| 79 | <td>Opens the Street View application to the given location. The URI scheme is |
| 80 | based on the syntax used for Street View panorama information in Google Maps URLs.<p> |
| 81 | The cbll field is required. The cbp and mz fields are optional.<p> |
| 82 | <table border="1"> |
| 83 | <tr><th>Parameter</th><th>Description</th></tr> |
| 84 | <tr><td>lat</td><td>latitude</td></tr> |
| 85 | <tr><td>lng</td><td>longitude</td></tr> |
| 86 | <tr><td>yaw</td><td>Panorama center-of-view in degrees clockwise from North.<br /> |
| 87 | <b>Note:</b> The two commas after the yaw parameter are required. They are present |
| 88 | for backwards-compatibility reasons.</td></tr> |
| 89 | <tr><td>pitch</td><td>Panorama center-of-view in degrees from |
| 90 | -90 (look straight up) to 90 (look straight down.)</td></tr> |
| 91 | <tr><td>zoom</td><td>Panorama zoom. 1.0 = normal zoom, 2.0 = zoomed in 2x, 3.0 = zoomed in 4x, and so on.<br /> |
| 92 | A zoom of 1.0 is 90 degree horizontal FOV for a nominal |
| 93 | landscape mode 4 x 3 aspect ratio display. |
| 94 | Android phones in portrait mode will adjust the zoom so that |
| 95 | the vertical FOV is approximately the same as the landscape vertical |
| 96 | FOV. This means that the horizontal FOV of an Android phone in portrait |
| 97 | mode is much narrower than in landscape mode. This is done to minimize |
| 98 | the fisheye lens effect that would be present if a 90 degree horizontal |
| 99 | FOV was used in portrait mode.</td></tr> |
| 100 | <tr><td>mapZoom</td><td>The map zoom of the map location associated with this panorama. This value is passed on to the |
Elliott Hughes | 7f87706 | 2009-07-30 17:00:34 -0700 | [diff] [blame] | 101 | Maps activity when the Street View "Go to Maps" menu item is chosen. It corresponds to the <em>z</em> parameter in |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 102 | the geo: intent.</td></tr> |
| 103 | </table> |
| 104 | </td> |
| 105 | </tr> |
| 106 | </table> |
| 107 | <p></p> |