Rahul Vaidya’s Blog

This submission is in response to this gmaps-api-flex feature request. This is a hack that provides functionality like what was requested here.

So you’ve added a custom tile layer to your Google Maps app in Flex, which lets you show all your pretty spatial features. Fantastic! If you want to make this tile layer dynamic, however, you run into a few problems. The Google Maps Flex API caches tiles that it has loaded from a specific Tile Overlay, so if your data changes, the changes won’t be reflected on your map immediately. There have been various hacks that force a refresh of the map, but they don’t completely meet the requirements set in this feature request. The attached code here is a hack that tries to mimic the requested functionality, without refreshing the entire map.

After exploring a little, I saw that one way the Flex API differentiates overlays is by the request URL. If you create an overlay, add it to the map, remove it, create a new overlay with the same URL, and add the new overlay, it will load the tiles from the internal cache. Now, this functionality can be nice if you’re switching between two different overlays, and there haven’t been any changes in the data. For instance, if an app requests tiles from the following URLs in order:

mapserver.php?X=0&Y=0&Z=0&LAYERS=calicounties

mapserver.php?X=0&Y=0&Z=0&LAYERS=oregcounties

it will load both of these layers properly, and cache them both. If you then load the calicounties layer, using the same URL string, it’ll give you back the cached version.

However, if the data has changed, you’d want to reload the entire layer. To do this, I have appended a garbage GET variable to the URL. The requests will now look like:

mapserver.php?X=0&Y=0&Z=0&LAYERS=calicounties&GARBAGE=SDK34K

mapserver.php?X=0&Y=0&Z=0&LAYERS=oregcounties&GARBAGE=SDK34K

Simply change the GARBAGE variable when loading calicounties again and it’ll load from the source.

The included code implements four events that are dispatched to/listened from the map object:

• TileLayerRefresh
  • Tell the Tile Layer to refresh (do not change the GARBAGE variable)
• TileLayerReload
  • Tell the Tile Layer to reload (change the GARBAGE variable)
• TileLayerRefreshed
  • Refresh/Reload completed successfully (all tiles loaded)
  • Implemented by incrementing a counter whenever Loader instances are created, and decrementing the counter whenever they complete/fail.
• TileLayerRefreshError
  • If any loading errors occurred.

Note: You need to pass the TileLayer both the TileOverlay that holds it and the Map object, so it can handle refreshing and event dispatch by itself.

1
2
var tileLayer:MapServerTileLayer = new MapServerTileLayer(map);
3
var tileLayerOverlay:TileLayerOverlay = new TileLayerOverlay(tileLayer);
4
tileLayer.setOverlay(tileLayerOverlay);
5
map.addOverlay(tileLayerOverlay);
6

For an example on using MapServer/PHP MapScript with Google Maps, go to this blog post.

A nice little function I found posted by “lazynitwit” on BlueHost forums:

01
function getHeaders()
02
{
03
    $headers = array();
04
    foreach ($_SERVER as $k => $v)
05
    {
06
        if (substr($k, 0, 5) == "HTTP_")
07
        {
08
            $k = str_replace('_', ' ', substr($k, 5));
09
            $k = str_replace(' ', '-', ucwords(strtolower($k)));
10
            $headers[$k] = $v;
11
        }
12
    }
13
    return $headers;
14
}  

The PHP function getallheaders() only works on Apache, and only if Apache has been installed as a module.

It turns out that this information is within the $_SERVER global variable, and can be parsed out.

This code is useful if, for instance, you want to differentiate between user browser requests and requests made through AJAX. Some of the JavaScript frameworks (jQuery, Prototype, YUI, MooTools) send a special header,

X-Requested-With: XMLHttpRequest

whenever a request is made. I have put this to use in my phpFreeChat chat box to allow channels to be specified in the URL as GET parameters.

via request headers php – bluehostforum.com.