Regions (BaseRegion
s) are geographical areas that do not yet have any of the necessary extra information to start a download (this is the responsibility ofDownloadableRegion
).
There are 4 types of BaseRegion
:
RectangleRegion
s are defined by a LatLngBounds
: two opposite LatLng
s.
This is usually all you get from most apps, so why not give your user a unique experience with some of our other region types...
CircleRegion
s are defined by a center LatLng
and radius in kilometers.
If you instead have two coordinates, one in the center, and one on the edge, you can use 'latlong2's Distance.distance()
method, as below:
LineRegion
s are defined by a list of LatLng
s, and a radius in meters.
This could be used to download tiles along a planned travel route, for example hiking or long-distance driving. Import coordinates from a routing engine, or from a GPX/KML file for maximum integration!
This region may generate more tiles than strictly necessary to cover the specified region. This is due to an internal limitation with the region generation algorithm, which uses rectangles to approximate the actual desired shape.
This type of region may consume more memory/RAM when generating tiles than other region types.
CustomPolygonRegion
s are defined by a list of LatLng
s defining the outline of a simple polygon.
Polygons should not contain self-intersections. These may produce unexpected results.
Holes are not supported.
RecoverableRegion
s aren't technically the same type of region as the others, and is the odd one out.
However, it can be converted to a downloadable region in the same way as the others, or the original BaseRegion
extracted using toRegion
.
For more info, see Recovery.