Last modified on 6 May 2022, at 07:53

Map View (outdated)

Revision as of 07:53, 6 May 2022 by LGE (Talk | contribs)

Map View is the view that displays Points of Interests (POI’s) on a base map. Both clients, Android and WinX, are using Open Street Maps (OSM) for its map source materials.

Google Maps (Android)

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.

Up to Version 2.5.0 UBIK® integrates Google Maps which requires 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.

Visualization

Map view
Map view (Android)
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 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 or a Geography content
  • If a POI group is currently open/active, objects that are shown are:
    • POI group items that belong to the current group;
    • Objects that are not POI group items;
  • If a map layer is currently selected, objects that are shown are:
    • 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 Ground overlay is configured.
IC Hint square.pngObjects have to pass all the checks above in order to be shown.
IC Attention.pngBefore Version 2.4.3 - Android objects had to be in the Infrastructure in order to be shown at all.


Map menu

Map layers button

Map layer dialog
Map layer dialog (Android)
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)

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 2.5.0 - Android on though. There, only Normal is available currently. Satellite is available .

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 DefaultMapZoomLocation using the 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 Show in map, UBIK® zooms to the content´s location using the StandardMapZoomLevel.

Location button (Android)

This button enables the user to zoom to the current position of the mobile device using the StandardMapZoomLevel. If the current zoom level is already closer to earth, the location of the mobile device is centered without applying the StandardMapZoomLevel. This button is only shown if a location is available.

Zoom buttons (Android)

The + button zooms into the map, the - button zooms out of the map.

Interaction

POI details

POI Details Panel
POI Details Panel (Windows)

On Android, clicking on an icon on the map will display a 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.


Buildings & Indoor Maps

See Building Levels for more info.

Geographies

See Geographies for details.


See also