Android开源地图项目 BigPlanetTracks 学习随笔

一、         app主体部分 [tyt.android.bigplanettracks]

二、         地图部分 [tyt.android.bigplanettracks.maps]

1、ui包

2、loader包 用来下载瓦片

3、maps包

4、storage包

三、         轨迹部分 [tyt.android.bigplanettracks.tracks]

 

 

一、   app主体部分 [tyt.android.bigplanettracks]

二、   地图部分 [tyt.android.bigplanettracks.maps]

1、ui包：界面部分

[1]     MapControl.java  地图核心操作

最下边包含一个内部类：面板类Panel，继承自View。

 

[2]     ZoomPanel.java   下方的缩放组件                           *会用到*

[3]     SmoothZoomEngine.java 平滑缩放引擎

包含一个Integer型的缩放队列：scaleQueue  

有SmoothZoomEngine线程  使用synchronized加锁

 

[4]     DoubleClickDetector.java 专门处理双击的类 包含双击判断

[5]     OnDialogClickListener.java   OnMapLongClickListener 监听器(基本空)

 

[6]     BitmapUtils.java 处理位图的实用工具  用来绘制BACKGROUND_COLOR颜色的空背景 和带框线LINE_COLOR的背景

[7]     AddBookmarkDialog.java 添加书签的对话框

 

2、loader包：下载瓦片

BaseLoader类定义了根据Tile去下载数据的瓦片RawTile数组tiles ，BaseLoader中很多都是使用抽象方法，这些方法在TileLoader中具体定义了。

 

[1]     BaseLoader.java   是一个继承自Thread类的抽象类

[2]     TileLoader.java  文件最下方有一个类ThreadLoader，继承自 BaseLoader，实现了BaseLoader中的抽象方法

 

3、maps包：地图相关类

[1]     RawTile.java  瓦片类  可被序列化(Intent传数据会用到) 记录Tile的行，列，以及图层的信息。

 

包含 x, y, z, s四个主要变量

 

Tile(x,y)坐标中x,y分别乘以瓦片的大小（在此为256）就得到了该Tile瓦片左上角在整个地图的偏移

 

x , y 是瓦片坐标系的坐标值，z代表缩放级别，s则共有八个字符：空字符和Galileo的七个字符。

x , y 的值在 z 增加时会按级数递增，而s 的值很可能是 x , y , z 三个参数组合后的从 0 到 7 的一个索引值。

x , y , z 组合后与 8 求余即可得到 s 的值。

 

当 x = 0 时，y 增 1 时，s会同时增 1，与 z 值无关。

当 y = 0 时，x 增 1 时，s会同时增3 ，与 z 值无关。

从上面两条可以得出，x , y 很可能以 3*x + y 的方式组合，然后与 8 求余即得 s。

 

推测公式为：（ 3*x + y ）%8 = s

 

详见http://blog.csdn.net/mygisforum/article/details/7582449

 

 

[2]     Preferences.java

保存软件的一些值，这些值都被声明为static final变量，类中包括每个值的put，get 方法。具体调用在BigPlanet类中。调用方式为Preferences.putGPSOffset();，Preferences.getGPSOffset();   每次启动软件都先进行初始化

 

[3]     Place.java   地点类

包括以下几个变量，以及它们的get  set方法

名称                  ：name;

纬度latitude      ：lat;

经度longitude   ：lon;

位置                    ：location;

地址                    ：address;

 

[4]     MarkerManager.java  标记物类

在MapControl.java 中有实例

构造函数中，将各个标记物对应的图片put入一个HashMap<Integer,MarkerImage> images中。

 

最下边两个类

MarkerImage  三个内部变量：

Bitmap  image   标记物图片

int      offsetX  X轴偏移

int      offsetY  Y轴偏移

 

Marker

              Place place; 地点

              RawTile tile; 瓦片

              Point offset; 偏移

              boolean isGPS;

              MarkerImage markerImage; 标记物图片

4、storage包：Cache缓存和文件缓存

[1]     ExpiredHashMap.java 能够存储一定量的位图，会自动删除最早的部分。

包含一个HashMap<ExpRawTile, Bitmap> (大小size在构造函数中指定)

gc()方法：用于在高速缓存中删除最旧的部分

 

ExpRawTile类在ExpiredHashMap.java文件最下边， 继承自瓦片类RawTile，实现了Comparable<ExpRawTile>接口，包含一个参数addedOn。两个ExpRawTile可比较addedOn的大小

 

[2]     BitmapCache.java 图片缓存类

包含一个ExpiredHashMap类型的变量 cacheMap

