Getting started with Maria Map Maker: Difference between revisions

From Maria GDK Wiki
Jump to navigation Jump to search
(Created page with "This guide will take you the shortest path from first-time startup to a finished map which can be used in a Maria GDK based application. You will also hopefully get a feel for...")
 
No edit summary
 
(13 intermediate revisions by the same user not shown)
Line 1: Line 1:
This guide will take you the shortest path from first-time startup to a finished map which can be used in a Maria GDK based application. You will also hopefully get a feel for the workflow in M3.
Maria Map Maker (M3) is an application to create, edit and manage maps. These maps can be used in other applications built with the MARIA Geo Development Kit (GDK).


First, a quick explanation of a few key concepts in M3. Follow the links for more in-depth documentation.
This guide will take you the shortest path from first-time startup to a finished map. You will also hopefully get a feel for the workflow in M3.


|[[File:ic map black 24dp 1x.png|none]][[File:ic layers black 24dp 1x.png|none]]|[[mmm_basemaps_overlays.html|'''Basemap/overlay''']]|The basemap and the overlay are lists of map layers. Each layer is a reference to an existing map. They are the starting points for editing maps in M3. Basemaps and overlays are quite similar, but we'll focus on the basemap in this guide. |[[File:product all black.png|none]]|[[mmm_products.html|'''Product''']]|A product is a folder which contains a product metadata XML file. It will also contain map data, styling files, and/or other files which the creator has found it useful to distribute as a unit. |[[File:workspace black.png|none]]|'''Workspace'''|A workspace is simply a folder containing one or more products. A user can have several workspaces active simultaneously.
== Concepts ==
We begin with a quick explanation of a few key concepts in M3. These terms will probably sound familiar, but we will explain what they mean in M3.


=== Workspace ===
[[File:workspace black.png|24px]]
A workspace is simply a folder containing one or more products. The workspace should only contain products created by M3 - no subfolders or loose files. Working with maps requires a lot of reading and writing from disk. This means that you should create your workspace on a fast storage device (such as a local SSD) if possible.
=== Product ===
[[File:product all black.png|24px]]
The product is the basic container for map data and all related files. It also contains metadata describing the product and its contents. The product ususally contains one or more datasets with the same theme, covering a specific geographical area.
The product consists of a folder on disk, with a specific naming scheme:
''<Product name>_<Sequence number>_<Version ID>''
Example:
''NorwayTopoRaster_v25_db95990c''
=== Basemap/overlay ===
[[File:ic map black 24dp 1x.png]]
[[File:ic layers black 24dp 1x.png]]
The basemap and the overlay are lists of map layers, where each layer is a reference to an existing raster or vector dataset, or the address of a web map. Information about visibility, scales and draw order is also stored here.
Basemaps and overlays are the starting points for editing maps in M3. They are also the entry point to your maps when they are used in other MARIA GDK applications.
Example:
''Norway Topo Raster N50 - N5000''
===Dataset===
[[File:Vector_black.png|24px]]
[[File:Raster_black.png|24px]]
[[File:Ic_terrain_black_24dp_1x.png]]
[[File:3d-tiles-24px.png]]
[[File:M3-Geoloc-black-32px.png|24px]]
[[File:M3-Routing_db.png]]
The dataset is the actual geographical data, with accompanying styling information and metadata. Datasets are always stored in a product. A dataset comes in a variety of types in M3:
* Vector
* Raster
* Elevation
* 3D
* Location
* Routing
== Step by step instructions ==
=== 1. Set up workspace===
When starting up Maria Map Maker for the first time, it's necessary to define a workspace. This could be a folder where you have some existing products, or an empty folder where you intend to create new products. Click the '''SETTINGS''' button on the left sidebar, and the '''Workspaces''' tab will be the first option. Each workspace you add gets its own button on the sidebar.
When starting up Maria Map Maker for the first time, it's necessary to define a workspace. This could be a folder where you have some existing products, or an empty folder where you intend to create new products. Click the '''SETTINGS''' button on the left sidebar, and the '''Workspaces''' tab will be the first option. Each workspace you add gets its own button on the sidebar.


[[File:M3 settings workspaces.png|none|frame|A workspace must be added before you can start working]]
[[File:M3 settings workspaces.png|none]]
 
 
=== 2. Import data ===
Now that you have a workspace configured, you can start importing data. In this example, we have a simple GeoTIFF file. The quickest way to import it is to simply drag and drop it on the map area. This will open the '''Map Import''' dialog.  We will leave all the options as they are. This will automatically create a new ''product'' and a new ''overlay'' for the dataset we're importing.
 
[[File:M3_simple_raster_import.PNG]]


Now that you have a workspace configured, you can start importing data. The quickest way to do this is to simply drag and drop a folder or file on the map area. This will open the '''Map Import''' dialog. In this example, we'll import at simple GeoTIFF file. We will leave all the options as they are.


Starting the import creates a Map Task, which you can follow in the '''Map Task Queue''' window.
=== 3. Map task ===
Starting the import creates a Map Task, which you can follow in the '''Map Task Queue''' window. When the Map Task is finished, you can double-click it to open the new product it was imported to.


[[File:M3 mapimport maptaskqueue.png|none|frame|The Map Task Queue]]
[[File:M3 mapimport maptaskqueue.png]]


When the map task is finished, a new product will have been created. The product will contain the raster dataset you imported, as well as an overlay with a reference to this dataset. To view the data, open your workspace, and double-click the new product.


[[File:M3 gettingstarted product.png|none|frame|A new map product was created for your dataset]]
=== 4. Open overlay ===
You now see the contents of the product - a raster dataset and an overlay. All editing and viewing of map datasets is done via the overlay, so double-click it to see your dataset in the map.


In the product window, double-click the overlay.
[[File:M3 gettingstarted overlay.png]]


[[File:M3 gettingstarted overlay.png|none|frame|A new overlay was created with a reference to the dataset you imported.]]


You should now see the dataset you imported. This product is now compatible and will be shown as is (background map not included) in any Maria GDK based application.
=== 5. Finished ===
You are now looking at the overlay. It contains a single layer - a reference to the raster dataset you just imported. The dataset should be visible in the map area. Your product is now ready to be used in any application based on MARIA GDK.


[[File:M3 gettingstarted finished.png|900px|none|The overlay references the dataset as a layer]]
[[File:M3 gettingstarted finished.png|900px]]


[[Category:Maria Map Maker]]
[[Category:Maria Map Maker|001]]

Latest revision as of 16:32, 1 November 2022

Maria Map Maker (M3) is an application to create, edit and manage maps. These maps can be used in other applications built with the MARIA Geo Development Kit (GDK).

This guide will take you the shortest path from first-time startup to a finished map. You will also hopefully get a feel for the workflow in M3.

Concepts

We begin with a quick explanation of a few key concepts in M3. These terms will probably sound familiar, but we will explain what they mean in M3.

Workspace

Workspace black.png

A workspace is simply a folder containing one or more products. The workspace should only contain products created by M3 - no subfolders or loose files. Working with maps requires a lot of reading and writing from disk. This means that you should create your workspace on a fast storage device (such as a local SSD) if possible.

Product

Product all black.png

The product is the basic container for map data and all related files. It also contains metadata describing the product and its contents. The product ususally contains one or more datasets with the same theme, covering a specific geographical area.

The product consists of a folder on disk, with a specific naming scheme: <Product name>_<Sequence number>_<Version ID>

Example: NorwayTopoRaster_v25_db95990c

Basemap/overlay

Ic map black 24dp 1x.png Ic layers black 24dp 1x.png

The basemap and the overlay are lists of map layers, where each layer is a reference to an existing raster or vector dataset, or the address of a web map. Information about visibility, scales and draw order is also stored here.

Basemaps and overlays are the starting points for editing maps in M3. They are also the entry point to your maps when they are used in other MARIA GDK applications.

Example: Norway Topo Raster N50 - N5000

Dataset

Vector black.png Raster black.png Ic terrain black 24dp 1x.png 3d-tiles-24px.png M3-Geoloc-black-32px.png M3-Routing db.png

The dataset is the actual geographical data, with accompanying styling information and metadata. Datasets are always stored in a product. A dataset comes in a variety of types in M3:

  • Vector
  • Raster
  • Elevation
  • 3D
  • Location
  • Routing

Step by step instructions

1. Set up workspace

When starting up Maria Map Maker for the first time, it's necessary to define a workspace. This could be a folder where you have some existing products, or an empty folder where you intend to create new products. Click the SETTINGS button on the left sidebar, and the Workspaces tab will be the first option. Each workspace you add gets its own button on the sidebar.

M3 settings workspaces.png


2. Import data

Now that you have a workspace configured, you can start importing data. In this example, we have a simple GeoTIFF file. The quickest way to import it is to simply drag and drop it on the map area. This will open the Map Import dialog. We will leave all the options as they are. This will automatically create a new product and a new overlay for the dataset we're importing.

M3 simple raster import.PNG


3. Map task

Starting the import creates a Map Task, which you can follow in the Map Task Queue window. When the Map Task is finished, you can double-click it to open the new product it was imported to.

M3 mapimport maptaskqueue.png


4. Open overlay

You now see the contents of the product - a raster dataset and an overlay. All editing and viewing of map datasets is done via the overlay, so double-click it to see your dataset in the map.

M3 gettingstarted overlay.png


5. Finished

You are now looking at the overlay. It contains a single layer - a reference to the raster dataset you just imported. The dataset should be visible in the map area. Your product is now ready to be used in any application based on MARIA GDK.

M3 gettingstarted finished.png

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