mil.nga.geopackage.tiles

Class TileBoundingBoxUtils

java.lang.Object

mil.nga.geopackage.tiles.TileBoundingBoxUtils

public class TileBoundingBoxUtils
extends Object

Tile Bounding Box utility methods

Author:

osbornb

Constructor Summary

Constructors

Constructor and Description
TileBoundingBoxUtils()

Method Summary

Modifier and Type	Method and Description
static BoundingBox	boundDegreesBoundingBoxWithWebMercatorLimits(BoundingBox boundingBox) Bound the upper and lower bounds of the degrees bounding box with web mercator limits
static BoundingBox	boundWgs84BoundingBoxWithWebMercatorLimits(BoundingBox boundingBox) Bound the upper and lower bounds of the WGS84 bounding box with web mercator limits
static BoundingBox	getBoundingBox(BoundingBox totalBox, long tileMatrixWidth, long tileMatrixHeight, long tileColumn, long tileRow) Get the bounding box of the tile column and row in the tile width and height bounds using the total bounding box with constant units
static BoundingBox	getBoundingBox(BoundingBox totalBox, long tileMatrixWidth, long tileMatrixHeight, TileGrid tileGrid) Get the bounding box of the tile grid in the tile width and height bounds using the total bounding box with constant units
static BoundingBox	getBoundingBox(BoundingBox totalBox, TileMatrix tileMatrix, long tileColumn, long tileRow) Get the bounding box of the tile column and row in the tile matrix using the total bounding box with constant units
static BoundingBox	getBoundingBox(BoundingBox totalBox, TileMatrix tileMatrix, TileGrid tileGrid) Get the bounding box of the tile grid in the tile matrix using the total bounding box with constant units
static BoundingBox	getBoundingBox(int x, int y, int zoom) Get the tile bounding box from the Google Maps API tile coordinates and zoom level
static double	getLatitudeFromPixel(long height, BoundingBox boundingBox, float pixel) Get the latitude from the pixel location, bounding box, and image height
static double	getLongitudeFromPixel(long width, BoundingBox boundingBox, float pixel) Get the longitude from the pixel location, bounding box, and image width
static double	getPixelXSize(BoundingBox webMercatorBoundingBox, long matrixWidth, int tileWidth) Get the pixel x size for the bounding box with matrix width and tile width
static double	getPixelYSize(BoundingBox webMercatorBoundingBox, long matrixHeight, int tileHeight) Get the pixel y size for the bounding box with matrix height and tile height
static BoundingBox	getProjectedBoundingBox(Long projectionEpsg, int x, int y, int zoom) Get the Projected tile bounding box from the Google Maps API tile coordinates and zoom level
static BoundingBox	getProjectedBoundingBox(Long projectionEpsg, TileGrid tileGrid, int zoom) Get the Projected tile bounding box from the Google Maps API tile tileGrid and zoom level
static BoundingBox	getProjectedBoundingBox(Projection projection, long x, long y, int zoom) Get the Projected tile bounding box from the Google Maps API tile coordinates and zoom level
static BoundingBox	getProjectedBoundingBox(Projection projection, TileGrid tileGrid, int zoom) Get the Projected tile bounding box from the Google Maps API tile grid and zoom level
static BoundingBox	getProjectedBoundingBox(String authority, Long code, int x, int y, int zoom) Get the Projected tile bounding box from the Google Maps API tile coordinates and zoom level
static BoundingBox	getProjectedBoundingBox(String authority, Long code, TileGrid tileGrid, int zoom) Get the Projected tile bounding box from the Google Maps API tile tileGrid and zoom level
static long	getTileColumn(BoundingBox totalBox, long matrixWidth, double longitude) Get the tile column of the longitude in constant units
static TileGrid	getTileGrid(BoundingBox webMercatorBoundingBox, int zoom) Get the tile grid that includes the entire tile bounding box
static TileGrid	getTileGrid(BoundingBox totalBox, long matrixWidth, long matrixHeight, BoundingBox boundingBox) Get the tile grid
static TileGrid	getTileGrid(Point point, int zoom, Projection projection) Get the tile grid for the location specified as the projection
static TileGrid	getTileGridFromWGS84(Point point, int zoom) Get the tile grid for the location specified as WGS84
static TileGrid	getTileGridWGS84(BoundingBox boundingBox, int zoom) Get the tile grid that includes the entire tile bounding box
static long	getTileRow(BoundingBox totalBox, long matrixHeight, double latitude) Get the tile row of the latitude in constant units
static BoundingBox	getWebMercatorBoundingBox(long x, long y, int zoom) Get the Web Mercator tile bounding box from the Google Maps API tile coordinates and zoom level
static BoundingBox	getWebMercatorBoundingBox(TileGrid tileGrid, int zoom) Get the Web Mercator tile bounding box from the Google Maps API tile grid and zoom level
static BoundingBox	getWGS84BoundingBox(TileGrid tileGrid, int zoom) Get the WGS84 tile bounding box from the tile grid and zoom level
static float	getXPixel(long width, BoundingBox boundingBox, double longitude) Get the X pixel for where the longitude fits into the bounding box
static int	getYAsOppositeTileFormat(int zoom, int y) Get the standard y tile location as TMS or a TMS y location as standard
static float	getYPixel(long height, BoundingBox boundingBox, double latitude) Get the Y pixel for where the latitude fits into the bounding box
static int	getZoomLevel(BoundingBox webMercatorBoundingBox) Get the zoom level of where the web mercator bounding box fits into the complete world
static BoundingBox	overlap(BoundingBox boundingBox, BoundingBox boundingBox2) Get the overlapping bounding box between the two bounding boxes
static double	tileHeightDegrees(int tilesPerSide) Get the tile height in degrees
static double	tileSize(int tilesPerSide) Get the tile size in meters
static double	tileSizeLatPerWGS84Side(int tilesPerLat) Get the tile height in degrees latitude
static double	tileSizeLonPerWGS84Side(int tilesPerLon) Get the tile height in degrees longitude
static int	tilesPerSide(int zoom) Get the tiles per side, width and height, at the zoom level
static int	tilesPerWGS84LatSide(int zoom) Get the tiles per latitude side at the zoom level
static int	tilesPerWGS84LonSide(int zoom) Get the tiles per longitude side at the zoom level
static double	tileWidthDegrees(int tilesPerSide) Get the tile width in degrees
static BoundingBox	toWebMercator(BoundingBox boundingBox) Convert the bounding box coordinates to a new web mercator bounding box
static BoundingBox	union(BoundingBox boundingBox, BoundingBox boundingBox2) Get the union bounding box combining the two bounding boxes
static int	zoomFromTilesPerSide(int tilesPerSide) Get the zoom level from the tiles per side
static double	zoomLevelOfTileSize(double tileSize) Get the zoom level from the tile size in meters

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

