Package mil.nga.geopackage.map

Class MapUtils

java.lang.Object

mil.nga.geopackage.map.MapUtils

public class MapUtils
extends Object

Map utilities

Since:

2.0.0

Constructor Summary

Constructors

Constructor	Description
MapUtils()

Method Summary

Modifier and Type	Method	Description
static BoundingBox	buildClickBoundingBox(LatLng latLng, double zoom, PixelBounds pixelBounds, View view, GoogleMap map, float screenClickPercentage)	Build a bounding box using the click location, zoom level, pixel bounds, map view, map, and screen percentage tolerance.
static BoundingBox	buildClickBoundingBox(LatLng latLng, float density, double zoom, PixelBounds pixelBounds, View view, GoogleMap map, float screenClickPercentage)	Build a bounding box using the click location, display density, zoom level, pixel bounds, map view, map, and screen percentage tolerance.
static BoundingBox	buildClickBoundingBox(LatLng latLng, View view, GoogleMap map, float screenClickPercentage)	Build a bounding box using the click location, map view, map, and screen percentage tolerance.
static BoundingBox	buildClickBoundingBox(LatLng latLng, BoundingBox mapBounds, float screenClickPercentage)	Build a bounding box using the location coordinate click location and map view bounds
static BoundingBox	buildClickBoundingBox(LatLng latLng, PixelBounds pixelBounds, View view, GoogleMap map, float screenClickPercentage)	Build a bounding box using the click location, pixel bounds, map view, map, and screen percentage tolerance.
static BoundingBox	buildClickBoundingBox(LatLngBoundingBox boundingBox)	Build a bounding box using the click location
static LatLngBoundingBox	buildClickLatLngBoundingBox(LatLng latLng, double zoom, PixelBounds pixelBounds, View view, GoogleMap map, float screenClickPercentage)	Build a lat lng bounding box using the click location, zoom level, pixel bounds, map view, map, and screen percentage tolerance.
static LatLngBoundingBox	buildClickLatLngBoundingBox(LatLng latLng, float density, double zoom, PixelBounds pixelBounds, View view, GoogleMap map, float screenClickPercentage)	Build a lat lng bounding box using the click location, display density, zoom level, pixel bounds, map view, map, and screen percentage tolerance.
static LatLngBoundingBox	buildClickLatLngBoundingBox(LatLng latLng, View view, GoogleMap map, float screenClickPercentage)	Build a lat lng bounding box using the click location, map view, map, and screen percentage tolerance.
static LatLngBoundingBox	buildClickLatLngBoundingBox(LatLng latLng, PixelBounds pixelBounds, View view, GoogleMap map, float screenClickPercentage)	Build a lat lng bounding box using the click location, pixel bounds, map view, map, and screen percentage tolerance.
static LatLngBounds	buildClickLatLngBounds(LatLng latLng, double zoom, PixelBounds pixelBounds, View view, GoogleMap map, float screenClickPercentage)	Build a lat lng bounds using the click location, zoom level, pixel bounds, map view, map, and screen percentage tolerance.
static LatLngBounds	buildClickLatLngBounds(LatLng latLng, float density, double zoom, PixelBounds pixelBounds, View view, GoogleMap map, float screenClickPercentage)	Build a lat lng bounds using the click location, display density, zoom level, pixel bounds, map view, map, and screen percentage tolerance.
static LatLngBounds	buildClickLatLngBounds(LatLng latLng, View view, GoogleMap map, float screenClickPercentage)	Build a lat lng bounds using the click location, map view, map, and screen percentage tolerance.
static LatLngBounds	buildClickLatLngBounds(LatLng latLng, PixelBounds pixelBounds, View view, GoogleMap map, float screenClickPercentage)	Build a lat lng bounds using the click location, pixel bounds, map view, map, and screen percentage tolerance.
static BoundingBox	getBoundingBox(GoogleMap map)	Get the WGS84 bounding box of the current map view screen.
static float	getCurrentZoom(GoogleMap map)	Get the current zoom level of the map
static double	getToleranceDistance(View view, GoogleMap map)	Get the tolerance distance meters in the current region of the map
static double	getToleranceDistance(LatLng latLng, double zoom, PixelBounds pixelBounds, View view, GoogleMap map, float screenClickPercentage)	Get the allowable tolerance distance in meters from the click location on the map view and map with the screen percentage tolerance.
static double	getToleranceDistance(LatLng latLng, float density, double zoom, PixelBounds pixelBounds, View view, GoogleMap map, float screenClickPercentage)	Get the allowable tolerance distance in meters from the click location on the map view and map with the screen percentage tolerance.
static double	getToleranceDistance(LatLng latLng, View view, GoogleMap map, float screenClickPercentage)	Get the allowable tolerance distance in meters from the click location on the map view and map with the screen percentage tolerance.
static double	getToleranceDistance(LatLng latLng, LatLngBoundingBox boundingBox)	Get the allowable tolerance distance in meters from the click bounding box
static double	getToleranceDistance(LatLng latLng, PixelBounds pixelBounds, View view, GoogleMap map, float screenClickPercentage)	Get the allowable tolerance distance in meters from the click location on the map view and map with the screen percentage tolerance.
static double	getToleranceDistance(LatLngBoundingBox boundingBox)	Get the allowable tolerance distance in meters from the click bounding box
static boolean	isPointNearMarker(LatLng point, MarkerOptions shapeMarker, double tolerance)	Is the point near the shape marker
static boolean	isPointNearMultiLatLng(LatLng point, MultiLatLng multiLatLng, double tolerance)	Is the point near any points in the multi lat lng
static boolean	isPointNearPoint(LatLng point, LatLng shapePoint, double tolerance)	Is the point near the shape point
static boolean	isPointOnMultiPolygon(LatLng point, MultiPolygonOptions multiPolygon, boolean geodesic, double tolerance)	Is the point on the multi polygon
static boolean	isPointOnMultiPolyline(LatLng point, MultiPolylineOptions multiPolyline, boolean geodesic, double tolerance)	Is the point on the multi polyline
static boolean	isPointOnPolygon(LatLng point, PolygonOptions polygon, boolean geodesic, double tolerance)	Is the point of the polygon
static boolean	isPointOnPolyline(LatLng point, PolylineOptions polyline, boolean geodesic, double tolerance)	Is the point on the polyline
static boolean	isPointOnShape(LatLng point, GoogleMapShape shape, boolean geodesic, double tolerance)	Is the point on or near the shape

