Marble/MapThemes: Difference between revisions

From KDE Wiki Sandbox
No edit summary
 
(24 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Construction}}
<languages />
<translate>


One of the core features of Marble is the support for different maps (map themes in Marble speak) and different planets. Each of them can be viewed in different projections: Make the planet look like a globe using the ''Spherical'' projection or view it like a printed map in the ''Mercator'' projection.
<!--T:1-->
{{Prevnext|Special:myLanguage/Marble/Tracking|Special:myLanguage/Marble/Bookmarks|Tracking|Bookmarks}}


== Planet Choices ==
<!--T:2-->
One of the core features of '''Marble''' is the support for different maps (map themes in '''Marble''' speak) and different planets. Each of them can be viewed in different projections: Make the planet look like a globe using the ''Spherical'' projection or view it like a printed map in the ''Mercator'' projection.


== Map Theme Choices ==
<!--T:3-->
Map themes are configured in the <menuchoice>Map View</menuchoice> dialog in '''Marble'''. You find it in the tab bar on the left in the Desktop version.


=== Overview Maps ===
<!--T:34-->
[[Image:Marble-MapView-Desktop.png|400px|center]]
 
<!--T:4-->
'''Marble's''' mobile version on the Nokia N900 offers you to open the <menuchoice>Map View</menuchoice> dialog via the main application menu.
 
<!--T:35-->
[[Image:Marble-MapView-Maemo.png|400px|center]]
 
<!--T:5-->
The <menuchoice>Map View</menuchoice> dialog lets you choose a projection, the planet (celestial body) and a map theme. The rest of this tutorials explains these choices in detail.
 
== Planet Choices == <!--T:6-->
 
<!--T:7-->
'''Marble''' supports about a dozen different planets. In the <menuchoice>Map View</menuchoice> dialog you can choose those planets where at least one map theme is installed for.
 
<!--T:8-->
{|class="tablecenter" style="border: 1px solid grey;"
|[[Image:Marble-Planet-Earth.png]]<br />Earth. Plenty of different map themes are available.
|[[Image:Marble-Planet-Moon.png]]<br />Moon. We're aware it's not really a planet.
|-
|[[Image:Marble-Planet-Mars.png]]<br />Mars
|[[Image:Marble-Planet-Venus.png]]<br />Venus
|-
|}
 
== Projection Choices == <!--T:9-->
 
<!--T:10-->
The projection defines how the surface of the planet is presented on the screen. This can be a globe or some sort of a flat map.
 
<!--T:11-->
{|class="vertical-centered wikitable" style="border: 1px solid grey;"
{|class="vertical-centered wikitable" style="border: 1px solid grey;"
! Map Theme || Preview || Description
!||Spherical Projection||Flat Map Projection||Mercator Projection
|-
!Example
|[[Image:Marble-Spherical.png|246px|center]]||[[Image:Marble-FlatMap.png|246px|center]]||[[Image:Marble-Mercator.png|246px|center]]
|-
!Common Usage
|Distant view, measuring large distances||Distant view||Close view, navigation
|}
 
<!--T:12-->
{{Tip|Unsure which projection to choose? A rule of thumb is to use the <menuchoice>Spherical</menuchoice> projection at very large distances and the <menuchoice>Mercator</menuchoice> projection otherwise.}}
 
== Map Theme Choices == <!--T:13-->
 
=== Overview Maps === <!--T:14-->
 
<!--T:15-->
{|class="vertical-centered wikitable" style="border: 1px solid grey;"
! width="100px" | Map Theme || Preview || Description
|-
|-
| Atlas
| Atlas
| [[Image:Marble-MapTheme-Atlas.png]] || A classic topographic map. It uses vector lines to mark coastlines, country borders etc. and a height relief.
| [[Image:Marble-MapTheme-Atlas.png]] || A classic topographic map. It uses vector lines to mark coastlines, country borders etc. and a height relief.
|-
| Plain Map
| [[Image:Marble-MapTheme-PlainMap.png]] || A simple version of the Atlas theme without topography.
|-
|-
| Satellite View
| Satellite View
| [[Image:Marble-MapTheme-SatelliteView.png]] || Earth as seen from space with sun illumination. Includes a cloud layer with real-time data.
| [[Image:Marble-MapTheme-SatelliteView.png]] || Earth as seen from space with sun illumination. Includes a cloud layer with real-time data.
|-
| Natural Earth
| [[Image:Marble-MapTheme-NaturalEarth.png]] || Natural Earth portrays the world environment in an idealized manner with little human influence. Includes a cloud layer with real-time data.
|-
|-
| Earth at Night
| Earth at Night
| [[Image:Marble-MapTheme-EarthAtNight.png]] || Earth as seen from space without sun illumination.
| [[Image:Marble-MapTheme-EarthAtNight.png]] || Earth as seen from space without sun illumination.
|-
| Plain Map
| [[Image:Marble-MapTheme-PlainMap.png]] || A simple version of the Atlas theme without topography.
|-
|-
|}
|}