TileBoundingBoxUtils

public TileBoundingBoxUtils()

Method Detail

overlap

public static BoundingBox overlap(BoundingBox boundingBox,
                                  BoundingBox boundingBox2)

Get the overlapping bounding box between the two bounding boxes

Parameters:

boundingBox - bounding box 1

boundingBox2 - bounding box 2

Returns:

bounding box

union

public static BoundingBox union(BoundingBox boundingBox,
                                BoundingBox boundingBox2)

Get the union bounding box combining the two bounding boxes

Parameters:

boundingBox - bounding box 1

boundingBox2 - bounding box 2

Returns:

bounding box

getXPixel

public static float getXPixel(long width,
                              BoundingBox boundingBox,
                              double longitude)

Get the X pixel for where the longitude fits into the bounding box

Parameters:

width - width

boundingBox - bounding box

longitude - longitude

Returns:

x pixel

getLongitudeFromPixel

public static double getLongitudeFromPixel(long width,
                                           BoundingBox boundingBox,
                                           float pixel)

Get the longitude from the pixel location, bounding box, and image width

Parameters:

width - width

boundingBox - bounding box

pixel - pixel

Returns:

longitude

getYPixel

public static float getYPixel(long height,
                              BoundingBox boundingBox,
                              double latitude)

Get the Y pixel for where the latitude fits into the bounding box

