1. Starting the application
To start gvSIG Mini go to your phone's applications menu. If the installation was successful you will see the gvSIG Mini icon from where you can run the application.
1.1 Giving permissions before launching gvSIG Mini
Before starting gvSIG Mini you must consider configure the permissions of the application. Each telephone manages its own J2ME security policy, so you must check your telephone's manual to learn how to configure the app's permissions.
You must allow gvSIG Mini to perform these actions:
- Network connections (HTTP)
- Read/write user files (To store maps into disk)
Depending on your telephone's security policy you will be allowed to change the permissions or not. If you have problems configuring the permissions for gvSIG Mini check this FAQ
Hint for tile storage
The first time you run gvSIG Mini you will probably want to configure the folder where the maps downloaded are going to be stored. Check this section to know how to do that. Besides, there is a useful gvSIG Desktop extension (Phone Cache) to download tile mashups and easily copy them into the SD card of the telephone. You can check its documentation here
2. Main screen
Once you run gvSIG Mini you will see the splash screen
After a few seconds, you will be probably prompted to allow the app to network connections, read/write user files or location data, if so, you'll have to allow it.
gvSIG Mini will then show the main screen
- GPS status icon
Show the status of localization data. If the icon is spinning, then localization data is being received otherwise it remains still.
- Layer name
The name of the current layer on the map.
- Zoom level bar
A bar showing the maximum and minimum zoom levels for current layer and current zoom level.
- My location icon
A marker of the current (or last) location fixed by the GPS.
- Map center pointer
This marker represents the point where to place route points on the map or where to select points of interest.
- Zoom in button
By touching this button a zoom in the map is performed (Only available on touch capable devices)
- Zoom out button
By touching this button a zoom out the map is performed (Only available on touch capable devices)
- Exit menu
By pressing left soft button, you will exit the application.
- Main menu
By pressing right soft button, the main menu will be displayed.
3. Main menu
Pressing menu soft button (or touching the word 'Menu') the main menu will be displayed.
You can select an option by moving the focus with phone's up/down arrows and pressing the right soft button.
4. Panning and zooming the map
You can pan the map to four directions by pressing the corresponding arrow keys of the phone (up, down, left, right). You can also zoom in and zoom out the map by pressing the # and * keys.
In touch devices you can pan the map by touching and dragging it to the desired position. When you release the finger, the full map will be shown.
Zoom in and zoom out functions can be activated by touching zoom in and zoom out buttons at the bottom of the map. You can also use the keys (up, down, left, right, #, *) above described of your touch device to pan and zoom the map.
5. Calculating routes
With gvSIG Mini you can calculate routes from a start point to a destination point. The service used to perform the
calculation is YOURS. Sometimes, it is possible that the server could not calculate a valid route between the points selected or it was out of service. Please consider setting start and destination points near roads, streets, etc.
Depending on your telephone's Java application memory, it is possible that very long routes cannot be displayed, the application can spend several minutes calculating it or the performance when panning the map decreases.
5.1 Route from here
You can set the route's origin by pressing the 'Route from here' menu option. A green flag will be displayed at the center of the screen symbolizing the origin of the route.
5.2 Route to here
You can set the route's destination by pressing the 'Route to here' menu option. A red flag will be displayed at the center of the screen symbolizing the origin of the route.
If you previously set the origin route point, then 'Select route type' dialog will automatically be shown.
5.3 Select route type
This dialog appears when you have selected both origin and destination point of a route. From here you can select desired Transport and Type of the route. Once you make your selection and press the OK menu option a query to the server will be made, and the loading screen will be shown. This operation may take several seconds and the cost will depend on your carrier provider.
Once the route has been calculated it will be shown on the map. At this point you can pan and zoom the map, keeping the route displayed until you clear the screen or calculate a new one.
5.4 Cancel route
This menu option will be activated when you set a route point or a route has been calculated. By pressing 'Cancel route' you will erase the route out from the map as well as any route point set.
6. Searching points of interest
You can search points of interest and view the results on the map by following the next steps:
You can access 'Search points of interest' dialog by clicking on the corresponding option menu.
You must focus the text box with up&down keys and click your phone's action key to access the edit mode, so that you can type what you want to find. For example, you can type: hospitals.
You can check 'Near from map center' to find only points of interest near the current center of the map, if you uncheck it you can see some results around the whole world.
Next press the right soft button to show the dialog menu. Focus 'Search' and press your phone's action key. A loading dialog will appear while retrieving the server answer.
Once the response is received, a dialog with the points of interest found will be displayed. You can focus any result with the up/down keys of your phone (or touching any) and perform any of the actions shown in the dialog menu.
These are the actions you can perform for each result:
- Route from here: Sets the location of the point of interest as the route's origin point
- Route to here: Sets the location of the point of interest as the route's destination point
- Show results on the map: Goes back to the map view and shows the points of interest on its location
- Center map: Centers the map on the location of the selected point of interest
- Show details: Shows a dialog with the full description of the point of interest
- Show nearest places: Shows a dialog with places near the current point of interest
- Show all the results: Goes back to found results when you are at 'Nearest places' dialog.
- New search: Goes backs to the initial dialog
7. Address searching
You can access 'Search address' dialog by pressing its corresponding menu option.
'Search address' dialog is similar to 'Search points of interest' one. The only difference is the criteria for finding places, that follows this rules:
- If you only fill the 'Street or place' text box, the results will be ordered by nearest to the center of the map to furthest. So you can use this kind of search to find streets or places near the center of the map.
- If you fill any of the two other text boxes (City or State), the results will be ordered by ranking. Usually a city has best rank than a street.
- If you fill the three text boxes, it will appear first the results nearest the City or State typed and then the rest.
8. Centering on my location
Centers the map on the current GPS location. The map will center on every new GPS location received.
Note: Layers with SRS different from one of the following codes will not recenter the map with the GPS location:
"EPSG:4*" "EPSG:230*" "EPSG:326*" "EPSG:327*" "EPSG:275*" "EPSG:27700"
You can check your layer SRS in the dialog 'Select layers'
Preset tile servers (such as OpenStreetMaps, Yahoo maps, etc.) support 'Centering on my location'
9. Managing layers
You can manage the layers configured in gvSIG Mini through the 'Select layers' option menu.
gvSIG Mini has several layers preset by default. You can shift from one layer to the following one by pressing the key '0' of your phone in the map view.
You can check and uncheck layers, so that unchecked ones will not be visible in the map view when you shift from one layer to another by pressing key '0'
9.1 Adding new layers to gvSIG Mini
You can add more layers than preset ones to the list of layers, and then use them on the map view. So far, gvSIG Mini supports WMS and WMS-c (TMS) layers which support the 'GetCapabilities' operation.
You can follow the next steps to configure new layers in gvSIG Mini:
- On the 'Select layers' dialog click on 'Menú'
- Press the 'Add server' menu option, you will be redirected to the 'WMS Server' dialog. You must focus the text box and type the URL of a WMS or WMS-c server that responds to a 'GetCapabilities' request(_for example: http://ovc.catastro.meh.es/Cartografia/WMS/ServidorWMS.aspx_). Don't type '?' character or 'GetCapabilities' word. Once you have typed the URL click on 'menu' and select the 'Get Capabilities' option menu.
- At this point, gvSIG Mini will perform a 'GetCapabilities' request to the server and after a while the list of layers available on the server will be displayed.
- You can select the layers you want to add to the list of layers, and then click on the 'Save' menu option. You will be prompted to add a name to the group of layers selected, focus the 'Input name' dialog, press your phone's action key and type the desired name. After that, you must press the action key and then the menu option 'OK' to save the changes.
- A new tab will appear in the 'Select layers' dialog.
- You can go back to the map view and navigate the new layer by pressing the key '0' as many times as you need to get the new layer visible.
10. Configuring gvSIG Mini to load stored maps
gvSIG Mini can store every single tile map downloaded from a server into disk. Thanks to this it is possible to navigate through maps without been connected to the Internet, which implies no cost taxes from your telephone provider and better performance while navigating. Everytime gvSIG Mini needs a tile, it will be loaded from previously cached tiles.
To activate this capability you must press the 'App directory' menu option.
You will be redirected to a dialog showing the root of your telephone's file system. You can focus any folder and enter into it by pressing the 'Open' menu option. Once you get to the directory you want to use for storing your files press 'Menu' and then 'Save'. From now on, gvSIG will automatically cache every downloaded tile map.
Note: Due to restrictions on the security policy of a lot of Java telephones, you may happen to be denied access to read/write files on disk. If so you won't be able to use the cached maps capability of gvSIG Mini.
We stronglly recommend you to try Phone Cache, a gvSIG Desktop extension to easily download tile mashups to be copied into the telephone's SD Card. It will generate a full set of tiles for using on your phone avoiding communications usage, which will dramatically both improve the speed of gvSIG Mini and reduce transmission costs. For more information, you can see Phone Cache Documentation