Jump to: navigation, search

Difference between revisions of "Map View (Xamarin)"


(Show context object on map {{Version/XamarinSince|1.3}})
(Redirected page to Map View)
 
(6 intermediate revisions by 3 users not shown)
Line 1: Line 1:
Similar to the [[Map_View|map view on our other {{UBIK}} clients]], the Xamarin version displays Points of Interest (POIs) and other objects with Geo information on world maps.
+
#REDIRECT [[Map View]]
 
+
= Base Map =
+
A world map is always displayed as the base layer of the map view. Depending on the "Map Type" setting (in the "AR" tab/category), different maps are used.
+
* Road: from Open Street map;
+
* Satellite: from Microsoft Bing map.
+
 
+
<gallery widths="280" heights="260">
+
File:UI_Xamarin_Map_Road.png|alt=Road Map
+
File:UI_Xamarin_Map_Satellite.png|alt=Satellite Map
+
</gallery>
+
 
+
Some basic UI options commonly seen in map applications are available as well. For example, an indicator for the current device position, buttons to center around the current position, etc.
+
 
+
= UBIK Map Content =
+
On the base map, {{UBIK}} can display different kinds of content with Geo information.
+
 
+
== Geo POIs ==
+
For each object carrying [[SYSCLS_GEO|Geo coordinates]], {{UBIK}} displays a map pin on the map accordingly. The object's icon (if any) is also included in the map pin.
+
 
+
Like in the [[POI_View_(Xamarin)|POI view]], you can select or deselect POIs. The options available on selected POIs are described in section [[POI_View_(Xamarin)#Interact_with_POIs|"Interact with POIs"]].
+
 
+
== Map Overlays ==
+
[[File:UI_Xamarin_Map_Overlay.png|thumb|alt=Map Overlay|Map Overlay]]
+
Sometimes more detailed maps are needed for specific and smaller regions, e.g. a factory. Map overlays are such image based maps that are displayed on top of the base map. The placement of an overlay is determined by [[SYSCLS_MAPOVERLAY|certain configurations on the overlay object]].
+
 
+
Here's an article on how to [[HowTo:Create_Image_Map_Overlays]].
+
 
+
{{Clear}}
+
 
+
== Map Shapes ==
+
[[File:UI_Xamarin_Map_Shape.png|thumb|alt=Map Shape|Map Shape]]
+
Map shapes can be considered as map overlays defined in a different data format.
+
* Like map overlays, they are displayed on top of the base map;
+
* Unlike map overlays, their display content as well as placements on the map are defined in [https://wiki.openstreetmap.org/wiki/Shapefiles shapefiles]. Details can be found [[SYSCLS_MAPSHAPE|here]].
+
 
+
{{Clear}}
+
 
+
== Group, Building & Level ==
+
The way Geo POIs can be grouped and displayed accordingly in the map view is exactly the same as in the [[POI_View_(Xamarin)#Group.2C_Building_.26_Level|POI view]]. In addition, other types of map content like map overlays & shapes can also belong to groups, buildings or levels. The displaying of them follows the same rules.
+
 
+
== Show on map {{Version/XamarinSince|1.3}} ==
+
When you execute the NavigateToMapPageCommand from a context object (e.g. ContentViewModel, ContentPageViewModel, ContentListItemViewModel, etc.), the map view will be opened with that context object. This includes:
+
* Entering necessary POI groups, buildings or building levels so that the context object is visible on the map;
+
* Centering the map around the context object;
+
* Selecting the POI for the context object automatically. (Once you start interacting with the map by e.g. entering another building, the selected states will most likely change.)
+
 
+
{{Attention|Unlike executing the NavigateToMapPageCommand from a place without a context object, doing so with one will additionally check the validity of that object, namely if it at least [[SYSCLS_GEO|has geo information]]. If not, the command will be disabled.}}
+
  
 
[[Category:Client|Map View (Xamarin)]]
 
[[Category:Client|Map View (Xamarin)]]
 
[[Category:Version 1.1|Map View (Xamarin)]]
 
[[Category:Version 1.1|Map View (Xamarin)]]
 
[[Category:Xamarin|Map View (Xamarin)]]
 
[[Category:Xamarin|Map View (Xamarin)]]

Latest revision as of 14:17, 21 February 2024

Redirect to: