Maria globe client: Difference between revisions

From Maria GDK Wiki
Jump to navigation Jump to search
(→)
(→)
 
(147 intermediate revisions by 2 users not shown)
Line 1: Line 1:
This page describes how to create a Maria GDK map client utilising '''''MariaGlobeMapControl''''' with 2D and 3D visualisation of map, tracks and draw objects.
[[File:Globe-3D.PNG|right|thumb|Maria Globe Client]]


[[File:Globe-3D.PNG|right|thumb|Maria Globe Client]]
These pages describe how to create a Maria GDK map client utilising '''''MariaGlobeMapControl''''' with 2D and 3D visualisation of map, tracks and draw objects.


== General ==
== General ==


* You will need to include the following NuGet package:
; Note
** '''''TPG.Maria.MariaGlobeMapControl''''' (Currently available Teleplan Globe internal only)
:* You will need to include the '''''TPG.MariaGDK3D''''' NuGet package. (Currently available Teleplan Globe internal only)
 
:: For more info, see [[Development requirements#Loading Maria GDK Packages| Loading Maria GDK, NuGet Packages]]
* Sample code is found in the '''''MariaGlobeClient''''' project, in the '''''Sample Projects''''' solution.  
:* Sample code is found in the '''''MariaGlobeClient''''' project, in the '''''Sample Projects''''' solution.  
** Note that the sample code is specifying the service connections in ''code'', and not by '''''app.config'''''.
:* Note that the sample code is specifying the service connections in ''code'', and not by '''''app.config'''''.
 
:* For general troubleshooting, see [[Development_troubleshooting|Development troubleshooting]]
== Utilising the globe control ==
 
=== Including MariaGlobeMapControl ===
 
Create a WPF Application, and add the necessary NuGet references. For details, see [[Basic map client|Maria Basic Map Client]].
 
Add the '''''MariaGlobeMapControl''''' to the Main window xaml.
 
<source lang="xml">
<Window x:Class="MariaGlobeClient.MainWindow"
        . . .
        Title="MariaGlobeClient" Height="600" Width="600">
    <Grid>
        <MariaGlobeMapControl x:Name="MariaGlobeCtrl" Background="#E9ECFA"                                                 
                              Is3DMode="False"
                              MouseMoveDistanceToStartTracking="0"
                              ZoomOnDblClick="False"
                              DegreeToLockRotateAndScale="2"
                              PercentageToLockScaleOnly="2.0"
                              IsProgressIndicatorVisible="False" />
    </Grid>
</Window>
</source>
 
=== Add view models ===
 
* Add a view model class (''MainViewModel'') for communication with the Maria component, and another (''MapViewModel'') for map handling. Both including inheritance from ViewModelBase, for details see [[Map_interaction_client/Prepare_your_application_for_interactions|''Prepare your application for interactions'']].
 
* Set the data context of your client window to the '''''MainViewModel''''', and implement an event handler for the '''''WindowClosing''''' event. For details see [[Basic map client|Maria Basic Map Client]].
 
==== MainViewModel ====
 
Add the following fields, properties and constructor to the '''''MainViewModel''''':
<source lang="c#">
private IMariaMapLayer _mapLayer;
private IMariaMapLayer _miniMapLayer;
 
public MapViewModel MapViewModel { get; }
public ObservableCollection<IMariaLayer> Layers { get; set; }
 
public IMapTemplateServiceClient MapTemplateServiceClient { get; private set; }
public IMapCatalogServiceClient MapCatalogServiceClient { get; private set; }
public GlobeMapManager GlobeMapManager { get; }
 
internal MainViewModel()
{
    Layers = new ObservableCollection<IMariaLayer>();
 
    IBindingFactory bindingFactory = new BindingFactory();
    IEndpointAddressFactory endpointAddressFactory = new EndpointAddressFactory();
 
    // Set up template client
    MapTemplateServiceClient = new MapTemplateServiceClientFactory(
        bindingFactory,
        endpointAddressFactory).New("http://tpg-geostore:9008/maptemplates", BindingType.BasicHttp);
 
    // Set up catalog service client and connect to service
    MapCatalogServiceClient = new MapCatalogServiceClient(
        bindingFactory.New(BindingType.BasicHttp),
        endpointAddressFactory.New("http://tpg-geostore:9008/catalog"));
 
 
    GlobeMapManager = new GlobeMapManager(MapCatalogServiceClient, MapTemplateServiceClient);
    GlobeMapManager.TileCacheManager.MaxCacheSize = 250;
 
    _mapLayer = new MapLayer(GlobeMapManager);
    _miniMapLayer = new MapLayer(GlobeMapManager);
    MapViewModel = new MapViewModel(_mapLayer, _miniMapLayer, this);
    Layers.Add(_mapLayer);
}


</source>
== Sections ==
;The following main topics are handled:


==== MapViewModel ====
{| class="wikitable"
|-
|
;1. [[Maria_globe_client/Utilising_the_globe_control|Utilising the globe control]]
|
[[File:Globe_First-3D.PNG|150px|link=Maria_globe_client/Utilising_the_globe_control]]
|-
|
;2. [[Maria_globe_client/Map_interaction|Map interaction]]
|
[[File:Map_Pref_3D.PNG|150px|link=Maria_globe_client/Map_interaction]]
|-
|
;3. [[Maria_globe_client/Draw_object_interaction|Draw object interaction]]
|
[[File:DrawObjects_3D.PNG|150px|link=Maria_globe_client/Draw_object_interaction]]
|-
|
;4. [[Maria_globe_client/Track_interaction|Track interaction]]
|
[[File:Track_3D.PNG|150px|link=Maria_globe_client/Track_interaction]]
|-
|
;5. [[Maria_globe_client/Auto_follow|Auto follow]]
|
[[File:Auto_follow_track_3D.PNG|150px|link=Maria_globe_client/Auto_follow]]
|-
|
;6. [[Maria_globe_client/Advanced_map_settings|Advanced map settings]]
|
[[File:3D_Set_P15_Y120_R30_af.png|150px|link=Maria_globe_client/Advanced_map_settings]]
|}






<source lang="c#">
[[Category:Creating applications]]
   
</source>

Latest revision as of 13:58, 28 October 2019

Maria Globe Client

These pages describe how to create a Maria GDK map client utilising MariaGlobeMapControl with 2D and 3D visualisation of map, tracks and draw objects.

General

Note
  • You will need to include the TPG.MariaGDK3D NuGet package. (Currently available Teleplan Globe internal only)
For more info, see Loading Maria GDK, NuGet Packages
  • Sample code is found in the MariaGlobeClient project, in the Sample Projects solution.
  • Note that the sample code is specifying the service connections in code, and not by app.config.
  • For general troubleshooting, see Development troubleshooting

Sections

The following main topics are handled
1. Utilising the globe control

Globe First-3D.PNG

2. Map interaction

Map Pref 3D.PNG

3. Draw object interaction

DrawObjects 3D.PNG

4. Track interaction

Track 3D.PNG

5. Auto follow

Auto follow track 3D.PNG

6. Advanced map settings

3D Set P15 Y120 R30 af.png

Retrieved from "http://docs.maria.teleplanglobe.com/index.php?title=Maria_globe_client&oldid=3072"