Methods inherited from class java.lang.Object

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

Constructor Detail

MapUtils

public MapUtils()

Method Detail

getCurrentZoom

public static float getCurrentZoom(GoogleMap map)

Get the current zoom level of the map

Parameters:

map - google map

Returns:

current zoom level

getToleranceDistance

public static double getToleranceDistance(View view,
                                          GoogleMap map)

Get the tolerance distance meters in the current region of the map

Parameters:

view - view

map - google map

Returns:

tolerance distance in meters

getBoundingBox

public static BoundingBox getBoundingBox(GoogleMap map)

Get the WGS84 bounding box of the current map view screen. The max longitude will be larger than the min resulting in values larger than 180.0.

Parameters:

map - google map

Returns:

current bounding box

buildClickBoundingBox

public static BoundingBox buildClickBoundingBox(LatLng latLng,
                                                View view,
                                                GoogleMap map,
                                                float screenClickPercentage)

Build a bounding box using the click location, map view, map, and screen percentage tolerance. The bounding box can be used to query for features that were clicked

Parameters:

latLng - click location

view - view

map - Google map

screenClickPercentage - screen click percentage between 0.0 and 1.0 for how close a feature on the screen must be to be included in a click query

Returns:

bounding box

buildClickBoundingBox

public static BoundingBox buildClickBoundingBox(LatLng latLng,
                                                PixelBounds pixelBounds,
                                                View view,
                                                GoogleMap map,
                                                float screenClickPercentage)

Build a bounding box using the click location, pixel bounds, map view, map, and screen percentage tolerance. The bounding box can be used to query for features that were clicked

Parameters:

latLng - click location

pixelBounds - click pixel bounds

view - view

map - Google map

screenClickPercentage - screen click percentage between 0.0 and 1.0 for how close a feature on the screen must be to be included in a click query

Returns:

bounding box

Since:

6.3.0

buildClickBoundingBox

public static BoundingBox buildClickBoundingBox(LatLng latLng,
                                                double zoom,
                                                PixelBounds pixelBounds,
                                                View view,
                                                GoogleMap map,
                                                float screenClickPercentage)

