Andbtiles Library

Android Library to display your changelog

License

License

GroupId

GroupId

com.tesera.andbtiles
ArtifactId

ArtifactId

library
Last Version

Last Version

1.0.6
Release Date

Release Date

Type

Type

aar
Description

Description

Andbtiles Library
Android Library to display your changelog
Project URL

Project URL

https://github.com/tesera/andbtiles
Source Code Management

Source Code Management

https://github.com/tesera/andbtiles

Download library

How to add to project

<!-- https://jarcasting.com/artifacts/com.tesera.andbtiles/library/ -->
<dependency>
    <groupId>com.tesera.andbtiles</groupId>
    <artifactId>library</artifactId>
    <version>1.0.6</version>
    <type>aar</type>
</dependency>
// https://jarcasting.com/artifacts/com.tesera.andbtiles/library/
implementation 'com.tesera.andbtiles:library:1.0.6'
// https://jarcasting.com/artifacts/com.tesera.andbtiles/library/
implementation ("com.tesera.andbtiles:library:1.0.6")
'com.tesera.andbtiles:library:aar:1.0.6'
<dependency org="com.tesera.andbtiles" name="library" rev="1.0.6">
  <artifact name="library" type="aar" />
</dependency>
@Grapes(
@Grab(group='com.tesera.andbtiles', module='library', version='1.0.6')
)
libraryDependencies += "com.tesera.andbtiles" % "library" % "1.0.6"
[com.tesera.andbtiles/library "1.0.6"]

Dependencies

compile (3)

Group / Artifact Type Version
com.google.code.gson : gson jar 2.2.4
commons-io : commons-io jar 2.4
com.android.support » support-v4 jar 19.0.1

Project Modules

There are no modules declared in this project.

Andbtiles

Andbtiles is an Android utility library that manages downloading, caching or harvesting of MBTiles and exposing them to external applications via a Content Provider.
content://com.tesera.andbtiles.provider/{mapId}/tiles

Features

  • Add a local map provider
  • Add a remote map provider
  • Select a cache method
  • Expose MBTiles data via ContentProvider

Datasources

  • Local MBTiles file
  • Remote MBTiles file
  • Map from TileJSON endpoint

Cache Modes

  • No cache: acts like a simple proxy, tiles are downloaded and exposed via the content provider
  • On-Demand cache: requested tiles are downloaded and cached locally
  • Full cache: tiles are harvest one by one and cached locally
  • Data-Only cache: only the private data (.mbtiles file) is downloaded and saved locally

Usage and Integration

See the Quick Start guides for more information on how to achieve a simple integration:

Sample application

Check out the sample application that builds UI on top of the library providing means for local file selection, remote file download, TileJSON endpoint parsing, cache method selection and map preview using Google Maps.

Example Use Case: Web View

  1. The web view loads a map and requests a tile via http.
  2. The web view client intercepts the request and uses content resolver to query for tile data.
  3. The Andbtiles content provider serves the tile data to the web view.

Limitations

A single content provider serves data from a single database only. Since the library can manage multiple maps, the connection to the previous content provider must be closed in order to use the new one.
Android likes to keep connections alive, so in order to close it you need to end the process that established it. Since this can be a major inconvenience when developing apps that show multiple maps or overlays, an alternative method for tile requests is provided.
Check out the getTile() method in the Examples for details.

Roadmap:

  • ver1: ability to add manual datasources
  • ver2: ability to add datasources via IntentFilter.
com.tesera.andbtiles

Tesera Systems Inc.

Versions

Version
1.0.6
1.0.5
1.0.4
1.0.3
1.0.2
1.0.1