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

All Methods Static Methods Concrete Methods
Modifier and Type	Method	Description
`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 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 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 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, 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 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

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

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

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

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

Class MapUtils

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

MapUtils

Method Detail

getCurrentZoom

getToleranceDistance

getBoundingBox

buildClickBoundingBox

buildClickLatLngBounds

getToleranceDistance

buildClickLatLngBoundingBox

isPointOnShape

isPointNearMarker

isPointNearPoint

isPointNearMultiLatLng

isPointOnPolyline

isPointOnMultiPolyline

isPointOnPolygon

isPointOnMultiPolygon