Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
en:help:v2:intents [2020/04/22 11:39] alpinequesten:help:v2:intents [2024/02/20 09:37] (current) psyberia
Line 1: Line 1:
-<sub>[[en:help|Online Help]] > [[en:help:v2|AlpineQuest 2.x]] > Maps & Layers</sub>+<sub>[[en:help:v2|Online Help]] > Intents</sub>
  
 ====== Intents ====== ====== Intents ======
Line 9: Line 9:
 ===== Global intents ===== ===== Global intents =====
 \\ \\
-The application responds to the following actions, even if it'not explicitly targeted.+The application responds to the following intents, even if it is not explicitly targeted.
  
-==== Action "net.psyberia.intent.action.DISPLAY_LOCATION" ====+\\
  
-Display a location on the map.+  * **Intent action "net.psyberia.intent.action.DISPLAY_LOCATION"** 
 + 
 +Displays a location on the map.
  
 ^ Optional extras  ^ Type  ^ Description  ^ ^ Optional extras  ^ Type  ^ Description  ^
Line 22: Line 24:
 | net.psyberia.intent.extra.LATITUDE  | Double  | WGS84 latitude.  | | net.psyberia.intent.extra.LATITUDE  | Double  | WGS84 latitude.  |
 | net.psyberia.intent.extra.ELEVATION  | Double  | WGS84 elevation (meters).  | | net.psyberia.intent.extra.ELEVATION  | Double  | WGS84 elevation (meters).  |
 +| net.psyberia.intent.extra.HEADING  | Double  | Heading of movement (degrees).  |
 +| net.psyberia.intent.extra.TIMESTAMP  | Double  | Unix timestamp in seconds, instead of current date. Set to ''"0.0"'' for no date.  |
 | net.psyberia.intent.extra.NAME  | String  | name of the point (ignored if using a track ID).  | | net.psyberia.intent.extra.NAME  | String  | name of the point (ignored if using a track ID).  |
 | net.psyberia.intent.extra.COMMENT  | String  | comment of the point (ignored if using a track ID).  | | net.psyberia.intent.extra.COMMENT  | String  | comment of the point (ignored if using a track ID).  |
 | net.psyberia.intent.extra.DESCRIPTION  | String  | description of the point (ignored if using a track ID).  | | net.psyberia.intent.extra.DESCRIPTION  | String  | description of the point (ignored if using a track ID).  |
-| net.psyberia.intent.extra.ICON  | String  | icon of the point (ignored if using a track ID).  |+| net.psyberia.intent.extra.ICON  | String  | icon name of the point (ignored if using a track ID).  | 
 +| net.psyberia.intent.extra.MOVE_TO  | Boolean  | Whether or not move the map center over the location.  |
  
 +__Example in Automate__:\\
 +- Block type: ''App start''\\
 +- Action: ''"net.psyberia.intent.action.DISPLAY_LOCATION"''\\
 +- Extras: ''{"net.psyberia.intent.extra.LONGITUDE": -0.1, "net.psyberia.intent.extra.LATITUDE": 54.5, "net.psyberia.intent.extra.NAME": "Test", "net.psyberia.intent.extra.ICON": "Car", "net.psyberia.intent.extra.MOVE_TO" as boolean: 0}''
  
 +\\
  