Build a bounding box using the click location, zoom level, pixel bounds, map view, map, and screen percentage tolerance. The bounding box can be used to query for features that were clicked

Parameters:

latLng - click location

zoom - current zoom level

pixelBounds - click pixel bounds

view - view

map - Google map

screenClickPercentage - screen click percentage between 0.0 and 1.0 for how close a feature on the screen must be to be included in a click query

Returns:

bounding box

Since:

6.3.0

buildClickBoundingBox

public static BoundingBox buildClickBoundingBox(LatLng latLng,
                                                float density,
                                                double zoom,
                                                PixelBounds pixelBounds,
                                                View view,
                                                GoogleMap map,
                                                float screenClickPercentage)

Build a bounding box using the click location, display density, zoom level, pixel bounds, map view, map, and screen percentage tolerance. The bounding box can be used to query for features that were clicked

Parameters:

latLng - click location

density - display density: DisplayMetrics.density

zoom - current zoom level

pixelBounds - click pixel bounds

view - view

map - Google map

screenClickPercentage - screen click percentage between 0.0 and 1.0 for how close a feature on the screen must be to be included in a click query

Returns:

bounding box

Since:

6.3.0

buildClickBoundingBox

public static BoundingBox buildClickBoundingBox(LatLngBoundingBox boundingBox)

Build a bounding box using the click location

Parameters:

boundingBox - click bounding box

Returns:

bounding box

Since:

6.3.0

buildClickLatLngBounds

public static LatLngBounds buildClickLatLngBounds(LatLng latLng,
                                                  View view,
                                                  GoogleMap map,
                                                  float screenClickPercentage)

Build a lat lng bounds using the click location, map view, map, and screen percentage tolerance. The bounding box can be used to query for features that were clicked

Parameters:

latLng - click location

view - view

map - Google map

screenClickPercentage - screen click percentage between 0.0 and 1.0 for how close a feature on the screen must be to be included in a click query

Returns:

bounding box

buildClickLatLngBounds

public static LatLngBounds buildClickLatLngBounds(LatLng latLng,
                                                  PixelBounds pixelBounds,
                                                  View view,
                                                  GoogleMap map,
                                                  float screenClickPercentage)

Build a lat lng bounds using the click location, pixel bounds, map view, map, and screen percentage tolerance. The bounding box can be used to query for features that were clicked

Parameters:

latLng - click location

pixelBounds - click pixel bounds

view - view

map - Google map

screenClickPercentage - screen click percentage between 0.0 and 1.0 for how close a feature on the screen must be to be included in a click query

Returns:

bounding box

Since:

6.3.0

buildClickLatLngBounds

public static LatLngBounds buildClickLatLngBounds(LatLng latLng,
                                                  double zoom,
                                                  PixelBounds pixelBounds,
                                                  View view,
                                                  GoogleMap map,
                                                  float screenClickPercentage)

Build a lat lng bounds using the click location, zoom level, pixel bounds, map view, map, and screen percentage tolerance. The bounding box can be used to query for features that were clicked

Parameters:

latLng - click location

zoom - current zoom level

pixelBounds - click pixel bounds

view - view

map - Google map

screenClickPercentage - screen click percentage between 0.0 and 1.0 for how close a feature on the screen must be to be included in a click query

Returns:

bounding box

Since:

6.3.0

buildClickLatLngBounds

public static LatLngBounds buildClickLatLngBounds(LatLng latLng,
                                                  float density,
                                                  double zoom,
                                                  PixelBounds pixelBounds,
                                                  View view,
                                                  GoogleMap map,
                                                  float screenClickPercentage)

Build a lat lng bounds using the click location, display density, zoom level, pixel bounds, map view, map, and screen percentage tolerance. The bounding box can be used to query for features that were clicked

Parameters:

latLng - click location

density - display density: DisplayMetrics.density

zoom - current zoom level

pixelBounds - click pixel bounds

view - view

map - Google map

screenClickPercentage - screen click percentage between 0.0 and 1.0 for how close a feature on the screen must be to be included in a click query

Returns:

bounding box

Since:

6.3.0

getToleranceDistance

public static double getToleranceDistance(LatLng latLng,
                                          View view,
                                          GoogleMap map,
                                          float screenClickPercentage)

Get the allowable tolerance distance in meters from the click location on the map view and map with the screen percentage tolerance.

