kopia lustrzana https://github.com/meshtastic/Meshtastic-Android
added example files for offline maps for testing
Jackson Rosenthal
rodzic
93fc27aba8
commit
56c1480acb
|
|
@ -0,0 +1,425 @@
|
|||
package com.geeksville.mesh.ui
|
||||
|
||||
import android.annotation.SuppressLint
|
||||
import android.graphics.Color
|
||||
import android.os.Bundle
|
||||
import android.os.Handler
|
||||
import android.util.Log
|
||||
import android.view.LayoutInflater
|
||||
import android.view.View
|
||||
import android.view.ViewGroup
|
||||
import android.widget.TextView
|
||||
import androidx.annotation.NonNull
|
||||
import androidx.appcompat.app.AppCompatActivity
|
||||
import androidx.core.content.ContextCompat
|
||||
import androidx.recyclerview.widget.LinearLayoutManager
|
||||
import androidx.recyclerview.widget.RecyclerView
|
||||
import com.geeksville.mesh.R
|
||||
import com.geeksville.mesh.databinding.ActivityOfflineBinding
|
||||
import com.mapbox.bindgen.Value
|
||||
import com.mapbox.common.*
|
||||
import com.mapbox.geojson.Point
|
||||
import com.mapbox.maps.*
|
||||
import com.mapbox.maps.plugin.annotation.annotations
|
||||
import com.mapbox.maps.plugin.annotation.generated.CircleAnnotationOptions
|
||||
import com.mapbox.maps.plugin.annotation.generated.createCircleAnnotationManager
|
||||
import java.util.*
|
||||
|
||||
/**
|
||||
* Example app that shows how to use OfflineManager and TileStore to
|
||||
* download regions for offline use.
|
||||
*
|
||||
* By default, users may download up to 250MB of data for offline
|
||||
* use without incurring additional charges. This limit is subject
|
||||
* to change during the beta.
|
||||
*/
|
||||
class OfflineActivity : AppCompatActivity() {
|
||||
private val tileStore: TileStore by lazy {
|
||||
TileStore.create().also {
|
||||
// Set default access token for the created tile store instance
|
||||
it.setOption(
|
||||
TileStoreOptions.MAPBOX_ACCESS_TOKEN,
|
||||
TileDataDomain.MAPS,
|
||||
Value(getString(R.string.mapbox_access_token))
|
||||
)
|
||||
}
|
||||
}
|
||||
private val resourceOptions: ResourceOptions by lazy {
|
||||
ResourceOptions.Builder().applyDefaultParams(this).tileStore(tileStore).build()
|
||||
}
|
||||
private val offlineManager: OfflineManager by lazy {
|
||||
OfflineManager(resourceOptions)
|
||||
}
|
||||
private val offlineLogsAdapter: OfflineLogsAdapter by lazy {
|
||||
OfflineLogsAdapter()
|
||||
}
|
||||
private var mapView: MapView? = null
|
||||
private lateinit var handler: Handler
|
||||
private lateinit var binding: ActivityOfflineBinding
|
||||
private var stylePackCancelable: Cancelable? = null
|
||||
private var tilePackCancelable: Cancelable? = null
|
||||
override fun onCreate(savedInstanceState: Bundle?) {
|
||||
super.onCreate(savedInstanceState)
|
||||
binding = ActivityOfflineBinding.inflate(layoutInflater)
|
||||
setContentView(binding.root)
|
||||
handler = Handler()
|
||||
|
||||
// Initialize a logger that writes into the recycler view
|
||||
binding.recycler.layoutManager = LinearLayoutManager(this)
|
||||
binding.recycler.adapter = offlineLogsAdapter
|
||||
|
||||
prepareDownloadButton()
|
||||
}
|
||||
|
||||
private fun prepareDownloadButton() {
|
||||
updateButton("DOWNLOAD") {
|
||||
downloadOfflineRegion()
|
||||
}
|
||||
}
|
||||
|
||||
private fun prepareCancelButton() {
|
||||
updateButton("CANCEL DOWNLOAD") {
|
||||
stylePackCancelable?.cancel()
|
||||
tilePackCancelable?.cancel()
|
||||
prepareDownloadButton()
|
||||
}
|
||||
}
|
||||
|
||||
private fun prepareViewMapButton() {
|
||||
// Disable network stack, so that the map can only load from downloaded region.
|
||||
OfflineSwitch.getInstance().isMapboxStackConnected = false
|
||||
logInfoMessage("Mapbox network stack disabled.")
|
||||
handler.post {
|
||||
updateButton("VIEW MAP") {
|
||||
// create a Mapbox MapView
|
||||
|
||||
// Note that the MapView must be initialised with the same TileStore that is used to create
|
||||
// the tile regions. (i.e. the tileStorePath must be consistent).
|
||||
|
||||
// If user did not assign the tile store path specifically during the tile region download
|
||||
// and the map initialisation period, the default tile store path will be used and
|
||||
// no extra action is needed.
|
||||
mapView = MapView(this@OfflineActivity).also { mapview ->
|
||||
val mapboxMap = mapview.getMapboxMap()
|
||||
mapboxMap.setCamera(CameraOptions.Builder().zoom(ZOOM).center(TOKYO).build())
|
||||
mapboxMap.loadStyleUri(Style.OUTDOORS) {
|
||||
// Add a circle annotation to the offline geometry.
|
||||
mapview.annotations.createCircleAnnotationManager().create(
|
||||
CircleAnnotationOptions()
|
||||
.withPoint(TOKYO)
|
||||
.withCircleColor(Color.RED)
|
||||
)
|
||||
}
|
||||
}
|
||||
binding.container.addView(mapView)
|
||||
mapView?.onStart()
|
||||
prepareShowDownloadedRegionButton()
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
private fun prepareShowDownloadedRegionButton() {
|
||||
updateButton("SHOW DOWNLOADED REGIONS") {
|
||||
showDownloadedRegions()
|
||||
prepareRemoveOfflineRegionButton()
|
||||
}
|
||||
}
|
||||
|
||||
private fun prepareRemoveOfflineRegionButton() {
|
||||
updateButton("REMOVE DOWNLOADED REGIONS") {
|
||||
removeOfflineRegions()
|
||||
showDownloadedRegions()
|
||||
binding.container.removeAllViews()
|
||||
|
||||
// Re-enable the Mapbox network stack, so that the new offline region download can succeed.
|
||||
OfflineSwitch.getInstance().isMapboxStackConnected = true
|
||||
logInfoMessage("Mapbox network stack enabled.")
|
||||
|
||||
prepareDownloadButton()
|
||||
}
|
||||
}
|
||||
|
||||
private fun updateButton(text: String, listener: View.OnClickListener) {
|
||||
binding.button.text = text
|
||||
binding.button.setOnClickListener(listener)
|
||||
}
|
||||
|
||||
private fun downloadOfflineRegion() {
|
||||
// By default, users may download up to 250MB of data for offline use without incurring
|
||||
// additional charges. This limit is subject to change during the beta.
|
||||
|
||||
// - - - - - - - -
|
||||
|
||||
// 1. Create style package with loadStylePack() call.
|
||||
|
||||
// A style pack (a Style offline package) contains the loaded style and its resources: loaded
|
||||
// sources, fonts, sprites. Style packs are identified with their style URI.
|
||||
|
||||
// Style packs are stored in the disk cache database, but their resources are not subject to
|
||||
// the data eviction algorithm and are not considered when calculating the disk cache size.
|
||||
stylePackCancelable = offlineManager.loadStylePack(
|
||||
Style.OUTDOORS,
|
||||
// Build Style pack load options
|
||||
StylePackLoadOptions.Builder()
|
||||
.glyphsRasterizationMode(GlyphsRasterizationMode.IDEOGRAPHS_RASTERIZED_LOCALLY)
|
||||
.metadata(Value(STYLE_PACK_METADATA))
|
||||
.build(),
|
||||
{ progress ->
|
||||
// Update the download progress to UI
|
||||
updateStylePackDownloadProgress(
|
||||
progress.completedResourceCount,
|
||||
progress.requiredResourceCount,
|
||||
"StylePackLoadProgress: $progress"
|
||||
)
|
||||
},
|
||||
{ expected ->
|
||||
if (expected.isValue) {
|
||||
expected.value?.let { stylePack ->
|
||||
// Style pack download finishes successfully
|
||||
logSuccessMessage("StylePack downloaded: $stylePack")
|
||||
if (binding.tilePackDownloadProgress.progress == binding.tilePackDownloadProgress.max) {
|
||||
prepareViewMapButton()
|
||||
} else {
|
||||
logInfoMessage("Waiting for tile region download to be finished.")
|
||||
}
|
||||
}
|
||||
}
|
||||
expected.error?.let {
|
||||
// Handle error occurred during the style pack download.
|
||||
logErrorMessage("StylePackError: $it")
|
||||
}
|
||||
}
|
||||
)
|
||||
|
||||
// - - - - - - - -
|
||||
|
||||
// 2. Create a tile region with tiles for the outdoors style
|
||||
|
||||
// A Tile Region represents an identifiable geographic tile region with metadata, consisting of
|
||||
// a set of tiles packs that cover a given area (a polygon). Tile Regions allow caching tiles
|
||||
// packs in an explicit way: By creating a Tile Region, developers can ensure that all tiles in
|
||||
// that region will be downloaded and remain cached until explicitly deleted.
|
||||
|
||||
// Creating a Tile Region requires supplying a description of the area geometry, the tilesets
|
||||
// and zoom ranges of the tiles within the region.
|
||||
|
||||
// The tileset descriptor encapsulates the tile-specific data, such as which tilesets, zoom ranges,
|
||||
// pixel ratio etc. the cached tile packs should have. It is passed to the Tile Store along with
|
||||
// the region area geometry to load a new Tile Region.
|
||||
|
||||
// The OfflineManager is responsible for creating tileset descriptors for the given style and zoom range.
|
||||
val tilesetDescriptor = offlineManager.createTilesetDescriptor(
|
||||
TilesetDescriptorOptions.Builder()
|
||||
.styleURI(Style.OUTDOORS)
|
||||
.minZoom(0)
|
||||
.maxZoom(16)
|
||||
.build()
|
||||
)
|
||||
|
||||
// Use the the default TileStore to load this region. You can create custom TileStores are are
|
||||
// unique for a particular file path, i.e. there is only ever one TileStore per unique path.
|
||||
|
||||
// Note that the TileStore path must be the same with the TileStore used when initialise the MapView.
|
||||
tilePackCancelable = tileStore.loadTileRegion(
|
||||
TILE_REGION_ID,
|
||||
TileRegionLoadOptions.Builder()
|
||||
.geometry(TOKYO)
|
||||
.descriptors(listOf(tilesetDescriptor))
|
||||
.metadata(Value(TILE_REGION_METADATA))
|
||||
.acceptExpired(true)
|
||||
.networkRestriction(NetworkRestriction.NONE)
|
||||
.build(),
|
||||
{ progress ->
|
||||
updateTileRegionDownloadProgress(
|
||||
progress.completedResourceCount,
|
||||
progress.requiredResourceCount,
|
||||
"TileRegionLoadProgress: $progress"
|
||||
)
|
||||
}
|
||||
) { expected ->
|
||||
if (expected.isValue) {
|
||||
// Tile pack download finishes successfully
|
||||
expected.value?.let { region ->
|
||||
logSuccessMessage("TileRegion downloaded: $region")
|
||||
if (binding.stylePackDownloadProgress.progress == binding.stylePackDownloadProgress.max) {
|
||||
prepareViewMapButton()
|
||||
} else {
|
||||
logInfoMessage("Waiting for style pack download to be finished.")
|
||||
}
|
||||
}
|
||||
}
|
||||
expected.error?.let {
|
||||
// Handle error occurred during the tile region download.
|
||||
logErrorMessage("TileRegionError: $it")
|
||||
}
|
||||
}
|
||||
prepareCancelButton()
|
||||
}
|
||||
|
||||
private fun showDownloadedRegions() {
|
||||
// Get a list of tile regions that are currently available.
|
||||
tileStore.getAllTileRegions { expected ->
|
||||
if (expected.isValue) {
|
||||
expected.value?.let { tileRegionList ->
|
||||
logInfoMessage("Existing tile regions: $tileRegionList")
|
||||
}
|
||||
}
|
||||
expected.error?.let { tileRegionError ->
|
||||
logErrorMessage("TileRegionError: $tileRegionError")
|
||||
}
|
||||
}
|
||||
// Get a list of style packs that are currently available.
|
||||
offlineManager.getAllStylePacks { expected ->
|
||||
if (expected.isValue) {
|
||||
expected.value?.let { stylePackList ->
|
||||
logInfoMessage("Existing style packs: $stylePackList")
|
||||
}
|
||||
}
|
||||
expected.error?.let { stylePackError ->
|
||||
logErrorMessage("StylePackError: $stylePackError")
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
private fun removeOfflineRegions() {
|
||||
// Remove the tile region with the tile region ID.
|
||||
// Note this will not remove the downloaded tile packs, instead, it will just mark the tileset
|
||||
// not a part of a tile region. The tiles still exists as a predictive cache in TileStore.
|
||||
tileStore.removeTileRegion(TILE_REGION_ID)
|
||||
|
||||
// Set the disk quota to zero, so that tile regions are fully evicted
|
||||
// when removed. The TileStore is also used when `ResourceOptions.isLoadTilePacksFromNetwork`
|
||||
// is `true`, and also by the Navigation SDK.
|
||||
// This removes the tiles that do not belong to any tile regions.
|
||||
tileStore.setOption(TileStoreOptions.DISK_QUOTA, Value(0))
|
||||
|
||||
// Remove the style pack with the style url.
|
||||
// Note this will not remove the downloaded style pack, instead, it will just mark the resources
|
||||
// not a part of the existing style pack. The resources still exists as disk cache.
|
||||
offlineManager.removeStylePack(Style.OUTDOORS)
|
||||
|
||||
MapboxMap.clearData(resourceOptions) {
|
||||
it.error?.let { error ->
|
||||
logErrorMessage(error)
|
||||
}
|
||||
}
|
||||
|
||||
// Reset progressbar.
|
||||
updateStylePackDownloadProgress(0, 0)
|
||||
updateTileRegionDownloadProgress(0, 0)
|
||||
}
|
||||
|
||||
private fun updateStylePackDownloadProgress(progress: Long, max: Long, message: String? = null) {
|
||||
binding.stylePackDownloadProgress.max = max.toInt()
|
||||
binding.stylePackDownloadProgress.progress = progress.toInt()
|
||||
message?.let {
|
||||
offlineLogsAdapter.addLog(OfflineLog.StylePackProgress(it))
|
||||
}
|
||||
}
|
||||
|
||||
private fun updateTileRegionDownloadProgress(progress: Long, max: Long, message: String? = null) {
|
||||
binding.tilePackDownloadProgress.max = max.toInt()
|
||||
binding.tilePackDownloadProgress.progress = progress.toInt()
|
||||
message?.let {
|
||||
offlineLogsAdapter.addLog(OfflineLog.TilePackProgress(it))
|
||||
}
|
||||
}
|
||||
|
||||
private fun logInfoMessage(message: String) {
|
||||
offlineLogsAdapter.addLog(OfflineLog.Info(message))
|
||||
}
|
||||
|
||||
private fun logErrorMessage(message: String) {
|
||||
offlineLogsAdapter.addLog(OfflineLog.Error(message))
|
||||
}
|
||||
|
||||
private fun logSuccessMessage(message: String) {
|
||||
offlineLogsAdapter.addLog(OfflineLog.Success(message))
|
||||
}
|
||||
|
||||
override fun onStart() {
|
||||
super.onStart()
|
||||
mapView?.onStart()
|
||||
}
|
||||
|
||||
override fun onStop() {
|
||||
super.onStop()
|
||||
mapView?.onStop()
|
||||
}
|
||||
|
||||
override fun onDestroy() {
|
||||
super.onDestroy()
|
||||
// Cancel the current downloading jobs
|
||||
stylePackCancelable?.cancel()
|
||||
tilePackCancelable?.cancel()
|
||||
// Remove downloaded style packs and tile regions.
|
||||
removeOfflineRegions()
|
||||
// Bring back the network connectivity when exiting the OfflineActivity.
|
||||
OfflineSwitch.getInstance().isMapboxStackConnected = true
|
||||
mapView?.onDestroy()
|
||||
}
|
||||
|
||||
private class OfflineLogsAdapter : RecyclerView.Adapter<OfflineLogsAdapter.ViewHolder>() {
|
||||
private var isUpdating: Boolean = false
|
||||
private val updateHandler = Handler()
|
||||
private val logs = ArrayList<OfflineLog>()
|
||||
|
||||
@SuppressLint("NotifyDataSetChanged")
|
||||
private val updateRunnable = Runnable {
|
||||
notifyDataSetChanged()
|
||||
isUpdating = false
|
||||
}
|
||||
|
||||
class ViewHolder internal constructor(view: View) : RecyclerView.ViewHolder(view) {
|
||||
internal var alertMessageTv: TextView = view.findViewById(R.id.alert_message)
|
||||
}
|
||||
|
||||
@NonNull
|
||||
override fun onCreateViewHolder(@NonNull parent: ViewGroup, viewType: Int): ViewHolder {
|
||||
val view =
|
||||
LayoutInflater.from(parent.context).inflate(R.layout.item_gesture_alert, parent, false)
|
||||
return ViewHolder(view)
|
||||
}
|
||||
|
||||
override fun onBindViewHolder(@NonNull holder: ViewHolder, position: Int) {
|
||||
val alert = logs[position]
|
||||
holder.alertMessageTv.text = alert.message
|
||||
holder.alertMessageTv.setTextColor(
|
||||
ContextCompat.getColor(holder.alertMessageTv.context, alert.color)
|
||||
)
|
||||
}
|
||||
|
||||
override fun getItemCount(): Int {
|
||||
return logs.size
|
||||
}
|
||||
|
||||
fun addLog(alert: OfflineLog) {
|
||||
when (alert) {
|
||||
is OfflineLog.Error -> Log.e(TAG, alert.message)
|
||||
else -> Log.d(TAG, alert.message)
|
||||
}
|
||||
logs.add(0, alert)
|
||||
if (!isUpdating) {
|
||||
isUpdating = true
|
||||
updateHandler.postDelayed(updateRunnable, 250)
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
private sealed class OfflineLog(val message: String, val color: Int) {
|
||||
class Info(message: String) : OfflineLog(message, android.R.color.black)
|
||||
class Error(message: String) : OfflineLog(message, android.R.color.holo_red_dark)
|
||||
class Success(message: String) : OfflineLog(message, android.R.color.holo_green_dark)
|
||||
class TilePackProgress(message: String) : OfflineLog(message, android.R.color.holo_purple)
|
||||
class StylePackProgress(message: String) : OfflineLog(message, android.R.color.holo_orange_dark)
|
||||
}
|
||||
|
||||
companion object {
|
||||
private const val TAG = "OfflineActivity"
|
||||
private const val ZOOM = 12.0
|
||||
private val TOKYO: Point = Point.fromLngLat(139.769305, 35.682027)
|
||||
private const val TILE_REGION_ID = "myTileRegion"
|
||||
private const val STYLE_PACK_METADATA = "my-outdoor-style-pack"
|
||||
private const val TILE_REGION_METADATA = "my-outdoors-tile-region"
|
||||
}
|
||||
}
|
||||
|
|
@ -0,0 +1,92 @@
|
|||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<androidx.coordinatorlayout.widget.CoordinatorLayout xmlns:android="http://schemas.android.com/apk/res/android"
|
||||
android:layout_width="fill_parent"
|
||||
android:layout_height="fill_parent">
|
||||
|
||||
<LinearLayout
|
||||
android:layout_width="fill_parent"
|
||||
android:layout_height="fill_parent"
|
||||
android:orientation="vertical"
|
||||
android:weightSum="10">
|
||||
|
||||
<FrameLayout
|
||||
android:id="@+id/container"
|
||||
android:layout_width="wrap_content"
|
||||
android:layout_height="0dp"
|
||||
android:layout_weight="6" />
|
||||
|
||||
<LinearLayout
|
||||
android:layout_width="fill_parent"
|
||||
android:layout_height="wrap_content"
|
||||
android:orientation="horizontal"
|
||||
android:paddingLeft="10dp"
|
||||
android:paddingRight="10dp"
|
||||
android:weightSum="10">
|
||||
|
||||
<TextView
|
||||
android:layout_width="0dp"
|
||||
android:layout_height="match_parent"
|
||||
android:layout_weight="2"
|
||||
android:text="style_pack"
|
||||
android:textSize="12sp"
|
||||
android:gravity="center"
|
||||
/>
|
||||
|
||||
<ProgressBar
|
||||
android:id="@+id/style_pack_download_progress"
|
||||
style="?android:attr/progressBarStyleHorizontal"
|
||||
android:layout_width="0dp"
|
||||
android:layout_height="wrap_content"
|
||||
android:layout_gravity="center"
|
||||
android:layout_weight="8"
|
||||
android:clickable="false"
|
||||
android:indeterminate="false"
|
||||
android:progressTint="@android:color/holo_orange_dark"
|
||||
android:max="100" />
|
||||
</LinearLayout>
|
||||
|
||||
<LinearLayout
|
||||
android:layout_width="fill_parent"
|
||||
android:layout_height="wrap_content"
|
||||
android:orientation="horizontal"
|
||||
android:paddingLeft="10dp"
|
||||
android:paddingRight="10dp"
|
||||
android:weightSum="10">
|
||||
|
||||
<TextView
|
||||
android:layout_width="0dp"
|
||||
android:layout_height="match_parent"
|
||||
android:layout_weight="2"
|
||||
android:gravity="center"
|
||||
android:textSize="12sp"
|
||||
android:text="tile_region" />
|
||||
|
||||
<ProgressBar
|
||||
android:id="@+id/tile_pack_download_progress"
|
||||
style="?android:attr/progressBarStyleHorizontal"
|
||||
android:layout_width="0dp"
|
||||
android:layout_height="wrap_content"
|
||||
android:layout_weight="8"
|
||||
android:layout_gravity="center"
|
||||
android:clickable="false"
|
||||
android:indeterminate="false"
|
||||
android:progressTint="@android:color/holo_purple"
|
||||
android:max="100" />
|
||||
</LinearLayout>
|
||||
|
||||
<androidx.recyclerview.widget.RecyclerView
|
||||
android:id="@+id/recycler"
|
||||
android:layout_width="fill_parent"
|
||||
android:layout_height="0dp"
|
||||
android:layout_weight="4"
|
||||
android:background="#97cdcfd3" />
|
||||
</LinearLayout>
|
||||
|
||||
<com.google.android.material.floatingactionbutton.ExtendedFloatingActionButton
|
||||
android:id="@+id/button"
|
||||
android:layout_width="wrap_content"
|
||||
android:layout_height="wrap_content"
|
||||
android:layout_gravity="end|bottom"
|
||||
android:layout_marginEnd="16dp"
|
||||
android:layout_marginBottom="16dp" />
|
||||
</androidx.coordinatorlayout.widget.CoordinatorLayout>
|
||||
|
|
@ -0,0 +1,14 @@
|
|||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
|
||||
android:layout_width="match_parent"
|
||||
android:layout_height="wrap_content">
|
||||
|
||||
<TextView
|
||||
android:id="@+id/alert_message"
|
||||
android:layout_width="match_parent"
|
||||
android:layout_height="wrap_content"
|
||||
android:paddingBottom="2dp"
|
||||
android:paddingTop="2dp"
|
||||
android:textSize="12sp" />
|
||||
|
||||
</FrameLayout>
|
||||
Ładowanie…
Reference in New Issue