=== Street Maps ===
=== Street Maps === <!--T:16-->
 
<!--T:17-->
These maps are optimized for high zoom levels, showing many details on the street and city level. Some of them provide good country and even continent or space views, but that's not their primary area of use. Need to find a route? Do you like hiking or biking? Want to explore the neighborhood? Pick one of these maps.
These maps are optimized for high zoom levels, showing many details on the street and city level. Some of them provide good country and even continent or space views, but that's not their primary area of use. Need to find a route? Do you like hiking or biking? Want to explore the neighborhood? Pick one of these maps.
</translate>
{|class="vertical-centered wikitable" style="border: 1px solid grey;"
{|class="vertical-centered wikitable" style="border: 1px solid grey;"
! Map Theme || Preview || Description
! <translate><!--T:18-->
width="100px" | Map Theme || Preview || Description
</translate>
|-
|-
! <p>OpenStreetMap</p><p>General purpose</p>
! <translate><!--T:19-->
<p>OpenStreetMap</p><p>General purpose</p>
| [[Image:Marble-MapTheme-OpenStreetMap.png]] || <p>The famous OpenStreetMap Mapnik layer. A general purpose map with useful information for the most common use cases. The map is identical to that shown on [http://openstreetmap.org openstreetmap.org].</p><p>Combine this map theme with the Mercator projection for optimal speed and a sharp map view.</p>
| [[Image:Marble-MapTheme-OpenStreetMap.png]] || <p>The famous OpenStreetMap Mapnik layer. A general purpose map with useful information for the most common use cases. The map is identical to that shown on [http://openstreetmap.org openstreetmap.org].</p><p>Combine this map theme with the Mercator projection for optimal speed and a sharp map view.</p>
</translate>
|-
|-
! <p>Osmarender</p><p>General purpose</p>
! <translate><!--T:20-->
<p>Osmarender</p><p>General purpose</p>
| [[Image:Marble-MapTheme-Osmarender.png]] || <p>The OpenStreetMap Osmarender layer. A general purpose map with useful information for the most common use cases. The map is identical to that selectable in the top-right toolbox on [http://openstreetmap.org openstreetmap.org].</p><p>Compared to the Mapnik layer (OpenStreetMap theme), this theme has more lively colors and presents some different data. The view from space looks better than that of Mapnik. On the other hand, Mapnik handles conflicting elements at the street level better. In Osmarender, icon sizes are less balanced and the z-order (stacking) is wrong for some elements. Labels overlap in densely packed areas.</p><p>Combine this map theme with the Mercator projection for optimal speed and a sharp map view.</p>
| [[Image:Marble-MapTheme-Osmarender.png]] || <p>The OpenStreetMap Osmarender layer. A general purpose map with useful information for the most common use cases. The map is identical to that selectable in the top-right toolbox on [http://openstreetmap.org openstreetmap.org].</p><p>Compared to the Mapnik layer (OpenStreetMap theme), this theme has more lively colors and presents some different data. The view from space looks better than that of Mapnik. On the other hand, Mapnik handles conflicting elements at the street level better. In Osmarender, icon sizes are less balanced and the z-order (stacking) is wrong for some elements. Labels overlap in densely packed areas.</p><p>Combine this map theme with the Mercator projection for optimal speed and a sharp map view.</p>
</translate>
|-
|-
! <p>OpenCycleMap</p><p>For bikers</p>
!<translate> <!--T:21-->
<p>OpenCycleMap</p><p>For bikers</p>
| [[Image:Marble-MapTheme-OpenCycleMap.png]] || <p>OpenStreetMap data presented for bikers. The map is identical to that selectable in the top-right toolbox on [http://openstreetmap.org openstreetmap.org].</p><p>Combine this map theme with the Mercator projection for optimal speed and a sharp map view.</p>
| [[Image:Marble-MapTheme-OpenCycleMap.png]] || <p>OpenStreetMap data presented for bikers. The map is identical to that selectable in the top-right toolbox on [http://openstreetmap.org openstreetmap.org].</p><p>Combine this map theme with the Mercator projection for optimal speed and a sharp map view.</p>
</translate>
|-
|-
! <p>OSM Hike & Bike Map</p><p>For hikers and bikers</p>
! <translate><!--T:22-->
| [[Image:Marble-MapTheme-OsmHikeAndBikeMap.png]] || <p>A map theme optimized for hiking and biking, based on OpenStreetMap data. Includes a very nice hillshading layer that shows the terrain (activate it in the Legend).</p><p>Combine this map theme with the Mercator projection for optimal speed and a sharp map view.</p>
<p>OSM Hike & Bike Map</p><p>For hikers and bikers</p>
| [[Image:Marble-MapTheme-OsmHikeAndBikeMap.png]] || <p>A map theme optimized for hiking and biking, based on OpenStreetMap data. Includes a very nice hillshading layer that shows the terrain (activate it in the <menuchoice>Legend</menuchoice> tab).</p><p>Combine this map theme with the Mercator projection for optimal speed and a sharp map view.</p>
</translate>
|-
|-
|}
|}


=== Educational Maps ===
<translate>
=== Educational Maps === <!--T:23-->
 
<!--T:24-->
{|class="vertical-centered wikitable" style="border: 1px solid grey;"
{|class="vertical-centered wikitable" style="border: 1px solid grey;"
! Map Theme || Preview || Description
! width="100px" | Map Theme || Preview || Description
|-
|-
| Historical Map 1689
| Historical Map 1689
| TODO || A historical world map from the year 1689 created by G. van Schagen in Amsterdam.
| [[Image:Marble-MapTheme-HistoricalMap1689.png]] || A historical world map from the year 1689 created by G. van Schagen in Amsterdam.
|-
| Historical Map 1720
| [[Image:Marble-MapTheme-HistoricalMap1720.png]] || A historical world map from the year 1720 created by Guillaume de L'Isle in Paris.
|-
| Historical Map 1786
| [[Image:Marble-MapTheme-HistoricalMap1786.png]] || A historical world map from the year 1786 created by William Faden in London.
|-
|-
| Precipitation (month)
| Precipitation (month)
| TODO || Colors indicate the precipitation in the given month
| [[Image:Marble-MapTheme-Precipitation.png]] || Colors indicate the [http://en.wikipedia.org/wiki/Precipitation_(meteorology) precipitation] in the given month. Open the <menuchoice>Legend</menuchoice> tab to find out which color matches which precipitation.
|-
|-
| Temperature (month)
| Temperature (month)
| TODO || Colors indicate the average temperature in the given month
| [[Image:Marble-MapTheme-Temperature.png]] || Colors indicate the average temperature in the given month. Open the <menuchoice>Legend</menuchoice> tab to find out which color matches which temperature.
|-
|-
|}
|}


=== Restricted Maps === <!--T:25-->


...
<!--T:26-->
These map themes work fine in '''Marble''' from a technical point of view. The terms of service of the companies offering these maps, however, may prevent you from using it. If you want to use these map themes, you must install them manually. Make sure their terms of service allow you to use them within '''Marble'''.


<!--T:27-->
{{Warning|1=To the best of our knowledge the usage of these restricted maps is forbidden in an application like '''Marble'''. We only want to demonstrate the technical feasibility here. Please don't add details on their installation in '''Marble''' to this Wiki. We don't want to promote the usage of maps which we think are not free.<br /><br />Read more about the restrictions on using Google Maps in [http://nienhueser.de/blog/?p=495 Dennis Nienhüser's blog].}}
<!--T:28-->
{|class="vertical-centered wikitable" style="border: 1px solid grey;"
{|class="vertical-centered wikitable" style="border: 1px solid grey;"
! Map Theme || Linux (KDE) || Mac, Windows || Maemo (N900)
! width="100px" | Map Theme || Preview || Description
|-
|-
| OpenStreetMap
! Google Maps
| style="background: #d8e8c2;" | Packaged || style="background: #d8e8c2;" | Packaged || style="background: #d8e8c2;" | Packaged
| [[Image:Marble-MapTheme-GoogleMaps.png]] || Street maps from [http://maps.google.com/ maps.google.com]
|-
|-
| Atlas
! Google Satellite
| style="background: #d8e8c2;" | Packaged || style="background: #d8e8c2;" | Packaged || style="background: #fff6c8;" | ''Marble Maps'' package
| [[Image:Marble-MapTheme-GoogleSatellite.png]] || Satellite maps from [http://maps.google.com/ maps.google.com]
|-
! Mapquest
| [[Image:Marble-MapTheme-Mapquest.png]] || Street maps from [http://mapquest.com/ mapquest.com]
|-
! Virtual Earth
| [[Image:Marble-MapTheme-VirtualEarth.png]] || Satellite maps from [http://virtualearth.net/ virtualearth.net]
|-
|-
|}
|}


== Projection Choices ==
== Installing Additional Map Themes == <!--T:29-->


<!--T:30-->
{|class="vertical-centered wikitable" style="border: 1px solid grey;"
{|class="vertical-centered wikitable" style="border: 1px solid grey;"
!||Spherical Projection||Flat Map Projection||Mercator Projection
! width="100px" | Map Theme || Linux (KDE) || Mac, Windows || Maemo (N900)
|-
| Atlas || style="background: #d8e8c2;" | Packaged || style="background: #d8e8c2;" | Packaged || style="background: #fff6c8;" | ''Marble Maps'' package
|-
| Earth at Night || style="background: #d8e8c2;" | Packaged || style="background: #d8e8c2;" | Packaged || style="background: #fff6c8;" | ''Marble Maps'' package
|-
| Google Maps || style="background: #ffd9b0;" | Manual installation ||style="background: #ffd9b0;" | Manual installation || style="background: #ffd9b0;" | Manual installation
|-
| Google Satellite || style="background: #ffd9b0;" | Manual installation ||style="background: #ffd9b0;" | Manual installation || style="background: #ffd9b0;" | Manual installation
|-
| Historical Map 1689 || style="background: #fff6c8;" | ''Download Maps'' feature ||style="background: #ffd9b0;" | [http://edu.kde.org/marble/maps.php Manual installation] || style="background: #fff6c8;" | ''Marble Maps'' package
|-
| Historical Map 1720 || style="background: #fff6c8;" | ''Download Maps'' feature ||style="background: #ffd9b0;" | [http://edu.kde.org/marble/maps.php Manual installation] || style="background: #ffd9b0;" | [http://edu.kde.org/marble/maps.php Manual installation]
|-
| Historical Map 1786 || style="background: #fff6c8;" | ''Download Maps'' feature ||style="background: #ffd9b0;" | [http://edu.kde.org/marble/maps.php Manual installation] || style="background: #ffd9b0;" | [http://edu.kde.org/marble/maps.php Manual installation]
|-
| Mapquest || style="background: #ffd9b0;" | Manual installation ||style="background: #ffd9b0;" | Manual installation || style="background: #ffd9b0;" | Manual installation
|-
| Natural Earth || style="background: #fff6c8;" | ''Download Maps'' feature ||style="background: #ffd9b0;" | [http://edu.kde.org/marble/maps.php Manual installation] || style="background: #ffd9b0;" | [http://edu.kde.org/marble/maps.php Manual installation]
|-
| OpenStreetMap || style="background: #d8e8c2;" | Packaged || style="background: #d8e8c2;" | Packaged || style="background: #d8e8c2;" | Packaged
|-
| Osmarender || style="background: #fff6c8;" | ''Download Maps'' feature ||style="background: #ffd9b0;" | [http://edu.kde.org/marble/maps.php Manual installation] || style="background: #fff6c8;" | ''Marble Maps'' package
|-
| Open CycleMap || style="background: #fff6c8;" | ''Download Maps'' feature ||style="background: #ffd9b0;" | [http://edu.kde.org/marble/maps.php Manual installation] || style="background: #ffd9b0;" | [http://edu.kde.org/marble/maps.php Manual installation]<br />Marble 1.2 and later: ''Marble Maps'' package
|-
| OSM Hike & Bike Map || style="background: #fff6c8;" | ''Download Maps'' feature ||style="background: #ffd9b0;" | [http://edu.kde.org/marble/maps.php Manual installation] || style="background: #fff6c8;" | ''Marble Maps'' package
|-
| Plain Map || style="background: #d8e8c2;" | Packaged || style="background: #d8e8c2;" | Packaged || style="background: #fff6c8;" | ''Marble Maps'' package
|-
| Precipitation || style="background: #d8e8c2;" | Packaged || style="background: #d8e8c2;" | Packaged || style="background: #fff6c8;" | ''Marble Maps'' package
|-
| Satellite View || style="background: #d8e8c2;" | Packaged || style="background: #d8e8c2;" | Packaged || style="background: #fff6c8;" | ''Marble Maps'' package
|-
| Temperature || style="background: #d8e8c2;" | Packaged || style="background: #d8e8c2;" | Packaged || style="background: #fff6c8;" | ''Marble Maps'' package
|-
| Virtual Earth || style="background: #ffd9b0;" | Manual installation ||style="background: #ffd9b0;" | Manual installation || style="background: #ffd9b0;" | Manual installation
|-
|}
 
<!--T:31-->
'''Legend'''
{|class="vertical-centered wikitable" style="border: 1px solid grey;"
! Term || Description
|-
| Marble Maps package || Please install the ''Marble Maps'' package from the extras repository (the same where you installed ''Marble - Virtual Globe'' from). See [[Marble/Maemo/Installation|Maemo Installation]] (Nokia N900 only).
|-
| Download Maps feature || Please use the ''Download Maps'' feature in Marble from the ''File'' menu (KDE only).
|-
|-
!Example
| Manual installation || Please follow the link (if any) and install the map theme manually.
|[[Image:Marble-Spherical.png|246px|center]]||[[Image:Marble-FlatMap.png|246px|center]]||[[Image:Marble-Mercator.png|246px|center]]
|-
|-
!Common Usage
|Distant view, measuring large distances||Distant view||Close view
|}
|}
<!--T:32-->
{{Prevnext|Special:myLanguage/Marble/Tracking|Special:myLanguage/Marble/Bookmarks|Tracking|Bookmarks}}
<!--T:33-->
[[Category:Education]]
</translate>

Latest revision as of 07:30, 14 August 2012


One of the core features of Marble is the support for different maps (map themes in Marble speak) and different planets. Each of them can be viewed in different projections: Make the planet look like a globe using the Spherical projection or view it like a printed map in the Mercator projection.

Map themes are configured in the Map View dialog in Marble. You find it in the tab bar on the left in the Desktop version.

Marble's mobile version on the Nokia N900 offers you to open the Map View dialog via the main application menu.

The Map View dialog lets you choose a projection, the planet (celestial body) and a map theme. The rest of this tutorials explains these choices in detail.

Planet Choices

Marble supports about a dozen different planets. In the Map View dialog you can choose those planets where at least one map theme is installed for.


Earth. Plenty of different map themes are available.

Moon. We're aware it's not really a planet.

Mars

Venus

Projection Choices

The projection defines how the surface of the planet is presented on the screen. This can be a globe or some sort of a flat map.

Spherical Projection Flat Map Projection Mercator Projection
Example
Common Usage Distant view, measuring large distances Distant view Close view, navigation
Tip
Unsure which projection to choose? A rule of thumb is to use the Spherical projection at very large distances and the Mercator projection otherwise.


Map Theme Choices

Overview Maps

Map Theme Preview Description
Atlas A classic topographic map. It uses vector lines to mark coastlines, country borders etc. and a height relief.
Plain Map A simple version of the Atlas theme without topography.
Satellite View Earth as seen from space with sun illumination. Includes a cloud layer with real-time data.
Natural Earth Natural Earth portrays the world environment in an idealized manner with little human influence. Includes a cloud layer with real-time data.
Earth at Night Earth as seen from space without sun illumination.

Street Maps

These maps are optimized for high zoom levels, showing many details on the street and city level. Some of them provide good country and even continent or space views, but that's not their primary area of use. Need to find a route? Do you like hiking or biking? Want to explore the neighborhood? Pick one of these maps.

Map Theme Preview Description

OpenStreetMap

General purpose

The famous OpenStreetMap Mapnik layer. A general purpose map with useful information for the most common use cases. The map is identical to that shown on openstreetmap.org.

Combine this map theme with the Mercator projection for optimal speed and a sharp map view.

Osmarender

General purpose

The OpenStreetMap Osmarender layer. A general purpose map with useful information for the most common use cases. The map is identical to that selectable in the top-right toolbox on openstreetmap.org.

Compared to the Mapnik layer (OpenStreetMap theme), this theme has more lively colors and presents some different data. The view from space looks better than that of Mapnik. On the other hand, Mapnik handles conflicting elements at the street level better. In Osmarender, icon sizes are less balanced and the z-order (stacking) is wrong for some elements. Labels overlap in densely packed areas.

Combine this map theme with the Mercator projection for optimal speed and a sharp map view.

OpenCycleMap

For bikers

OpenStreetMap data presented for bikers. The map is identical to that selectable in the top-right toolbox on openstreetmap.org.

Combine this map theme with the Mercator projection for optimal speed and a sharp map view.

OSM Hike & Bike Map

For hikers and bikers

A map theme optimized for hiking and biking, based on OpenStreetMap data. Includes a very nice hillshading layer that shows the terrain (activate it in the Legend tab).

Combine this map theme with the Mercator projection for optimal speed and a sharp map view.

Educational Maps

Map Theme Preview Description
Historical Map 1689 A historical world map from the year 1689 created by G. van Schagen in Amsterdam.
Historical Map 1720 A historical world map from the year 1720 created by Guillaume de L'Isle in Paris.
Historical Map 1786 A historical world map from the year 1786 created by William Faden in London.
Precipitation (month) Colors indicate the precipitation in the given month. Open the Legend tab to find out which color matches which precipitation.
Temperature (month) Colors indicate the average temperature in the given month. Open the Legend tab to find out which color matches which temperature.

Restricted Maps

These map themes work fine in Marble from a technical point of view. The terms of service of the companies offering these maps, however, may prevent you from using it. If you want to use these map themes, you must install them manually. Make sure their terms of service allow you to use them within Marble.

Warning
To the best of our knowledge the usage of these restricted maps is forbidden in an application like Marble. We only want to demonstrate the technical feasibility here. Please don't add details on their installation in Marble to this Wiki. We don't want to promote the usage of maps which we think are not free.

Read more about the restrictions on using Google Maps in Dennis Nienhüser's blog.


Map Theme Preview Description
Google Maps Street maps from maps.google.com
Google Satellite Satellite maps from maps.google.com
Mapquest Street maps from mapquest.com
Virtual Earth Satellite maps from virtualearth.net

Installing Additional Map Themes

Map Theme Linux (KDE) Mac, Windows Maemo (N900)
Atlas Packaged Packaged Marble Maps package
Earth at Night Packaged Packaged Marble Maps package
Google Maps Manual installation Manual installation Manual installation
Google Satellite Manual installation Manual installation Manual installation
Historical Map 1689 Download Maps feature Manual installation Marble Maps package
Historical Map 1720 Download Maps feature Manual installation Manual installation
Historical Map 1786 Download Maps feature Manual installation Manual installation
Mapquest Manual installation Manual installation Manual installation
Natural Earth Download Maps feature Manual installation Manual installation
OpenStreetMap Packaged Packaged Packaged
Osmarender Download Maps feature Manual installation Marble Maps package
Open CycleMap Download Maps feature Manual installation Manual installation
Marble 1.2 and later: Marble Maps package
OSM Hike & Bike Map Download Maps feature Manual installation Marble Maps package
Plain Map Packaged Packaged Marble Maps package
Precipitation Packaged Packaged Marble Maps package
Satellite View Packaged Packaged Marble Maps package
Temperature Packaged Packaged Marble Maps package
Virtual Earth Manual installation Manual installation Manual installation

Legend

Term Description
Marble Maps package Please install the Marble Maps package from the extras repository (the same where you installed Marble - Virtual Globe from). See Maemo Installation (Nokia N900 only).
Download Maps feature Please use the Download Maps feature in Marble from the File menu (KDE only).
Manual installation Please follow the link (if any) and install the map theme manually.