里边的函数，都是通过变量cacheMap调用ExpiredHashMap里的方法：清空clear()，get(), put()方法，gc()方法

 

[3]     BitmapCacheWrapper.java

其中有一个BitmapCacheWrapper类型的 实例instance，通过getInstance()得到

包含“不缩放”和“缩放”两种类型的的图片缓存，它们是BitmapCache类型的变量 cache(大小CACHE_SIZE)和scaledCache(大小为20)。

 

put方法：

putToCache(RawTile tile, Bitmap bitmap) 放置一个位图切片到缓存

putToScaledCache(RawTile tile, Bitmap bitmap)放置一个缩放过的位图切片到缓存

    get方法类似

 

public void gc(){

              scaledCache.gc();

              cache.gc();

       }

 

       public void clear() {

              scaledCache.clear();

              cache.clear();

       }

 

[4]     IlocalStorage 是个文件缓存的接口类，提供一些待实现接口

clear() 清空文件缓存

put()  在文件缓存保留瓦片

get()  返回指定的瓦片或空（如果没有找到）

 

[5]     LocalStorage 实现IlocalStorage中的接口                     **重要**

 

指定文件缓存的根目录 private static final String root_dir_location = "/sdcard/bigplanet/";                       ****没找到此目录****

拥有一个ILocalStorage 类型的实例localStorage，通过getInstance()获取;

构造函数中初始化文件缓存（如果有必要）;

clear() 清空文件缓存的函数，调用deleteDir()方法, 递归删除目录及其中的所有内容。

String buildPath(RawTile tile)  根据传入的RawTile对象，和根目录拼接，返回完整路径名称。

其中RawTile类中已重写toString函数。

@Override

       public String toString() {

              String path = s+"/"+z+"/"+x+"/"+y+"/";

              return path;

       }

void put(RawTile tile, byte[] data);

调用buildPath(tile)函数，通过tile构建完整路径，通过BufferedOutputStream输入流，将数据data写入文件中。

 

BufferedInputStream  get(RawTile tile);

调用buildPath(tile)函数，通过tile构建完整路径，返回BufferdInputStrem输入流(带有缓冲区域的InputStream)。

 

[6]     SQLLocalStorage.java   实现IlocalStorage中的接口

 

1)        将图片文件以二进制形式存到数据库中

2)        字段为：

x int,

y int,

z int,

s int,

image blob,

PRIMARY KEY (x,y,z,s)

 

3)        地图数据库的路径为/sdcard/RMaps/maps/

轨迹数据库的路径为/sdcard/BigPlanetTracks/

 

4)        put函数，存入数据库

      public void put(RawTile tile, byte[] data) {

             ContentValues initialValues = new ContentValues();

             initialValues.put(SQLLocalStorage.X_COLUMN, tile.x);

             initialValues.put(SQLLocalStorage.Y_COLUMN, tile.y);

             initialValues.put(SQLLocalStorage.Z_COLUMN, tile.z);

             initialValues.put(SQLLocalStorage.S_COLUMN, tile.s);

             initialValues.put(SQLLocalStorage.IMAGE_COLUMN, data);

             db.insert(SQLLocalStorage.TILES_TABLE, null, initialValues);

              }

其中

private static String X_COLUMN = "x";

      private static String Y_COLUMN = "y";

      private static String Z_COLUMN = "z";

      private static String S_COLUMN = "s";

              private static String IMAGE_COLUMN = "image";

              图像通过byte[] data存储在数据库中

 

5)        get函数

public BufferedInputStream get(RawTile tile)

返回的是 BufferedInputStream类型的 io变量

byte[] d = c.getBlob(c.getColumnIndex(SQLLocalStorage.IMAGE_COLUMN));

io = new BufferedInputStream(new ByteArrayInputStream(d), 4096);

 

 

BLOB (binary large object)，二进制大对象，是一个可以存储二进制文件的容器。

在计算机中，BLOB常常是数据库中用来存储二进制文件的字段类型。

BLOB是一个大文件，典型的BLOB是一张图片或一个声音文件，由于它们的尺寸，必须使用特殊的方式来处理（例如：上传、下载或者存放到一个数据库）。

 

 

 

6)        SQLLocalStorage和LocalStorage中都有一个

private static ILocalStorage localStorage;实例

通过public static ILocalStorage getInstance() {

              if (localStorage == null) {

                     localStorage = new SQLLocalStorage();

              }

              return localStorage;

       } 函数读取

 

三、              轨迹部分 [tyt.android.bigplanettracks.tracks]