Parameters:

height - height

boundingBox - bounding box

latitude - latitude

Returns:

y pixel

getLatitudeFromPixel

public static double getLatitudeFromPixel(long height,
                                          BoundingBox boundingBox,
                                          float pixel)

Get the latitude from the pixel location, bounding box, and image height

Parameters:

height - height

boundingBox - bounding box

pixel - pixel

Returns:

latitude

getBoundingBox

public static BoundingBox getBoundingBox(int x,
                                         int y,
                                         int zoom)

Get the tile bounding box from the Google Maps API tile coordinates and zoom level

Parameters:

x - x coordinate

y - y coordinate

zoom - zoom level

Returns:

bounding box

getWebMercatorBoundingBox

public static BoundingBox getWebMercatorBoundingBox(long x,
                                                    long y,
                                                    int zoom)

Get the Web Mercator tile bounding box from the Google Maps API tile coordinates and zoom level

Parameters:

x - x coordinate

y - y coordinate

zoom - zoom level

Returns:

bounding box

getWebMercatorBoundingBox

public static BoundingBox getWebMercatorBoundingBox(TileGrid tileGrid,
                                                    int zoom)

Get the Web Mercator tile bounding box from the Google Maps API tile grid and zoom level

Parameters:

tileGrid - tile grid

zoom - zoom level

Returns:

bounding box

getProjectedBoundingBox

public static BoundingBox getProjectedBoundingBox(Long projectionEpsg,
                                                  int x,
                                                  int y,
                                                  int zoom)

Get the Projected tile bounding box from the Google Maps API tile coordinates and zoom level

Parameters:

projectionEpsg - projection epsg

x - x coordinate

y - y coordinate

zoom - zoom level

Returns:

bounding box

getProjectedBoundingBox

public static BoundingBox getProjectedBoundingBox(String authority,
                                                  Long code,
                                                  int x,
                                                  int y,
                                                  int zoom)

Get the Projected tile bounding box from the Google Maps API tile coordinates and zoom level

Parameters:

authority - projection authority

code - projection code

x - x coordinate

y - y coordinate

zoom - zoom level

Returns:

bounding box

Since:

1.3.0

getProjectedBoundingBox

public static BoundingBox getProjectedBoundingBox(Projection projection,
                                                  long x,
                                                  long y,
                                                  int zoom)

Get the Projected tile bounding box from the Google Maps API tile coordinates and zoom level

Parameters:

projection - projection

x - x coordinate

y - y coordinate

zoom - zoom level

Returns:

bounding box

getProjectedBoundingBox

public static BoundingBox getProjectedBoundingBox(Long projectionEpsg,
                                                  TileGrid tileGrid,
                                                  int zoom)

Get the Projected tile bounding box from the Google Maps API tile tileGrid and zoom level

Parameters:

projectionEpsg - projection epsg

tileGrid - tile grid

zoom - zoom level

Returns:

bounding box

getProjectedBoundingBox

public static BoundingBox getProjectedBoundingBox(String authority,
                                                  Long code,
                                                  TileGrid tileGrid,
                                                  int zoom)

Get the Projected tile bounding box from the Google Maps API tile tileGrid and zoom level

Parameters:

authority - projection authority

code - projection code

tileGrid - tile grid

zoom - zoom level

Returns:

bounding box

Since:

1.3.0

getProjectedBoundingBox

public static BoundingBox getProjectedBoundingBox(Projection projection,
                                                  TileGrid tileGrid,
                                                  int zoom)

Get the Projected tile bounding box from the Google Maps API tile grid and zoom level

Parameters:

projection - projection

tileGrid - tile grid

zoom - zoom level

Returns:

bounding box

getTileGridFromWGS84

public static TileGrid getTileGridFromWGS84(Point point,
                                            int zoom)

Get the tile grid for the location specified as WGS84

Parameters:

point - point

zoom - zoom level

Returns:

tile grid

Since:

1.1.0

getTileGrid

public static TileGrid getTileGrid(Point point,
                                   int zoom,
                                   Projection projection)

Get the tile grid for the location specified as the projection

Parameters:

point - point

zoom - zoom level

