com.mousebird.maply

Class RemoteTileInfoNew

java.lang.Object

com.mousebird.maply.TileInfoNew

com.mousebird.maply.RemoteTileInfoNew

public class RemoteTileInfoNew
extends TileInfoNew

Remote Tile Info Object (New)
Not to be confused with the old one, which works with the older loading subsystem, the new remote tile info object contains min/max zoom, coordinate system and URL information for fetching individual data tiles.

Field Summary

Fields

Modifier and Type	Field and Description
protected java.util.ArrayList<java.lang.String>	baseURLs
java.io.File	cacheDir The cache directory for data tiles.
CoordSystem	coordSys Optional coordinate system describing the tile set.
protected java.util.ArrayList<java.lang.String>	headerNames
okhttp3.Headers	headers Optional headers to add to the Request.
protected java.util.ArrayList<java.lang.String>	headerVals
Mbr	validBounds If set, we'll test the tiles against this bounding box before trying to fetch them.
CoordSystem	validCoordSys If set, the bounding box is in this coordinate system.

Fields inherited from class com.mousebird.maply.TileInfoNew

maxZoom, minZoom, uniqueID

Constructor Summary

Constructors

Constructor and Description
RemoteTileInfoNew(java.lang.String inBaseURL, int inMinZoom, int inMaxZoom) Initialize with enough information to fetch remote tiles.

Method Summary

Modifier and Type	Method and Description
void	addBaseURL(java.lang.String baseURL) Some sources offer the same content from multiple URLs for speed.
void	addHeader(java.lang.String name, java.lang.String val) Add a header key/value to the HTTP request before it goes out.
void	addValidBounds(Mbr inBbox, CoordSystem inCoordSys) Add a bounding box that defined validity for any tile before it's fetched.
java.lang.String	buildCacheName(int x, int y, int level, boolean flipY) Build a cache name for the cache file
okhttp3.Request	buildRequest(java.net.URL url, java.lang.Object OkHTTP_TAG) Build an okHTTP request
java.net.URL	buildURL(int x, int y, int level, boolean flipY) Construct a URL for a given tile.
java.lang.Object	fetchInfoForTile(TileID tileID, boolean flipY) Build the URL and other info for a single tile fetch.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

baseURLs

protected java.util.ArrayList<java.lang.String> baseURLs

cacheDir

public java.io.File cacheDir

The cache directory for data tiles.
In general, we want to cache. The globe, in particular, is going to fetch the same tiles over and over, quite a lot. The cacheing behavior is a little dumb. It will just write files to the given directory forever. If you're interacting with a giant image pyramid, that could be problematic.

headers

public okhttp3.Headers headers

Optional headers to add to the Request.
These are name/data pairs which will be stuck in the NSURLRequest header.

coordSys

public CoordSystem coordSys

Optional coordinate system describing the tile set.
This coordinate system is required if the tile info will need to evaluate valid tiles as defined by the addValidBounds:coordSystem: call.

validBounds

public Mbr validBounds

If set, we'll test the tiles against this bounding box before trying to fetch them.

validCoordSys

public CoordSystem validCoordSys

If set, the bounding box is in this coordinate system.

headerNames

protected java.util.ArrayList<java.lang.String> headerNames

headerVals

protected java.util.ArrayList<java.lang.String> headerVals

Constructor Detail

RemoteTileInfoNew

public RemoteTileInfoNew(java.lang.String inBaseURL,
                         int inMinZoom,
                         int inMaxZoom)

Initialize with enough information to fetch remote tiles. This version of the init method takes all the explicit information needed to fetch remote tiles. This includes the base URL and min and max zoom levels.

Parameters:

inBaseURL - The base URL for fetching TMS tiles. This is a replacement URL with {x}, {y}, and {z} in the string.

inMinZoom - The minimum zoom level to fetch. This really should be 0.

inMaxZoom - The maximum zoom level to fetch.

Method Detail

addBaseURL

public void addBaseURL(java.lang.String baseURL)

Some sources offer the same content from multiple URLs for speed. You can add more than one baseURL in that case and it'll pick among them.

addValidBounds

public void addValidBounds(Mbr inBbox,
                           CoordSystem inCoordSys)

Add a bounding box that defined validity for any tile before it's fetched.
Not all data sources cover all possible tiles. If you know your data source does not, you can specify what area is valid ahead of times. Tiles that do not overlap that area will not be loaded.

buildURL

public java.net.URL buildURL(int x,
                             int y,
                             int level,
                             boolean flipY)

Construct a URL for a given tile. If you'd like to override this you can construct your own URL. If you need to mess with Request parameters look for buildRequest().

addHeader

public void addHeader(java.lang.String name,
                      java.lang.String val)

Add a header key/value to the HTTP request before it goes out.

buildRequest

public okhttp3.Request buildRequest(java.net.URL url,
                                    java.lang.Object OkHTTP_TAG)

Build an okHTTP request

buildCacheName

public java.lang.String buildCacheName(int x,
                                       int y,
                                       int level,
                                       boolean flipY)

Build a cache name for the cache file

fetchInfoForTile

public java.lang.Object fetchInfoForTile(TileID tileID,
                                         boolean flipY)

Build the URL and other info for a single tile fetch. Returns is a RemoteTileFetcheInfo object.

Overrides:

fetchInfoForTile in class TileInfoNew