View source for Map View (outdated)

Map View is the view that displays Points of Interests (POI’s) on a base map. Both clients, Android and WinX, are using [https://www.openstreetmap.org/ Open Street Maps (OSM)] 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]]
Since {{UBIK}} Android 2.5.0, Open Street Maps (OSM) is used instead of Google Maps; hence, no Google Play Services are required anymore. {{Version/AndroidSince|2.5.0}}

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 map and 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 base map typically displays all the [[SYSCLS_GEO|Geo content]] according to the rules described below. Different objects are represented by different icons on the map.

The rules regarding what content should be displayed are as follows:
* The object has to be a Geo 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;
** Objects that are '''not''' POI group items;
* If a [[#Map_layers_button| map layer]] is currently selected, objects that are shown are:
** [[SYSCLS_MAPITEM|Items]] of the current Map Layer;
** Objects that are '''not''' map layer items.
* If there is an object as the context of the map view (e.g. User opens a Geo content in the map), that object is displayed in addition to whatever else is.
* If an Image [[SYSCLS_MAPOVERLAY| Ground overlay]] is configured.
** This overlays are used to [[Image Map Overlays| visualize building schemes on the map]].  
{{Hint|Objects have to pass all the checks above in order to be shown.}}

{{Attention|Before {{Version/Android|2.4.3}} objects had to be in the [[SYSREL_INFRASTRUCTURE|Infrastructure]] in order to be shown at all.}}

=== Map menu ===

==== 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.

==== Map types setting (Windows) ====
[[File:UI_WinX_Map_Type_Setting.png|thumb|alt=Map Types|Map Types (Windows)]]
The user can choose different map types (Road and Satellite) for the base map. This setting can be found in the "Map" section of the application 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.

== 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]].
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.

=== Buildings & Indoor Maps ===
See [[Building_Levels|Building Levels]] for more info.

[[Category:Client|Map View]]