projection - projection

Returns:

tile grid

Since:

1.1.0

getTileGrid

public static TileGrid getTileGrid(BoundingBox webMercatorBoundingBox,
                                   int zoom)

Get the tile grid that includes the entire tile bounding box

Parameters:

webMercatorBoundingBox - web mercator bounding box

zoom - zoom level

Returns:

tile grid

toWebMercator

public static BoundingBox toWebMercator(BoundingBox boundingBox)

Convert the bounding box coordinates to a new web mercator bounding box

Parameters:

boundingBox - bounding box

Returns:

bounding box

tileSize

public static double tileSize(int tilesPerSide)

Get the tile size in meters

Parameters:

tilesPerSide - tiles per side

Returns:

tile size

zoomLevelOfTileSize

public static double zoomLevelOfTileSize(double tileSize)

Get the zoom level from the tile size in meters

Parameters:

tileSize - tile size in meters

Returns:

zoom level

Since:

1.2.0

tileWidthDegrees

public static double tileWidthDegrees(int tilesPerSide)

Get the tile width in degrees

Parameters:

tilesPerSide - tiles per side

Returns:

tile width degrees

tileHeightDegrees

public static double tileHeightDegrees(int tilesPerSide)

Get the tile height in degrees

Parameters:

tilesPerSide - tiles per side

Returns:

tile height degrees

tilesPerSide

public static int tilesPerSide(int zoom)

Get the tiles per side, width and height, at the zoom level

Parameters:

zoom - zoom level

Returns:

tiles per side

getYAsOppositeTileFormat

public static int getYAsOppositeTileFormat(int zoom,
                                           int y)

Get the standard y tile location as TMS or a TMS y location as standard

Parameters:

zoom - zoom level

y - y coordinate

Returns:

opposite tile format y

zoomFromTilesPerSide

public static int zoomFromTilesPerSide(int tilesPerSide)

Get the zoom level from the tiles per side

Parameters:

tilesPerSide - tiles per side

Returns:

zoom level

getTileGrid

public static TileGrid getTileGrid(BoundingBox totalBox,
                                   long matrixWidth,
                                   long matrixHeight,
                                   BoundingBox boundingBox)

Get the tile grid

Parameters:

totalBox - total bounding box

matrixWidth - matrix width

matrixHeight - matrix height

boundingBox - bounding box

Returns:

tile grid

getTileColumn

public static long getTileColumn(BoundingBox totalBox,
                                 long matrixWidth,
                                 double longitude)

Get the tile column of the longitude in constant units

Parameters:

totalBox - total bounding box

matrixWidth - matrix width

longitude - in constant units

Returns:

tile column if in the range, -1 if before, TileMatrix.getMatrixWidth() if after

getTileRow

public static long getTileRow(BoundingBox totalBox,
                              long matrixHeight,
                              double latitude)

Get the tile row of the latitude in constant units

Parameters:

totalBox - total bounding box

matrixHeight - matrix height

latitude - in constant units

Returns:

tile row if in the range, -1 if before, TileMatrix.getMatrixHeight() if after

getBoundingBox

public static BoundingBox getBoundingBox(BoundingBox totalBox,
                                         TileMatrix tileMatrix,
                                         long tileColumn,
                                         long tileRow)

Get the bounding box of the tile column and row in the tile matrix using the total bounding box with constant units

Parameters:

totalBox - total bounding box

tileMatrix - tile matrix

tileColumn - tile column

tileRow - tile row

Returns:

bounding box

Since:

1.2.0

getBoundingBox

public static BoundingBox getBoundingBox(BoundingBox totalBox,
                                         long tileMatrixWidth,
                                         long tileMatrixHeight,
                                         long tileColumn,
                                         long tileRow)

Get the bounding box of the tile column and row in the tile width and height bounds using the total bounding box with constant units

Parameters:

totalBox - total bounding box

tileMatrixWidth - matrix width

tileMatrixHeight - matrix height

tileColumn - tile column

tileRow - tile row

Returns:

bounding box

Since:

1.2.0

getBoundingBox

