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	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 long	getTileColumn(BoundingBox webMercatorTotalBox, long matrixWidth, double longitude) Get the tile column of the longitude in degrees
static TileGrid	getTileGrid(BoundingBox webMercatorBoundingBox, int zoom) Get the tile grid that includes the entire tile bounding box
static TileGrid	getTileGrid(BoundingBox webMercatorTotalBox, long matrixWidth, long matrixHeight, BoundingBox webMercatorBoundingBox) 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 long	getTileRow(BoundingBox webMercatorTotalBox, long matrixHeight, double latitude) Get the tile row of the latitude in degrees
static BoundingBox	getWebMercatorBoundingBox(BoundingBox webMercatorTotalBox, long tileMatrixWidth, long tileMatrixHeight, long tileColumn, long tileRow) Get the web mercator bounding box of the tile column and row in the tile width and height bounds using the total bounding box
static BoundingBox	getWebMercatorBoundingBox(BoundingBox webMercatorTotalBox, long tileMatrixWidth, long tileMatrixHeight, TileGrid tileGrid) Get the web mercator bounding box of the tile grid in the tile width and height bounds using the total bounding box
static BoundingBox	getWebMercatorBoundingBox(BoundingBox webMercatorTotalBox, TileMatrix tileMatrix, long tileColumn, long tileRow) Get the web mercator bounding box of the tile column and row in the tile matrix using the total bounding box
static BoundingBox	getWebMercatorBoundingBox(BoundingBox webMercatorTotalBox, TileMatrix tileMatrix, TileGrid tileGrid) Get the web mercator bounding box of the tile grid in the tile matrix using the total bounding box
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 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 int	tilesPerSide(int zoom) Get the tiles per side, width and height, 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

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 -

boundingBox2 -

Returns:

union

public static BoundingBox union(BoundingBox boundingBox,
                                BoundingBox boundingBox2)

Get the union bounding box combining the two bounding boxes

Parameters:

boundingBox -

boundingBox2 -

Returns:

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 -

boundingBox -

longitude -

Returns:

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 -

boundingBox -

pixel -

Returns:

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 -

boundingBox -

tileRowBoundingBox -

Returns:

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 -

boundingBox -

pixel -

Returns:

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 -

y -

zoom -

Returns:

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 -

y -

zoom -

Returns:

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:

x -

y -

zoom -

Returns:

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 -

x -

y -

zoom -

Returns:

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 -

x -

y -

zoom -

Returns:

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 -

tileGrid -

zoom -

Returns:

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 -

tileGrid -

zoom -

Returns:

getTileGridFromWGS84

public static TileGrid getTileGridFromWGS84(Point point,
                                            int zoom)

Get the tile grid for the location specified as WGS84

Parameters:

point -

zoom -

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 -

zoom -

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 -

zoom -

Returns:

toWebMercator

public static BoundingBox toWebMercator(BoundingBox boundingBox)

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

Parameters:

boundingBox -

tileSize

public static double tileSize(int tilesPerSide)

Get the tile size in meters

Parameters:

tilesPerSide -

Returns:

tileWidthDegrees

public static double tileWidthDegrees(int tilesPerSide)

Get the tile width in degrees

Parameters:

tilesPerSide -

Returns:

tileHeightDegrees

public static double tileHeightDegrees(int tilesPerSide)

Get the tile height in degrees

Parameters:

tilesPerSide -

Returns:

tilesPerSide

public static int tilesPerSide(int zoom)

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

Parameters:

zoom -

Returns:

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 -

y -

Returns:

zoomFromTilesPerSide

public static int zoomFromTilesPerSide(int tilesPerSide)

Get the zoom level from the tiles per side

Parameters:

tilesPerSide -

Returns:

getTileGrid

public static TileGrid getTileGrid(BoundingBox webMercatorTotalBox,
                                   long matrixWidth,
                                   long matrixHeight,
                                   BoundingBox webMercatorBoundingBox)

Get the tile grid

Parameters:

webMercatorTotalBox -

matrixWidth -

matrixHeight -

webMercatorBoundingBox -

Returns:

getTileColumn

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

Get the tile column of the longitude in degrees

Parameters:

webMercatorTotalBox -

matrixWidth -

longitude - in meters

Returns:

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

getTileRow

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

Get the tile row of the latitude in degrees

Parameters:

webMercatorTotalBox -

matrixHeight -

latitude - in meters

Returns:

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

getWebMercatorBoundingBox

public static BoundingBox getWebMercatorBoundingBox(BoundingBox webMercatorTotalBox,
                                                    TileMatrix tileMatrix,
                                                    long tileColumn,
                                                    long tileRow)

Get the web mercator bounding box of the tile column and row in the tile matrix using the total bounding box

Parameters:

webMercatorTotalBox - total bounding box

tileMatrix - tile matrix

tileColumn - tile column

tileRow - tile row

Returns:

bounding box

getWebMercatorBoundingBox

public static BoundingBox getWebMercatorBoundingBox(BoundingBox webMercatorTotalBox,
                                                    long tileMatrixWidth,
                                                    long tileMatrixHeight,
                                                    long tileColumn,
                                                    long tileRow)

Get the web mercator bounding box of the tile column and row in the tile width and height bounds using the total bounding box

Parameters:

webMercatorTotalBox - total bounding box

matrixWidth - matrix width

matrixHeight - matrix height

tileColumn - tile column

tileRow - tile row

Returns:

bounding box

getWebMercatorBoundingBox

public static BoundingBox getWebMercatorBoundingBox(BoundingBox webMercatorTotalBox,
                                                    TileMatrix tileMatrix,
                                                    TileGrid tileGrid)

Get the web mercator bounding box of the tile grid in the tile matrix using the total bounding box

Parameters:

webMercatorTotalBox - total bounding box

tileMatrix - tile matrix

tileGrid - tile grid

Returns:

bounding box

Since:

1.1.1

getWebMercatorBoundingBox

public static BoundingBox getWebMercatorBoundingBox(BoundingBox webMercatorTotalBox,
                                                    long tileMatrixWidth,
                                                    long tileMatrixHeight,
                                                    TileGrid tileGrid)

Get the web mercator bounding box of the tile grid in the tile width and height bounds using the total bounding box

Parameters:

webMercatorTotalBox - total bounding box

tileMatrixWidth - matrix width

tileMatrixHeight - matrix height

tileGrid - tile grid

Returns:

bounding box

Since:

1.1.1

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 -

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 -

matrixWidth -

tileWidth -

Returns:

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 -

matrixHeight -

tileHeight -

Returns: