Changes

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}}

[[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).

The rules regarding what content should be displayed are as follows.:* An The object has to be in the infrastructure in order to be shown;a Geo content or a [[Geographies|Geography]]{{AttentionVersion/WinXSince|This has become optional since [[Release_22.45.3]]}}{{Version/AndroidSince|2.5.5}} content

** Objects that are '''not ''' POI group items;

** [[SYSCLS_MAPITEM|map layer itemsItems]] that belong to of the current layerMap Layer;** Objects that are '''not ''' map layer items.* If there is an object as the context of the map view (e.g. Users open User opens a Geo object 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]]. {{AttentionHint|Objects have to pass all the checks above in order to be shown.}}

==== Map settings button menu ====[[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.

[[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)]]

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

=== Zoom buttons = Map types setting (Android) ====The {{key press|+}} button zooms into When Google Maps is used as a basic technology, the user can choose different maptypes (Normal, Satellite and Hybrid) for the {{key press|-}} button zooms out of 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 {{ClearVersion/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.

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

==== Zoom ====* Double tap to increase the zoom level by 1 (zoom in)Geographies {{Version/WinXSince|2.* Two finger tap to decrease the zoom level by 1 (zoom out)5.* Two finger pinch3}}{{Version/stretchAndroidSince|2.5.5}} ===* 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 respectivelySee [[Geographies|Geographies]] for details.

==== Rotate ==See also ==A user can rotate the map by placing two fingers on the map and applying a rotate motion* [https://www.openstreetmap.org/ Open Street Map]

[[Category:Client|Map View]][[Category:Android|Map View]][[Category:WinX|Map View]]