public static BoundingBox getBoundingBox(BoundingBox totalBox,
                                         TileMatrix tileMatrix,
                                         TileGrid tileGrid)

Get the bounding box of the tile grid in the tile matrix using the total bounding box with constant units

Parameters:

totalBox - total bounding box

tileMatrix - tile matrix

tileGrid - tile grid

Returns:

bounding box

Since:

1.2.0

getBoundingBox

public static BoundingBox getBoundingBox(BoundingBox totalBox,
                                         long tileMatrixWidth,
                                         long tileMatrixHeight,
                                         TileGrid tileGrid)

Get the bounding box of the tile grid in the tile width and height bounds using the total bounding box with constant units

Parameters:

totalBox - total bounding box

tileMatrixWidth - matrix width

tileMatrixHeight - matrix height

tileGrid - tile grid

Returns:

bounding box

Since:

1.2.0

getZoomLevel

public static int getZoomLevel(BoundingBox webMercatorBoundingBox)

Get the zoom level of where the web mercator bounding box fits into the complete world

Parameters:

webMercatorBoundingBox - web mercator bounding box

Returns:

zoom level

getPixelXSize

public static double getPixelXSize(BoundingBox webMercatorBoundingBox,
                                   long matrixWidth,
                                   int tileWidth)

Get the pixel x size for the bounding box with matrix width and tile width

Parameters:

webMercatorBoundingBox - web mercator bounding box

matrixWidth - matrix width

tileWidth - tile width

Returns:

pixel x size

getPixelYSize

public static double getPixelYSize(BoundingBox webMercatorBoundingBox,
                                   long matrixHeight,
                                   int tileHeight)

Get the pixel y size for the bounding box with matrix height and tile height

Parameters:

webMercatorBoundingBox - web mercator bounding box

matrixHeight - matrix height

tileHeight - tile height

Returns:

pixel y size

boundWgs84BoundingBoxWithWebMercatorLimits

public static BoundingBox boundWgs84BoundingBoxWithWebMercatorLimits(BoundingBox boundingBox)

Bound the upper and lower bounds of the WGS84 bounding box with web mercator limits

Parameters:

boundingBox - wgs84 bounding box

Returns:

bounding box

Since:

1.1.6

boundDegreesBoundingBoxWithWebMercatorLimits

public static BoundingBox boundDegreesBoundingBoxWithWebMercatorLimits(BoundingBox boundingBox)

Bound the upper and lower bounds of the degrees bounding box with web mercator limits

Parameters:

boundingBox - degrees bounding box

Returns:

bounding box

Since:

1.3.1

getTileGridWGS84

public static TileGrid getTileGridWGS84(BoundingBox boundingBox,
                                        int zoom)

Get the tile grid that includes the entire tile bounding box

Parameters:

boundingBox - wgs84 bounding box

zoom - zoom level

Returns:

tile grid

Since:

1.2.0

getWGS84BoundingBox

public static BoundingBox getWGS84BoundingBox(TileGrid tileGrid,
                                              int zoom)

Get the WGS84 tile bounding box from the tile grid and zoom level

Parameters:

tileGrid - tile grid

zoom - zoom

Returns:

wgs84 bounding box

Since:

1.2.0

tilesPerWGS84LatSide

public static int tilesPerWGS84LatSide(int zoom)

Get the tiles per latitude side at the zoom level

Parameters:

zoom - zoom level

Returns:

tiles per latitude side

Since:

1.2.0

tilesPerWGS84LonSide

public static int tilesPerWGS84LonSide(int zoom)

Get the tiles per longitude side at the zoom level

Parameters:

zoom - zoom level

Returns:

tiles per longitude side

Since:

1.2.0

tileSizeLatPerWGS84Side

public static double tileSizeLatPerWGS84Side(int tilesPerLat)

Get the tile height in degrees latitude

Parameters:

tilesPerLat - tiles per latitude side

Returns:

degrees

Since:

1.2.0

tileSizeLonPerWGS84Side

public static double tileSizeLonPerWGS84Side(int tilesPerLon)

Get the tile height in degrees longitude

Parameters:

tilesPerLon - tiles per longitude side

Returns:

degrees

Since:

1.2.0