Map View is the view that displays Points of Interests (POI’s) on a base map. == Prerequisites ==Since {{UBIK}} Both clients, Android 2and WinX, are using [https://www.5openstreetmap.0, org/ Open Street Maps (OSM) is used instead of Google Maps; hence, no Google Play Services are required anymore ({{Version/AndroidSince|2.5.0}})] for its map source materials.
== Google Maps (Android) ==
[[File:UI_Android_Google_Play_Services_Missing.png|thumb|alt=Google Play Services Missing|Google Play Services Missing]]
Up to Version 2.5.0 Since {{UBIK}} integrates [https://developersAndroid 2.google5.com/maps/documentation/android/ 0, Open Street Maps (OSM) is used instead of Google Maps] which requires [https://developers.google.com/android/guides/overview ; hence, no Google Play Services]are required anymore. If the latter is not available on a device, {{UBIK}} can still be installed and most of its features will still function. However, the map view will not be accessible and a notification will be shown in that case ({{Version/AndroidSince|2.45.50}}).
Up to Version 2.5.0 {{UBIK}} integrates [https://developers.google.com/maps/documentation/android/ Google Maps] which requires [https://developers.google.com/android/guides/overview Google Play Services]. If the latter is not available on a device, {{UBIK}} can still be installed and most of its features will still function. However, the map view will not be accessible and a notification will be shown in that case. {{Version/AndroidSince|2.4.5}}
== Visualization ==
[[File:map_view.png|thumb|alt=Map view|Map view(Android)]][[File:UI_WinX_Map_View.png|thumb|alt=Map view|Map view (Windows)]]A typical Map view consists of the base mapand some addtional, platform specific buttons and menus:* Android: top map menu, bottom navigation menu, location button, zoom buttons;* Windows: left buttons bar and a current location/orientation indicator(arrow).
=== Base map ===
The rules regarding what content should be displayed are as follows:
* The object has to be a Geo content or a [[Geographies|Geography]]{{Version/WinXSince|2.5.3}}{{Version/AndroidSince|2.5.5}} content
* If a [[HowTo:Use_POI_Groups|POI group]] is currently open/active, objects that are shown are:
** [[SYSCLS_POIGROUPITEM|POI group items]] that belong to the current group;
=== Map menu ===
==== Home button ====
[[File:home_button.png|thumb|alt=Home button|Home button]]
Pressing this button, opens a dialog box asking the user to specify where to navigate next. The user has the option of navigating to either the [[UBIK Client Basics#Menu|start menu]], [[#Map settings button|settings]] or the information view. To go back the map view without any selection the user must press the back button in the bottom navigation menu
==== Map settings button ====
[[File:map_settings.png|thumb|alt=Map settings|Map settings]]
By pressing this button, the user can change between Map (default setting), Satellite and Hybrid views. The map view changes the base map after clicking one of the radio buttons.
==== Map layers button ====
[[File:map_layer_dialog.png|thumb|alt=Map layer dialog|Map layer dialog(Android)]][[File:UI_WinX_Map_Layer_Panel.png|thumb|alt=Map Layer Panel|Map Layer Panel (Windows)]]
The Geo content can be configured on the server side to belong to a certain layer.
By pressing this button, a dialog will be displayed to the user, containing all the available layers. By checking off the layers in the dialog box, the user is able to decide to view the Geo content belonging to the checked layers.
=== Location button = Map types setting (Windows) ====This button enables the [[File:UI_WinX_Map_Type_Setting.png|thumb|alt=Map Types|Map Types (Windows)]]The user to zoom into can choose different map types (Road and Satellite) for the base map. This setting can be found in the current position "Map" section of the mobile deviceapplication settings.
==== Map types setting (Android) ====When Google Maps is used as a basic technology, the user can choose different map types (Normal, Satellite and Hybrid) for the base map. This setting can be found in the Actionbar on the far right. As a default technology, Open Street Map (OSM) is used from {{Version/Android|2.5.0}} on though. There, only Normal is available currently. Satellite is available {{Version/AndroidSince|2.5.3}}. === Map Control ======= Initial zoom behaviour (Android) ====Everytime the MapView gets openend, {{UBIK}} zooms to a specified location using a specified zoom level. Thereby following behaviour is applied:* If the Map View gets openend for the first time after login, {{UBIK}} zooms to the [[Settings#AR_settings|DefaultMapZoomLocation]] using the [[Settings#AR_settings|StandardMapZoomLevel]].* When closing the Map View, the location and zoom level of the shown map section gets saved. If the Map View gets openend again during the current session, {{UBIK}} zooms to the saved location using the saved zoom level.* If the Map View gets openend via the Context Action [[UBIK_Client_Basics#Context_Menu|Show in map]], {{UBIK}} zooms to the content´s location using the [[Settings#AR_settings|StandardMapZoomLevel]]. ==== Location button (Android) ====This button enables the user to zoom to the current position of the mobile device using the [[Settings#AR_settings|StandardMapZoomLevel]]. If the current zoom level is already closer to earth, the location of the mobile device is centered without applying the [[Settings#AR_settings|StandardMapZoomLevel]]. This button is only shown if a location is available. ==== Zoom buttons (Android) ====
The {{key press|+}} button zooms into the map, the {{key press|-}} button zooms out of the map.
{{Clear}}
== Interaction ==
=== POI details ===
[[File:UI_WinX_Map_POI_Panel.png|thumb|alt=POI Details Panel|POI Details Panel (Windows)]]
On Android, clicking on an icon on the map will display a [[POI dialog|POI dialog/Info window]].
On Windows, clicking on an icon on the map, will display a details panel on the right side of the map page. Another click on the selected POI will deselect it and dismiss the details panel.
=== POI dialog ===
By clicking on an icon on the map, a [[POI dialog]] will be displayed.
=== Map gestures ===
==== Zoom ====
* Double tap to increase the zoom level by 1 (zoom in).
* Two finger tap to decrease the zoom level by 1 (zoom out).
* Two finger pinch/stretch.
* One finger zooming by double tapping but not releasing on the second tap and then sliding the finger up or down the screen to zoom in and out respectively.
==== Scroll =Buildings & Indoor Maps ===A user can scroll (pan) around the map by dragging the map with their fingerSee [[Building_Levels|Building Levels]] for more info.
==== Tilt ====For versions using Google Maps instead of OSM (before Geographies {{Version/WinXSince|2.5.0), the map can be tilted.A user can tilt the map by placing two fingers on the map and moving them down or up together to increase or decrease the tilt angle respectively.This feature is not available anymore for newer versions (3}}{{Version/AndroidSince|2.5.05}})===See [[Geographies|Geographies]] for details.
==== Rotate ==See also ==For versions using Google Maps instead of OSM (before 2* [https://www.5openstreetmap.0), the map can be rotated.A user can rotate the map by placing two fingers on the map and applying a rotate motion.This feature is not available anymore for newer versions ({{Versionorg/AndroidSince|2.5.0}}).Open Street Map]
[[Category:Client|Map View]]
[[Category:Android|Map View]]
[[Category:WinX|Map View]]