Parameters:

latLng - click location

view - map view

map - map

screenClickPercentage - screen click percentage between 0.0 and 1.0 for how close a feature on the screen must be to be included in a click query

Returns:

tolerance distance in meters

getToleranceDistance

public static double getToleranceDistance(LatLng latLng,
                                          PixelBounds pixelBounds,
                                          View view,
                                          GoogleMap map,
                                          float screenClickPercentage)

Get the allowable tolerance distance in meters from the click location on the map view and map with the screen percentage tolerance.

Parameters:

latLng - click location

pixelBounds - click pixel bounds

view - map view

map - map

screenClickPercentage - screen click percentage between 0.0 and 1.0 for how close a feature on the screen must be to be included in a click query

Returns:

tolerance distance in meters

Since:

6.3.0

getToleranceDistance

public static double getToleranceDistance(LatLng latLng,
                                          double zoom,
                                          PixelBounds pixelBounds,
                                          View view,
                                          GoogleMap map,
                                          float screenClickPercentage)

Get the allowable tolerance distance in meters from the click location on the map view and map with the screen percentage tolerance.

Parameters:

latLng - click location

zoom - current zoom level

pixelBounds - click pixel bounds

view - map view

map - map

screenClickPercentage - screen click percentage between 0.0 and 1.0 for how close a feature on the screen must be to be included in a click query

Returns:

tolerance distance in meters

Since:

6.3.0

getToleranceDistance

public static double getToleranceDistance(LatLng latLng,
                                          float density,
                                          double zoom,
                                          PixelBounds pixelBounds,
                                          View view,
                                          GoogleMap map,
                                          float screenClickPercentage)

Get the allowable tolerance distance in meters from the click location on the map view and map with the screen percentage tolerance.

Parameters:

latLng - click location

density - display density: DisplayMetrics.density

zoom - current zoom level

pixelBounds - click pixel bounds

view - map view

map - map

screenClickPercentage - screen click percentage between 0.0 and 1.0 for how close a feature on the screen must be to be included in a click query

Returns:

tolerance distance in meters

Since:

6.3.0

getToleranceDistance

public static double getToleranceDistance(LatLng latLng,
                                          LatLngBoundingBox boundingBox)

Get the allowable tolerance distance in meters from the click bounding box

Parameters:

latLng - click location

boundingBox - click bounding box

Returns:

tolerance distance in meters

Since:

6.3.0

getToleranceDistance

public static double getToleranceDistance(LatLngBoundingBox boundingBox)

Get the allowable tolerance distance in meters from the click bounding box

Parameters:

boundingBox - click bounding box

Returns:

tolerance distance in meters

Since:

6.3.0

buildClickLatLngBoundingBox

public static LatLngBoundingBox buildClickLatLngBoundingBox(LatLng latLng,
                                                            View view,
                                                            GoogleMap map,
                                                            float screenClickPercentage)

Build a lat lng bounding box using the click location, map view, map, and screen percentage tolerance. The bounding box can be used to query for features that were clicked

Parameters:

latLng - click location

view - map view

map - map

screenClickPercentage - screen click percentage between 0.0 and 1.0 for how close a feature on the screen must be to be included in a click query

Returns:

lat lng bounding box

buildClickLatLngBoundingBox

public static LatLngBoundingBox buildClickLatLngBoundingBox(LatLng latLng,
                                                            PixelBounds pixelBounds,
                                                            View view,
                                                            GoogleMap map,
                                                            float screenClickPercentage)

Build a lat lng bounding box using the click location, pixel bounds, map view, map, and screen percentage tolerance. The bounding box can be used to query for features that were clicked

Parameters:

latLng - click location

pixelBounds - click pixel bounds

view - map view

map - map

screenClickPercentage - screen click percentage between 0.0 and 1.0 for how close a feature on the screen must be to be included in a click query

Returns:

lat lng bounding box

Since:

6.3.0

buildClickLatLngBoundingBox

public static LatLngBoundingBox buildClickLatLngBoundingBox(LatLng latLng,
                                                            double zoom,
                                                            PixelBounds pixelBounds,
                                                            View view,
                                                            GoogleMap map,
                                                            float screenClickPercentage)

Build a lat lng bounding box using the click location, zoom level, pixel bounds, map view, map, and screen percentage tolerance. The bounding box can be used to query for features that were clicked

