/* Copyright (c) 2016, KlokanTech.com & OpenMapTiles contributors. All rights reserved. Code license: BSD 3-Clause License Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. * Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. Design license: CC-BY 4.0 See https://github.com/openmaptiles/openmaptiles/blob/master/LICENSE.md for details on usage */ package com.onthegomap.flatmap.basemap.layers; import static com.onthegomap.flatmap.basemap.util.Utils.nullIfEmpty; import com.onthegomap.flatmap.FeatureCollector; import com.onthegomap.flatmap.FeatureMerge; import com.onthegomap.flatmap.VectorTile; import com.onthegomap.flatmap.basemap.BasemapProfile; import com.onthegomap.flatmap.basemap.generated.OpenMapTilesSchema; import com.onthegomap.flatmap.basemap.generated.Tables; import com.onthegomap.flatmap.basemap.util.LanguageUtils; import com.onthegomap.flatmap.basemap.util.Utils; import com.onthegomap.flatmap.config.FlatmapConfig; import com.onthegomap.flatmap.reader.SourceFeature; import com.onthegomap.flatmap.stats.Stats; import com.onthegomap.flatmap.util.Translations; import com.onthegomap.flatmap.util.ZoomFunction; import java.util.List; import java.util.Map; /** * Defines the logic for generating river map elements in the {@code waterway} layer from source features. *

* This class is ported to Java from OpenMapTiles * waterway sql files. */ public class Waterway implements OpenMapTilesSchema.Waterway, Tables.OsmWaterwayLinestring.Handler, BasemapProfile.FeaturePostProcessor, BasemapProfile.NaturalEarthProcessor { /* * Uses Natural Earth at lower zoom-levels and OpenStreetMap at higher zoom levels. * * For OpenStreetMap, attempts to merge disconnected linestrings with the same name * at lower zoom levels so that clients can more easily render the name. We also * limit their length at merge-time which only has visibilty into that feature in a * single tile, so at render-time we need to allow through features far enough outside * the tile boundary enough to not accidentally filter out a long river only because a * short segment of it goes through this tile. */ private final Translations translations; private final FlatmapConfig config; public Waterway(Translations translations, FlatmapConfig config, Stats stats) { this.config = config; this.translations = translations; } private static final Map CLASS_MINZOOM = Map.of( "river", 12, "canal", 12, "stream", 13, "drain", 13, "ditch", 13 ); private static final ZoomFunction.MeterToPixelThresholds MIN_PIXEL_LENGTHS = ZoomFunction.meterThresholds() .put(9, 8_000) .put(10, 4_000) .put(11, 1_000); @Override public void processNaturalEarth(String table, SourceFeature feature, FeatureCollector features) { if (feature.hasTag("featurecla", "River")) { record ZoomRange(int min, int max) {} ZoomRange zoom = switch (table) { case "ne_110m_rivers_lake_centerlines" -> new ZoomRange(3, 3); case "ne_50m_rivers_lake_centerlines" -> new ZoomRange(4, 5); case "ne_10m_rivers_lake_centerlines" -> new ZoomRange(6, 8); default -> null; }; if (zoom != null) { features.line(LAYER_NAME) .setBufferPixels(BUFFER_SIZE) .setAttr(Fields.CLASS, FieldValues.CLASS_RIVER) .setZoomRange(zoom.min, zoom.max); } } } @Override public void process(Tables.OsmWaterwayLinestring element, FeatureCollector features) { String waterway = element.waterway(); String name = nullIfEmpty(element.name()); boolean important = "river".equals(waterway) && name != null; int minzoom = important ? 9 : CLASS_MINZOOM.getOrDefault(element.waterway(), 14); features.line(LAYER_NAME) .setBufferPixels(BUFFER_SIZE) .setAttr(Fields.CLASS, element.waterway()) .putAttrs(LanguageUtils.getNames(element.source().tags(), translations)) .setMinZoom(minzoom) // details only at higher zoom levels so that named rivers can be merged more aggressively .setAttrWithMinzoom(Fields.BRUNNEL, Utils.brunnel(element.isBridge(), element.isTunnel()), 12) .setAttrWithMinzoom(Fields.INTERMITTENT, element.isIntermittent() ? 1 : 0, 12) // at lower zoom levels, we'll merge linestrings and limit length/clip afterwards .setBufferPixelOverrides(MIN_PIXEL_LENGTHS).setMinPixelSizeBelowZoom(11, 0); } @Override public List postProcess(int zoom, List items) { if (zoom >= 9 && zoom <= 11) { return FeatureMerge.mergeLineStrings( items, MIN_PIXEL_LENGTHS.apply(zoom).doubleValue(), config.tolerance(zoom), BUFFER_SIZE ); } return items; } }