planetiler/planetiler-core/src/test/java/com/onthegomap/planetiler/VectorTileTest.java

433 wiersze
14 KiB
Java

/* ****************************************************************
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
****************************************************************/
package com.onthegomap.planetiler;
import static com.onthegomap.planetiler.TestUtils.*;
import static com.onthegomap.planetiler.geo.GeoUtils.JTS_FACTORY;
import static org.junit.jupiter.api.Assertions.assertEquals;
import static org.junit.jupiter.api.Assertions.assertNotSame;
import static org.junit.jupiter.api.Assertions.assertTrue;
import static org.junit.jupiter.api.DynamicTest.dynamicTest;
import com.google.common.primitives.Ints;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import java.util.stream.Stream;
import org.junit.jupiter.api.DynamicTest;
import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.TestFactory;
import org.locationtech.jts.geom.Coordinate;
import org.locationtech.jts.geom.CoordinateXY;
import org.locationtech.jts.geom.Geometry;
import org.locationtech.jts.geom.GeometryCollection;
import org.locationtech.jts.geom.LinearRing;
import org.locationtech.jts.geom.MultiPolygon;
import org.locationtech.jts.geom.Point;
import org.locationtech.jts.geom.Polygon;
import org.locationtech.jts.geom.PrecisionModel;
import org.locationtech.jts.geom.util.AffineTransformation;
import org.locationtech.jts.geom.util.NoninvertibleTransformationException;
import org.locationtech.jts.precision.GeometryPrecisionReducer;
import vector_tile.VectorTileProto;
/**
* This class is copied from
* https://github.com/ElectronicChartCentre/java-vector-tile/blob/master/src/test/java/no/ecc/vectortile/VectorTileEncoderTest.java
* and modified based on the changes in VectorTileEncoder, and adapted to junit 5.
*/
public class VectorTileTest {
// Tests adapted from https://github.com/ElectronicChartCentre/java-vector-tile/blob/master/src/test/java/no/ecc/vectortile/VectorTileEncoderTest.java
private static List<Integer> getCommands(Geometry geom) {
return Ints.asList(VectorTile.encodeGeometry(TRANSFORM_TO_TILE.transform(geom)).commands());
}
@Test
public void testToGeomType() {
Geometry geometry = JTS_FACTORY.createLineString(new Coordinate[]{new CoordinateXY(1, 2), new CoordinateXY(3, 4)});
assertEquals((byte) VectorTileProto.Tile.GeomType.LINESTRING.getNumber(),
VectorTile.encodeGeometry(geometry).geomType().asByte());
}
@Test
public void testCommands() {
assertEquals(List.of(9, 6, 12, 18, 10, 12, 24, 44, 15), getCommands(newPolygon(
3, 6,
8, 12,
20, 34,
3, 6
)));
}
@Test
public void testCommandsFilter() {
assertEquals(List.of(9, 6, 12, 18, 10, 12, 24, 44, 15), getCommands(newPolygon(
3, 6,
8, 12,
8, 12,
20, 34,
3, 6
)));
}
@Test
public void testPoint() {
assertEquals(List.of(9, 6, 12), getCommands(newMultiPoint(
newPoint(3, 6)
)));
}
@Test
public void testMultiPoint() {
assertEquals(List.of(17, 10, 14, 3, 9), getCommands(newMultiPoint(
newPoint(5, 7),
newPoint(3, 2)
)));
}
private static VectorTile.Feature newVectorTileFeature(String layer, Geometry geom,
Map<String, Object> attrs) {
return new VectorTile.Feature(layer, 1, VectorTile.encodeGeometry(geom), attrs);
}
@Test
public void testNullAttributeValue() {
VectorTile vtm = new VectorTile();
Map<String, Object> attrs = new HashMap<>();
attrs.put("key1", "value1");
attrs.put("key2", null);
attrs.put("key3", "value3");
vtm.addLayerFeatures("DEPCNT", List.of(
newVectorTileFeature("DEPCNT", newPoint(3, 6), attrs)
));
byte[] encoded = vtm.encode();
assertNotSame(0, encoded.length);
var decoded = VectorTile.decode(encoded);
assertEquals(List
.of(new VectorTile.Feature("DEPCNT", 1, VectorTile.encodeGeometry(newPoint(3, 6)), Map.of(
"key1", "value1",
"key3", "value3"
))), decoded);
assertSameGeometries(List.of(newPoint(3, 6)), decoded);
}
@Test
public void testAttributeTypes() {
VectorTile vtm = new VectorTile();
Map<String, Object> attrs = Map.of(
"key1", "value1",
"key2", 123,
"key3", 234.1f,
"key4", 567.123d,
"key5", (long) -123,
"key6", "value6",
"key7", Boolean.TRUE,
"key8", Boolean.FALSE
);
vtm.addLayerFeatures("DEPCNT", List.of(newVectorTileFeature("DEPCNT", newPoint(3, 6), attrs)));
byte[] encoded = vtm.encode();
assertNotSame(0, encoded.length);
List<VectorTile.Feature> decoded = VectorTile.decode(encoded);
assertEquals(1, decoded.size());
Map<String, Object> decodedAttributes = decoded.get(0).attrs();
assertEquals("value1", decodedAttributes.get("key1"));
assertEquals(123L, decodedAttributes.get("key2"));
assertEquals(234.1f, decodedAttributes.get("key3"));
assertEquals(567.123d, decodedAttributes.get("key4"));
assertEquals((long) -123, decodedAttributes.get("key5"));
assertEquals("value6", decodedAttributes.get("key6"));
assertEquals(Boolean.TRUE, decodedAttributes.get("key7"));
assertEquals(Boolean.FALSE, decodedAttributes.get("key8"));
}
@Test
public void testMultiPolygonCommands() {
// see https://github.com/mapbox/vector-tile-spec/blob/master/2.1/README.md
assertEquals(List.of(
9, 0, 0, 26, 20, 0, 0, 20, 19, 0, 15,
9, 22, 2, 26, 18, 0, 0, 18, 17, 0, 15,
9, 4, 13, 26, 0, 8, 8, 0, 0, 7, 15
), getCommands(newMultiPolygon(
newPolygon(0, 0,
10, 0,
10, 10,
0, 10,
0, 0
),
newPolygon(
11, 11,
20, 11,
20, 20,
11, 20,
11, 11
),
newPolygon(
13, 13,
13, 17,
17, 17,
17, 13,
13, 13
)
)));
}
@Test
public void testMultiPolygon() {
MultiPolygon mp = newMultiPolygon(
(Polygon) newPoint(13, 16).buffer(3),
(Polygon) newPoint(24, 25).buffer(5)
).reverse(); // ensure outer CCW, inner CW winding
assertTrue(mp.isValid());
Map<String, Object> attrs = Map.of("key1", "value1");
VectorTile vtm = new VectorTile();
vtm.addLayerFeatures("mp", List.of(newVectorTileFeature("mp", mp, attrs)));
byte[] encoded = vtm.encode();
assertTrue(encoded.length > 0);
var features = VectorTile.decode(encoded);
assertEquals(1, features.size());
MultiPolygon mp2 = (MultiPolygon) decodeSilently(features.get(0).geometry());
assertEquals(mp.getNumGeometries(), mp2.getNumGeometries());
}
@Test
public void testGeometryCollectionSilentlyIgnored() {
GeometryCollection gc = newGeometryCollection(
newPoint(13, 16).buffer(3),
newPoint(24, 25)
);
Map<String, Object> attributes = Map.of("key1", "value1");
VectorTile vtm = new VectorTile();
vtm.addLayerFeatures("gc", List.of(newVectorTileFeature("gc", gc, attributes)));
byte[] encoded = vtm.encode();
var features = VectorTile.decode(encoded);
assertEquals(0, features.size());
}
// New tests added:
@Test
public void testRoundTripPoint() {
testRoundTripGeometry(JTS_FACTORY.createPoint(new CoordinateXY(1, 2)));
}
@Test
public void testRoundTripMultipoint() {
testRoundTripGeometry(JTS_FACTORY.createMultiPointFromCoords(new Coordinate[]{
new CoordinateXY(1, 2),
new CoordinateXY(3, 4)
}));
}
@Test
public void testRoundTripLineString() {
testRoundTripGeometry(JTS_FACTORY.createLineString(new Coordinate[]{
new CoordinateXY(1, 2),
new CoordinateXY(3, 4)
}));
}
@Test
public void testRoundTripPolygon() {
testRoundTripGeometry(JTS_FACTORY.createPolygon(
JTS_FACTORY.createLinearRing(new Coordinate[]{
new CoordinateXY(0, 0),
new CoordinateXY(4, 0),
new CoordinateXY(4, 4),
new CoordinateXY(0, 4),
new CoordinateXY(0, 0)
}),
new LinearRing[]{
JTS_FACTORY.createLinearRing(new Coordinate[]{
new CoordinateXY(1, 1),
new CoordinateXY(1, 2),
new CoordinateXY(2, 2),
new CoordinateXY(2, 1),
new CoordinateXY(1, 1)
})
}
));
}
@Test
public void testRoundTripMultiPolygon() {
testRoundTripGeometry(JTS_FACTORY.createMultiPolygon(new Polygon[]{
JTS_FACTORY.createPolygon(new Coordinate[]{
new CoordinateXY(0, 0),
new CoordinateXY(1, 0),
new CoordinateXY(1, 1),
new CoordinateXY(0, 1),
new CoordinateXY(0, 0)
}),
JTS_FACTORY.createPolygon(new Coordinate[]{
new CoordinateXY(3, 0),
new CoordinateXY(4, 0),
new CoordinateXY(4, 1),
new CoordinateXY(3, 1),
new CoordinateXY(3, 0)
})
}));
}
@Test
public void testRoundTripAttributes() {
testRoundTripAttrs(Map.of(
"string", "string",
"long", 1L,
"double", 3.5d,
"true", true,
"false", false
));
}
@Test
public void testMultipleFeaturesMultipleLayer() {
Point point = JTS_FACTORY.createPoint(new CoordinateXY(0, 0));
Map<String, Object> attrs1 = Map.of("a", 1L, "b", 2L);
Map<String, Object> attrs2 = Map.of("b", 3L, "c", 2L);
byte[] encoded = new VectorTile().addLayerFeatures("layer1", List.of(
new VectorTile.Feature("layer1", 1L, VectorTile.encodeGeometry(point), attrs1),
new VectorTile.Feature("layer1", 2L, VectorTile.encodeGeometry(point), attrs2)
)).addLayerFeatures("layer2", List.of(
new VectorTile.Feature("layer2", 3L, VectorTile.encodeGeometry(point), attrs1)
)).encode();
List<VectorTile.Feature> decoded = VectorTile.decode(encoded);
assertEquals(attrs1, decoded.get(0).attrs());
assertEquals("layer1", decoded.get(0).layer());
assertEquals(attrs2, decoded.get(1).attrs());
assertEquals("layer1", decoded.get(1).layer());
assertEquals(attrs1, decoded.get(2).attrs());
assertEquals("layer2", decoded.get(2).layer());
}
private void testRoundTripAttrs(Map<String, Object> attrs) {
testRoundTrip(JTS_FACTORY.createPoint(new CoordinateXY(0, 0)), "layer", attrs, 1);
}
private void testRoundTripGeometry(Geometry input) {
testRoundTrip(input, "layer", Map.of(), 1);
}
private void testRoundTrip(Geometry input, String layer, Map<String, Object> attrs, long id) {
VectorTile.VectorGeometry encodedGeom = VectorTile.encodeGeometry(input);
Geometry output = decodeSilently(encodedGeom);
assertTrue(input.equalsExact(output), "%n%s%n!=%n%s".formatted(input, output));
byte[] encoded = new VectorTile().addLayerFeatures(layer, List.of(
new VectorTile.Feature(layer, id, VectorTile.encodeGeometry(input), attrs)
)).encode();
List<VectorTile.Feature> decoded = VectorTile.decode(encoded);
VectorTile.Feature expected = new VectorTile.Feature(layer, id,
VectorTile.encodeGeometry(input), attrs);
assertEquals(List.of(expected), decoded);
assertSameGeometries(List.of(input), decoded);
}
private void assertSameGeometries(List<Geometry> expected, List<VectorTile.Feature> actual) {
assertEquals(expected, actual.stream().map(d -> decodeSilently(d.geometry())).toList());
}
@TestFactory
public Stream<DynamicTest> testScaleUnscale() throws NoninvertibleTransformationException {
var scales = List.of(0, 1, 2, 16);
var scaleUp = AffineTransformation.scaleInstance(256d / 4096, 256d / 4096);
var scaleDown = scaleUp.getInverse();
return Stream.of(
newPoint(0, 0),
newPoint(0.25, -0.25),
newPoint(1.25, 1.25),
newPoint(1.5, 1.5),
newMultiPoint(
newPoint(1.25, 1.25),
newPoint(1.5, 1.5)
),
newLineString(0, 0, 1.2, 1.2),
newLineString(0, 0, 0.1, 0.1),
newLineString(0, 0, 1, 1, 1.2, 1.2, 2, 2),
newLineString(8000, 8000, 8000, 8001, 8001, 8001),
newLineString(-4000, -4000, -4000, -4001, -4001, -4001),
newMultiLineString(
newLineString(0, 0, 1, 1),
newLineString(1.1, 1.1, 2, 2)
),
newMultiLineString(
newLineString(0, 0, 0.1, 0.1),
newLineString(1.1, 1.1, 2, 2)
),
newMultiLineString(
newLineString(-10, -10, -9, -9),
newLineString(0, 0, 0.1, 0.1),
newLineString(1.1, 1.1, 2, 2)
),
newPolygon(0, 0, 1, 0, 1, 1, 0, 1, 0, 0),
newPolygon(0, 0, 0.1, 0, 0.1, 0.1, 0, 0.1, 0, 0),
newPolygon(0, 0, 1, 0, 1, 0.1, 1, 1, 0, 1, 0, 0),
newMultiPolygon(
newPolygon(0, 0, 1, 0, 1, 1, 0, 1, 0, 0),
newPolygon(0, 0, -1, 0, -1, -1, 0, -1, 0, 0)
),
newPolygon(0, 0, 1, 0, 1, 1, 0, 1, 0, 0.1, 0, 0)
).map(scaleUp::transform)
.flatMap(geometry -> scales.stream().flatMap(scale -> Stream.of(
dynamicTest(scaleDown.transform(geometry) + " scale: " + scale, () -> {
PrecisionModel pm = new PrecisionModel((4096 << scale) / 256d);
assertSameGeometry(
GeometryPrecisionReducer.reduce(geometry, pm),
VectorTile.encodeGeometry(geometry, scale).decode()
);
}),
dynamicTest(scaleDown.transform(geometry) + " unscale: " + scale, () -> {
PrecisionModel pm = new PrecisionModel((4096 << scale) / 256d);
PrecisionModel pm0 = new PrecisionModel(4096d / 256);
assertSameGeometry(
GeometryPrecisionReducer.reduce(GeometryPrecisionReducer.reduce(geometry, pm), pm0),
VectorTile.encodeGeometry(geometry, scale).unscale().decode()
);
})
)
));
}
private void assertSameGeometry(Geometry expected, Geometry actual) {
if (expected.isEmpty() && actual.isEmpty()) {
// OK
} else {
assertSameNormalizedFeature(expected, actual);
}
}
}