Parameters:

latLng - click location

zoom - current zoom level

pixelBounds - click pixel bounds

view - map view

map - map

screenClickPercentage - screen click percentage between 0.0 and 1.0 for how close a feature on the screen must be to be included in a click query

Returns:

lat lng bounding box

Since:

6.3.0

buildClickLatLngBoundingBox

public static LatLngBoundingBox buildClickLatLngBoundingBox(LatLng latLng,
                                                            float density,
                                                            double zoom,
                                                            PixelBounds pixelBounds,
                                                            View view,
                                                            GoogleMap map,
                                                            float screenClickPercentage)

Build a lat lng bounding box using the click location, display density, zoom level, pixel bounds, map view, map, and screen percentage tolerance. The bounding box can be used to query for features that were clicked

Parameters:

latLng - click location

density - display density: DisplayMetrics.density

zoom - current zoom level

pixelBounds - click pixel bounds

view - map view

map - map

screenClickPercentage - screen click percentage between 0.0 and 1.0 for how close a feature on the screen must be to be included in a click query

Returns:

lat lng bounding box

Since:

6.3.0

buildClickBoundingBox

public static BoundingBox buildClickBoundingBox(LatLng latLng,
                                                BoundingBox mapBounds,
                                                float screenClickPercentage)

Build a bounding box using the location coordinate click location and map view bounds

Parameters:

latLng - click location

mapBounds - map bounds

screenClickPercentage - screen click percentage between 0.0 and 1.0 for how close a feature on the screen must be to be included in a click query

Returns:

bounding box

Since:

6.3.0

isPointOnShape

public static boolean isPointOnShape(LatLng point,
                                     GoogleMapShape shape,
                                     boolean geodesic,
                                     double tolerance)

Is the point on or near the shape

Parameters:

point - lat lng point

shape - map shape

geodesic - geodesic check flag

tolerance - distance tolerance

Returns:

true if point is on shape

isPointNearMarker

public static boolean isPointNearMarker(LatLng point,
                                        MarkerOptions shapeMarker,
                                        double tolerance)

Is the point near the shape marker

Parameters:

point - point

shapeMarker - shape marker

tolerance - distance tolerance

Returns:

true if near

isPointNearPoint

public static boolean isPointNearPoint(LatLng point,
                                       LatLng shapePoint,
                                       double tolerance)

Is the point near the shape point

Parameters:

point - point

shapePoint - shape point

tolerance - distance tolerance

Returns:

true if near

isPointNearMultiLatLng

public static boolean isPointNearMultiLatLng(LatLng point,
                                             MultiLatLng multiLatLng,
                                             double tolerance)

Is the point near any points in the multi lat lng

Parameters:

point - point

multiLatLng - multi lat lng

tolerance - distance tolerance

Returns:

true if near

isPointOnPolyline

public static boolean isPointOnPolyline(LatLng point,
                                        PolylineOptions polyline,
                                        boolean geodesic,
                                        double tolerance)

Is the point on the polyline

Parameters:

point - point

polyline - polyline

geodesic - geodesic check flag

tolerance - distance tolerance

Returns:

true if on the line

isPointOnMultiPolyline

public static boolean isPointOnMultiPolyline(LatLng point,
                                             MultiPolylineOptions multiPolyline,
                                             boolean geodesic,
                                             double tolerance)

Is the point on the multi polyline

Parameters:

point - point

multiPolyline - multi polyline

geodesic - geodesic check flag

tolerance - distance tolerance

Returns:

true if on the multi line

isPointOnPolygon

public static boolean isPointOnPolygon(LatLng point,
                                       PolygonOptions polygon,
                                       boolean geodesic,
                                       double tolerance)

Is the point of the polygon

Parameters:

point - point

polygon - polygon

geodesic - geodesic check flag

tolerance - distance tolerance

Returns:

true if on the polygon

isPointOnMultiPolygon

public static boolean isPointOnMultiPolygon(LatLng point,
                                            MultiPolygonOptions multiPolygon,
                                            boolean geodesic,
                                            double tolerance)

Is the point on the multi polygon

Parameters:

point - point

multiPolygon - multi polygon

geodesic - geodesic check flag

tolerance - distance tolerance

Returns:

true if on the multi polygon