-General intents+  * **Intent scheme "geo"** 
-  * **''"APP_STOP"''**: Close the application.+ 
 +Displays or searches a location. 
 + 
 +^ Supported formats examples 
 +| geo:{lat},{lon} 
 +| geo:{lat},{lon}({name}) 
 +| geo:{lat},{lon}?z={osm_zoom_id} 
 +| geo:?q={lat},{lon}({name}) 
 +| geo:0,0?q={lat},{lon}({name}) 
 +| geo:0,0?q={address} 
 + 
 +Some examples: 
 +<html><br /> 
 +<a href="geo:38.8894716,-77.0352538">geo:38.8894716,-77.0352538</a><br /> 
 +<a href="geo:38.8894716,-77.0352538;name=Washington+Monument">geo:38.8894716,-77.0352538;name=Washington+Monument</a><br /> 
 +<a href="geo:38.8894716,-77.0352538(Washington+Monument)">geo:38.8894716,-77.0352538(Washington+Monument)</a><br /> 
 +<a href="geo:323482,4306480;crs=EPSG:32618;u=20">geo:323482,4306480;crs=EPSG:32618;u=20</a><br /> 
 +<a href="geo:18S+323482+4306480;crs=utm">geo:18S+323482+4306480;crs=utm</a><br /> 
 +</html> 
 + 
 +\\ 
 + 
 +  * **Intent schemes "http" and "https"** 
 + 
 +Displays or searches a location. 
 + 
 +^ Supported formats examples 
 +| https://www.google.com/maps/place/{lat},{lon} 
 +| https://www.google.com/maps/place/{lat},{lon},{google_zoom_id}z 
 +| https://maps.google.com/?q={lat},{lon} 
 +| https://maps.google.com/?q=loc:{lat},{lon},{google_zoom_id}z 
 +| https://maps.google.com/?q=loc:{lat},{lon},{google_zoom_id}z({name}) 
 + 
 +\\ 
 + 
 +===== Application specific intents ===== 
 +\\ 
 +To use the following intents, you must explicitly target the application package. 
 + 
 +\\ 
 + 
 +  * **Intent action "APP_STOP"** 
 + 
 +Closes the application. 
 + 
 +\\ 
 + 
 +  * **Intent action "DISPLAY_LOCATION"** 
 + 
 +Displays a location on the map. 
 + 
 +^ Optional extras  ^ Type  ^ Description 
 +| mem_id  | String  | Memory ID. If specified, replaces a previous location displayed with this same ID.  | 
 +| track_id  | String  | Track ID. If specified, appends the location to a track named after this ID.   | 
 +| set_id  | String  | Set ID. If specified, adds the location to a waypoints set named after this ID.  | 
 +| longitude  | Double  | WGS84 longitude. 
 +| latitude  | Double  | WGS84 latitude. 
 +| elevation  | Double  | WGS84 elevation (meters). 
 +| heading  | Double  | Heading of movement (degrees). 
 +| timestamp  | Double  | Unix timestamp in seconds, instead of current date. Set to ''"0.0"'' for no date.  | 
 +| name  | String  | name of the point (ignored if using a track ID).  | 
 +| comment  | String  | comment of the point (ignored if using a track ID).  | 
 +| description  | String  | description of the point (ignored if using a track ID).  | 
 +| icon  | String  | icon name of the point (ignored if using a track ID).  | 
 +| move_to  | Boolean  | Whether or not move the map center over the location. 
 + 
 +__Example in Automate__:\\ 
 +- Block type: ''App start''\\ 
 +- Package: ''psyberia.alpinequest.full''\\ 
 +- Activity class: ''psyberia.alpinequest.full.AlpineQuestActivity''\\ 
 +- Action: ''"DISPLAY_LOCATION"''\\ 
 +- Extras: ''{"longitude": -0.1, "latitude": 54.5, "name": "Test", "icon": "Car", "move_to" as boolean: 0}'' 
 + 
 +\\ 
 + 
 +  * **Intent action "LANDMARKS_FAST_WAYPOINT"** 
 + 
 +Creates and displays a waypoint on the mapThe waypoint is saved in the current placemarks Explorer place, the screen center location or the GPS location (if available) is used based on the last created waypoint choice. 
 + 
 +^ Optional extras  ^ Type  ^ Description 
 +| name  | String  | name of the waypoint. 
 + 
 +\\
  
-Placemarks: +  * **Intent actions "TRACKER_START", "TRACKER_STOP" and "TRACKER_ADD_WAYPOINT"**
-  * **''"LANDMARKS_FAST_WAYPOINT"''**: Create a waypoint on the mapsaved in the default placemarks folder. The screen center location or GPS location (if available) is used based on the last created waypoint choices. Extra fields: **''"name"''** (//''String''//; the waypoint name).+
  
-Track recorder: +Respectively starts the track recorder, stops the track recorder and add a waypoint to current recorded track.
-  * **''"TRACKER_START"''**: Start the track recorder+
-  * **''"TRACKER_STOP"''**: Stop the track recorder+
-  * **''"TRACKER_ADD_WAYPOINT"''**: Add a waypoint to the recorded track. Extra fields: **''"name"''** (//''String''//; the waypoint name).+
  
 +^ Optional extras for "TRACKER_ADD_WAYPOINT"  ^ Type  ^ Description  ^
 +| name  | String  | name of the waypoint.  |