254 lines
6.3 KiB
Markdown
254 lines
6.3 KiB
Markdown
|
|
> Wednesday, 7 May 2014
|
|
|
|
# Commands reference
|
|
|
|
## setdataset
|
|
|
|
setdataset,name,lat1,lng1,time1,name1,speed1,altitude,adresa1,icon_name1,voiceTimeout,smsLength,isInCall...
|
|
|
|
Examples:
|
|
|
|
setDataset,vehicles_positions,46.591381765902,-113.577594361268,2015-05-21 17:21:36,DANIEL DAVIS 56,71 mph,928 meters,Bucharest Bulevardul Marasesti 25,arrow_e.png,5,141,true
|
|
|
|
setDataset,vehicles_positions,36.314,-88.613,demo2,Speed: 90 Km/h Time: 23:54<br>503 Watts Rd Dresden TN 38225 USA,bigcar0.png,37.314,-89.613,Demo101,Speed: 90 Km/h Time: 23:54<br>254-448 Estate Dr Cape Girardeau MO 63701 USA,dodge.png
|
|
setDataset,shape3,45.2,46.4,,,,45.3,46.5,,,,45.4,46.6,,,
|
|
|
|
Each point needs to be specified with exactly 5 params. If they are empty, simply leave blank. A `smsLength` of 0 or non-existent means the unit does not support sms. `voiceTimeout` is the number of seconds after which a call goes to failed.
|
|
|
|
|
|
## setCall
|
|
|
|
setCall,unitName,true|false
|
|
|
|
Examples:
|
|
|
|
setCall,TRBO103,true
|
|
setCall,Demo101,false
|
|
|
|
## updatedataset
|
|
|
|
updatedataset,name,points
|
|
|
|
It will update the points with the specified names in the specified dataset. See `setdataset` for the points format.
|
|
|
|
Examples:
|
|
|
|
updateDataset,LandView,53.330872983017,18.6328125,airport,New,fire_department.png
|
|
|
|
|
|
## deletefromdataset
|
|
|
|
deletefromdataset, name, name1, name2,...
|
|
|
|
Remove points from dataset.
|
|
|
|
## removeDataset
|
|
|
|
removedataset, name
|
|
|
|
Removes a dataset.
|
|
|
|
|
|
## putOnMap
|
|
|
|
putonmap,autosize,datasetName
|
|
autosize = true|false
|
|
|
|
Will display a dataset on the map. If `autosize` is `true` the map will zoom in or out and resize so that all the points in dataset will be visible.
|
|
|
|
Examples:
|
|
|
|
putOnMap,true,LandView
|
|
|
|
## clearFromMap
|
|
|
|
clearfrommap,datasetName
|
|
|
|
|
|
## reset
|
|
|
|
|
|
## poly
|
|
|
|
poly,true|false,color,thickness, dataSetName
|
|
//first param is autozoom
|
|
|
|
## resize
|
|
|
|
resize,X,Y
|
|
|
|
Will resize the map. Not needed in the latest version as the map will resize itself based on document view size changes.
|
|
|
|
## openInfo
|
|
|
|
openinfo,namePoint
|
|
|
|
Open the info bubble on the specified point and display the *description* param in it.
|
|
|
|
|
|
## centerzoom
|
|
|
|
centerzoom,lat,lng,zoom
|
|
|
|
Will center the map on the specified coordinates and set the zoom level. If zoom is < 0 it will be left unchanged.
|
|
|
|
## putlabels
|
|
|
|
putlabels,dataset
|
|
|
|
Show labels under the dataset points. The label is the point name.
|
|
|
|
## removelabels
|
|
|
|
removelabels,{dataset}
|
|
|
|
setLabels,[ON|OFF]
|
|
|
|
## newpolygon
|
|
|
|
newpolygon,tempName[,fillColor,fillOpacity,borderColor,borderOpacity,borderWidth]
|
|
|
|
Examples:
|
|
|
|
newpolygon,Geofence,#EFED4F,0.3,#61C1A3,0.7,4
|
|
|
|
Starts the creation of a new polygon on the map.
|
|
|
|
## setPolygon
|
|
|
|
setpolygon,name,fillColor,fillOpacity,borderColor,borderOpacity,borderWidth,lat1,lng1,lat2,lng2,lat3,lng3...
|
|
|
|
Examples:
|
|
|
|
setpolygon,Geofence,#EFED4F,0.3,#61C1A3,0.7,4,44.41844,26.08446,44.41697,26.084,44.41804,26.08899,44.42013,26.08771
|
|
|
|
## updatePolygonStyle
|
|
|
|
updatePolygonStyle,name,fillColor,fillOpacity,borderColor,borderOpacity,borderWidth
|
|
|
|
|
|
## getPolygon
|
|
|
|
getpolygon,name[|'ALL']
|
|
|
|
Will return the polygons in the following format
|
|
|
|
[name1,color1,l1,long1,l2,long2,...][name2,color2,l21,lg21,...]
|
|
|
|
The return value is written in a div with id `response_string` and the `location.href` is set to `app://polygon/response_string`.
|
|
|
|
## deletePolygon
|
|
|
|
deletepolygon,name[|'ALL']
|
|
|
|
|
|
## startEditPolygon
|
|
|
|
startEditPolygon,name
|
|
|
|
|
|
## endEditPolygon
|
|
|
|
endeditpolygon
|
|
|
|
Only one polygon can be edited at a time.
|
|
|
|
## Polygon frequent commands
|
|
|
|
for creating a new polygons
|
|
-- new polygon, name, color
|
|
-- then when user press save getPolygon,name
|
|
-- if cancel deletePolygon,name
|
|
for canceling an edit
|
|
-- deletePolygon, xx
|
|
-- setPolygon, xx, ...
|
|
for canceling the creation of a new polygon
|
|
-- deletePolygon, tempName
|
|
to update a polygon
|
|
-- deletePolygon,name
|
|
-- setPolygon,newName,{new settings}
|
|
|
|
|
|
## getMapType
|
|
|
|
getmaptype
|
|
|
|
Will return [map|satellite|hybrid]. This is only for Google Maps. For OSM there is only one map type.
|
|
|
|
|
|
## setMapType
|
|
|
|
setMapType,[map|satellite|hybrid]
|
|
|
|
Only works for Google Maps.
|
|
|
|
## showconsole
|
|
|
|
showconsole,true|false
|
|
|
|
Used to show the console inside the map in an overlay div.
|
|
Examples:
|
|
|
|
showconsole,true
|
|
showconsole,false
|
|
|
|
## setLegacyIcons
|
|
>added May 5, 2015
|
|
|
|
setLegacyIcons,true|false
|
|
|
|
When set, the labels and icon alignment will be adapted to work with older icons from `images` folder. Set it to `false` to use the icons in new `cars` and `places` folders.
|
|
|
|
## not used anymore
|
|
|
|
- getAddress,id,lat,longc
|
|
- getLocation,addressString
|
|
- clearResponse
|
|
|
|
|
|
|
|
# How tos for SDMaps project
|
|
|
|
## To compile
|
|
|
|
- checkout the project from SVN
|
|
- `cd {co_directory}`
|
|
- install node if you haven't already
|
|
- `npm install`
|
|
- `npm install grunt-cli -g`
|
|
- `npm install -g grunt` [windows]
|
|
- `npm install` [windows]
|
|
- to see the available tasks `grunt -h`
|
|
- the project can compile an *OSM version* and a *GOOGLE version* like so
|
|
+ to compile for *osm* use `grunt osm`
|
|
+ to compile a version for goole use `grunt google`
|
|
|
|
The compiled application ready for distribution will be in `dest` directory.
|
|
|
|
The map should be uploaded using ftp on `portal.safemobile.com` on `/upload/safenet/map`.
|
|
|
|
## To debug
|
|
|
|
1. get the commands from SafeDispatch
|
|
2. add them to `TestCommands` file in an array and modify the `test()` function so that the `messages` variable refers to the array with the commands
|
|
3. start the application from `SfmbMaps...html` from the parent directory(not from `dest`)
|
|
4. you should start a server in the project directory for easier debugging `http-server .`
|
|
5. open a the console in the browser and look for errors
|
|
6. to display the console inside the map add *showconsole,true* as the first command in the array of commands
|
|
|
|
|
|
## To do 4 september 2015
|
|
|
|
- [ ] color label based on icon color
|
|
- [ ] fix geofences extra properties
|
|
- [ ] make info bubble sit still if the user interacts with the buttons and the unit position changes
|
|
- [ ] change the date formatted next to the *ago* indicator in info bubble
|
|
|
|
|
|
## Issues on March 14, 2016
|
|
|
|
- the text message is not cleared if you close the InfoWindow before sending it then open it for another unit
|
|
- when being added to the dataset, a new unit (which was not previously in the dataset) can't open a InfoWindow
|
|
|