Jump to: navigation, search

Difference between revisions of "Map View (Xamarin)"


(Redirected page to Map View)
 
(3 intermediate revisions by 2 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.
+
* Standard (Open Street Map).
+
* Satellite (Bing Maps).
+
* Road (Bing Maps).{{Version/XamarinSince|4.5}}
+
 
+
<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.
+
 
+
== Customizable tile source for Bing road maps {{Version/XamarinSince|4.5}} ==
+
Bing maps support many parameters and offer multiple servers to deliver map tiles. {{UBIK}} allows the user to customize the BingRoadTilesUrl in a profile to achieve the following.
+
* Use different servers to get the more reliable and suitable tiles service if necessary;
+
* Specify a language/culture in which the tiles should be delivered;
+
* Or even request different types of Bing map tiles.
+
 
+
By default (namely BingRoadTilesUrl is unspecified), the following URL pattern is used.
+
 
+
<code><nowiki>http://ak.dynamic.t{s}.tiles.virtualearth.net/comp/ch/{quadkey}?mkt=en-US&amp;it=G,L&amp;shading=hill&amp;og=2290&amp;n=z&amp;token={k}</nowiki></code>
+
 
+
In this case, all tiles are delivered in English since that's requested through <code><nowiki>mkt=en-US</nowiki></code>. Please refer to [https://learn.microsoft.com/en-us/bingmaps/rest-services/common-parameters-and-types/supported-culture-codes supported culture codes] from Microsoft when you want tiles in other languages.
+
 
+
{{Hint|Microsoft also provides a Chinese server URL pattern<br/> <code><nowiki>https://dynamic.t{s}.tiles.ditu.live.com/comp/ch/{quadkey}?mkt=zh-CN&amp;it=G,L&amp;ur=CN&amp;og=804&amp;n=z&amp;token={k}</nowiki></code>.<br/> Just for clarification, it is also possible to request map tiles in Chinese using the default URL pattern as long as the correct culture code is specified, namely <code><nowiki>mkt=zh-Hans</nowiki></code>, <code><nowiki>mkt=zh-Hant</nowiki></code> or <code><nowiki>mkt=zh-CN</nowiki></code>.<br/> But the dedicated one might deliver tiles that comply more to the local laws. Please choose one that you see fit.}}
+
 
+
 
+
= 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: