Difference between revisions of "Maps tab"

From Project-GC
Jump to: navigation, search
(Added information about colors)
(Colors: Background colours)
(9 intermediate revisions by 5 users not shown)
Line 1: Line 1:
The '''Maps tab''' is a tab in a users [[Profile Stats]] that shows where they have found caches. At the top there is a World map that shows how many of the 250 countries the user have found caches in, under the world map all the found countries are listed with the number of caches found in each country.  
+
The '''Maps tab''' is a tab in a user's [[Profile Stats]] that shows where they have found caches. At the top there is a World map that shows how many of the 250 countries the user has found caches in. Under the world map all the found countries are listed with the number of caches found in each country and the percentage of caches found in that country. The percentages can be used to see how far the user is from gaining the next level of color based on the dynamic requirements.
  
Next is a map of the country where the user have found the most caches followed by maps for the [[continent]]s where the user have found caches and after that a map for each country that the user have found a cache in. This tab will be very long if the user have logged many countrys.
+
Next are maps for the [[continent]]s where the user has found caches and after that a map for each country that the user has found a cache in presented in order of number of finds. This tab will be very long if the user has logged caches in many countries.  
 
 
The maps of individual countries have toggle buttons for regions and counties, there is also buttons for each individual region that the user have found caches in, clicking the button with the regionname produces a map of the region with the found counties marked.
 
  
 +
If the country has county-support the maps of individual countries have toggle buttons for [[region]]s and [[county|counties]], and there are also buttons for each individual region that the user has found caches in, clicking the button with the regions name produces a map of the region with the found counties marked.
  
 
== Colors ==
 
== Colors ==
Every area where the geocacher has found at least one geocache gets colored to show that they have geocached there. There are five levels of colors, the darker the color, the more finds in the area. The color levels are based on two requirements, whichever is lowest (easiest) is used.
+
Every area where the geocacher has found at least one geocache gets colored to show that they have geocached there. There are five levels of colors: the darker the color, the more finds in the area. The color levels are based on two requirements, whichever is lowest (easiest) is used.
  
 
{| class="wikitable" style="text-align: right;"
 
{| class="wikitable" style="text-align: right;"
 
|+ Color levels
 
|+ Color levels
 
|-
 
|-
! Level !! Fixed requirement !! Dynamic requirement
+
! Level !! Fixed requirement !! Dynamic requirement !! RGB
|-
+
|- style="background:#EBE7E4;"
| 1 || 1 || N/A
+
| 0 || 0 || 0% || [235,231,228]
|-
+
|- style="background:#E0C889;"
| 2 || 10 || 10%
+
| 1 || 1 || >0% || [224,200,137]
|-
+
|- style="background:#F0CC6B;"
| 3 || 100 || 30%
+
| 2 || 10 || 10% || [240,204,107]
|-
+
|- style="background:#CFA22B;"
| 4 || 1000 || 50%
+
| 3 || 100 || 30% || [207,162, 43]
|-
+
|- style="background:#A47D18; color:white"
| 5 || 5000 || 80%
+
| 4 || 1000 || 50% || [164,125, 24]
 +
|- style="background:#664A00; color:white"
 +
| 5 || 5000 || 80% || [102, 74,  0]
 +
 
 
|}
 
|}
  
The dynamic requirement is based on how many percent of the currently active geocaches the geocacher has found. More than 100% is possible if some of the finds are now archived.
+
The dynamic requirement is based on how many percent of the currently active geocaches the geocacher has found. More than 100% is possible if some of the finds are now archived. Using fixed numbers only has been tried, but for almost every single geocacher it means a darker color in 1-2 zones and then light colors in all others. Also there is a big difference between finding 1,000 geocaches in Germany/Nordrhein-Westfalen vs Germany/Hamburg, which makes it hard to use only fixed numbers.
 +
 
 +
Another variant for the coloring would be base it on the number of finds a geocacher has in the zone with the most finds in it. This however has the downside that it easily happens that other zones are downgraded after logging for example a [[Power trail]], something that wasn't wished for. These are the reasons why the above system has been implemented.
 +
 
 +
The color theme itself is based on the colors used by [[Profile stats]] in general. In turn those colors are based on the nature's earth tones, which relates to the activity of [[Geocaching]].
 +
 
 +
== Image sizes ==
 +
The default size of the map images are made to fit Profile stats by using a size of max 734 pixels in width or 512 pixels in height. When clicking a map it opens up in a larger version. By copy/pasting the link a user can adjust the image size to use by adjusting the scale parameter (by adding &scale=VALUE to the url). Available values are: 1 (default), 2, 4, 8, 16.
  
 +
== Map sources ==
 +
All maps are generated based on data from [[OpenStreetMap]] with one exception, Canada, which has a mix of sources. The polygon data is imported via [https://osm-boundaries.com OSM-Boundaries.com]. If you find issues with the borders the data can be corrected in [[OpenStreetMap]], Project-GC will then update its polygons with the next update.
  
 
[[Category:Statistics]]
 
[[Category:Statistics]]

Revision as of 08:40, 29 May 2021

The Maps tab is a tab in a user's Profile Stats that shows where they have found caches. At the top there is a World map that shows how many of the 250 countries the user has found caches in. Under the world map all the found countries are listed with the number of caches found in each country and the percentage of caches found in that country. The percentages can be used to see how far the user is from gaining the next level of color based on the dynamic requirements.

Next are maps for the continents where the user has found caches and after that a map for each country that the user has found a cache in presented in order of number of finds. This tab will be very long if the user has logged caches in many countries.

If the country has county-support the maps of individual countries have toggle buttons for regions and counties, and there are also buttons for each individual region that the user has found caches in, clicking the button with the regions name produces a map of the region with the found counties marked.

Colors

Every area where the geocacher has found at least one geocache gets colored to show that they have geocached there. There are five levels of colors: the darker the color, the more finds in the area. The color levels are based on two requirements, whichever is lowest (easiest) is used.

Color levels
Level Fixed requirement Dynamic requirement RGB
0 0 0% [235,231,228]
1 1 >0% [224,200,137]
2 10 10% [240,204,107]
3 100 30% [207,162, 43]
4 1000 50% [164,125, 24]
5 5000 80% [102, 74, 0]

The dynamic requirement is based on how many percent of the currently active geocaches the geocacher has found. More than 100% is possible if some of the finds are now archived. Using fixed numbers only has been tried, but for almost every single geocacher it means a darker color in 1-2 zones and then light colors in all others. Also there is a big difference between finding 1,000 geocaches in Germany/Nordrhein-Westfalen vs Germany/Hamburg, which makes it hard to use only fixed numbers.

Another variant for the coloring would be base it on the number of finds a geocacher has in the zone with the most finds in it. This however has the downside that it easily happens that other zones are downgraded after logging for example a Power trail, something that wasn't wished for. These are the reasons why the above system has been implemented.

The color theme itself is based on the colors used by Profile stats in general. In turn those colors are based on the nature's earth tones, which relates to the activity of Geocaching.

Image sizes

The default size of the map images are made to fit Profile stats by using a size of max 734 pixels in width or 512 pixels in height. When clicking a map it opens up in a larger version. By copy/pasting the link a user can adjust the image size to use by adjusting the scale parameter (by adding &scale=VALUE to the url). Available values are: 1 (default), 2, 4, 8, 16.

Map sources

All maps are generated based on data from OpenStreetMap with one exception, Canada, which has a mix of sources. The polygon data is imported via OSM-Boundaries.com. If you find issues with the borders the data can be corrected in OpenStreetMap, Project-GC will then update its polygons with the next update.