org.mapfish.print.map.tiled.osm.OsmLayerParam Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of print-lib Show documentation
Library for generating PDFs and images from online webmapping services
There is a newer version: 3.22.0
package org.mapfish.print.map.tiled.osm;

import com.google.common.base.Strings;
import com.google.common.collect.HashMultimap;
import com.google.common.collect.Multimap;
import com.google.common.collect.Ordering;
import com.vividsolutions.jts.geom.Envelope;
import com.vividsolutions.jts.util.Assert;
import org.mapfish.print.map.tiled.AbstractTiledLayerParams;
import org.mapfish.print.parser.HasDefaultValue;
import org.mapfish.print.wrapper.PArray;
import org.mapfish.print.wrapper.PObject;

import java.awt.Dimension;
import java.net.URI;
import java.net.URISyntaxException;
import java.util.Arrays;
import java.util.Iterator;

/**
 * The parameters for configuration an OSM layer.
 */
public final class OsmLayerParam extends AbstractTiledLayerParams {
    private static final int NUMBER_OF_EXTENT_COORDS = 4;
    private static final double DEFAULT_RESOLUTION_TOLERANCE = 1.9;
    private static final int[] DEFAULT_TILE_SIZE = new int[]{256, 256};
    private static final double[] DEFAULT_MAX_EXTENT =
            new double[]{-20037508.34, -20037508.34, 20037508.34, 20037508.34};
    private static final Double[] DEFAULT_RESOLUTIONS = new Double[]{
            156543.03390625,
            78271.516953125,
            39135.7584765625,
            19567.87923828125,
            9783.939619140625,
            4891.9698095703125,
            2445.9849047851562,
            1222.9924523925781,
            611.4962261962891,
            305.74811309814453,
            152.87405654907226,
            76.43702827453613,
            38.218514137268066,
            19.109257068634033,
            9.554628534317017,
            4.777314267158508,
            2.388657133579254,
            1.194328566789627,
            0.5971642833948135
    };
    private final Multimap additionalCustomParam = HashMultimap.create();
    /**
     * The URL used for the tile requests.
     * Supported formats:
     * 
     * The base part of the URL, for example 'http://tile.openstreetmap.org'. This results in an URL
     * like 'http://tile.openstreetmap.org/12/123/456.png'.
     * An URL template with the placeholders '{x}', '{y}' or '{-y}', and '{z}'. For example:
     * 'http://tile.openstreetmap.org/{z}/{x}/{y}.png'. 
 The placeholder '{-y}' provides support for OSGeo
     * TMS tiles.
     * 
     * 
     */
    public String baseURL;
    /**
     * The maximum extent of the osm layer. Must have 4 coordinates, minX, minY, maxX, maxY
     * Default: [-20037508.34, -20037508.34, 20037508.34, 20037508.34]
     */
    @HasDefaultValue
    public double[] maxExtent = DEFAULT_MAX_EXTENT;
    /**
     * The size of each tile.  Must have 2 values: width, height
     * Default: [256, 256]
     */
    @HasDefaultValue
    public int[] tileSize = DEFAULT_TILE_SIZE;
    /**
     * The allowed resolutions for this layer.
     */
    @HasDefaultValue
    public Double[] resolutions = DEFAULT_RESOLUTIONS;
    /**
     * The amount of difference between a resolution and a target resolution to consider the two equal.  The
     * value is a value from 0-1.
     */
    @HasDefaultValue
    public double resolutionTolerance = DEFAULT_RESOLUTION_TOLERANCE;
    /**
     * The DPI of the OSM tiles.
     */
    @HasDefaultValue
    public Double dpi = null;
    /**
     * The image extension.  for example png, jpeg, etc...
     */
    @HasDefaultValue
    public String imageExtension = "png";
    /**
     * Custom query parameters to use when making http requests. {@link #customParams}.
     * 
     * The json should look something like:
     * 
     * {
     *     "param1Name": "value",
     *     "param2Name": ["value1", "value2"]
     * }
     * 
     */
    @HasDefaultValue
    public PObject customParams;

    /**
     * convert a param object to a multimap.
     *
     * @param objectParams the parameters to convert.
     * @return the corresponding Multimap.
     */
    public static Multimap convertToMultiMap(final PObject objectParams) {
        Multimap params = HashMultimap.create();
        if (objectParams != null) {
            Iterator customParamsIter = objectParams.keys();
            while (customParamsIter.hasNext()) {
                String key = customParamsIter.next();
                if (objectParams.isArray(key)) {
                    final PArray array = objectParams.optArray(key);
                    for (int i = 0; i < array.size(); i++) {
                        params.put(key, array.getString(i));
                    }
                } else {
                    params.put(key, objectParams.optString(key, ""));
                }
            }
        }

        return params;
    }

    /**
     * Read the {@link #customParams} into a Multimap.
     */
    public Multimap getCustomParams() {
        Multimap result = convertToMultiMap(this.customParams);
        result.putAll(this.additionalCustomParam);
        return result;
    }

    /**
     * Set a custom parameter.
     *
     * @param name the parameter name
     * @param value the parameter value
     */
    public void setCustomParam(final String name, final String value) {
        this.additionalCustomParam.put(name, value);
    }

    /**
     * Validate the properties have the correct values.
     */
    public void postConstruct() {
        Assert.equals(NUMBER_OF_EXTENT_COORDS, this.maxExtent.length,
                      "maxExtent must have exactly 4 elements to the array.  Was: " +
                              Arrays.toString(this
                                                      .maxExtent));
        Assert.equals(2, this.tileSize.length,
                      "tileSize must have exactly 2 elements to the array.  Was: " +
                              Arrays.toString(this.tileSize));
        Assert.isTrue(this.resolutions.length > 0, "resolutions must have at least one value");

        Arrays.sort(this.resolutions, Ordering.natural().reverse());
        Assert.isTrue(validateBaseUrl(), "invalid baseURL");
    }

    /**
     * Get the max extent as a envelop object.
     */
    public Envelope getMaxExtent() {
        final int minX = 0;
        final int maxX = 1;
        final int minY = 2;
        final int maxY = 3;
        return new Envelope(this.maxExtent[minX], this.maxExtent[minY], this.maxExtent[maxX],
                            this.maxExtent[maxY]);
    }

    @Override
    public String getBaseUrl() {
        return this.baseURL;
    }

    public Dimension getTileSize() {
        return new Dimension(this.tileSize[0], this.tileSize[1]);
    }

    @Override
    public String createCommonUrl() {
        return getBaseUrl();
    }

    @Override
    public boolean validateBaseUrl() {
        String url = getBaseUrl();
        if (Strings.isNullOrEmpty(url)) {
            return false;
        }

        // replace placeholders with dummy values, then check if an URI can be created
        url = url
                .replace("{z}", "0")
                .replace("{x}", "0")
                .replace("{y}", "0")
                .replace("{-y}", "0");

        try {
            new URI(url);
            return true;
        } catch (URISyntaxException exc) {
            return false;
        }
    }
}