OpenGeofiction:Coastline maintenance: Difference between revisions

From OpenGeofiction
(Move to new coastline process)
Line 1: Line 1:
{{see also|OpenGeofiction:Coastline maintenance/experimental}}
Maintaining '''coastline integrity''' is important because when there are gaps or mistakes in the coastline, it can create major rendering problems on the map, which look like giant "floods." Everyone should be careful with the ''natural=coastline'' tag. Unlike with other tags, please do not just "play with" coastline tags to experiment with "how it might look" - the map renderer handles coastline tags differently.
Maintaining '''coastline integrity''' is important because when there are gaps or mistakes in the coastline, it creates rendering problems on the map, which look like giant "floods." Everyone should be careful with the ''natural=coastline'' tag. Unlike with other tags, please do not just "play with" coastline tags to experiment with "how it might look" - the map renderer handles coastline tags differently, and mistakes can appear on the world map for several hours, even if they are fixed right away.
 
To protect against disruption the coastline is automatically checked a twice an hour, and only passed to the renderer if it has no errors. This check is done on each continent in turn, with the last good coastline being used for a continent when it has issues. So, a single coastline error will result in a complete continent not having its coastline updated.


== The "too many nodes" Problem ==
== The "too many nodes" Problem ==
Line 6: Line 7:
The OSM standard does not allow more than 2000 nodes in a coastline way (or any way, for that matter, but it's a problem most commonly seen with coastlines). The solution to the problem is simple - you just "split" the way into two ways, connect end-to-end. This is a single step in JOSM. If you start with a single coastline way, you can select an individual node and then use the "split way" feature (keyboard shortcut "P"). Done!  
The OSM standard does not allow more than 2000 nodes in a coastline way (or any way, for that matter, but it's a problem most commonly seen with coastlines). The solution to the problem is simple - you just "split" the way into two ways, connect end-to-end. This is a single step in JOSM. If you start with a single coastline way, you can select an individual node and then use the "split way" feature (keyboard shortcut "P"). Done!  


== Troubleshooting the "Flooding" Problem ==
Coastlines must be in the counter-clockwise direction, with land on the left side of the way.
 
== Errors ==


It can be quite difficult, however, to find the exact location of the cause of a "flooding" problem. To help with that, the following very useful map overlay has been created, which displays nodes where the coastline is broken in some way (go [http://wiki.opengeofiction.net/util/coastline_info.html here] for a larger version):
It can be quite difficult, however, to find the exact location of the cause of a "flooding" problem. To help with that, the following very useful map overlay has been created, which displays nodes where the coastline is broken in some way:


{{#multimaps:  
{{#multimaps:  
Line 15: Line 18:
| width = 100%
| width = 100%
| height = 600px
| height = 600px
| zoom = 3
| zoom = 2
| maxzoom = 19
| maxzoom = 19
| layers = +Standard
| layers = +Tiles05,Standard
| overlays = +Coastline Errors
| overlays = +Coastline Errors,Coastline Errors World,Old process
| overlaydef = {
| overlaydef = {
"Coastline Errors": [
"Coastline Errors": [
  {"url": "https://data.opengeofiction.net/extracts/coastline_errors.json"}
],
"Coastline Errors World": [
  {"url": "https://data.opengeofiction.net/extracts/coastline_errors_world.json"}
],
"Old process": [
   {"url": "/util-data/coastline/coastline_errors.json"}
   {"url": "/util-data/coastline/coastline_errors.json"}
] }
] }
}}
}}


Line 34: Line 42:
In the case of a continent flooding, you're all - especially the more experienced users - called upon to try to fix it. Because it is important, it is justified to make an edit in another user's territory if you see a coastline problem.
In the case of a continent flooding, you're all - especially the more experienced users - called upon to try to fix it. Because it is important, it is justified to make an edit in another user's territory if you see a coastline problem.


=== Expert troubleshooting ===
===Continent summary===
The coastline process uses Overpass, [https://ogfdata.rent-a-planet.com/extracts/ogf-coastline-data.osm.pbf the data extracted from Overpass] can be used to further troubleshoot complex problems. This also available as per-continent extracts for easier use: '''[https://wiki.opengeofiction.net/util-data/coastline/coastline-AN.osm.gz AN]''', '''[https://wiki.opengeofiction.net/util-data/coastline/coastline-AR.osm.gz AR]''', [https://wiki.opengeofiction.net/util-data/coastline/coastline-BG.osm.gz BG], [https://wiki.opengeofiction.net/util-data/coastline/coastline-ER.osm.gz ER], [https://wiki.opengeofiction.net/util-data/coastline/coastline-KA.osm.gz KA], [https://wiki.opengeofiction.net/util-data/coastline/coastline-OR.osm.gz OR], [https://wiki.opengeofiction.net/util-data/coastline/coastline-PE.osm.gz PE], '''[https://wiki.opengeofiction.net/util-data/coastline/coastline-TA.osm.gz TA]''', '''[https://wiki.opengeofiction.net/util-data/coastline/coastline-UL.osm.gz UL]'''. These URLs can be used directly using ''File/Open Location...'' in {{OSMW|JOSM|JOSM}}.
The following table lists a summary of the coastline condition for each continent. Any error in a continent will prevent the coast being updated for that continent.
 
The ''.osm.pbf'' links can be loaded directly into {{OSMW|JOSM|JOSM}} using ''File/Open Location...''.
 
{{purge}}
{{#clear_external_data:}}
{{#get_web_data:url=https://data.opengeofiction.net/extracts/coastline_summary.json
|format=JSON
|data=
continent=continent,
errors=errors,
mtime=mtime,
status=status
}}
{| class="wikitable sortable"
! Continent
! Status
! #Errors
! Last update
{{#for_external_table:<nowiki/>
{{!}}-
{{!}} style="padding:1em" {{!}} {{coastlinedata|{{{continent}}}}}
{{!}} style="padding:1em" {{!}} {{{status}}}
{{!}} style="padding:1em" {{!}} {{{errors}}}
{{!}} style="padding:1em" {{!}} {{{mtime}}}
}}
|}


== Lakes and Inland Seas ==
== Lakes and Inland Seas ==
Line 42: Line 76:
:''Before multipolygon relations were added to OSM, some large lakes were also tagged with natural=coastline, but most of them have been converted. Currently there are a few large lakes left (like the Great lakes), that still use this tag. Because of the complexity and size of these lakes, this tagging is difficult to change, so they might stay this way for the time being. But you should not introduce any new inland water areas that are tagged this way.''
:''Before multipolygon relations were added to OSM, some large lakes were also tagged with natural=coastline, but most of them have been converted. Currently there are a few large lakes left (like the Great lakes), that still use this tag. Because of the complexity and size of these lakes, this tagging is difficult to change, so they might stay this way for the time being. But you should not introduce any new inland water areas that are tagged this way.''


If you draw large lakes and inland seas, best practice seems to be to use ''natural=water / water=lake'', either as a simple closed way or as a multipolygon relation. I prefer the later... then you can treat the individual lakeshore ways more or less the same way you treat ocean coastline ways.
If you draw large lakes and inland seas, best practice is to use ''natural=water / water=lake'', either as a simple closed way or as a multipolygon relation.


== A Visual Summary ==
== A Visual Summary ==

Revision as of 00:13, 16 July 2022

Maintaining coastline integrity is important because when there are gaps or mistakes in the coastline, it can create major rendering problems on the map, which look like giant "floods." Everyone should be careful with the natural=coastline tag. Unlike with other tags, please do not just "play with" coastline tags to experiment with "how it might look" - the map renderer handles coastline tags differently.

To protect against disruption the coastline is automatically checked a twice an hour, and only passed to the renderer if it has no errors. This check is done on each continent in turn, with the last good coastline being used for a continent when it has issues. So, a single coastline error will result in a complete continent not having its coastline updated.

The "too many nodes" Problem

The OSM standard does not allow more than 2000 nodes in a coastline way (or any way, for that matter, but it's a problem most commonly seen with coastlines). The solution to the problem is simple - you just "split" the way into two ways, connect end-to-end. This is a single step in JOSM. If you start with a single coastline way, you can select an individual node and then use the "split way" feature (keyboard shortcut "P"). Done!

Coastlines must be in the counter-clockwise direction, with land on the left side of the way.

Errors

It can be quite difficult, however, to find the exact location of the cause of a "flooding" problem. To help with that, the following very useful map overlay has been created, which displays nodes where the coastline is broken in some way:

Loading map...

You can click on a marker in that map to see more information about the related node. A full discussion of how to maintain coastlines can be found on the OpenStreetMapW.svg openstreetmap wiki. A very short summary is that nodes must be:

  • a member of exactly one such way, either as an interior point or as its combined start and end point (if the way is closed) or
  • a member of exactly two ways, where it is the start point of one and the end point of the other
  • nodes that do not meet this condition are displayed on the coastline_info map. Obviously they don't always cause a rendering problem, but in the case of major flooding you will probably find the problematic location among them.

In the case of a continent flooding, you're all - especially the more experienced users - called upon to try to fix it. Because it is important, it is justified to make an edit in another user's territory if you see a coastline problem.

Continent summary

The following table lists a summary of the coastline condition for each continent. Any error in a continent will prevent the coast being updated for that continent.

The .osm.pbf links can be loaded directly into OpenStreetMapW.svg JOSM using File/Open Location....

Purge


Continent Status #Errors Last update

AN.osm.pbf / .db valid 0 2024-04-29 04:33:31 UTC
PE.osm.pbf / .db valid 0 2024-04-29 04:33:48 UTC
BG.osm.pbf / .db valid 0 2024-04-29 04:33:49 UTC
KA.osm.pbf / .db valid 0 2024-04-29 04:34:14 UTC
TA.osm.pbf / .db valid 0 2024-04-29 04:34:31 UTC
OR.osm.pbf / .db valid 0 2024-04-29 04:34:42 UTC
ER.osm.pbf / .db valid 0 2024-04-29 04:34:59 UTC
UL.osm.pbf / .db valid 0 2024-04-29 04:36:08 UTC
AR.osm.pbf / .db valid 0 2024-04-29 04:37:06 UTC
world.osm.pbf / .db valid 0 2024-04-29 04:47:21 UTC

Lakes and Inland Seas

There are some lakes and seas in Openstreetmap that are tagged as natural=coastline. This has been deprecated. Quoting from the OSM wiki:

Before multipolygon relations were added to OSM, some large lakes were also tagged with natural=coastline, but most of them have been converted. Currently there are a few large lakes left (like the Great lakes), that still use this tag. Because of the complexity and size of these lakes, this tagging is difficult to change, so they might stay this way for the time being. But you should not introduce any new inland water areas that are tagged this way.

If you draw large lakes and inland seas, best practice is to use natural=water / water=lake, either as a simple closed way or as a multipolygon relation.

A Visual Summary

Here is a great graphic that summarizes OGF coastline work.

Isleño Graphic Coastline Advice.png